執行 IBM Thin Client for Enterprise JavaBeans (EJB)

EJB 用戶端是透過網際網路交互 ORB 通訊協定的遠端方法呼叫 (RMI-IIOP) Java™ Platform Standard Edition (Java SE) 應用程式，可透過「Java 命名和目錄介面 (JNDI)」查閱從伺服器存取遠端 Enterprise Java Bean。 IBM® Thin Client for EJB 提供較小的覆蓋區，易於部署至 Java SE 環境及 Eclipse Rich Client Platform (RCP) 環境。 您可以使用 WebSphere® Application Server 安裝或 Application Client for WebSphere Application Server 安裝與您的應用程式組合 IBM Thin Client for EJB 程式庫。 IBM Thin Client for EJB 也會延伸 Java SE 執行時期的選擇。 它可以在隨附於 WebSphere Application Server 產品的 Java 執行時期環境 (JRE)、從 Oracle 網站下載的 JRE ，或從 HP 網站下載的 JRE 中執行。

開始之前

如果 IBM Thin Client for EJB 在非IBM 產品平台上使用非IBM 產品 JRE 執行，則需要 IBM ORB 實作程式庫。 例如，在 Windows 上執行 IBM Thin Client for EJB with Sun Microsystems JRE™、 Linux®或 Solaris ，以及在 HP-UX上執行 HP JRE。 IBM提供的 Solaris 混合式和 HP 混合式 JRE 不視為非IBM 產品 JRE 環境。

IBM Thin Client for EJB 可以使用 JNDI 查閱來存取 WebSphere Application Server 上的 2.x 版和 3.x 版 EJB ，但它無法存取 3.x EJB 透過資源注入。 如果用戶端應用程式是在 Java Platform, Enterprise Edition (Java EE) 應用程式用戶端儲存器內執行的 Java Platform, Enterprise Edition (Java EE) 應用程式用戶端，則支援資源注入。

在設定 EJB Thin Client 環境之前，請先取得 EJB Thin Client for WebSphere Application Server的 Java 保存檔 (JAR)。 如果要取得 EJB Thin Client for WebSphere Application Server，請安裝 WebSphere Application Server 或應用程式用戶端。 EJB Thin Client for WebSphere Application Server 檔 com.ibm.ws.ejb.thinclient_9.0.jarcom.ibm.ws.ejb.thinclient.zos_9.0.jar位於 app_server_root\runtimes 目錄中。 Use the com.ibm.ws.ejb.thinclient.zos_9.0.jar 適用於在 z/OS上執行的任何用戶端。 對於在分散式平台上執行的任何用戶端，請使用 com.ibm.ws.ejb.thinclient.jar 。 決定要使用的用戶端取決於用戶端平台，而不是您所連接伺服器的平台。

將 IBM Thin Client for EJB with WebSphere Application Server 產品 com.ibm.ws.ejb.thinclient_9.0.jarcom.ibm.ws.ejb.thinclient.zos_9.0.jar 及 endorsed_apis_9.0.jar 檔案的 Java 保存檔 (JAR) 複製到其他機器，以建立輕量型用戶端環境來與產品進行通訊。 IBM Thin Client for EJB 副本受您取得 Thin Client for EJB 之 WebSphere 產品授權合約的相同條款所規範。 如需正確使用及其他限制，請參閱授權合約。

將 app_server_root\runtimes\endorsed\endorsed_apis_9.0.jar 檔案複製到預設目錄 JAVA_JRE\lib\endorsed。 或者，您可以使用 java.endorsed.dirs 內容來指定您選擇的目錄。 如果您選擇使用替代目錄，則最佳作法是只包含 endorsed_apis JAR 檔。

IBM Thin Client for EJB with WebSphere Application Server 在具有 JDK 支援的分散式作業系統上執行。 當 IBM Thin Client for EJB 作為獨立式 Java SE 應用程式與非IBM 產品 JRE 搭配使用時，您必須透過下列其中一種方法來置換 JRE 的預設 ORB 實作:

• 在 Java 系統類別路徑中包含 com.ibm.ws.orb_9.0.jar 檔。
• 使用 Java Endorsed Standards Override Mechanism ，置換 JRE 中的預設 ORB 實作。
• 將 java.endorsed.dirs 路徑設為包含 com.ibm.ws.orb_9.0.jar 檔的目錄。

