ucb.util
Class SimpleObjectRegistry

java.lang.Object
  extended by ucb.util.SimpleObjectRegistry

public class SimpleObjectRegistry
extends Object

A kind of registry that provides a very simple means of exchanging remote objects by name. One can create a registry, allowing the constructor to select an available port. One can find a bound object by name over a sequence of port numbers and hosts.


Field Summary
static int DEFAULT_HIGH_PORT
          The default values for LOWPORT and HIGHPORT arguments.
static int DEFAULT_LOW_PORT
          The default values for LOWPORT and HIGHPORT arguments.
 
Constructor Summary
SimpleObjectRegistry()
          Same as SimpleObjectRegistry (DEFAULT_LOW_PORT, DEFAULT_HIGH_PORT).
SimpleObjectRegistry(int port)
          Same as SimpleObjectRegistry (PORT, PORT).
SimpleObjectRegistry(int lowPort, int highPort)
          Create a new SimpleObjectRegistry on one of the ports LOWPORT to HIGHPORT, if possible.
 
Method Summary
 void close()
          Remove all bindings from this registry, and disable it from further use.
static Remote findObject(String name, String host)
          Same as findObject (NAME, HOST, DEFAULT_LOW_PORT, DEFAULT_HIGH_PORT).
static Remote findObject(String name, String[] hosts)
          Same as findObject (NAME, HOSTS, DEFAULT_LOW_PORT, DEFAULT_HIGH_PORT).
static Remote findObject(String name, String[] hosts, int lowPort, int highPort)
           
static Remote findObject(String name, String host, int lowPort, int highPort)
          Find an remote object named NAME in some registry on HOST on some port number between LOWPORT and HIGHPORT.
 int port()
          The port number on which this registry is exported.
 void rebind(String name, Remote value)
          Bind NAME to VALUE in this registry, replacing any existing binding.
 void unbind()
          Remove all bindings in this registry.
 void unbind(String name)
          Remove any binding of NAME in this registry.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DEFAULT_LOW_PORT

public static final int DEFAULT_LOW_PORT
The default values for LOWPORT and HIGHPORT arguments.

See Also:
Constant Field Values

DEFAULT_HIGH_PORT

public static final int DEFAULT_HIGH_PORT
The default values for LOWPORT and HIGHPORT arguments.

See Also:
Constant Field Values
Constructor Detail

SimpleObjectRegistry

public SimpleObjectRegistry(int lowPort,
                            int highPort)
                     throws RemoteException
Create a new SimpleObjectRegistry on one of the ports LOWPORT to HIGHPORT, if possible. Throws RemoteException if no registry can be created on any of these ports.

Throws:
RemoteException

SimpleObjectRegistry

public SimpleObjectRegistry(int port)
                     throws RemoteException
Same as SimpleObjectRegistry (PORT, PORT).

Throws:
RemoteException

SimpleObjectRegistry

public SimpleObjectRegistry()
                     throws RemoteException
Same as SimpleObjectRegistry (DEFAULT_LOW_PORT, DEFAULT_HIGH_PORT).

Throws:
RemoteException
Method Detail

findObject

public static Remote findObject(String name,
                                String host,
                                int lowPort,
                                int highPort)
                         throws NotBoundException
Find an remote object named NAME in some registry on HOST on some port number between LOWPORT and HIGHPORT. Throws NotBoundException if no such object is found for whatever reason (i.e., either because no registry is found or because NAME is unbound on all such registries.)

Throws:
NotBoundException

findObject

public static Remote findObject(String name,
                                String host)
                         throws NotBoundException
Same as findObject (NAME, HOST, DEFAULT_LOW_PORT, DEFAULT_HIGH_PORT).

Throws:
NotBoundException

findObject

public static Remote findObject(String name,
                                String[] hosts,
                                int lowPort,
                                int highPort)
                         throws NotBoundException
Throws:
NotBoundException

findObject

public static Remote findObject(String name,
                                String[] hosts)
                         throws NotBoundException
Same as findObject (NAME, HOSTS, DEFAULT_LOW_PORT, DEFAULT_HIGH_PORT).

Throws:
NotBoundException

port

public int port()
The port number on which this registry is exported.


rebind

public void rebind(String name,
                   Remote value)
Bind NAME to VALUE in this registry, replacing any existing binding.


unbind

public void unbind(String name)
Remove any binding of NAME in this registry.


unbind

public void unbind()
Remove all bindings in this registry.


close

public void close()
Remove all bindings from this registry, and disable it from further use.