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






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 - Version 1.1.7 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.