java.rmi.registry
類別 LocateRegistry

java.lang.Object
  java.rmi.registry.LocateRegistry

public final class LocateRegistry
extends Object

LocateRegistry 用於獲得對特定主機（包括本地主機）上引導遠端物件註冊表的參考，或用於創建一個接受對特定埠號調用的遠端物件註冊表。

注意，getRegistry 調用並不實際產生到遠端主機的連接。它只創建對遠端註冊表的本地參考，即便遠端主機上沒有正運行的註冊表，它也會成功創建一個參考。因此，調用作為此方法的結果返回的遠端註冊表的後續方法可能會失敗。

從以下版本開始：

JDK1.1

另請參見：

Registry

方法摘要

static Registry	createRegistry(int port) 創建並導出接受指定 port 請求的本地主機上的 Registry 實例。
static Registry	createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 在本地主機上創建並導出 Registry 實例，該本地主機使用的是與該實例通信的自定義Socket處理器。
static Registry	getRegistry() 返回本地主機在預設註冊表埠號 1099 上對遠端物件 Registry 的參考。
static Registry	getRegistry(int port) 返回本地主機在指定 port 上對遠端物件 Registry 的參考。
static Registry	getRegistry(String host) 返回指定 host 在預設註冊表埠號 1099 上對遠端物件 Registry 的參考。
static Registry	getRegistry(String host, int port) 返回指定的 host 和 port 上對遠端物件 Registry 的參考。
static Registry	getRegistry(String host, int port, RMIClientSocketFactory csf) 返回本地創建的指定 host 和 port 上對遠端物件 Registry 的遠端參考。

從類別 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 - 註冊表在其上接受請求的埠號

返回：

對遠端物件註冊表的參考（一個 stub）

拋出：

RemoteException - 如果無法創建該參考

從以下版本開始：

JDK1.1

getRegistry

public static Registry getRegistry(String host)
                            throws RemoteException

返回指定 host 在預設註冊表埠號 1099 上對遠端物件 Registry 的參考。如果 host 為 null，則使用本地主機。

參數：

host - 用於遠端註冊表的主機

返回：

對遠端物件註冊表的參考（一個 stub）

拋出：

RemoteException - 如果無法創建該參考

從以下版本開始：

JDK1.1

getRegistry

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

返回指定的 host 和 port 上對遠端物件 Registry 的參考。如果 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 來創建到遠端 host 和 port 上註冊表的 Socket 連接。

參數：

host - 用於遠端註冊表的主機

port - 註冊表在其上接受請求的埠號

csf - 用於產生到註冊表的連接的客戶端的 Socket 處理器。如果 csf 為 null，則預設客戶端的 Socket 處理器將用於註冊表 stub。

返回：

對遠端物件註冊表的參考（一個 stub）

拋出：

RemoteException - 如果無法創建該參考

從以下版本開始：

1.2

createRegistry

public static Registry createRegistry(int port)
                               throws RemoteException

創建並導出接受指定 port 請求的本地主機上的 Registry 實例。

導出 Registry 實例與調用靜態 UnicastRemoteObject.exportObject 方法一樣，都是將傳入 Registry 實例和指定的 port 作為參數，只不過導出的 Registry 實例具有已知物件的標識標符（用值 ObjID.REGISTRY_ID 建構的 ObjID 實例）。

參數：

port - 註冊表在其上接受請求的埠號

返回：

註冊表

拋出：

RemoteException - 如果無法導出註冊表

從以下版本開始：

JDK1.1

createRegistry

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

在本地主機上創建並導出 Registry 實例，該本地主機使用的是與該實例通信的自定義Socket處理器。創建的註冊表使用從提供的 RMIServerSocketFactory 創建的 ServerSocket 偵聽給定 port 上的傳入請求。

導出 Registry 實例與調用靜態 UnicastRemoteObject.exportObject 方法一樣，都是將傳入 Registry 實例、指定的 port、指定的 RMIClientSocketFactory 和指定的 RMIServerSocketFactory 作為參數，只不過 Registry 實例具有已知物件的標識符（用值 ObjID.REGISTRY_ID 建構的 ObjID 實例）。

參數：

port - 註冊表在其上接受請求的埠號

csf - 用於連接到註冊表的客戶端的 Socket 處理器

ssf - 用於產生到註冊表的連接的伺服器端的 ServerSocket 處理器

返回：

註冊表

拋出：

RemoteException - 如果無法導出註冊表

從以下版本開始：

1.2