Java EE 5 Tutorial 範例運行實戰指南：環境配置與 EJB 部署全流程

環境準備與安裝

應用伺服器安裝

以 Sun Java System Application Server（以下簡稱 APPServer）為例，安裝路徑設為 D:/Sun/APPServer。安裝過程中務必啟用管理主控台驗證並設定強密碼。安裝完成後，直接從啟動選單啟動伺服器，瀏覽器訪問 https://localhost:4848/asadmin，輸入 admin 與密碼即可進入管理主控台。

範例專案環境配置

Java EE 5 Tutorial 範例（examples 目錄）因依賴公共模組，無法單獨抽取編譯運行。需修改 bp-project 目錄下兩個關鍵配置檔：

build.properties

javaee.home=D:/Sun/APPServer
javaee.tutorial.home=D:/J2EE5example

app-server.properties

javaee.home=D:\\Sun\\APPServer

注意：路徑分隔符需與作業系統一致，Windows 使用雙反斜線或正斜線均可，但建議統一風格。

Ant 建構工具安裝

確保系統已安裝 Ant 並配置至環境變數 PATH 中，可在命令列輸入 ant -version 驗證。

EJB 範例編譯與部署實戰：Cart 範例

1. 開啟 DOS 命令視窗，切換至 ejb/cart 目錄
2. 執行 ant 編譯，生成 build 與 dist 兩個目錄
3. 啟動應用伺服器，訪問管理主控台 https://localhost:4848/asadmin
4. 登入後選擇 Enterprise Applications 選單，部署 dist 目錄下生成的 cart.ear
5. 部署成功後，回到命令視窗執行 asant run，主控台將輸出運行結果

常見問題排查：Duke's Bank 範例部署失敗

部署 Duke's Bank 範例時常遇到無法登入、找不到資料庫相關資源等問題。核心排查方向包括：

• 資料庫連線池配置：確認 JDBC 資源與連線池在管理主控台中正確建立並關聯
• JNDI 名稱對應：檢查 sun-ejb-jar.xml 或 persistence.xml 中的 JNDI 名稱與伺服器配置一致
• 資料庫 Schema 初始化：部署前需執行 SQL 腳本建立表結構，或啟用自動建表功能
• 事務與安全設定：確認 EJB 方法的事務屬性（如 Required）與安全角色映射正確

若有成功部署經驗的開發者，歡迎分享關鍵配置步驟，互助解決此經典難題。

最佳實踐總結

1. 路徑零空格原則：安裝路徑與專案路徑避免包含空格與中文字符
2. 配置檔版本控管：將修改後的 build.properties 納入版本控管，團隊共享
3. Ant 目標熟悉度：閱讀 build.xml 理解 deploy、run、undeploy 等目標依賴關係
4. 日誌分析習慣：部署失敗時優先查看 server.log 而非僅看主控台輸出