java.lang.Object | |
↳ | java.rmi.Naming |
The 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).
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Binds the specified
name to a remote object. | |||||||||||
Returns an array of the names bound in the registry.
| |||||||||||
Returns a reference, a stub, for the remote object associated
with the specified
name . | |||||||||||
Rebinds the specified name to a new remote object.
| |||||||||||
Destroys the binding for the specified name that is associated
with a remote object.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Binds the specified 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 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) |
Returns an array of the names bound in the registry. The names are URL-formatted (without the scheme component) strings. The array contains a snapshot of the names present in the registry at the time of the call.
name | a registry name in URL format (without the scheme component) |
---|
MalformedURLException | if the name is not an appropriately formatted URL |
---|---|
RemoteException | if registry could not be contacted. |
Returns a reference, a stub, for the remote object associated
with the specified name
.
name | a name in URL format (without the scheme component) |
---|
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 |
Rebinds the specified name to a new remote object. Any existing binding for the name is replaced.
name | a name in URL format (without the scheme component) |
---|---|
obj | new remote object to associate with the name |
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) |
Destroys the binding for the specified name that is associated with a remote object.
name | a name in URL format (without the scheme component) |
---|
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) |