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

Eclipse Lomboz 插件完整指南：安裝、配置與首個 J2EE 專案實戰

編輯：Java 相關知識

什麼是 Lomboz？

Lomboz 是 Eclipse 早期最知名的開源 J2EE 開發插件 (現已併入 JBoss Tools / Red Hat CodeReady Studio 血脈)。它將 Eclipse 轉型為全功能 J2EE IDE，整合 Web 模組 (Servlet/JSP/HTML)、EJB 模組、應用伺服器部署/除錯、XDoclet 代碼生成 於一體，支援主流伺服器：Tomcat、JBoss、JOnAS、Resin、Orion、JRun、Oracle IAS、WebLogic、WebSphere。

核心功能亮點

Web 應用開發：HTML/JSP/編輯器 (語法高亮、程式碼助手、語法檢查)
Wizard 驅動建立 Web/EJB 專案、EJB 客戶端測試程式
標準封裝部署：EAR (企業應用)、WAR (Web 模組)、JAR (EJB 模組)
XDoclet 整合：EJB 1.1/2.0 代碼/描述檔自動生成
遠端/本地除錯：強大的 Java 除錯器支援 JSP/EJB 伺服器端代碼斷點
Web Service 支援：WSDL 客戶端生成

安裝前置作業：避坑指南

1. JDK vs JRE — 必須安裝完整 JDK

Eclipse 運行只需 JRE，但 **JSP 編譯、XDoclet 代碼生成需要 `tools.jar` (僅存在 JDK `lib/` 目錄)**。

下載安裝 JDK 1.4.2+ (建議 1.5/1.6 以上)

環境變數：

JAVA_HOME=C:\j2sdk1.4.2
CLASSPATH=.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar
PATH=%JAVA_HOME%\bin;%PATH%

Eclipse 設定：`Window > Preferences > Java > Installed JREs` → 編輯 JRE Home 指向 **JDK 根目錄下的 `jre` 子目錄** (如 `C:\j2sdk1.4.2\jre`)，而非 JRE 獨立安裝目錄。

2. Eclipse 版本與中文化

建議使用 **全新、未啟動過的 Eclipse 3.0.1** 安裝語言包，否則選單可能部分未漢化。
若中文化不全：刪除 `eclipse/configuration` 目錄後重啟。

3. EMF (Eclipse Modeling Framework) — Lomboz 3.0 必裝

Lomboz 3.0 模型層建立於 EMF，**必須安裝 EMF Runtime 2.0.0+ 或 SDK**，否則 Preferences 樹中不會出現 Lomboz 設定項。

安裝 Lomboz 插件

官網 `www.objectlearn.com` 下載對應 Eclipse 版本的 `lomboz.zip`。
解壓至 **Eclipse 安裝根目錄** (合併 `plugins`、`features` 目錄)。
啟動 Eclipse，進入插件啟用配置：

啟用步驟 (Eclipse 3.0 介面)：

`Window > Customize Perspective > New` → 勾選 `Lomboz J2EE Wizards` 及所有子項
`Window > Customize Perspective > Show Views` → 勾選 `Lomboz J2EE` 及子項
`Window > Customize Perspective > Action Sets` → 勾選 `Lomboz Actions`
`Window > Preferences > Workbench > Label Decorations` → 勾選 `Lomboz J2EE Decorators`

完成後工具列將出現 Lomboz 專用圖示，`File > New > Project` 將新增 J2EE 專案類型。

核心配置四步曲

步驟 1：Java 建置路徑預設值

`Window > Preferences > Java > Build Path` → `Source and Output Folders` 從 `Project` 改為 `Folders`，Source Folder = `src`，Output Folder = `bin`。套用。

步驟 2：Lomboz 專屬設定

`Window > Preferences > Lomboz`：

JSP 編譯器 `tools.jar` 路徑：指向 JDK `lib/tools.jar` (關鍵！)
Enable JSP Syntax Checking：大量 JSP 專案建議關閉以提升儲存速度。
Server Restart：重新部署後自動重啟伺服器 (Tomcat 用戶強烈建議開啟)。
Update server classpath and deployment parameters：保持勾選，自動同步專案 Classpath 與伺服器定義。
Code Generation Plugin：預設 XDoclet。
★ Use application server classpath (極重要)：必須勾選。啟動伺服器時使用伺服器定義的 Classpath，而非 Eclipse 專案 Classpath。否則 Web/EJB 容器會重複載入類別 (專案一次、EAR/WAR/JAR 再一次)，導致 `ClassCastException`、`LinkageError` 等詭異類別載入問題。

步驟 3：伺服器定義

`Preferences > Lomboz > Server Definitions`：

選擇伺服器類型 (Tomcat 5.x, JBoss 4.x 等)
設定 `Home Directory` (安裝路徑) 與 `Classpath Variables` (伺服器啟動需載入的庫，如 `servlet-api.jar`、資料庫驅動)
`Classpath` 頁籤：檢查/增減啟動時載入的庫，**修改後必須按 Apply**。

步驟 4：驗證 Classpath Variables

`Preferences > Java > Build Path > Classpath Variables` → 確認步驟 3 設定的變數已出現在列表中。

步驟 5：XDoclet 配置 (EJB 開發必備)

需 JDK 1.2+ (不支援 1.1)
確認 `tools.jar` 在 Classpath Variables、`JAVA_HOME/bin` 在 PATH 中。

建立第一個 J2EE 專案實戰

`File > New > Project` → `Lomboz J2EE Wizards > Lomboz J2EE Project` → Next
專案名：`MyJ2EEProject` → Next
Java Settings 頁：確認 Source=`src`、Output=`bin` → Next
Web Modules 頁：`Add` → Module Name=`myweb` → Next
Targeted Servers 頁：選擇已配置的伺服器 → `Add` → 設為預設 → 勾選 `update classpath and deployment properties for default server` → Next
Finish → 提示關聯 Java Perspective 選 `Yes`

專案結構解析：

`myweb/` (Web 模組根目錄)
- `index.jsp`、`error.jsp`：預設歡迎/錯誤頁
- `web.xml`：部署描述檔
- `WEB-INF/build.xml`：Ant 建置/部署腳本
- `WEB-INF/targets.xml`：目標伺服器部署參數

此時已擁有可部署至 Tomcat/JBoss 的標準 Web 模組雛形。後續可透過 Wizard 新增 Servlet、JSP、EJB、Struts Action 等元件。

進階：三種賦予既有專案 J2EE 特性的方式

New J2EE Module：在現有專案中新增 Web/EJB 模組 (需手動檢查 Build Path 庫)。
New EAR Module：將現有 Web/EJB 模組打包為 EAR (WebSphere、Orion、Oracle 等伺服器僅接受 EAR 部署)。
Enabling existing modules：為非 Lomboz 建立的 Web/EJB 目錄補全 Lomboz 元資料與 J2EE 結構 (同樣需檢查 Build Path)。