精通 JBuilder：全域類別庫建立與維護指南

JBuilder 類別庫為獨立於專案的全域資源，支援 Class、Source、Documentation、Framework、Required Libraries 五大標籤。本文詳細說明類別庫結構、配置檔格式、儲存位置策略，並完整演示以 Hibernate 為例建立類別庫的全流程。

類別庫五大標籤功能

配置檔格式

每個類別庫對應一個 .library XML 檔，範例 (Axis.library)：

<?xml version="1.0" encoding="UTF-8"?>
<library>
  <fullname>Axis</fullname>
  <class>
    <path>[saaj.jar]</path>
    <path>[jaxrpc.jar]</path>
    <path>[axis.jar]</path>
    <path>[axis-ant.jar]</path>
    <path>[wsdl4j.jar]</path>
    <path>[commons-logging.jar]</path>
    <path>[commons-discovery.jar]</path>
  </class>
  <source>
    <path>[../extras/ws-axis.zip]ws-axis/java/src/</path>
  </source>
  <documentation>
    <!-- Javadoc 與 class 同包在 JAR 內，此處留空 -->
  </documentation>
</library>

• 路徑中 [...] 表示相對於 .library 檔所在目錄。
• Source 路徑指向包含套件結構的根目錄。
• Documentation 為空時，JBuilder 會嘗試從 Class JAR 內讀取 Javadoc。

儲存位置與可見性策略

建議：統一放入 JBuilder 資料夾，團隊共享同一套設定，避免版本不一致。

完整建立流程：Hibernate 類別庫

準備資源

• JAR 檔：D:\JTJB2005\chapter3\extraLib\hibernate\lib\ 下所有 .jar。
• Javadoc：D:\JTJB2005\chapter3\extraLib\hibernate\doc\api\ (根目錄，含套件結構)。

步驟 1：新增類別庫

1. Tools → Configure → Libraries...
2. 左側 New... → 名稱 hibernate，位置選 JBuilder → Add...

步驟 2：加入 JAR 檔

1. 定位到 lib 目錄，Ctrl+A 全選所有 JAR → OK。
2. 精靈列表顯示所有路徑 → OK。

步驟 3：設定 Javadoc

1. 切換 Documentation 標籤 → Add...
2. 選擇 doc/api 目錄 (根目錄，非具體 html 檔) → OK。

步驟 4：完成並驗證

1. 對話框 OK → /lib/hibernate.library 產生。
2. 專案中 import net.sf.hibernate.Session; 按 F1 → 顯示 Javadoc 即成功。

進階維護技巧

• 升級版本：直接編輯 .library 檔替換 JAR 路徑，或 GUI 中 Remove 舊路徑 Add 新路徑。
• 遷移分享：將 .library 檔複製到同事 JBuilder/lib 即可使用。
• 版控：團隊可將標準 .library 檔納入版控，新成員 Checkout 後放入 JBuilder/lib 即完成環境同步。

建立完善的 JBuilder 類別庫，是從「能編譯」邁向「高效開發、文檔隨手、團隊同步」的關鍵基礎設施。