|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
For obtaining references to remote objects, RMI provides a simple
remote object registry interface, implemented by RMI's
rmiregistry, that provides methods for storing and retrieving
remote object references. The java.rmi.Naming class
provides methods to access a remote object registry using URL-formatted
names to specify in a compact format both the remote registry along
with the name for the remote object.
Typically a "registry" exists on every node that allows RMI connections to servers on that node. A registry on a particular node contains a transient database that maps names to remote objects. When a registry starts up, the registry database is empty. The names stored in the registry are pure and are not parsed. A service storing itself in the registry may want to prefix its name of the service by a package name (although not required), to reduce name collisions in the registry.
To create a registry that runs in an application, use one of the
LocateRegistry.createRegistry methods. To obtain a reference
to a remote object registry, use one of the
LocateRegistry.getRegistry methods.
Naming,
LocateRegistry| Field Summary | |
static int |
REGISTRY_PORT
Well known port for registry. |
| Method Summary | |
void |
bind(String name,
Remote obj)
Binds the specified name to a remote object. |
String[] |
list()
Returns an array of the names bound in the registry. |
Remote |
lookup(String name)
Returns a reference, a stub, for the remote object associated with the specified name. |
void |
rebind(String name,
Remote obj)
Rebinds the specified name to a new remote object. |
void |
unbind(String name)
Destroys the binding for the specified name that is associated with a remote object. |
| Field Detail |
public static final int REGISTRY_PORT
| Method Detail |
public Remote lookup(String name)
throws RemoteException,
NotBoundException,
AccessException
name.name - a URL-formatted name for the remote objectNotBoundException - if name is not currently boundRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)
public void bind(String name,
Remote obj)
throws RemoteException,
AlreadyBoundException,
AccessException
name to a remote object.name - a URL-formatted name for the remote objectobj - a reference for the remote object (usually a stub)AlreadyBoundException - if name is already boundMalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)
public void unbind(String name)
throws RemoteException,
NotBoundException,
AccessException
name - a URL-formatted name associated with a remote objectNotBoundException - if name is not currently boundMalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)
public void rebind(String name,
Remote obj)
throws RemoteException,
AccessException
name - a URL-formatted name associated with the remote objectobj - new remote object to associate with the nameMalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)
public String[] list()
throws RemoteException,
AccessException
RemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.