利用 Ant 建置工具來建置 JAX-WS Web 服務範例


J2EE 可攜性
重建 JAX-WS Web 服務範例
開始使用
識別範例建置的目錄結構
重建及重新安裝 JaxWSServicesSamples.ear 檔案

J2EE 可攜性

在 J2EE 平台上開發應用程式其中一個最大的好處是具備可攜性。  範例展示區中的所有程式範例都是在工作站開發,在 z/OS 系統上執行, 完全不必變更任何一行 Java 程式碼。  透過在 Intel 上或在 AIX 或 Linux 之類的作業系統上建置 J2EE 應用程式, 開發人員可以不必處理從 EBCDIC 到 ASCII 或從 ASCII 到 EBCDIC 檔案的轉換。由於工具的可用性, 開發人員可輕鬆在開發工作站上進行撰寫和測試,並將企業保存檔 (EAR) 安裝在 z/OS 系統上。

重建 JAX-WS 範例

每一位 WebSphere Application Server for z/OS 客戶 都有權使用多平台所適用的應用程式伺服器媒體。 如果您在此套件所支援的其中一個平台上安裝 WebSphere Application Server 基本產品和範例, 則您看到的展示區是一樣的。不過,其中有一點差別。當您按一下 sample_name > 使用 Ant 建置 > 平台 > 重建和安裝檔案, 您所看到的重建 EAR 檔的指示乃是您平台所專用的指示。  由於 EAR 檔中的文字檔(XML、xmi 或 JavaServer Pages (JSP) 檔等)必須是 ASCII 格式,因此, 在 ASCII 機器中比較容易編輯這些檔案。如果您在 ASCII 機器上進行變更,之後您可以將最後結果的 EAR 檔重新安裝在 z/OS 平台上,而不需將 EBCDIC 轉換成 ASCII。 

開始使用

請將 WebSphere Application Server 安裝在您選擇的分散式平台中,並指示安裝範例應用程式。 在「安裝範例應用程式」畫面上,選取安裝範例應用程式

在試圖修改或重建範例之前,請建立 <profile_root>/samples/src/JaxWSServicesSamples 目錄的備份。

識別範例建置的目錄結構

範例安裝在下列目錄中:

<profile_root>/samples/src/JaxWSServicesSamples 包含連線測試、回應和 MTOM 範例的範例程式碼。
<profile_root>/samples/lib/JaxWSServicesSamples 包含範例的 Web 保存檔 (WAR)、Java 保存檔和最終 JaxWSServicesSamples.ear 檔案。這個目錄是在重新建置此範例之後建立的。
<profile_root>/samples/javadoc/JaxWSServicesSamples 內含範例 Javadoc 文件。這個目錄是在重新建置此範例之後建立的。
<profile_root>/samples/bld/JaxWSServicesSamples 內含所產生的類別檔。這些類別檔是用來產生最終 JaxWSServicesSamples.ear 檔案。這個目錄是在重新建置此範例之後建立的。

重建及重新安裝 JaxWSServicesSamples.ear 檔案

安裝 WebSphere Application Server 時會提供 JAX-WS Web 服務範例企業保存檔 (EAR)。在使用範例前,不需先建置。下列指示說明重新建置範例的相關步驟,以及和修改有關的其他資訊。

執行範例建置 Script

轉送重建的 JaxWSServicesSamples.ear 檔案
移除及重新安裝 JaxWSServicesSamples.ear 檔案

執行範例建置 Script

若要重建 JAX-WS WebServices 範例 EAR 檔,請執行下列步驟:

  1. 驗證 <profile_root>/bin 位於 PATH 環境變數中。
  2. 切換至 <profile_root>/samples/src/JaxWSServicesSamples 目錄。
  3. 執行範例建置 Script。
    • 在 Windows 平台的指令行上輸入 buildJaxWSSamples
    • 在 AIX 或 Linux 之類的平台的指令行上輸入 buildJaxWSSamples.sh

此時會建置範例。

buildJaxWSSamples Script 位於 <profile_root>/bin 目錄中。這些 Script 會設定適當的類別路徑資訊,並且執行 Ant 建置公用程式。Ant 公用程式會讀取說明如何建置範例的 build.xml 檔。 有關 Ant 公用程式的其他文件,請參閱 Apache Ant 網站

重要資訊 在建置處理期間,只會重建變更過的類別檔。其餘的類別檔會重新包裝成新的 EAR 檔。

轉送重建的 JaxWSServicesSamples.ear 檔案

請按照下列指示,使用「檔案轉送通訊協定 (FTP)」將二進位 EAR 檔轉送至 z/OS 伺服器。

  1. <profile_root>/samples/lib/JaxWSServicesSamples 目錄中找出重建的 EAR 檔。
  2. 從開發平台開啟與 WebSphere Application Server for z/OS 之間的 FTP 階段作業。
  3. 切換至 <profile_root>/samples/lib/JaxWSServicesSamples 目錄。
  4. 刪除現有的 JaxWSServicesSamples.ear 檔案。輸入此指令: del JaxWSServicesSamples.ear
  5. 若要以二進位格式轉送該檔案,請輸入此指令:bin
  6. 從開發平台將重建的 JaxWSServicesSamples.ear 移到目標應用程式伺服器。輸入此指令:put JaxWSServicesSamples.ear
  7. 結束 FTP 階段作業。輸入 quit

移除及重新安裝 JaxWSServicesSamples.ear 檔案

依預設,JAX-WS Web 服務範例會安裝在 <profile_root>/installedApps/<cell name> 目錄中,其中 <cell name> 是安裝應用程式的 Cell 名稱。 請按下列步驟中的說明,重新安裝範例:

  1. 停止應用程式伺服器。
  2. 移除 JAX-WS Web 服務範例 EAR 檔:
    1. 輸入下列指令:

      cd <profile_root>\bin
      setupCmdLine

      cd <profile_root>/bin
      . ./setupCmdLine.sh

      cd <profile_root>/bin
      . ./setupCmdLine.sh

      cd <profile_root>/bin
      . ./setupCmdLine

      其中 <profile_root> 代表設定檔安裝目錄。
    2. 輸入下列指令來解除安裝應用程式(<profile_root>/bin 必須在 PATH 中):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('JaxWSServicesSamples')" 

  3. 重新安裝範例:
    • 切換至 <profile_root>/samples/lib/JaxWSServicesSamples 目錄
    • 找出 JaxWSServicesSamples.ear
    • 輸入下列指令:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      其中 <node> 是節點的名稱,<server> 是要安裝範例的伺服器名稱。

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      其中 <node> 是節點的名稱,<server> 是要安裝範例的伺服器名稱。

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      其中 <node> 是節點的名稱,<server> 是要安裝範例的伺服器名稱。
      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<node>', 
                  '-server', '<server>' ] )"
                
      其中 <node> 是節點的名稱,<server> 是要安裝範例的伺服器名稱。
  4. 啟動應用程式伺服器。

現在您已經重建及重新安裝 JAX-WS Web 服務範例應用程式。您可以配置和執行連線測試、回應及 MTOM 範例用戶端了。