注冊服務(wù)程序接口
---------------------------------------------------------------------
----------
第 6 章
RMI 系統使用 java.rmi.registry.Registry 接口和 java.rmi.registry.Locat
eRegistry 類(lèi)來(lái)為按名字檢索和注冊對象提供眾所周知的自舉服務(wù)。
registry 是一種將名字映射到遠程對象的遠程對象。所有的服務(wù)器進(jìn)程都支持自
己的注冊服務(wù)程序或能為主機所用的單個(gè)注冊服務(wù)程序。
LocateRegistry 方法用于使注冊服務(wù)程序在特定的主機中或主機與端口中運行起
來(lái)。java.rmi.Naming 類(lèi)方法用于調用一個(gè)遠程對象，該對象使用恰當的 Locat
eRegistry.getRegistry 方法來(lái)實(shí)現 Registry 接口。
主題：
Registry 接口
LocateRegistry 類(lèi)
RegistryHandler 接口
6.1 Registry 接口
java.rmi.registry.Registry 遠程接口可為查詢(xún)、綁定、再綁定、取消綁定和列
出注冊服務(wù)程序內容提供方法。java.rmi.Naming 類(lèi)用 registry 遠程接口提供
基于 URL 的命名。
package java.rmi.registry;
public interface Registry extends java.rmi.Remote {
public static final int REGISTRY_PORT = 1099;
public java.rmi.Remote lookup(String name)
throws java.rmi.RemoteException,
java.rmi.NotBoundException, java.rmi.AccessException;
public void bind(String name, java.rmi.Remote obj)
throws java.rmi.RemoteException,
java.rmi.AlreadyBoundException, java.rmi.AccessException;
public void rebind(String name, java.rmi.Remote obj)
throws java.rmi.RemoteException, java.rmi.AccessException;
public void unbind(String name)
throws java.rmi.RemoteException,
java.rmi.NotBoundException, java.rmi.AccessException;
public String[] list()
throws java.rmi.RemoteException, java.rmi.AccessException;
}
REGISTRY_PORT 是注冊服務(wù)程序的缺省端口。
lookup 方法返回綁定到指定 name 的遠程對象，而遠程對象則實(shí)現一組遠程接口
?？蛻?hù)機可將遠程對象強制轉換為所期望的遠程接口類(lèi)型（該強制類(lèi)型轉換可能
以它在 Java 語(yǔ)言中的常見(jiàn)失敗方式而失?。?。
bind 方法將 name 與遠程對象 obj 相關(guān)聯(lián)。如果名字已綁定到某一對象上，則
拋出 AlreadyBoundExcepton。
rebind 方法將 name 與遠程對象 obj 相關(guān)聯(lián)。該名字以前的所有綁定均將被丟
棄。
unbind 方法刪除 name 和遠程對象 obj 之間的綁定。如果名字并未綁定到某一
對象上，則拋出 NotBoundException。
list 方法返回一個(gè) Strings 數組，其中包含注冊服務(wù)程序中所綁名字的快照。
該返回值含有注冊服務(wù)程序內容的快照。
客戶(hù)機可以使用 LocateRegistry 和 Registry 接口或基于 URL 的 java.rmi.N
aming 類(lèi)的方法來(lái)訪(fǎng)問(wèn)注冊服務(wù)程序。該注冊服務(wù)程序僅支持與服務(wù)器位于同一
主機的客戶(hù)機的 bind、unbind 和 rebind。所有主機均可進(jìn)行查詢(xún)操作。
.2 LocateRegistry 類(lèi)
java.rmi.registry.LocateRegistry 類(lèi)用來(lái)獲得對特定主機（包括本地主機）的
引導遠程對象注冊服務(wù)程序的引用（創(chuàng )建 stub），或者創(chuàng )建能在特定端口接受調
用的遠程對象注冊服務(wù)程序。
注冊服務(wù)程序實(shí)現將遠程對象名（字符串）與遠程對象引用相關(guān)聯(lián)的簡(jiǎn)單命名語(yǔ)
法。服務(wù)器重新啟動(dòng)不會(huì )記住這些名字和遠程對象之間的綁定。
注意，getRegistry 調用并不真正與遠程主機連接。它只簡(jiǎn)單地建立了對遠程注
冊服務(wù)程序的本地引用，且即使遠程主機中沒(méi)有注冊服務(wù)程序運行也將獲得成功
。因此，對于該方法作為返回值返回的遠程注冊服務(wù)程序進(jìn)行進(jìn)一步的方法調用
時(shí)，可能會(huì )導致失敗。
package java.rmi.registry;
public final class LocateRegistry
{
public static Registry getRegistry()
throws java.rmi.RemoteException;
public static Registry getRegistry(int port)
throws java.rmi.RemoteException;
public static Registry getRegistry(String host)
throws java.rmi.RemoteException;
public static Registry getRegistry(String host, int port)
throws java.rmi.RemoteException;
public static Registry getRegistry(String host, int port,
RMIClientSocketFactory csf)
throws RemoteException;
public static Registry createRegistry(int port)
throws java.rmi.RemoteException;
public static Registry createRegistry(int port,
RMIClientSocketFactory csf,
RMIServerSocketFactory ssf)
throws RemoteException;
}
前四個(gè) getRegistry 方法返回對當前主機、指定 port 的當前主機、指定的 ho
st 或指定 host 的特定 port 的注冊服務(wù)程序引用。所返回的是帶有指定主機和
端口信息的注冊服務(wù)程序的遠程 stub。
第五個(gè) getRegistry 方法（將 RMIClientSocketFactory 作為參數）返回本地創(chuàng )
建的遠程 stub，它對應于指定 host 和 port 上的遠程對象 Registry。與用該
方法構造 stub 的遠程注冊服務(wù)程序進(jìn)行通信時(shí)，將使用所提供的 RMIClientSo
cketFactory、csf 來(lái)創(chuàng )建到遠程主機和端口的注冊服務(wù)程序的 Socket 連接。
----------------------------------------------------------------------
----------
注意 - 從 getRegistry 方法返回的注冊服務(wù)程序是含有已知對象標識符的專(zhuān)門(mén)
構造的 stub。目前仍不支持將注冊服務(wù)程序 stub 從一個(gè)虛擬機傳給另一個(gè)虛擬
機（其有效性將取決于實(shí)現）。使用 LocateRegistry.getRegistry 方法可以獲
得主機的相應注冊服務(wù)程序。
----------------------------------------------------------------------
----------
createRegistry 方法創(chuàng )建和導出特定 port 的本地主機的注冊服務(wù)程序。
第二種 createRegistry 方法在與注冊服務(wù)程序通信時(shí)更富有靈活性。該調用將
在本地主機中創(chuàng )建和導出 Registry，本地主機使用自定義套接字工廠(chǎng)用于與注冊
服務(wù)程序的通信。所創(chuàng )建的注冊服務(wù)程序在給定的 port 上使用從 RMIServerSo
cketFactory 所創(chuàng )建的 ServerSocket 監聽(tīng)到來(lái)請求。接收到注冊服務(wù)程序引用
的客戶(hù)機將使用從 RMIClientSocketFactory 所創(chuàng )建的 Socket。
----------------------------------------------------------------------
----------
注意 - 使用 createRegistry 方法啟動(dòng)注冊服務(wù)程序不能保持服務(wù)器進(jìn)程的活動(dòng)
性。
6.3 RegistryHandler 接口
----------------------------------------------------------------------
----------
注意 - JDK1.2 中不鼓勵使用 RegistryHandler 接口。JDK1.1 中，它僅由 RMI
實(shí)現在內部使用，而不能用于應用程序。
----------------------------------------------------------------------
----------
package java.rmi.registry;
public interface RegistryHandler
{
Registry registryStub(String host, int port)
throws java.rmi.RemoteException, java.rmi.UnknownHostException;
Registry registryImpl(int port) throws java.rmi.RemoteException;
}
方法 registryStub 返回一個(gè)與位于指定主機和端口的遠程注冊服務(wù)程序進(jìn)行聯(lián)
系的 stub。
方法 registryImpl 將構造并導出位于指定的端口的注冊服務(wù)程序。端口必須為
非零。
