Class Naming
public final class Naming extends Object
Naming
class provides methods for storing and obtaining references to remote objects in a remote object registry. Each method of the Naming
class takes as one of its arguments a name that is a java.lang.String
in URL format (without the scheme component) of the form: //host:port/name
where host
is the host (remote or local) where the registry is located, port
is the port number on which the registry accepts calls, and where name
is a simple string uninterpreted by the registry. Both host
and port
are optional. If host
is omitted, the host defaults to the local host. If port
is omitted, then the port defaults to 1099, the "well-known" port that RMI's registry, rmiregistry
, uses.
Binding a name for a remote object is associating or registering a name for a remote object that can be used at a later time to look up that remote object. A remote object can be associated with a name using the Naming
class's bind
or rebind
methods.
Once a remote object is registered (bound) with the RMI registry on the local host, callers on a remote (or local) host can lookup the remote object by name, obtain its reference, and then invoke remote methods on the object. A registry may be shared by all servers running on a host or an individual server process may create and use its own registry if desired (see java.rmi.registry.LocateRegistry.createRegistry
method for details).
- Since:
- 1.1
- See Also:
Method Summary
Modifier and Type | Method | Description |
---|---|---|
static void |
bind |
Binds the specified name to a remote object. |
static String[] |
list |
Returns an array of the names bound in the registry. |
static Remote |
lookup |
Returns a reference, a stub, for the remote object associated with the specified name . |
static void |
rebind |
Rebinds the specified name to a new remote object. |
static void |
unbind |
Destroys the binding for the specified name that is associated with a remote object. |
Method Details
lookup
public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
name
.- Parameters:
-
name
- a name in URL format (without the scheme component) - Returns:
- a reference for a remote object
- Throws:
-
NotBoundException
- if name is not currently bound -
RemoteException
- if registry could not be contacted -
AccessException
- if this operation is not permitted -
MalformedURLException
- if the name is not an appropriately formatted URL - Since:
- 1.1
bind
public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
name
to a remote object.- Parameters:
-
name
- a name in URL format (without the scheme component) -
obj
- a reference for the remote object (usually a stub) - Throws:
-
AlreadyBoundException
- if name is already bound -
MalformedURLException
- if the name is not an appropriately formatted URL -
RemoteException
- if registry could not be contacted -
AccessException
- if this operation is not permitted (if originating from a non-local host, for example) - Since:
- 1.1
unbind
public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
- Parameters:
-
name
- a name in URL format (without the scheme component) - Throws:
-
NotBoundException
- if name is not currently bound -
MalformedURLException
- if the name is not an appropriately formatted URL -
RemoteException
- if registry could not be contacted -
AccessException
- if this operation is not permitted (if originating from a non-local host, for example) - Since:
- 1.1
rebind
public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
- Parameters:
-
name
- a name in URL format (without the scheme component) -
obj
- new remote object to associate with the name - Throws:
-
MalformedURLException
- if the name is not an appropriately formatted URL -
RemoteException
- if registry could not be contacted -
AccessException
- if this operation is not permitted (if originating from a non-local host, for example) - Since:
- 1.1
list
public static String[] list(String name) throws RemoteException, MalformedURLException
- Parameters:
-
name
- a registry name in URL format (without the scheme component) - Returns:
- an array of names (in the appropriate format) bound in the registry
- Throws:
-
MalformedURLException
- if the name is not an appropriately formatted URL -
RemoteException
- if registry could not be contacted. - Since:
- 1.1
© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.rmi/java/rmi/Naming.html