BEA WebLogic Server 9.0 API Reference

weblogic.rmi.registry
Class LocateRegistry

java.lang.Object
  weblogic.rmi.registry.LocateRegistry

All Implemented Interfaces:

Registry, Remote

public final class LocateRegistry

extends Object

implements 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.

Copyright © 2005 BEA Systems, Inc. All Rights Reserved.

Field Summary

Fields inherited from interface java.rmi.registry.Registry

REGISTRY_PORT

Method Summary

void	bind(String name, Remote o) Binds a name to a remote object in the registry.
static String	clearURL(weblogic.protocol.ServerURL url)
static Registry	createRegistry(int port) Returns a WebLogic Server registry located on localhost at the specified port.
static Registry	getRegistry() Returns the WebLogic Server registry located on localhost.
static Registry	getRegistry(int port) Returns the WebLogic Server registry located on localhost at the specified port.
static Registry	getRegistry(String name) Returns the WebLogic Server registry located on the specified host.
static Registry	getRegistry(String name, int port) Returns the WebLogic Server registry located on the specified host and port.
static weblogic.protocol.ServerURL	getServerURL(String name)
static String	getURL(weblogic.protocol.ServerURL url)
String[]	list() Returns an array of names (URLs) currently bound into the WebLogic Server registry.
Remote	lookup(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(String name, Remote o) Rebinds a name to a remote object.
void	unbind(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

bind

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

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 Registry

Parameters:

name - the name for the Remote object.

Throws:

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

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

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

clearURL

public static String clearURL(weblogic.protocol.ServerURL url)
                       throws MalformedURLException

Throws:

MalformedURLException

createRegistry

public static Registry createRegistry(int port)
                               throws 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:

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

getRegistry

public static Registry getRegistry()
                            throws RemoteException

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

Returns:

the registry.

Throws:

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

getRegistry

public static Registry getRegistry(int port)
                            throws 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:

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

getRegistry

public static Registry getRegistry(String name)
                            throws RemoteException,
                                   UnknownHostException

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:

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

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

getRegistry

public static Registry getRegistry(String name,
                                   int port)
                            throws RemoteException,
                                   UnknownHostException

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:

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

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

getServerURL

public static weblogic.protocol.ServerURL getServerURL(String name)
                                                throws MalformedURLException

Throws:

MalformedURLException

getURL

public static String getURL(weblogic.protocol.ServerURL url)

list

public String[] list()
              throws RemoteException,
                     AccessException

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

Specified by:

list in interface Registry

Returns:

an array of URLs bound in the registry.

Throws:

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

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

lookup

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

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 Registry

Parameters:

name - the name of remote object to locate.

Returns:

the remote object.

Throws:

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

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

NotBoundException - if the specified name is not bound.

rebind

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

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 Registry

Parameters:

name - the name for the remote object.

Throws:

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

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

unbind

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

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 Registry

Parameters:

name - the name for the Remote object.

Throws:

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

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

NotBoundException - if the specified name is not bound.