JBoss Seam 學習系列三：JBoss Tools 產生首個 Seam 專案與 CRUD 實戰

使用 JBoss Tools 快速產生 Seam 專案與資料庫 CRUD 功能

透過 JBoss Tools 整合開發環境，體驗 Seam 專案建立、實體類別產生、CRUD 介面自動生成的完整流程，理解 Seam Gen 代碼生成機制與產出結構。

專案建立完整步驟

1. 建立 Seam Web 專案

2. 設定專案資訊

首次使用需設定 Target Runtime 與 Target Server (JBoss AS)。

3. 設定 Seam Runtime 與資料庫連線

配置 Connection Profile 連接資料庫，完成後點擊 Finish 產生專案。

專案結構解析

產生 4 個 Eclipse 專案：

• seamfirst — Web 專案 (WAR)
• seamfirst-ear — EAR 封裝專案
• seamfirst-jar — EJB 專案
• seamfirst-test — 測試專案

驗證基礎框架

啟動 JBoss Server，訪問 https://localhost:8080/seamfirst：

內建登入/登出功能與首頁，展示 Seam 安全模組預設實作。

資料庫 CRUD 自動生成

前置條件

MySQL 資料庫含 Customer 表：ID (int)、customername (varchar)、customerdesc (varchar)、createdate (date)、email (varchar)

生成步驟

1. 專案右鍵 → Seam Generate Entities
2. 
3. 
4. 完成後重新啟動伺服器

功能驗證

選單新增「Customer List」，支援完整新增、刪除、修改、查詢操作。

產生代碼結構分析

Java 類別 (3 個核心類)

均使用 @Name 註解，實現表現層直接存取業務層元件。

頁面檔案 (6 個檔案)

• Customer.xhtml / Customer.page.xml
• CustomerEdit.xhtml / CustomerEdit.page.xml
• CustomerList.xhtml / CustomerList.page.xml

關鍵機制解析

1. resultList 來源追蹤

#{customerList.resultList} 中的 resultList 定義於父類 EntityQuery，非 CustomerList 自身屬性。

2. .page.xml 擴展機制

每個 .xhtml 對應 .page.xml，為 Seam 對 JSF 導航、參數綁定、安全控制的擴展，後續文章將詳細說明。

心得

Seam Gen 產生功能完備但介面風格固定，實務上需客製化產生模板 (FreeMarker) 以符合專案 UI 標準與操作習慣。