| java.rmi.registry.Registry
All known Subclasses: javax.microedition.xlet.ixc.IxcRegistry,
| Registry | | public interface Registry extends Remote(Code) | | 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.
version:
1.13, 02/02/00
author:
Ann Wollrath
since:
JDK1.1
See Also: java.rmi.Naming
See Also: java.rmi.registry.LocateRegistry |
| Field Summary | |
| final public static int | REGISTRY_PORT
Well known port for registry. |
| Method Summary | |
| public void | bind(String name, Remote obj)
Binds the specified name to a remote object. | | public String[] | list()
Returns an array of the names bound in the registry. | | public Remote | lookup(String name)
Returns a reference, a stub, for the remote object associated
with the specified name. | | public void | rebind(String name, Remote obj)
Rebinds the specified name to a new remote object. | | public void | unbind(String name)
Destroys the binding for the specified name that is associated
with a remote object. |
| REGISTRY_PORT | | final public static int REGISTRY_PORT(Code) | | Well known port for registry.
|
| bind | | public void bind(String name, Remote obj) throws RemoteException, AlreadyBoundException, AccessException(Code) | | Binds the specified name to a remote object.
Parameters:
name - a URL-formatted name for the remote object
Parameters:
obj - a reference for the remote object (usually a stub)
exception:
AlreadyBoundException - if name is already bound
exception:
MalformedURLException - if the name is not an appropriatelyformatted URL
exception:
RemoteException - if registry could not be contacted
exception:
AccessException - if this operation is not permitted (iforiginating from a non-local host, for example)
since:
JDK1.1 |
| list | | public String[] list() throws RemoteException, AccessException(Code) | | Returns an array of the names bound in the registry. The names are
URL-formatted strings. The array contains a snapshot of the names
present in the registry at the time of the call.
an array of names (in the appropriate URL format) boundin the registry
exception:
RemoteException - if registry could not be contacted
exception:
AccessException - if this operation is not permitted (iforiginating from a non-local host, for example)
since:
JDK1.1 |
| rebind | | public void rebind(String name, Remote obj) throws RemoteException, AccessException(Code) | | Rebinds the specified name to a new remote object. Any existing
binding for the name is replaced.
Parameters:
name - a URL-formatted name associated with the remote object
Parameters:
obj - new remote object to associate with the name
exception:
MalformedURLException - if the name is not an appropriatelyformatted URL
exception:
RemoteException - if registry could not be contacted
exception:
AccessException - if this operation is not permitted (iforiginating from a non-local host, for example)
since:
JDK1.1 |
| unbind | | public void unbind(String name) throws RemoteException, NotBoundException, AccessException(Code) | | Destroys the binding for the specified name that is associated
with a remote object.
Parameters:
name - a URL-formatted name associated with a remote object
exception:
NotBoundException - if name is not currently bound
exception:
MalformedURLException - if the name is not an appropriatelyformatted URL
exception:
RemoteException - if registry could not be contacted
exception:
AccessException - if this operation is not permitted (iforiginating from a non-local host, for example)
since:
JDK1.1 |
|
|