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 SummaryModifier and TypeMethodDescriptionstatic voidBinds the specifiednameto a remote object.static String[]Returns an array of the names bound in the registry.static RemoteReturns a reference, a stub, for the remote object associated with the specifiedname.static voidRebinds the specified name to a new remote object.static voidDestroys the binding for the specified name that is associated with a remote object.
- 
Method Details- 
lookuppublic static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException Returns a reference, a stub, for the remote object associated with the specifiedname.- 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
 
- 
bindpublic static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException Binds the specifiednameto 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
 
- 
unbindpublic static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException Destroys the binding for the specified name that is associated with a remote object.- 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
 
- 
rebindRebinds the specified name to a new remote object. Any existing binding for the name is replaced.- 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
 
- 
listReturns 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.- 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
 
 
-