Eclipse Web Tools Platform (WTP) 1.0 實戰教學：從零構建 J2EE 書籤管理應用

前言：WTP 讓 Eclipse 具備 J2EE 開發能力

JDT 只能開發普通 Java 應用，WTP 為 Eclipse 注入 JSP、Servlet、EJB、XML 編輯器與部署/除錯支援。本教學用 WTP 1.0 + Derby + JBoss 3.2.3，手把手構建含 JSP/Servlet/Session Bean 的三層書籤應用。

環境準備清單

• J2SE 1.4.2 SDK
• JBoss 3.2.3 (完整包，非 jbossweb-tomcat*)
• XDoclet 1.2.3
• WTP 1.0 (或 all-in-one 包)
• Apache Derby 10.1.2 Eclipse Plugins (core + ui)

記憶體/磁碟需同時跑 Eclipse + JBoss + Derby。

核心配置三部曲

1. JRE：Preferences → Java → Installed JREs 添加 1.4.2 設為預設
2. JBoss Runtime：Preferences → Server → Installed Runtimes 添加 JBoss 3.2.3，指向解壓目錄，關聯上述 JRE
3. JBoss Server Instance：J2EE 透視圖 → Servers 視圖 → New Server → JBoss 3.2.3 → Start，Console 見啟動日誌

專案架構：EAR 統籌 EJB + Web

1. EJB Project：BookmarkEJB，加入 EAR BookmarkEAR，啟用 ejbdoclet
2. Dynamic Web Project：BookmarkWeb，同樣加入 BookmarkEAR，啟用 webdoclet

Project Explorer 見雙專案掛載同一 EAR（圖 4、5）。

圖 4：建立 BookmarkEJB 專案後

圖 5：建立 BookmarkWeb 專案後

資料庫設置：Derby 嵌入 Eclipse

1. 右鍵 BookmarkEJB → Apache Derby → Add Nature / Start Network Server
2. Data Source Explorer 新增連線：Derby 10.1 Client Driver，DB wtp，用戶 APP/password，指定 derbyclient.jar
3. SQL 編輯器執行 CREATE TABLE bookmarks (url VARCHAR(255) PK, title VARCHAR(255)) 並插入兩筆測試資料（圖 7-9）

圖 7：展開的 Database Explorer

圖 8：Database Output 視圖

圖 9：書籤表內容

JBoss 資料源配置

1. 停止 JBoss
2. $JBOSS/server/default/deploy/derby-ds.xml 定義 DerbyDS (JNDI)、連線 URL jdbc:derby://localhost:1527/wtp、驅動 org.apache.derby.jdbc.ClientDriver、連線池 5-20
3. 複製 derbyclient.jar 到 $JBOSS/server/default/lib
4. 啟動 JBoss，Console 見 DerbyDS 部署成功

核心代碼實作：XDoclet 驅動

1. Session Bean：BookmarkSessionBean

• WTP 精靈生成骨架 (XDoclet Enterprise JavaBean)
• 添加 @ejb.resource-ref 綁定 DerbyDS
• 建立 BookmarkValueObject (Serializable) 傳遞資料
• 實作 getBookmarks() (JDBC 查詢) / saveBookmark() (PreparedStatement) / getDerbyDataSource() (JNDI 查找)

2. Controller Servlet：BookmarkController

• 精靈生成 Servlet，BookmarkWeb 專案屬性勾選 BookmarkEJB.jar 依賴
• @web.ejb-local-ref 引用 Session Bean
• getBookmarkSession() JNDI 查找 LocalHome 建立實例
• doPost() 驗證 URL/Title 長度 → 錯誤導向 SaveBookmarkError.jsp → 成功儲存並查詢全量書籤導向 ShowAllBookmarks.jsp

3. View JSPs

• CreateNewBookmark.jsp：表單 POST 到 Servlet
• SaveBookmarkError.jsp：輸出 request.getAttribute("errors")
• ShowAllBookmarks.jsp：JSTL 迭代 request.getAttribute("bookmarks") 顯示超連結

部署與測試

1. 右鍵 CreateNewBookmark.jsp → Run As → Run on Server → 選 JBoss
2. 等 Console 出現 BookmarkEAR.ear Deployed
3. 瀏覽器見表單 → 故意留空觸發錯誤頁 (圖 19) → 正確輸入見書籤列表 (圖 20)

圖 18：EAR 部署中錯誤

圖 19：SaveBookmarkError 輸出

圖 20：ShowAllBookmarks 輸出

結語

全程體驗 WTP 精靈生成 EJB/Servlet/JSP、XDoclet 標註驅動部署描述符、Derby/JBoss 整合、EAR 熱部署測試。掌握此流程，即具備 WTP 進行 Web/J2EE/資料庫開發的核心能力。