wsdeploy 指令

請利用 wsdeploy 指令,將 WebSphere® 產品特定的部署類別新增到與 Web 服務相容的企業應用程式企業保存檔 (EAR) 或應用程式用戶端 Java™ 保存檔 (JAR) 檔中。

Java API for XML-Based RPC (JAX-RPC) 應用程式支援 wsdeploy 指令。 應用程式伺服器所實作的 Java API for XML-Based Web Services (JAX-WS) 程式設計模型不支援 wsdeploy 指令。 如果您的 Web 服務應用程式只含有 JAX-WS 端點,您不需要執行 wsdeploy 指令,因為這個指令只用來處理 JAX-RPC 端點。

利用 wsdeploy 工具新增到 JAR 檔或與 Web 服務相容的 EAR 檔的部署類別包括:
  • Stub
  • 序列化程式和解除序列化程式
  • 服務介面的實作
這個部署步驟必須執行至少一次,且可以執行許多次。 部署可以另外執行,通常是利用 wsdeploy 指令或組合工具來執行,或在安裝應用程式時執行。 當利用 wsadmin 指令來安裝時,請指定 -deployws 選項。
wsdeploy 指令依下列清單中的說明來運作:
  • 檢查企業應用程式或 JAR 檔中的每個模組。
  • 如果模組包含所存在之 webservices.xml 部署描述子指示的 Web 服務實作,將會找出相關的「Web 服務說明語言 (WSDL)」檔,然後用 role deploy-server 選項來執行 WSDL2Java 指令。
  • 如果模組包含所存在之用戶端部署描述子指示的 Web 服務用戶端,將會找出相關聯的 WSDL 檔,然後用 role deploy-client 選項來執行 WSDL2Java 指令。
  • 編譯和重新包裝 WSDL2Java 指令產生的檔案。
請參閱適用於 JAX-RPC 應用程式之 WSDL2Java 指令的指令資訊,以進一步瞭解所產生要用於部署的檔案。

當編譯產生的檔案時,如果 EAR 或 JAR 檔並非自行包含,這些檔案可以參照 EAR 或 JAR 檔之外的應用程式特定類別。 在這種情況下,請利用 -jardir 或 -cp 選項來指定在編譯產生的檔案時,要新增到 CLASSPATH 變數的其他 JAR 檔或壓縮檔。

wsdeploy 指令語法

下列範例說明指令語法:
wsdeploy Input_filename Output_filename [options]
必要選項:
  • Input_filename

    指定要部署的 EAR 或 JAR 檔的路徑。

  • Output_filename

    指定已部署的 EAR 或 JAR 檔的路徑。 如果 output_filename 已存在,將會無聲自動改寫。 output_filename 可以與 input_filename 相同。

其他選項:
  • -jardir directory

    指定包含 JAR 檔或壓縮檔的目錄。 這個目錄中所有 JAR 檔和壓縮檔都新增到用來編譯所產生檔案的 CLASSPATH 中。 這個選項可以是指定零次或許多次。

  • -cp entries

    指定在編譯產生的類別時,要新增到 CLASSPATH 的項目。 多重項目利用在 CLASSPATH 環境變數中的相同方法來區隔。

  • -codegen

    指定產生但不編譯部署程式碼。 這個選項會隱含地指定 -keep 選項。

  • -debug

    包含編譯時的除錯資訊,也就是利用 javac -g 來編譯。

  • -help

    顯示說明訊息並結束。

  • -ignoreerrors

    如果發生驗證或編譯錯誤,不停止部署。

  • -keep

    不刪除包含產生之類別的工作目錄。 會顯示一則訊息來指示保留的工作目錄名稱。

  • -novalidate

    不驗證輸入檔中的 Web 服務部署描述子。

  • -trace

    顯示處理資訊,包括產生的檔案的名稱。

  • -compliancelevel level

    設定編譯器相符性的 JDK 層次。 有效的值包括:1.4、5.0、6.0(預設值)和 7.0。 這個旗標是選用的。

下列範例說明如何在 wsdeploy 指令中使用選項:
wsdeploy x.ear x_deployed.ear -trace -keep
Processing web service module x_client.jar.
Keeping directory: f:\temp\Base53383.tmp for module: x_client.jar.
Parsing XML file:f:\temp\Base53383.tmp\WarDeploy.wsdl
Generating f:\temp\Base53383.tmp\generatedSource\com\test\WarDeploy.java
Generating f:\temp\Base53383.tmp\generatedSource\com\test\WarDeployLocator.java
Generating f:\temp\Base53383.tmp\generatedSource\com\test\HelloWsBindingStub.java
Compiling f:\temp\Base53383.tmp\generatedSource\com\test\WarDeploy.java.
Compiling f:\temp\Base53383.tmp\generatedSource\com\test\WarDeployLocator.java.
Compiling f:\temp\Base53383.tmp\generatedSource\com\test\HelloWsBindingStub.java.
Done processing module x_client.jar.  
可能會顯示下列訊息:
  • -f 旗標無效。

    f 選項無法識別為有效選項。

  • -c 旗標語意不明。

    選項可以縮寫,但縮寫必須是唯一的。 在這個情況下,wsdeploy 指令無法判斷想要的選項。

  • -c 旗標遺漏 -p 參數。

    省略選項的必要參數。

  • 遺漏 p 參數。

    省略必要的選項。


指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rwbs_wsdeploy
檔名:rwbs_wsdeploy.html