您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

深入 Geronimo 應用伺服器：以 Maven、Struts、EJB 建構電話簿 Web 應用

編輯：Java 相關知識

本文延續「三種方法連接資料庫到 Geronimo」，完整示範如何擴充簡單資料庫應用，導入 Apache Struts 前端與 EJB 後端，並以 Maven 自動化建構、封裝、部署企業級應用 (EAR)。

技術棧概覽

Maven：專案物件模型 (POM) 驅動建構生命週期，管理相依 (從 iBiblio 下載)、執行 XDoclet 代碼產生、封裝 EAR、自動部署至執行中 Geronimo。Geronimo 本身即以 Maven 建構。
Struts (Model 2)：業務邏輯封裝於純 Java Action，標籤庫簡化 JSP 顯示，極致分離關注點。
XDoclet：以 Javadoc 標籤驅動代碼產生，大幅減少 J2EE 部署描述符手寫負擔 (代碼:描述符 ≈ 1:3)。

建置先決條件

Maven 1.0.2 安裝並驗證 maven 指令。
從原始碼建構 Geronimo (Wiki 指引)，將 geronimo-deployment-plugin-1.0-SNAPSHOT.jar 裝入 $MAVEN_HOME/plugins。
安裝 XDoclet 1.2.3：解壓 .jar 至本地倉庫 .maven/repository/xdoclet/jars，並加入 maven-xdoclet-plugin-1.2.3.jar 至 plugins 目錄。

滿足條件後，專案根目錄執行 maven 應顯示 BUILD SUCCESSFUL。Geronimo 需先啟動 (java -jar bin/server.jar org/apache/geronimo/DebugConsole org/apache/geronimo/RuntimeDeployer)。

專案結構與核心代碼

Web 層 (Struts + JSP + Tiles)

src/webapp：JSP、Tiles 模板 (site-template.jsp)、資源檔。
兩大視圖：ListPhoneNumbersPage.jsp (DisplayTag 分頁顯示)、EditPhoneNumberPage.jsp (Struts 表單標籤)。
Actions (src/java/org/acme/phonebook/struts)：ListNumbers、SaveEntry、EditEntry、DeleteEntry 等。

XDoclet 驅動 Struts 設定

Action 類別 Javadoc 標籤產生 struts-config.xml：

/** @struts.action path="/pages/SaveEntry" name="phoneBookEntryForm" scope="request" input="/pages/EditPhoneNumberPage.jsp" ... */
/** @struts.action-forward name="success" path="/pages/ListNumbers.do" redirect="true" */

Action 呼叫 EJB

PhoneBookSessionLocal session = PhoneBookSessionUtil.getLocalHome().create();
Collection c = session.listEntries();
request.setAttribute("numbers", c); // 供 JSP 顯示

PhoneBookSessionUtil 為 XDoclet 產生的輔助類別。

JSP 顯示 (DisplayTag)

<display:table name="numbers" requestURI="ListNumbers.do" pagesize="5">
  <display:column property="name" title="Name"/>
  <display:column property="phoneNumber" title="Phone"/>
  <display:column title="Actions">
    <html:link action="/pages/EditEntry" paramId="id" paramName="row_obj" paramProperty="name">Edit</html:link>
    <html:link action="/pages/DeleteEntry" ... onclick="return confirmDelete('Number')">Delete</html:link>
  </display:column>
</display:table>

EJB 層 (CMP Entity + Stateless Session)

PhoneBookEntryBean：CMP Entity Bean，對應資料表 phone，XDoclet 產生部署描述符與介面。
PhoneBookSessionBean：Stateless Session Facade，提供業務邏輯與交易邊界 (@ejb.transaction type="Required")，隔離 Web 層與持久化細節。

/** @ejb.interface-method view-type="both" @ejb.transaction type="Required" */
public Collection listEntries() {
    Collection entries = PhoneBookEntryUtil.getLocalHome().findAll();
    // 轉換為 Value Object 回傳
}

部署計劃與配置關鍵點

EAR 層 (`src/resources/ear`)

application.xml、geronimo-application.xml：定義模組、應用層級 JDBC 連接器 (參考前文)。
geronimo-application.xml 的 configId="org/acme/PhoneBook" 必須與 maven.xml 部署目標 id 一致，否則自動部署失敗。

EJB 模組 (`src/resources/ejb/META-INF/openejb-jar.xml`)

<cmp-connection-factory><resource-link>MysqlDataSource</resource-link></cmp-connection-factory>：名稱必須與連接器配置一致。
<local-jndi-name>java:comp/env/ejb/PhoneBookEntryLocal</local-jndi-name>：JNDI 名稱錯誤會導致找不到 Bean。
<table-name>、<cmp-field-mapping>：對應資料表/欄位。

Web 模組 (`src/webapp/WEB-INF/geronimo-jetty.xml`)

<web-app ... configId="org/acme/PhoneBookWeb">
  <context-priority-classloader>true</context-priority-classloader>
</web-app>

關鍵：context-priority-classloader=true 解決 Geronimo 庫與 Struts 類別衝突，隔離應用類別載入範圍 (Geronimo M4 版檔名改為 geronimo-web.xml)。

Merge 目錄與 XDoclet 合併機制

src/resources/merge 放置 taglibs.xml 等片段，XDoclet 產生 web.xml、struts-config.xml 時自動合併。

Maven 建構腳本 (`maven.xml`)

<goal name="start">
  <deploy:distribute uri="deployer:geronimo:jmx:rmi://localhost/jndi/rmi:/JMXConnector" ... module="target/${pom.artifactId}.ear"/>
  <deploy:start ... id="org/acme/PhoneBook"/>
</goal>

自動化部署極便利，惟需定期清理暫存目錄避免舊部署檔堆積。