當執行 IBM Thin Client for EJB 作為 Eclipse RCP 應用程式時，建議使用方法 2 來置換預設 JRE ORB 實作。

注意: 執行 IBM Thin Client for EJB 並使用 -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager 指令行選項時，會擲出 ClassDefNotFound錯誤。 IBM Thin Client for EJB 不支援使用 WsLog管理程式，但您可以使用另一個 Java 記載管理程式。

1. 呼叫用戶端應用程式。
   執行下列 Java 指令:

   

   <java_install_root>\bin\java  
   -classpath com.ibm.ws.ejb.thinclient_9.0.jar;<list_of_your_application_jars_and_classes> 
   -Djava.naming.provider.url=iiop://<your_application_server_machine_name>
   <fully_qualified_class_name_to_run>

   如果您想要啟用鑑別和 SSL ，請將下列系統內容新增至 Java 指令:

   <java_install_root>/bin/java  
   -classpath com.ibm.ws.ejb.thinclient_9.0.jar:<list_of_your_application_jars_and_classes> 
   -Djava.naming.provider.url=iiop://<your_application_server_machine_name> 
   -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
   -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
   <fully_qualified_class_name_to_run>

   

   export LIBPATH=<app_server_root>/lib:$LIBPATH
   <java_install_root>/bin/java  
   -classpath com.ibm.ws.ejb.thinclient.zos_9.0.jar:<list_of_your_application_jars_and_classes> 
   -Djava.naming.provider.url=iiop://<your_application_server_machine_name> 
   -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
   -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
   <fully_qualified_class_name_to_run>

2. 提供 IIOP 鑑別配置和用戶端 SSL 配置。
   將下列系統內容新增至 Java 指令:

   -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
   -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props

   您可以從 WebSphere Application Server 安裝架構取得 ssl.client.props 檔和 sas.client.props 檔，並修改檔案以符合您的環境。 您至少必須將 ssl.client.props 檔案中金鑰檔的位置更新為目標環境的相符位置。 例如，

   -Dcom.ibm.ssl.keyStore=/home/user1/etc/key.p12 
   -Dcom.ibm.ssl.trustStore=/home/user1/etc/trust.p12

   使用非IBM 產品 JRE 執行應用程式時建議的 SSL 配置設定:

   com.ibm.ssl.protocol=SSL
   com.ibm.ssl.trustManager=SunX509
   com.ibm.ssl.keyManager=SunX509
   com.ibm.ssl.contextProvider=SunJSSE
   
   com.ibm.ssl.keyStoreType=JKS
   com.ibm.ssl.keyStoreProvider=SUN
   com.ibm.ssl.keyStore=/home/user1/etc/key.jks
   
   com.ibm.ssl.trustStoreType=JKS
   com.ibm.ssl.trustStoreProvider=SUN
   com.ibm.ssl.trustStore=/home/user1/etc/trust.jks

   在應用程式執行之前，必須使用 Java keytool 公用程式來建立金鑰儲存庫檔和信任儲存庫檔。 非IBM 產品 JRE 不支援自動產生金鑰檔。

   您必須以 com.ibm.ws.orb_9.0.jar 檔置換非IBM 產品 JRE 的預設 ORB 實作，或將它新增至類別路徑。

3. 執行用戶端應用程式:
   • 如果您已將 endorsed_apis_9.0.jar 檔案複製到 JAVA_JRE\lib\endorsed 預設目錄，請輸入下列指令; 例如:
     

     %JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>

     

     $JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>

   • 如果您已將 endorsed_apis_9.0.jar 檔案複製到預設 JAVA_JRE\lib\endorsed 目錄以外的目錄，請輸入下列指令; 例如:
     

     %JAVA_HOME%\bin\java 
     -Djava.endorsed.dirs=<directory_that_includes_endorsed_apis_9.0.jar> 
     -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>

     

     $JAVA_HOME/bin/java 
     -Djava.endorsed.dirs=<directory_that_includes_endorsed_apis_9.0.jar>
     -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>