hydra

Class RmiRegistryHelper

java.lang.Object

hydra.RmiRegistryHelper

public class RmiRegistryHelper
extends java.lang.Object

Helps create and access RMI registries. Includes helper methods for use by clients to access the master registry and the master proxy which is bound there.

Constructor Summary

Constructors

Constructor and Description
RmiRegistryHelper()

Method Summary

Modifier and Type	Method and Description
static void	bind(java.rmi.registry.Registry registry, java.lang.String key, java.rmi.Remote val) Binds a remote object into the given RMI registry using the specified key.
static void	bindInMaster(java.lang.String key, java.rmi.Remote val) Binds a remote object into the master RMI registry using the specified key.
protected static java.lang.String	detectKnownRMIBugs(java.rmi.UnmarshalException unmarshalEx) Detect known RMI bugs, notably 52149 or 52150.
static java.lang.String	getMasterRegistryURL() Returns the URL for the master RMI registry.
static java.rmi.Remote	lookup(java.lang.String url) Looks up a remote object by url.
static java.rmi.Remote	lookupInMaster(java.lang.String name) Looks up the specified object in the master RMI registry.
static MasterProxyIF	lookupMaster() Looks up the master proxy in the master RMI registry.
static java.rmi.registry.Registry	startRegistry(java.lang.String name, int port) Starts an in-process RMI registry using the given name and port.

Methods inherited from class java.lang.Object

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

Constructor Detail

RmiRegistryHelper

public RmiRegistryHelper()

Method Detail

startRegistry

public static java.rmi.registry.Registry startRegistry(java.lang.String name,
                                                       int port)

Starts an in-process RMI registry using the given name and port. Waits until it is answering before returning.

Returns:

the registry.

Throws:

HydraRuntimeException - if an exception occurs.

HydraTimeoutException - if the registry fails to answer after within START_TIMEOUT_SEC.

bind

public static void bind(java.rmi.registry.Registry registry,
                        java.lang.String key,
                        java.rmi.Remote val)

Binds a remote object into the given RMI registry using the specified key. The registry must be local to the caller.

Throws:

HydraRuntimeException - Another object is bound to that name or if some other RemoteException occurs.

lookup

public static java.rmi.Remote lookup(java.lang.String url)

Looks up a remote object by url.

detectKnownRMIBugs

protected static java.lang.String detectKnownRMIBugs(java.rmi.UnmarshalException unmarshalEx)

Detect known RMI bugs, notably 52149 or 52150.

Parameters:

unmarshalEx - An UnmarshalException which was thrown by rmi.

Returns:

String The failure message for the known RMI bug, or null if no bug was detected.

getMasterRegistryURL

public static java.lang.String getMasterRegistryURL()

Returns the URL for the master RMI registry.

lookupMaster

public static MasterProxyIF lookupMaster()

Looks up the master proxy in the master RMI registry.

bindInMaster

public static void bindInMaster(java.lang.String key,
                                java.rmi.Remote val)

Binds a remote object into the master RMI registry using the specified key. The registry must be local to the caller.

Throws:

HydraRuntimeException - Another object is bound to that name or if some other RemoteException occurs.

lookupInMaster

public static java.rmi.Remote lookupInMaster(java.lang.String name)

Looks up the specified object in the master RMI registry.