Interface java.rmi.registry.Registry
All Packages Class Hierarchy This Package Previous Next Index
Interface java.rmi.registry.Registry
- public interface Registry
- extends Remote
A "registry" exists on every node that allows RMI connections to
servers on that node. The registry on a particular node contains a
transient database that maps names to remote objects. When the
node boots, 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.
The LocateRegistry class is used to obtain the registry for different hosts.
- See Also:
- LocateRegistry
-
REGISTRY_PORT
- Well known port for registry
-
bind(String, Remote)
- Binds the name to the specified remote object.
-
list()
- Returns an array of the names in the registry.
-
lookup(String)
- Returns the remote object associated with the specified name in the
registry.
-
rebind(String, Remote)
-
Rebind the name to a new object, replacing any existing binding.
-
unbind(String)
- Unbind the name.
REGISTRY_PORT
public static final int REGISTRY_PORT
- Well known port for registry
bind
public abstract void bind(String name,
Remote obj) throws RemoteException, AlreadyBoundException, AccessException
- Binds the name to the specified remote object.
- Throws: RemoteException
- If remote operation failed.
- Throws: AlreadyBoundException
- If name is already bound.
- Throws: AccessException
- If this operation is not permitted.
list
public abstract java.lang.String[] list() throws RemoteException, AccessException
- Returns an array of the names in the registry.
- Throws: RemoteException
- If remote operation failed.
- Throws: AccessException
- If this operation is not permitted.
lookup
public abstract java.rmi.Remote lookup(String name) throws RemoteException, NotBoundException, AccessException
- Returns the remote object associated with the specified name in the
registry.
- Throws: RemoteException
- If remote operation failed.
- Throws: NotBoundException
- if there is no object with this name in the
registry.
- Throws: AccessException
- If this operation is not permitted.
rebind
public abstract void rebind(String name,
Remote obj) throws RemoteException, AccessException
- Rebind the name to a new object, replacing any existing binding.
- Throws: RemoteException
- If remote operation failed.
- Throws: AccessException
- If this operation is not permitted.
unbind
public abstract void unbind(String name) throws RemoteException, NotBoundException, AccessException
- Unbind the name.
- Throws: RemoteException
- If remote operation failed.
- Throws: NotBoundException
- if there is no object with this name in the
registry.
- Throws: AccessException
- If this operation is not permitted.
All Packages Class Hierarchy This Package Previous Next Index