1 緒論
1.1 動機
隨着擁有內容倉庫的內容提供商的增長，在數據倉庫上面需要有一套統一的程序接口規範。基於Java技術的API規範的目的就是提供這樣的一套接口，這樣做，以便爲建立一套真正的工業用的內容基礎結構打下基礎。
應用開發者和客戶解決方案集成哲不用再學習每一個內容提供商的特殊API規範。相反的，程序開發人員能夠開發基於內容的獨立邏輯的應用，這種應用能夠很好的識別內容倉庫的體系結構和物理存儲方案。
用戶也可以不用在他們的內容倉庫上面建立任何應用而完成內容倉庫的交換，並從中獲取利益。
1.2 目標
控制API設計的指導原則是：
ü 它不必和任何特殊潛在的結構，數據源或協議相聯繫
API的本質是一組能夠被外部以各種不同方式實現的Java接口。因此，在本質上實現這個目標並不困難。在這裏最主要的挑戰是在API中要提供足夠的彈性以便它能適用於分層的和沒有分層的倉庫模型。這點是通過提供內容選項的分層的、以路徑爲基礎的地址和直接的、以共同唯一ID（UUID）爲基礎的地址來實現的。
ü 從程序設計者的角度出發，它必須易於使用
爲了達到這個目的，API被儘可能被設計得簡單和直接。特別的，它有一個簡單的對象模型，並且它集中在表現一個內容倉庫的核心功能而不是貿人進入有可能被當作是內容應用的區域。
ü 它必須在各種已經存在內容倉庫上面提供儘可能相對簡單的實現
已經做出共同的努力以確保在大多數主要內容提供商的內容倉庫之上實現API變得相對容易。（特別是下面的第一級模型）
ü 然而，它必須使那些高級的與內容相關的應用所需要的綜合功能表化
爲了識別在這個目標和上一個目標之間存在着差別，本規範分成兩個兼容的級別和一系列的可選特徵。
第一級模型定義了一個只讀的倉庫。它包括讀取倉庫內容，內省內容類型的定義，對命名空間的基本支持，導出內容成XML和檢索等功能。這些功能必須滿足表現模板和由大部分已經存在的以代碼爲基礎的內容相關應用組成的基本門戶應用的需要。第一級模型也被設計得能夠在任何已經存在內容倉庫進行簡單的實現。
第二級模型添加了一些方法的定義，這些方法包括內容修改，指定內容的類型，進一步的支持命名空間以及從XML中導入內容等。
最後，定義了大量的獨立可選組件以便支持兼容的倉庫。這些組件包括事務、版本化、觀察器、訪問控制、鎖和對檢索支持的添加。