Module org.newsclub.net.unix.rmi

Package org.newsclub.net.unix.rmi

Class AFRegistry

java.lang.Object

org.newsclub.net.unix.rmi.AFRegistry

All Implemented Interfaces:

Registry, Remote

Direct Known Subclasses:

AFUNIXRegistry

public abstract class AFRegistry
extends Object
implements Registry

A wrapper for RMI registries, both remote and local, to allow for a clean removal of bound resources upon shutdown.

Author:

Christian Kohlschütter

Field Summary

Fields inherited from interface java.rmi.registry.Registry

REGISTRY_PORT

Method Summary

Modifier and Type	Method	Description
void	bind(String name, Remote obj)
AFNaming	getNaming()	Returns the AFNaming instance responsible for this registry.
final boolean	isLocal()	Returns true if the wrapped Registry instance is locally created.
boolean	isRemoteServer()	Deprecated.
String[]	list()
Remote	lookup(String name)
Remote	lookup(String name, long timeout, TimeUnit unit)	Returns the remote reference bound to the specified name in this registry.
void	rebind(String name, Remote obj)
void	unbind(String name)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

isRemoteServer

@Deprecated
public boolean isRemoteServer()

Deprecated.

Returns true if the wrapped Registry instance is a locally created RemoteServer.

Returns:

true if wrapped instance is a locally created RemoteServer.

See Also:

• isLocal()

isLocal

public final boolean isLocal()

Returns true if the wrapped Registry instance is locally created.

Returns:

true if wrapped instance is locally created.

getNaming

public AFNaming getNaming()

Returns the AFNaming instance responsible for this registry.

Returns:

The AFNaming instance.

lookup

public Remote lookup(String name)
              throws RemoteException,
NotBoundException,
AccessException

Specified by:

lookup in interface Registry

Throws:

RemoteException

NotBoundException

AccessException

bind

public void bind(String name,
 Remote obj)
          throws RemoteException,
AlreadyBoundException,
AccessException

Specified by:

bind in interface Registry

Throws:

RemoteException

AlreadyBoundException

AccessException

unbind

public void unbind(String name)
            throws RemoteException,
NotBoundException,
AccessException

Specified by:

unbind in interface Registry

Throws:

RemoteException

NotBoundException

AccessException

rebind

public void rebind(String name,
 Remote obj)
            throws RemoteException,
AccessException

Specified by:

rebind in interface Registry

Throws:

RemoteException

AccessException

list

public String[] list()
              throws RemoteException,
AccessException

Specified by:

list in interface Registry

Throws:

RemoteException

AccessException

lookup

public Remote lookup(String name,
 long timeout,
 TimeUnit unit)
              throws NotBoundException,
RemoteException

Returns the remote reference bound to the specified name in this registry. If the reference has not been bound yet, repeated attempts to resolve it are made until the specified time elapses.

Parameters:

name - the name for the remote reference to look up

timeout - The timeout value.

unit - The timeout unit.

Returns:

a reference to a remote object

Throws:

NotBoundException - if name is not currently bound and couldn't be resolved in the specified time.

RemoteException - if remote communication with the registry failed; if exception is a ServerException containing an AccessException, then the registry denies the caller access to perform this operation

AccessException - if this registry is local and it denies the caller access to perform this operation

NullPointerException - if name is null