public final class LocateRegistry extends Object
LocateRegistry is used to obtain a reference to a bootstrap
remote object registry on a particular host (including the local host), or
to create a remote object registry that accepts calls on a specific port.
Note that a getRegistry call does not actually make a
connection to the remote host. It simply creates a local reference to
the remote registry and will succeed even if no registry is running on
the remote host. Therefore, a subsequent method invocation to a remote
registry returned as a result of this method may fail.
Registry| Modifier and Type | Method and Description |
|---|---|
static Registry |
createRegistry(int port)
Creates and exports a
Registry instance on the local
host that accepts requests on the specified port. |
static Registry |
createRegistry(int port,
RMIClientSocketFactory csf,
RMIServerSocketFactory ssf)
Creates and exports a
Registry instance on the local
host that uses custom socket factories for communication with that
instance. |
static Registry |
getRegistry()
Returns a reference to the the remote object
Registry for
the local host on the default registry port of 1099. |
static Registry |
getRegistry(int port)
Returns a reference to the the remote object
Registry for
the local host on the specified port. |
static Registry |
getRegistry(String host)
Returns a reference to the remote object
Registry on the
specified host on the default registry port of 1099. |
static Registry |
getRegistry(String host,
int port)
Returns a reference to the remote object
Registry on the
specified host and port. |
static Registry |
getRegistry(String host,
int port,
RMIClientSocketFactory csf)
Returns a locally created remote reference to the remote object
Registry on the specified host and
port. |
public static Registry getRegistry() throws RemoteException
Registry for
the local host on the default registry port of 1099.RemoteException - if the reference could not be createdpublic static Registry getRegistry(int port) throws RemoteException
Registry for
the local host on the specified port.port - port on which the registry accepts requestsRemoteException - if the reference could not be createdpublic static Registry getRegistry(String host) throws RemoteException
Registry on the
specified host on the default registry port of 1099. If
host is null, the local host is used.host - host for the remote registryRemoteException - if the reference could not be createdpublic static Registry getRegistry(String host, int port) throws RemoteException
Registry on the
specified host and port. If host
is null, the local host is used.host - host for the remote registryport - port on which the registry accepts requestsRemoteException - if the reference could not be createdpublic static Registry getRegistry(String host, int port, RMIClientSocketFactory csf) throws RemoteException
Registry on the specified host and
port. Communication with this remote registry will
use the supplied RMIClientSocketFactory csf
to create Socket connections to the registry on the
remote host and port.host - host for the remote registryport - port on which the registry accepts requestscsf - client-side Socket factory used to
make connections to the registry. If csf
is null, then the default client-side Socket
factory will be used in the registry stub.RemoteException - if the reference could not be createdpublic static Registry createRegistry(int port) throws RemoteException
Registry instance on the local
host that accepts requests on the specified port.
The Registry instance is exported as if the static
UnicastRemoteObject.exportObject method is invoked, passing the
Registry instance and the specified port as
arguments, except that the Registry instance is
exported with a well-known object identifier, an ObjID
instance constructed with the value ObjID.REGISTRY_ID.
port - the port on which the registry accepts requestsRemoteException - if the registry could not be exportedpublic static Registry createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException
Registry instance on the local
host that uses custom socket factories for communication with that
instance. The registry that is created listens for incoming
requests on the given port using a
ServerSocket created from the supplied
RMIServerSocketFactory.
The Registry instance is exported as if
the static UnicastRemoteObject.exportObject method is invoked, passing the
Registry instance, the specified port, the
specified RMIClientSocketFactory, and the specified
RMIServerSocketFactory as arguments, except that the
Registry instance is exported with a well-known object
identifier, an ObjID instance constructed with the value
ObjID.REGISTRY_ID.
port - port on which the registry accepts requestscsf - client-side Socket factory used to
make connections to the registryssf - server-side ServerSocket factory
used to accept connections to the registryRemoteException - if the registry could not be exported 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, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138