模块  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的引用。
        结果
        引用(存根)到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始:
        1.1
      • getRegistry

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

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

        public static Registry getRegistry​(String host,
                                           int port)
                                    throws RemoteException
        返回对指定的hostport上的远程对象Registryport 如果hostnull ,则使用本地主机。
        参数
        host - 远程注册表的主机
        port - 注册表接受请求的端口
        结果
        引用(存根)到远程对象注册表
        异常
        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为null,则将在注册表存根中使用默认客户端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