利用 Ant 建置工具建置 BeenThere 範例


J2EE 可攜性
重新建置這個展示區中所附的範例
開始使用
識別目錄結構
重新建置和安裝範例

J2EE 可攜性

在 J2EE 平台上開發應用程式其中一個最大的好處是具備可攜性。「範例展示區」中的所有範例程式都是在工作站上開發並在 z/OS 系統上執行, 而未動到任何一行 Java 程式碼。藉由將 J2EE 應用程式建置在 Intel 或 UNIX 系統上, 開發人員即不需面臨將 EBCDIC 轉換成 ASCII 或將 ASCII 轉換成 EBCDIC 檔案的苦差事。由於工具的可用性, 開發人員可輕鬆在開發工作站上進行撰寫和測試,並將企業保存檔 (EAR) 安裝在 z/OS 系統上。

重新建置這個展示區中所附的範例

只要是 WebSphere Application Server (Application Server) for z/OS 客戶, 即能夠使用多平台的 Application Server 媒體。如果您將 WebSphere Application Server Base 基礎產品和範例安裝在此套件所支援的其中一個平台上, 可看到相同的展示區。不過,例外的是當您按一下 sample_name > 使用 Ant 來建置 > 平台 > 重新建置和安裝 sample.ear 檔, 將會指示您在該平台上重新建置 EAR 檔。由於 EAR 檔中的文字檔(XML、xmi、JavaServer Pages (JSP) 檔等)必須採 ASCII 格式, 因此可輕鬆在 ASCII 機器上編輯這些檔案。如果您在 ASCII 機器上進行變更,之後您可以將最後結果的 EAR 檔部署和安裝在 z/OS 平台上, 而不需將 EBCDIC 轉換成 ASCII。 



開始使用

將 WebSphere Application Server 安裝在您所選的分散式平台上, 並指出要安裝應用程式伺服器的範例應用程式。

在試圖修改或重新建置範例之前,請先備份 <profile_root> 目錄。 建立 samples 目錄的 zip 檔。您可以解壓縮 zip 檔,將 samples 目錄還原成原始狀態。



識別目錄結構

範例的建置目錄結構如下:


profile_root/samples/src/BeenThere 包含 BeenThere 範例的範例程式碼。
profile_root/samples/lib/BeenThere 包含 BeenThere 範例的 BeenThere.ear 檔。
profile_root/samples/javadoc/BeenThere 包含建置「BeenThere 範例」時產生的 Javadoc 文件。
profile_root/samples/bld/BeenThere 包含所產生的類別檔。請利用這些類別檔來產生最終的 BeenThere.ear 檔。bld 目錄是在重新建置「BeenThere 範例」之後建立的。



重新建置和安裝範例

下列指引將說明重新建置範例的步驟。


執行範例建置 Script

請遵循下列步驟來執行範例建置 Script,它會重新建置範例:

  1. 開啟命令提示字元。
  2. 在指令行中,切換至 profile_root/samples/src/BeenThere 目錄。
  3. 執行範例建置 Script:

  4. 輸入下述指令:

    profile_root\samples\bin\BeenThere\buildBeenThere.bat

    輸入下述指令:

    . profile_root/samples/bin/BeenThere/buildBeenThere.sh

    • 若為 Windows 開發平台,請輸入下列指令:

      profile_root\samples\bin\BeenThere\buildBeenThere.bat

    • 若為 UNIX 和 Linux 開發平台,請輸入下列指令:

      . profile_root/samples/bin/BeenThere/buildBeenThere.sh
    輸入下述指令:

    . profile_root/samples/bin/BeenThere/buildBeenThere.sh

此時會建置範例。

請在 profile_root/samples/bin/BeenThere 目錄中尋找 buildBeenThere.batbuildBeenThere.sh Script。 這些 Script 會設定適當的類別路徑資訊,並且執行 Ant 建置公用程式。Ant 公用程式會讀取 build.xml 檔,說明如何建置範例。請造訪 Jakarta 網站,以取得 Ant 的其他文件。

轉送重新建置 BeenThere.ear

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

  1. <profile_root>/samples/lib/BeenThere 目錄中,尋找重新建置的 EAR 檔
  2. 從開發平台開啟和 WebSphere Application Server for z/OS 間的 FTP 階段作業
  3. 將目錄切換至 <profile_root>/samples/lib/BeenThere
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

移除和重新安裝 BeenThere.ear

請按下列步驟中的說明,重新安裝範例:


  1. 開啟 Web 瀏覽器,移至 http://<host_name>:9060/ibm/console 來啟動管理主控台,其中 <host_name> 是執行部署管理程式的主機名稱或 IP 位址。
  2. 開啟 Web 瀏覽器,移至 http://<host_name>:9060/ibm/console 來啟動管理主控台,其中 <host_name> 是執行部署管理程式的主機名稱或 IP 位址。
  3. 開啟 Web 瀏覽器,移至 http://<host_name>:9080/admin 來啟動管理主控台,其中 <host_name> 是執行部署管理程式的主機名稱或 IP 位址。
  4. 開啟 Web 瀏覽器,移至 http://<host_name>:9060/ibm/console 來啟動管理主控台,其中 <host_name> 是執行部署管理程式的主機名稱或 IP 位址。
  5. 按一下伺服器 > 叢集
  6. 選取所有的叢集。
  7. 按一下停止
  8. 按一下應用程式 > 企業應用程式
  9. 選取 BeenThere 應用程式。
  10. 按一下解除安裝
  11. 按一下管理主控台主畫面頂端的儲存
  12. 按一下儲存
  13. 完成安裝 BeenThere.ear 檔的步驟

這時會將重新建置的 BeenThere.ear 檔部署在應用程式伺服器中。