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).
Registry,
LocateRegistry,
LocateRegistry.createRegistry(int) | Modifier and Type | Method and Description |
|---|---|
static void |
bind (String name,
Remote obj)
Binds the specified
name to a remote object. |
static String[] |
list (String name)
Returns an array of the names bound in the registry.
|
static Remote |
lookup (String name)
Returns a reference, a stub, for the remote object associated
with the specified
name. |
static void |
rebind (String name,
Remote obj)
Rebinds the specified name to a new remote object.
|
static void |
unbind (String name)
Destroys the binding for the specified name that is associated
with a remote object.
|
public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
name.name - a name in URL format (without the scheme component)NotBoundException - if name is not currently boundRemoteException - if registry could not be contactedAccessException - if this operation is not permittedMalformedURLException - if the name is not an appropriately
formatted URLpublic static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
name to a remote object.name - a name in URL format (without the scheme component)obj - a reference for the remote object (usually a stub)AlreadyBoundException - if name is already boundMalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
name - a name in URL format (without the scheme component)NotBoundException - if name is not currently boundMalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
name - a name in URL format (without the scheme component)obj - new remote object to associate with the nameMalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contactedAccessException - if this operation is not permitted (if
originating from a non-local host, for example)public static String[] list(String name) throws RemoteException, MalformedURLException
name - a registry name in URL format (without the scheme
component)MalformedURLException - if the name is not an appropriately
formatted URLRemoteException - if registry could not be contacted. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2020, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.
Scripting on this page tracks web page traffic, but does not change the content in any way.