利用 EJB2WebService 工具建立 Web 服務

您可以利用 EJB2WebService 工具,在指令行透過 IBM® WebSphere® 執行時期環境,從 EJB Bean 產生 Web 服務。附註:EJB2WebService13 指令支援 EJB 2.0 版和 J2EE 1.3,而 EJB2WebService 指令則支援 EJB 2.1 和 J2EE 1.4。

指令行設定

在使用 EJB2WebService 工具之前,您必須先依照下列方式來設定 Web 服務指令行:

  1. 從命令提示字元切換至 Rational® Developer 產品的 bin 目錄。
  2. 執行下列批次 Script:
    • Windows®

      setupenv.bat

    • Linux:

      . setupenv.sh  

  3. 切換至要建立 Web 服務的目錄。我們將這個目錄稱為指令行測試目錄。 Linux:您必須有這個目錄的寫入存取權。

現在,您可以利用 EJB2WebService 工具以及匯出的 EAR 檔案來建立 Web 服務。

建立 Web 服務

附註:EJB2WebService 工具有兩個版本。如果您執行 EJB2WebService 指令, 該指令會使用 J2EE 1.4。另外,您可以使用 EJB2WebService13 指令,該指令會使用 J2EE 1.3。針對以下任一指令,如果您要建立使用 J2EE 1.3 的 Web 服務,您可以將 EJB2WebService 換成 EJB2WebService13

如果要利用 EJB2WebService 工具來建立 Web 服務,請在命令提示字元中輸入下列指令:

附註:<EJB.ear> 必須是最終引數。請參閱 EJB2WebService 工具,以取得選用和強制性引數的清單。

提示:
  • 建議您指定選用引數:-host <hostname:port>。 該指令的預設埠為 6080,但是 WebSphere Application Server 的預設埠為 9080。
  • 記下您指定給 -project 的指令行測試目錄路徑和名稱。當您部署及測試 Web 服務時,會需要這項資訊。

範例

這是如何使用 EJB2WebService 工具的範例:

EJB2WebService -host localhost:9080 -ri MyEJB.remoteInterface -project MyEJBProject MyEJB.ear

EJB2WebService 工具的主要輸出是位於產生之目錄結構的根目錄中,名為 <ProjectName>EAR.ear 的原始 EAR 檔的修改版本。META-INF 目錄也產生在 <ProjectName> 之下。 這個目錄存有產生的 WSDL 檔、Java™ 類別等等。如果您沒有指定 -server-side-only 引數,就會同時建立含有某些額外 Java 檔(其中包括您的複式類型的序列化常式和解除序列化常式類別)的用戶端目錄。

產生 EAR 檔之後,您就可以將它部署在伺服器中,供他人使用。

重要事項:如果您選擇使用 -splitWsdl 引數, 將產生 EAR 檔,但是當它匯入到工作區並部署到 Unit Test Environment 或遠端伺服器後,在伺服器啟動時將出現異常狀況。這個異常狀況是路由器 Web 專案中遺漏 WSDL 所導致的。請執行下列任一項來排除這個錯誤:
  • 利用管理主控台來部署到獨立式 WebSphere Application Server。
  • 使用整體 WSDL - 也就是說,不要使用 -splitWsdl 引數。
  • 將 EJB 專案中 META-INF/wsdl 目錄下的所有 WSDL 檔案手動複製到路由器 Web 專案的 WEB-INF/wsdl
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.