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

lookup

 public abstract 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.

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.

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.

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.

list

 public abstract 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.

All Packages  Class Hierarchy  This Package  Previous  Next  Index

Submit a bug or feature