Package weblogic.rmi.registry

Class LocateRegistry

java.lang.Object

weblogic.rmi.registry.LocateRegistry

All Implemented Interfaces:

java.rmi.registry.Registry, java.rmi.Remote

public final class LocateRegistry
extends java.lang.Object
implements java.rmi.registry.Registry

This class is provided for compatibility with the java.rmi.* package.

The registry returned is a co-located object that invokes methods on the server-side JNDI implementation.

Field Summary

Fields inherited from interface java.rmi.registry.Registry

REGISTRY_PORT

Method Summary

Modifier and Type	Method	Description
void	bind(java.lang.String name, java.rmi.Remote o)	Binds a name to a remote object in the registry.
static java.rmi.registry.Registry	createRegistry(int port)	Returns a WebLogic Server registry located on localhost at the specified port.
static java.rmi.registry.Registry	getRegistry()	Returns the WebLogic Server registry located on localhost.
static java.rmi.registry.Registry	getRegistry(int port)	Returns the WebLogic Server registry located on localhost at the specified port.
static java.rmi.registry.Registry	getRegistry(java.lang.String name)	Returns the WebLogic Server registry located on the specified host.
static java.rmi.registry.Registry	getRegistry(java.lang.String name, int port)	Returns the WebLogic Server registry located on the specified host and port.
java.lang.String[]	list()	Returns an array of names (URLs) currently bound into the WebLogic Server registry.
java.rmi.Remote	lookup(java.lang.String name)	Returns a remote object -- an initialized instance of a stub or the instance of a co-located object when the object is found in the weblogic.rmi name space.
void	rebind(java.lang.String name, java.rmi.Remote o)	Rebinds a name to a remote object.
void	unbind(java.lang.String name)	Unbinds a name from the registry.

Methods inherited from class java.lang.Object

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

Method Detail

lookup

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

Returns a remote object -- an initialized instance of a stub or the instance of a co-located object when the object is found in the weblogic.rmi name space.

Specified by:

lookup in interface java.rmi.registry.Registry

Parameters:

name - the name of remote object to locate.

Returns:

the remote object.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.

java.rmi.AccessException - if there is an error accessing the remote object.

java.rmi.NotBoundException - if the specified name is not bound.

bind

public void bind(java.lang.String name,
                 java.rmi.Remote o)
          throws java.rmi.RemoteException,
                 java.rmi.AlreadyBoundException

Binds a name to a remote object in the registry.

The name may be a full URL that follows conventional RMI naming procedures or a name for the object itself. Use the following naming convention within the Weblogic registry:

  t3://localhost:7001/nameForRemoteObject

where t3://localhost:7001 is the default URL.

Specified by:

bind in interface java.rmi.registry.Registry

Parameters:

name - the name for the Remote object.

o - the remote object.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.

java.rmi.AlreadyBoundException - if the name is already bound to another object.

java.rmi.AccessException - if there is an error accessing the remote object.

unbind

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

Unbinds a name from the registry.

The name may be a full URL that follows conventional RMI naming procedures or a name for the object itself. Use the following naming convention within the Weblogic registry:

  t3://localhost:7001/nameForRemoteObject

where t3://localhost:7001 is the default URL.

Specified by:

unbind in interface java.rmi.registry.Registry

Parameters:

name - the name for the Remote object.

Throws:

java.rmi.RemoteException - if there is an error with the Remote object.

java.rmi.AccessException - if there is an error accessing the Remote object.

java.rmi.NotBoundException - if the specified name is not bound.

rebind

public void rebind(java.lang.String name,
                   java.rmi.Remote o)
            throws java.rmi.RemoteException

Rebinds a name to a remote object. If the name is already bound to another Remote object, the binding is removed before binding to the new remote object.

The name may be a full URL that follows conventional RMI naming procedures or a name for the object itself. Use the following naming convention within the Weblogic registry:

  t3://localhost:7001/nameForRemoteObject

where t3://localhost:7001 is the default URL.

Specified by:

rebind in interface java.rmi.registry.Registry

Parameters:

name - the name for the remote object.

o - the remote object.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.

java.rmi.AccessException - if there is an error accessing the remote object.

list

public java.lang.String[] list()
                        throws java.rmi.RemoteException

Returns an array of names (URLs) currently bound into the WebLogic Server registry.

Specified by:

list in interface java.rmi.registry.Registry

Returns:

an array of URLs bound in the registry.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.

java.rmi.AccessException - if there is an error accessing the remote object.

getRegistry

public static java.rmi.registry.Registry getRegistry()
                                              throws java.rmi.RemoteException

Returns the WebLogic Server registry located on localhost. Provides compatibility with the java.rmi.* package.

Returns:

the registry.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.

getRegistry

public static java.rmi.registry.Registry getRegistry(int port)
                                              throws java.rmi.RemoteException

Returns the WebLogic Server registry located on localhost at the specified port. Provides compatibility with the java.rmi.* package.

Parameters:

port - the port at which WebLogic registry is located.

Returns:

the registry.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.

getRegistry

public static java.rmi.registry.Registry getRegistry(java.lang.String name)
                                              throws java.rmi.RemoteException

Returns the WebLogic Server registry located on the specified host. Provides compatibility with the java.rmi.* package.

Parameters:

name - the host where the registry is located.

Returns:

the registry.

Throws:

java.rmi.UnknownHostException - if the host specified by the URL is unknown.

java.rmi.RemoteException - if there is an error with the remote object.

getRegistry

public static java.rmi.registry.Registry getRegistry(java.lang.String name,
                                                     int port)
                                              throws java.rmi.RemoteException

Returns the WebLogic Server registry located on the specified host and port. Provides compatibility with the java.rmi.* package.

Parameters:

name - the name of host where the registry is located.

port - the port where the registry is located.

Returns:

the registry.

Throws:

java.rmi.UnknownHostException - if the host specified by the URL is unknown.

java.rmi.RemoteException - if there is an error with the remote object.

createRegistry

public static java.rmi.registry.Registry createRegistry(int port)
                                                 throws java.rmi.RemoteException

Returns a WebLogic Server registry located on localhost at the specified port. Provides compatibility with the java.rmi.* package.

Parameters:

port - the port where the registry is located.

Returns:

the registry.

Throws:

java.rmi.RemoteException - if there is an error with the remote object.