java.rmi
public final class Naming extends Object
The Naming
class handles interactions with RMI registries.
Each method takes a URL in String
form, which points to
the RMI registry. The scheme of the URL is irrelevant. The relevant
part is:
//host:port/name
which tells the method how to locate and access the registry. The host and port are both optional, and default to `localhost' and the standard RMI registry port (1099) respectively. The name is simply a string used to refer to a particular service hosted by the registry. The registry does not attempt to interpret this further.
RMI services are registered using one of these names, and the same name
is later used by the client to lookup the service and access its methods.
Registries can be shared by multiple services, or a service can create
its own registry using createRegistry()
.
Modifier and Type | Method and Description |
---|---|
static void |
bind(String name,
Remote obj)
Try to bind the given object to the given service name.
|
static String[] |
list(String name)
Lists all services at the named registry.
|
static Remote |
lookup(String name)
Looks for the remote object that is associated with the named service.
|
static void |
rebind(String name,
Remote obj)
Forces the binding between the given Remote-object and the given service
name, even if there was already an object bound to this name.
|
static void |
unbind(String name)
Remove a binding for a given service name.
|
public static Remote lookup(String name) throws NotBoundException, MalformedURLException, RemoteException
//host:port/service-nameThe port is optional.
name
- the service name and locationNotBoundException
- if no object implements the serviceMalformedURLException
RemoteException
public static void bind(String name, Remote obj) throws AlreadyBoundException, MalformedURLException, RemoteException
name
- obj
- AlreadyBoundException
MalformedURLException
RemoteException
public static void unbind(String name) throws RemoteException, NotBoundException, MalformedURLException
name
- RemoteException
NotBoundException
MalformedURLException
public static void rebind(String name, Remote obj) throws RemoteException, MalformedURLException
name
- obj
- RemoteException
MalformedURLException
public static String[] list(String name) throws RemoteException, MalformedURLException
name
- url that specifies the registryRemoteException
MalformedURLException