org.exolab.jms.net.registry
Interface Registry

All Known Subinterfaces:

LocalRegistry

public interface Registry

The Registry provides a simple interface for binding and retrieving remote object references by name.

Version:

$Revision: 1.1 $ $Date: 2004/11/26 01:51:05 $

Author:

Tim Anderson

Method Summary

void	bind(java.lang.String name, Proxy proxy) Binds the specified name to a remote object.
Proxy	lookup(java.lang.String name) Returns a proxy for the remote object associated with the specified name
void	unbind(java.lang.String name) Removes the binding for the specified name

Method Detail

lookup

public Proxy lookup(java.lang.String name)
             throws java.rmi.NotBoundException,
                    java.rmi.RemoteException

Returns a proxy for the remote object associated with the specified name

Parameters:

name - the name the proxy is bound under

Returns:

the proxy bound to name

Throws:

java.rmi.NotBoundException - if name is not bound

java.rmi.RemoteException - if the registry could not be contacted

bind

public void bind(java.lang.String name,
                 Proxy proxy)
          throws java.rmi.AccessException,
                 java.rmi.AlreadyBoundException,
                 java.rmi.RemoteException

Binds the specified name to a remote object.

Parameters:

name - the name of the binding

proxy - the proxy for the remote object

Throws:

java.rmi.AccessException - if the caller doesn't have permission to bind the object

java.rmi.AlreadyBoundException - if name is already bound

java.rmi.RemoteException - if the registry could not be contacted

unbind

public void unbind(java.lang.String name)
            throws java.rmi.AccessException,
                   java.rmi.NotBoundException,
                   java.rmi.RemoteException

Removes the binding for the specified name

Parameters:

name - the name of the binding

Throws:

java.rmi.AccessException - if the caller doesn't have permission to unbind the object

java.rmi.NotBoundException - if name is not bound

java.rmi.RemoteException - if the registry could not be contacted