準則: 組合 J2EE 應用程式
這個準則討論如何以 J2EE 模組來組合為 J2EE 應用程式。
關係
相關元素
主要說明

簡介

J2EE 應用程式組合人員會以 J2EE 模組來組合為 J2EE 應用程式。只要修改部署描述子或提供替代的描述子,「應用程式組合人員」可以挑選現成的模組在應用程式中使用。

有些應用程式伺服器需要在部署用的 EJB-JAR、WAR 及其他 JAR 保存檔外圍多一層 EAR "wrapper",這表示 J2EE 應用程式元件提供者也可能需要組合測試用的 EAR。

J2EE 規格的 J2EE.8.3「應用程式組合」一節提出 J2EE 應用程式的詳細組合步驟。以下是這個指引的總結摘要。

組合 J2EE 應用程式

組合 J2EE 應用程式需要下列步驟:

  1. 選取應用程式會使用的 J2EE 模組。
  2. 建立應用程式目錄結構。
  3. 調和 J2EE 模組部署描述子。
    • 編輯 J2EE 模組部署描述子,連結內部滿足的相依性,並去除多餘的安全角色名稱。
    • 定義交易、安全角色、方法權限等。
    • (選擇性)使用 alt-dd 元素來指定替代部署描述子,同時保留原始部署描述子。
    • 指定環境起始目錄給 J2EE 應用程式中的每一個 Web 模組。
    • 確保正確描述元件相依性。
    • 確保應用程式中每一個類別只有一個版本。
  4. 為應用程式建立 XML 部署描述子,命名為 "application.xml"。
  5. 包裝應用程式。
    a. 將 J2EE 模組放入適當的目錄中。將部署描述子放入 META-INF/application.xml 中。
    b. 包裝成 ".EAR" 檔案。

新增/移除模組

在部署之前,應用程式中可能會增加 J2EE 模組,步驟如下:

  1. 在應用程式套件中決定新模組的位置。(選擇性)
    在應用程式套件階層中建立新目錄。
  2. 將新的 J2EE 模組複製到應用程式套件中理想的位置。
  3. 編輯 J2EE 模組的部署描述子來連結相依性,
    由應用程式中的 J2EE 模組在內部滿足這些相依性。
  4. 視需要編輯 J2EE 應用程式部署描述子。

同樣地,從應用程式套件階層中移除模組,並編輯部署描述子來解決不一致性,這樣就可以移除模組。

驗證應用程式

在試圖部署之前,最好先驗證保存檔的內容,因為不明確的錯誤(尤其是在應用程式伺服器端)可能會導致出現含糊不清或不存在的錯誤訊息。例如,確認 EAR 中至少定義一個模組

也可以利用 J2EE SDK 提供的 J2EE 驗證器工具來驗證 EAR。此工具可以確定 EAR 在內部一致且形式完整。例如,可以確定模組和應用程式保存檔符合標準規格(J2EE、Servlet 及 EJB)。