compact2, compact3

java.rmi.registry

Class LocateRegistry

java.lang.Object

java.rmi.registry.LocateRegistry

public final class LocateRegistry
extends Object

LocateRegistry用于获取对特定主机（包括本地主机）上的引导远程对象注册表的引用，或用于创建接受特定端口上的调用的远程对象注册表。

请注意， getRegistry呼叫实际上并不连接到远程主机。 它只是创建对远程注册表的本地引用，并且即使没有在远程主机上运行注册表，也将成功。 因此，作为此方法的结果返回的远程注册表的后续方法调用可能会失败。

从以下版本开始：

JDK1.1

另请参见：

Registry

方法摘要

Modifier and Type	Method and Description
static Registry	createRegistry(int port) 在本地主机上创建并导出 Registry实例，该实例接受指定的 port上的请求。
static Registry	createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 在本地主机上创建并导出 Registry实例，该实例使用自定义套接字工厂进行与该实例的通信。
static Registry	getRegistry() 返回对默认注册表端口1099的本地主机的远程对象 Registry 。
static Registry	getRegistry(int port) 在指定的port上返回对本地主机的远程对象 Registry的 port 。
static Registry	getRegistry(String host) 返回参考对远程对象 Registry上的指定 host 1099默认注册表端口上。
static Registry	getRegistry(String host, int port) 返回对指定的 host和 port上的远程对象 Registry的 port 。
static Registry	getRegistry(String host, int port, RMIClientSocketFactory csf) 返回本地创建的对指定的 host和 port上的远程对象 Registry的远程引用。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细信息

getRegistry

public static Registry getRegistry()
                            throws RemoteException

返回对默认注册表端口1099的本地主机的远程对象 Registry 。

结果

引用（stub）到远程对象注册表

异常

RemoteException - 如果无法创建引用

从以下版本开始：

JDK1.1

getRegistry

public static Registry getRegistry(int port)
                            throws RemoteException

在指定的port上返回对本地主机的远程对象 Registry的 port 。

参数

port - 注册表接受请求的端口

结果

引用（stub）到远程对象注册表

异常

RemoteException - 如果无法创建引用

从以下版本开始：

JDK1.1

getRegistry

public static Registry getRegistry(String host)
                            throws RemoteException

返回参考远程对象 Registry指定的 host 1099如果默认的注册表端口 host是 null ，该本地主机使用。

参数

host - 远程注册表的主机

结果

引用（stub）到远程对象注册表

异常

RemoteException - 如果引用无法创建

从以下版本开始：

JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port)
                            throws RemoteException

返回对指定的host和port上的远程对象Registry的port 。 如果host是null ，则使用本地主机。

参数

host - 远程注册表的主机

port - 注册表接受请求的端口

结果

引用（stub）到远程对象注册表

异常

RemoteException - 如果无法创建引用

从以下版本开始：

JDK1.1

getRegistry

public static Registry getRegistry(String host,
                                   int port,
                                   RMIClientSocketFactory csf)
                            throws RemoteException

返回在指定的host和port上的远程对象Registry的本地创建的远程引用。 与此远程注册表的通信将使用随附的RMIClientSocketFactory csf创建Socket连接到远程host和port上的注册表。

参数

host - 远程注册表的主机

port - 注册表接受请求的端口

csf - 客户端Socket工厂用于连接注册表。 如果csf为空，则默认客户端Socket工厂将在注册表存根中使用。

结果

引用（存根）到远程注册表

异常

RemoteException - 如果无法创建引用

从以下版本开始：

1.2

createRegistry

public static Registry createRegistry(int port)
                               throws RemoteException

在本地主机上创建并导出Registry实例，该实例接受指定的port的port 。

所述Registry实例被导出为如果静态UnicastRemoteObject.exportObject方法被调用时，使所述Registry实例和指定port作为参数，不同的是Registry实例与公知的对象标识符，导出ObjID与值构建的实例ObjID.REGISTRY_ID 。

参数

port - 注册表接受请求的端口

结果

注册表

异常

RemoteException - 如果无法导出注册表

从以下版本开始：

JDK1.1

createRegistry

public static Registry createRegistry(int port,
                                      RMIClientSocketFactory csf,
                                      RMIServerSocketFactory ssf)
                               throws RemoteException

在本地主机上创建并导出Registry实例，该实例使用自定义套接字工厂进行与该实例的通信。 所创建的注册表监听给定传入请求port使用ServerSocket从所提供的创建RMIServerSocketFactory 。

导出Registry实例，就像调用静态UnicastRemoteObject.exportObject方法一样，传递Registry实例，指定的port ，指定的RMIClientSocketFactory和指定的RMIServerSocketFactory作为参数，不同之处在于使用公知的对象标识符导出Registry实例， ObjID实例构造的值为ObjID.REGISTRY_ID 。

参数

port - 注册表接受请求的端口

csf - 客户端 Socket工厂用于连接注册表

ssf - 服务器端 ServerSocket工厂用于接受注册表的连接

结果

注册表

异常

RemoteException - 如果无法导出注册表

从以下版本开始：

1.2