您可以利用 Bean2WebService 工具,在指令行透過
IBM® WebSphere® 執行時期環境,從 Java™ Bean 產生 Web 服務。
語法
在您設定好指令行之後,您可以利用下列語法和引數來執行工具:
- Windows®: Bean2WebService
[<選用性引數>] -cp <Classpath> -project <ProjectName> <BeanName>
- Linux: Bean2WebService.sh [<選用性引數>] -cp
<Classpath> -project <ProjectName> <BeanName>
註: <BeanName> 必須是最終 (final) 引數。
引數
強制引數:
- -project <ProjectName>
- 指定專案名稱。這用來在現行工作目錄中,建立一個儲存所有產生的檔案的目錄。如果專案名稱已經存在,就會建立現有 EAR 檔的備份版本。比方說,如果您有一個名稱為 MyWebService 的專案,就會將 MyWebService.ear 檔更名為 MyWebService.ear.backup。
- -cp <ClassPath>
- 指定含有 Java Bean 和執行它所需要的所有相依項的 JAR 檔和目錄清單(以特定平台專用路徑定界字元來分開各項目)。
- <BeanName>
- 指定顯現為 Web 服務的編譯 Java 類別的完整套件名稱。
編譯 Java 類別,同時使用
- -g 選項,以便產生之 WSDL 檔案中的組件名稱屬性,含有各方法的正確參數名稱。
選用引數:
- -methods <method list>
- 指定 Web 服務要顯現 Java Bean 中的哪些公開非靜態方法。預設值是併入所有這些方法。<method list> 中的方法必須用空格來分開。
- -clientType <J2SE | Application | Servlet | EJB>
- 產生指定的用戶端類型的 Skeleton 實作類別。您只能結合 -genMain 引數來使用這個引數。如果您已指定了 -server-side-only 引數,就不能使用這個引數。
- -genMain <name of main class>
- 指定要產生之 main 類別的名稱。您只能結合 -clientType 引數來使用這個引數。如果您已指定了 -server-side-only 引數,就不能使用這個引數。
- -voidReturn [ONEWAY | TWOWAY]
- 指出 void return 方法要成為要求/回應作業(預設值)或單向作業。
- -host <hostName:portNumber>
- 指定主機名稱和埠號。預設值是 localhost:6080。
- -contextRoot <ContextRoot>
- 指定 Web 服務的環境定義起始目錄。預設值是 <ProjectName>。
- -servicePortName <PortName>
- 指定 Web 服務的埠名稱。預設值是 Java Bean 的名稱。
請利用 -host、-contextRoot 和 -servicePortName 等引數來指定服務端點的 URL。格式如下:http://HostName:PortNumber/<ContextRoot>/services/<PortName>
- -sei <endpoint interface>
- 指定預先撰寫的服務端點介面(Java 程式檔)的完整路徑名稱。如果沒有指定的話,就會在執行時期動態產生一個名稱。
- -server-side-only
- 只產生伺服器端 Helper 類別。預設值是產生伺服器端和用戶端 Helper 類別。
- -clientEJBName <EJB client filename>
- 利用用戶端 EJB 檔中的資訊,來配置含用戶端應用程式名稱的用戶端 webservicesclient.xml 描述子。
如果您沒有提供這個選項,您必須先手動編輯 webservicesclient.xml,才能將它加入用戶端 EJB 檔中。
- -style <style type>
- 依照 <style type> 所指定來產生 RPC、Doc 或 Wrapped 樣式的 WSDL。
預設樣式是 Wrapped。
- -use <bindings>
- 依照 <bindings> 所指定,利用 literal 或 encoded 連結來產生 WSDL。預設值是 literal。
- -splitWsdl
- 產生不部署的個別介面和實作 WSDL 文件。預設值是建立將介面和實作資訊組合起來的單一文件。
- - wsSecDir <directory>
- 指定範本所在之目錄的完整路徑,來利用 WS 安全資訊配置產生的部署描述子。
目錄必須包含 ibm-webservices-bnd.xmi 和 ibm-webservices-ext.xmi 檔,
如果產生用戶端連結的話,也必須包含 ibm-webservicesclient-bnd.xmi 和 ibm-webservicesclient-ext.xmi。
- -PkgtoNS <package> <namespace>
- 指出 Java 套件至名稱空間的對映。
如果發現沒有名稱空間的套件,就會產生適用的名稱空間名稱。您可以重複這個引數來指定多個套件的對映。
- -verbose
- 在執行工具時,顯示額外資訊。
- -help
- 顯示說明資訊。
附註:不支援 -deploy 選項。