View Javadoc

1   /*
2    * Copyright (c) 1998-2005 The Jgroup Team.
3    *
4    * This program is free software; you can redistribute it and/or modify
5    * it under the terms of the GNU Lesser General Public License version 2 as
6    * published by the Free Software Foundation.
7    *
8    * This program is distributed in the hope that it will be useful,
9    * but WITHOUT ANY WARRANTY; without even the implied warranty of
10   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
11   * GNU Lesser General Public License for more details.
12   *
13   * You should have received a copy of the GNU Lesser General Public License
14   * along with this program; if not, write to the Free Software
15   * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
16   *
17   */
18  package jgroup.relacs.gm;
19  
20  import java.io.IOException;
21  
22  import jgroup.core.Layer;
23  
24  /**
25   * Service interface for performing lookups from a replicated
26   * client group using the group-enabled lookup service (greg).
27   * 
28   * See <code>LookupService<code> for more details.
29   *
30   * @author Rohnny Moland
31   * @since Jgroup 2.2
32   */
33  public interface GregLookupService
34    extends Layer
35  {
36    /**
37     * Returns a proxy for the remote object group associated with 
38     * the specified name in greg. 
39     *  
40     * @param name
41     *   The name associated with the remote object group.
42     * @return
43     *   A proxy for the remote object group.
44     * 
45     * @exception IOException
46     *   If an error occured during lookup.
47     */
48    public Object lookup(String name)
49      throws IOException;
50  
51  } // END GregLookupService