Module  java.rmi
软件包  java.rmi.registry

Class LocateRegistry


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

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

    从以下版本开始：
    1.1
    另请参见：
    Registry

    • 方法详细信息

      • getRegistry

        public static Registry getRegistry​()
                            throws RemoteException
        返回对默认注册表端口1099的本地主机的远程对象 Registry的引用。
        结果
        引用（stub）到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始：
        1.1

      • getRegistry

        public static Registry getRegistry​(int port)
                            throws RemoteException
        在指定的 port上返回对本地主机的远程对象 Registry的引用。
        参数
        port - 注册表接受请求的端口
        结果
        引用（stub）到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始：
        1.1

      • getRegistry

        public static Registry getRegistry​(String host)
                            throws RemoteException
        返回对默认注册表端口1099上指定的 host上的远程对象 Registry的引用。如果 host为 null ，则使用本地主机。
        参数
        host - 远程注册表的主机
        结果
        引用（stub）到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始：
        1.1

      • getRegistry

        public static Registry getRegistry​(String host,
                                   int port)
                            throws RemoteException
        在指定的host和port上返回对远程对象Registry的port 。 如果host是null ，则使用本地主机。
        参数
        host - 远程注册表的主机
        port - 注册表接受请求的端口
        结果
        引用（stub）到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始：
        1.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请求。

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

        参数
        port - 注册表接受请求的端口
        结果
        注册表
        异常
        RemoteException - 如果注册表无法导出
        从以下版本开始：
        1.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