Cabin實體和 TravelAgent EJB已經部署完畢，我們打算從遠程客戶端對其進行訪問。本節中，我們會創建一個遠程客戶端，連向EJB服務器，為TravelAgent EJB定位EJB遠程接口，並與TravelAgent EJB進行交互，以創建Cabin實體並將其從數據庫中取出。下列代碼展示了一個Java應用程序，該程序新建了一個Cabin實體，設置其name、 deckLevel、shipId和bedCount成員屬性，然後再用主鍵對其進行定位。
package com.titan.clients;
import com.titan.travelagent.TravelAgentRemote;
import com.titan.domain.Cabin;
import javax.naming.InitialContext;
import javax.naming.Context;
import javax.naming.NamingException;
import java.util.Properties;
import javax.rmi.PortableRemoteObject;
public class Client {
public static void main(String [] args) {
try {
Context jndiContext = getInitialContext( );
Object ref = jndiContext.lookup("TravelAgentBean/remote");
TravelAgentRemote dao = (TravelAgentRemote)
PortableRemoteObject.narrow(ref,TravelAgentRemote.class);
Cabin cabin_1 = new Cabin( );
cabin_1.setId(1);
cabin_1.setName("Master Suite");
cabin_1.setDeckLevel(1);
cabin_1.setShipId(1);
cabin_1.setBedCount(3);
dao.createCabin(cabin_1);
Cabin cabin_2 = dao.findCabin(1);
System.out.println(cabin_2.getName( ));
System.out.println(cabin_2.getDeckLevel( ));
System.out.println(cabin_2.getShipId( ));
System.out.println(cabin_2.getBedCount( ));
} catch (javax.naming.NamingException ne){ne.printStackTrace( );}
}
public static Context getInitialContext( )
throws javax.naming.NamingException {
Properties p = new Properties( );
// ... 指定廠商專有的JNDI屬性
return new javax.naming.InitialContext(p);
}
}
為了訪問enterprise bean，客戶端首先使用JNDI獲得一個連向bean所在容器的目錄。JNDI是一組獨立於實現的API，用於目錄和命名系統。每家EJB廠商都必須提供一個與JNDI兼容的目錄服務。這意味著他們必須給出一個JNDI service provider(JNDI服務提供程序)，即一段類似JDBC驅動的軟件代碼。不同的service provider與不同的目錄服務相連接，就如同JDBC一樣，不同的驅動程序與不同的關系數據庫相連接。getInitialContext()方法使用JNDI來獲得一個指向EJB服務器的網絡連接。
用於獲取JNDI上下文的代碼和你使用哪一家EJB廠商的產品有關。如何獲取與你所用的產品相配的JNDI上下文，請參考廠商文檔。例如，在WebSphere中用於獲取JNDI上下文的代碼可能類似如下。
public static Context getInitialContext( )
throws javax.naming.NamingException {
java.util.Properties properties = new java.util.Properties( );
properties.put(javax.naming.Context.PROVIDER_URL, "iiop:///");
properties.put(javax.naming.Context.INITIAL_CONTEXT_FACTORY,
"com.ibm.ejs.ns.jndi.CNInitialContextFactory");
return new InitialContext(properties);
}
而針對JBoss編寫的同一方法會有所不同。
public static Context getInitialContext( )
throws javax.naming.NamingException {
Properties p = new Properties( );
p.put(Context.INITIAL_CONTEXT_FACTORY,
"org.jnp.interfaces.NamingContextFactory");
p.put(Context.URL_PKG_PREFIXES,
" org.jboss.naming:org.jnp.interfaces");
p.put(Context.PROVIDER_URL, "jnp://localhost:1099");
return new javax.naming.InitialContext(p);
}
一旦建立起JNDI連接，並且通過getInitialContext()方法獲得了上下文，我們就可以利用上下文來查找TravelAgent EJB的遠程接口了。
Object ref = jndiContext.lookup("TravelAgentBean/remote");
在本書中，我們將始終為遠程客戶端應用程序使用形如“TravelAgentBean/remote”這樣的查找名稱。你所用的實際查找名稱或許有所不同，這依賴於廠商的要求。你需要把查找名稱綁定到EJB服務器的命名服務上，而有些廠商可能會要求一個特殊的目錄路徑，或者提供一個默認的綁定。
如果使用標准的Java EE組件(Servlet、JSP、EJB或Java EE應用客戶端)，無論你使用哪家EJB廠商的產品，在創建JNDI InitialContext時都不需要顯式的設置屬性。這是因為JNDI屬性可以在部署期間配置並被自動應用。一個Java EE組件會以如下方式獲得其InitialContext。
public static Context getInitialContext( )
throws javax.naming.NamingException {
return new javax.naming.InitialContext( );
}
相比於為簡單Java客戶端手工配置JNDI屬性，這種方式更為簡單，也更易於移植。所有的Java EE組件都使用相同的JNDI命名系統，enterprise bean以此來查找任何服務。特別要指明的是，這些組件要求指向EJB的引用要與“java:comp/env/ejb/”名字空間綁定。例如，對於像 servlet這樣一個不同的Java EE組件而言，為了查找TravelAgent EJB，下面是我們所要做的全部工作。
Object ref = jndiContext.lookup("java:comp/env/ejb/TravelAgentRemote");
在部署期間，你要使用廠商的部署工具將JNDI名稱映射到TravelAgent EJB的遠程接口。在後續章節裡，我們會看到使用特殊的注解可以將指向EJB的引用直接注入到bean class中。我們已經看到過這種方式的一個例子，即：將EntityManager服務注入到Travel- AgentBean類裡。在本書中，Java客戶端應用程序需要使用顯式的參數來進行JNDI查找。作為替代方案，你也可以使用一種特殊的Java EE組件，叫做Java EE應用客戶端(Java EE Application Client)，但是這類組件超出了本書的討論范圍。有關Java EE應用客戶端組件的更多信息可以參考Java EE 5的規范。
客戶端應用程序使用PortableRemoteObject.narrow()方法將Object ref窄化(narrow)成一個TravelAgentRemote引用。
Object ref = jndiContext.lookup("TravelAgentRemote");
CabinHomeRemote home = (TravelAgentRemote)
PortableRemoteObject.narrow(ref,TravelAgentRemote.class);
PortableRemoteObject.narrow()方法在EJB 1.1中被首次引入，並繼續沿用於EJB 3.0的遠程客戶端。這需要支持基於IIOP之上的RMI。由於CORBA要支持許多不同的語言，而轉型並非CORBA的固有功能(一些語言沒有轉型概念)。因此，為了獲得一個指向TravelAgentRemote的遠程引用，我們必須顯示地對從lookup()返回的對象進行窄化。
用於查找TravelAgent EJB遠程接口的名稱，可以是特定於廠商的默認值，特定於廠商的注解，或部署描述文件。或者，如果EJB產品中帶有部署向導，還可以由部署人員使用向導來設置。JNDI的名稱完全取決於部署bean的人;可以與在XML部署描述文件中設定的bean名字相同，也可以截然不同。
