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

Variable Index

 o REGISTRY_PORT
Well known port for registry

Method Index

 o bind(String, Remote)
Binds the name to the specified remote object.
 o list()
Returns an array of the names in the registry.
 o lookup(String)
Returns the remote object associated with the specified name in the registry.
 o rebind(String, Remote)
Rebind the name to a new object, replacing any existing binding.
 o unbind(String)
Unbind the name.

Variables

 o REGISTRY_PORT
 public static final int REGISTRY_PORT
Well known port for registry

Methods

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