利用 WSDL2Client 工具建立 Web 服務用戶端

WSDL2Client 工具會從一或多份 WSDL 文件,產生完全能夠部署的 Web 服務用戶端,並選用地將它們部署在應用程式伺服器中。

必備條件:

您可以分四個階段來使用這個工具:

  1. 設定 -project 引數來執行工具,以建立特定 WSDL 文件所說明之 Web 服務的 Skeleton 用戶端實作範本。
  2. 在範本中撰寫您的實作程式碼,並利用第 1 階段產生的建置 Script 來編譯它。
  3. 如果您指定了 -clientType J2SE 選項,且您指定您的 -genMain 選項,請利用第 1 階段產生的執行 Script 來執行您的用戶端。
  4. 如果您將 -clientType 選項指定為 Application、EJB 或 Servlet,請設定 -createEar 引數來重新執行工具,以從這項實作中建置啟用 Web 服務用戶端的保存檔,再將它部署在應用程式伺服器中。

指令行設定

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

  1. 從命令提示字元切換至 Rational® Developer 產品的 bin 目錄。
  2. 執行下列批次 Script:
    • Windows®setupenv.bat
    • Linux:. setupenv.sh
  3. 切換至要建立 Web 服務的目錄。我們將這個目錄稱為指令行測試目錄。 Linux:您必須有這個目錄的寫入存取權。

現在,您可以執行 WSDL2WebServiceClient 工具的第 1 階段。

建立 Skeleton Web 服務用戶端實作

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

如果要建立 Skeleton Web 服務用戶端實作,請在命令提示字元中輸入下列指令:

重要事項:
  • 最終引數必須是 <WSDL URI>,區分大小寫。請參閱 WSDL2Client 工具,以取得選用和強制引數的清單。
  • 如果您計劃依以下說明建立已啟用 Web 服務用戶端的保存檔,當您建立 Skeleton Web 服務用戶端實作時,您必須指定 -clientType 引數。

提示:請記下指令行測試目錄路徑和您指定給 -project 的名稱。您稍後部署和測試 Web 服務時,會需要這項資訊。

設定 -project <ProjectDir> 引數來執行這個工具之後,會在指定的專案下,建立含有若干子目錄的 "client-side" 目錄。這些子目錄含有所有必要的 Java 範本,其中包括複式類型的序列化和取消序列化類別,以及建置 Web 服務實作所需要的部署描述子。 如果您已指定您的 -clientType 和 -genMain 選項,您也發現已產生給用戶端類型的 main 類別實作範本。

另外,也會產生稱為 buildclient 的建置 Script 來協助您編譯這個程式碼。如果您已設定 -clientType J2SE 引數來執行這個工具,也會產生稱為 runclient 的執行 Script。

編譯實作程式碼

如果要編譯程式碼,請執行下列動作:
  1. 切換至 <ProjectDir> 目錄,再切換至 client-side 目錄。
  2. 如果您的實作程式碼相依於 .jar 檔或含有 .class 檔的目錄,請編輯編譯 Script,再將這些相依項的完整路徑名稱加入 USER_CLASSPATH 變數中。比方說:
    • Windows:set USER_CLASSPATH = c:\MyJars\webservice.jar;c:\MyClasses
    • Linux: USER_CLASSPATH = /home/MyJars/webservice.jar:/home/MyClasses
  3. 輸入下列指令:buildclient

執行 J2EE Web 服務用戶端

如果要執行 J2SE Web 服務用戶端,請執行下列動作:
  1. 切換至 <ProjectDir> 目錄,再切換至 client-side 目錄。
  2. 如果您的實作程式碼相依於 .jar 檔或含有 .class 檔的目錄,請編輯編譯 Script,再將這些相依項的完整路徑名稱加入 USER_CLASSPATH 變數中。比方說:
    • Windows:set USER_CLASSPATH = c:\MyJars\webservice.jar;c:\MyClasses
    • Linux: USER_CLASSPATH = /home/MyJars/webservice.jar:/home/MyClasses
  3. 輸入下列指令:runclient

建立啟用 Web 服務用戶端的保存檔

如果要建立啟用 Web 服務用戶端的保存檔,請執行下列動作:
  1. 切換至 <WSDK-install-dir>/bin 目錄。
  2. 輸入下列指令:WSDL2Client [<選用性引數>] -createEar <File.ear> -clientType <Application | EJB | Servlet> <ProjectDir>
重要事項:
  • 最後一個引數必須是 <ProjectDir>,而且必須含有 "client-side" 目錄。
  • 當您依本作業中前面的描述建立 Skeleton Web 服務用戶端實作時,您必須指定 -clientType 引數,才能夠成功執行 -createEar 引數。

寫好、編譯好實作程式碼,且設定 -createEar <File.ear> 引數來重新執行工具之後,輸出就是新的或更新的 EAR 檔。您也會發現,實作 Web 服務的用戶端類別已移至 META-INF\classes 目錄中,這是它的正常位置。如果您指定了 -clientType Servlet,您會發現用戶端類別已移至 WEB-INF\classes 目錄。

使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.