WSDL2Client 工具參照

WSDL2Client 工具會從 Web 服務的 WSDL 文件產生用戶端。  

語法

在您設定好指令行之後,您可以利用下列語法和引數來執行工具:

如果要建立 Skeleton 用戶端實作:
  • <WSDL URI> 必須是最終引數。
  • 為了成功執行 -createEar 引數,您必須在建立 Skeleton Web 服務用戶端實作時,指定 -clientType 引數。
如果要建立用戶端保存檔,請執行下列動作:

引數

如果要建立 Skeleton 用戶端實作,請執行下列動作:

強制引數:

-project <ProjectName>
指定輸出目標專案目錄的完整路徑名稱。如果這個目錄不存在,WSDL2Client 會建立它。預設值是現行目錄。
<WSDL-URI>
將 WSDL 文件的位置指定為 URI。這個 URI 可以在遠端,也可以在本端檔案系統中。如果您的 WSDL 跨越多份 WSDL 文件,您必須在匯入鏈的頂端指定文件,通常是實作 WSDL。

選用引數:

-NSToPkg <mappings>
指定 namespace=package 對映清單。
-fileNSToPkg <mappings file>
指定含有 namespace=package 對映之內容檔的路徑。請注意,這個檔案的名稱空間中的冒號 (':') 必須用反斜線來跳離。 比方說,http\://my.namespace。WSDL2Client 會忽略任何不含跳離冒號的名稱空間參照。
-all
產生 WSDL 文件中定義的所有複式類型的 Java™ 類別。預設值是只產生 WSDL 文件所定義和參照的類別。
-genResolver
產生匯入解析器,其中含有匯入的 xsd(xml 綱目)檔中的所有資訊。請參閱 Note 1 來取得這個參數的其他資訊。
-wsSecDir <directory>
指定範本所在之目錄的完整路徑,以便利用這個範本來搭配 WS 安全資訊配置 EJB2WebService 產生的部署描述子。 目錄必須含有 ibm-webservices-bnd.xmi 和 ibm-webservices-ext.xmi 檔。如果您產生用戶端連結,目錄也必須含有 ibm-webservicesclient-bnd.xmi 和 ibm-webservicesclient-ext.xmi 檔。
-clientType <J2SE | Application | Servlet | EJB>
產生指定的用戶端類型的 Skeleton 實作類別。您只能結合 -genMain 引數來使用這個引數。
-genMain <name of main class>
指定要產生之 main 類別的名稱。您只能結合 -clientType 引數來使用這個引數。
-user
指定用來存取 WSDL URI 的使用者名稱。
-password
指定用來存取 WSDL URI 的密碼。
-verbose
在執行工具時,顯示額外資訊。
-help
顯示說明資訊。

如果要建立用戶端保存檔,請執行下列動作:

強制引數:
-createEar<name of target ear file>
指定要建立的 EAR 檔的完整路徑名稱。如果它已經存在,在新檔案改寫它之前,會用 .ear~ 副檔名來備份它。
-clientType <application | servlet | EJB>
指定要實作的用戶端類型。
-ri
指定用戶端遠端介面的名稱。這必須是完整套件名稱。如果您指定 -clientType EJB,這個引數就是強制的。這個引數對所有其他類型都無效。
-main
指定用戶端 main 類別的名稱。這必須是完整套件名稱。如果您指定 -clientType <Application | Servlet>,這個引數就是強制的。這個引數對所有其他類型都無效。
<ProjectDir>
WSDL2Client 的第 1 階段所建立之專案目錄的路徑名稱,或某個其他工具,如 Bean2WebService。這個目錄必須包括含用戶端編譯實作的用戶端目錄。
選用引數:
-verbose
在執行工具時,顯示額外資訊。
-help
顯示說明資訊。
附註 1:請只選取 -genResolver 引數,以便 Web 服務執行時產生一個遠端絕對參照本端,它不必連接網際網路。 它不應該用於本端或相對匯入項目。另外,對於含有可匯入 XSD 檔案之 WSDL 匯入項目的檔案,不應該使用 -genResolver 選項。 例如,可以替代綱目元素外保有 WSDL 匯入項目:
  <import location="a.xsd" namespace="http://namespaceA"/>
  <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema" 
      targetNamespace="http://namespaceA" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema">
換成在綱目元素內有綱目匯入項目:
  <types>
    <schema xmlns="http://www.w3.org/2001/XMLSchema" 
      targetNamespace="http://namespaceA" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <import schemaLocation="a.xsd" namespace="http://namespaceA"/>
使用條款 | 讀者意見
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.