模块  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的引用。如果 host是 null ，则使用本地主机。
        参数
        host - 远程注册表的主机
        结果
        引用（存根）到远程对象注册表
        异常
        RemoteException - 如果无法创建引用
        从以下版本开始：
        1.1

      • getRegistry

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