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的引用。如果 hostnull ,则使用本地主机。
        参数
        host - 远程注册表的主机
        结果
        引用(stub)到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始:
        1.1
      • getRegistry

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

        public static Registry getRegistry​(String host,
                                           int port,
                                           RMIClientSocketFactory csf)
                                    throws RemoteException
        返回本地创建的对指定的hostport的远程对象Registry远程引用。 与此远程注册表的通信将使用随附的RMIClientSocketFactory csf创建Socket连接到远程hostport的注册表。
        参数
        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