Java Content Repository API 實戰：基於 Apache Jackrabbit 的內容管理系統構建

JSR-170：統一內容倉庫標準的誕生

隨著內容管理應用普及，廠商私有倉庫引擎導致複雜性高、可維護性差、廠商鎖定嚴重。JSR-170 (Content Repository for Java Technology API) 在 `javax.jcr` 命名空間提供統一 API，實現廠商中立的倉庫訪問。核心優勢：不綁定底層架構（文件系統、WebDAV、XML、SQL 數據庫均可）、支援匯入匯出無縫切換後端、標準化版本控制、訪問控制、搜尋等複雜功能。

倉庫模型：樹狀層次結構

單一倉庫包含一或多工作區，每工作區含項目樹（節點與屬性）。節點有主節點類型（定義允許的屬性/子節點）與混合類型（`mix:versionable` 版本控制、`mix:lockable` 鎖定、`mix:referenceable` UUID）。預定義類型：`nt:unstructured`（最靈活）、`nt:file`/`nt:folder`/`nt:resource`（文件系統映射）、`nt:version`（版本控制）。命名空間防止衝突（如 `jcr:`、`mix:`、`nt:`、`wiki:`）。

安裝與配置：手動 vs 自動

所需庫：jackrabbit-core、commons-collections、concurrent、derby、jcr、log4j、lucene、slf4j、xerces。

手動配置：`repository.xml` 指定文件系統、安全管理、工作區、持久化管理器、搜尋索引、版本控制；`jaas.config` 配置認證；JNDI + `RegistryHelper` 獲取 Repository；`SimpleCredentials` 獲取 Session → Workspace → 根節點。

自動配置：`TransientRepository` 啟動首個 Session 時自動初始化，關閉最後 Session 時停止，犧牲移植性換取簡單性。

JCRWiki 實戰：從設計到核心功能

內容拓撲

百科全書條目為 `nt:unstructured` 節點，三屬性：標題、內容、分類（單/多值）。

基本操作

• 新增：`addNode()`、`setProperty()`，最後 `session.save()` 持久化。
• 遍歷訪問：`getNode()`、`getProperty()` 相對路徑遍歷；`getNodes()` 獲取迭代器瀏覽。
• XPath 搜尋：`QueryManager.createQuery()` 執行 XPath 查詢（支援 `jcr:contains` 全文搜尋），類似 JDBC 流程。

進階功能

• XML 匯入匯出：`session.exportSystemView()` / `session.importXML()` 實現跨廠商倉庫遷移。
• 二進制內容：`nt:file` 節點下建 `jcr:content` (`nt:resource`)，設 `jcr:mimeType`、`jcr:data` (FileInputStream)、`jcr:lastModified`。
• 版本控制：節點加 `mix:versionable`，`checkout()` → 修改 → `save()` → `checkin()`；`VersionHistory` 瀏覽歷史（跳過無狀態的根版本 Vroot）。

結語

JSR-170 最終版已有商業實現，獲 SAP、Macromedia、IBM 等巨頭支持。如 ORM 改變資料庫編程，JCR API 將深度變革內容應用開發方式。Apache Jackrabbit 作為開源參考實現，為開發者提供了寶貴的學習與實踐平台。