精通 JBuilder：專案擴展類別庫管理實務

JBuilder 專案依賴三類擴展類別庫：共享其他專案、JBuilder 全域類別庫、指定 JAR/ZIP 檔。本文示範如何透過「專案屬性 → 路徑 → 所需類別庫」介面管理，並以 Hibernate 類別庫為例說明操作步驟與 Javadoc 整合驗證。

三種來源比較

操作步驟：將 JBuilder 類別庫加入專案

1. 開啟 Project → Project Properties → Paths → Required Libraries 標籤。
2. 點選 Add... → 選擇 Libraries 標籤。
3. 在樹狀結構中展開 JBuilder 節點，勾選目標類別庫 (如 hibernate)。
4. 確定返回，列表出現 hibernate 項目 → OK 完成。

驗證 Javadoc 整合

1. 專案中開啟任一 Java 檔，import net.sf.hibernate.Session;。
2. 游標停在 Session 上按 F1。
3. 彈出 Help Viewer 顯示 Hibernate Javadoc → 設定正確。
4. 若為空白，需回 JBuilder 類別庫設定修正 Documentation 路徑。

圖示說明

圖 1：專案擴展類別庫管理介面

圖 2：從 JBuilder 類別庫樹選擇 hibernate

常見問題排查

• 編譯找不到類別：確認 Required Libraries 列表已勾選，且 JBuilder 類別庫 Class 標籤路徑正確。
• F1 無 Javadoc：檢查 JBuilder 類別庫 Documentation 標籤指向的目錄結構是否與套件名對應 (如 api/org/hibernate/Session.html)。
• 來源碼無法跳轉：Source 標籤需指向包含 .java 的根目錄 (如 src/)，而非 JAR 檔。

建議策略

1. 團隊建立「標準 JBuilder 類別庫庫」，含所有通用第三方庫完整 Class/Source/Documentation 設定。
2. 新專案建立時，統一引用標準庫，避免各自配置 JAR/ZIP 造成版本不一致。
3. 專案專用庫 (如內部框架特定版本) 再採 JAR/ZIP 方式置於專案 lib/ 目錄並加入版控。

善用 JBuilder 類別庫機制，能實現「一次設定、處處可用、來源文檔隨碼走」的高效開發體驗。