• JcrTemplate，允許執行JcrCallback和異常處理（將需檢查的JCR異常轉換成不需檢查的Spring DAO異常）。這個模板實現了來自JCRSession的絕大部分方法，可以簡單地作為替換物使用。此外該模板知道線程綁定的會話，這個會話可以跨幾個方法使用，這在使用事務型倉庫時非常有用。
• RepositoryFactoryBean，它配置、啟動和停止倉庫實例。因為JSR-170并沒有說明倉庫配置的標準方式，需要注意實現在這個方面的不同。這個支持包含預定義的用于Jackrabbit和Jeceira的FactoryBean，以及一個可以很容易支持其它倉庫的抽象基類。
• SessionFactory，用來統一Repository，Credentials和Workspace接口，允許自動注冊監聽器和自定義名字空間。
• Spring聲明性事務為那些實現了（可選）事務特性的倉庫提供了支持。
• OpenSessionInView攔截器和過濾器允許每個線程跨不同組件使用同一會話。與JcrTemplate一起，檢索、關閉和管理JCR會話的工作已經外部化，對于調用者完全透明。

本文將使用參考實現（Jackrabbit），由于JCR模塊使用的是javax.jcr接口，因此改變實現根本就是一個配置的問題。讓我們一步一步地來看看在Jackrabbit之上如何使用Java內容倉庫，以及如何讓Spring模塊來幫助完成這一工作。

配置倉庫和SessionFactory

<bean id="repository" class="org.springmodules.jcr.jackrabbit.RepositoryFactoryBean">

<!-- normal factory beans params -->

<property name="configuration" value="classpath:jackrabbit-repo.xml"/>

<property name="homeDir" ref="./tmp/repo"/>

</bean>

JCR支持提供RepositoryFactoryBean類配置Jackrabbit，它需要JackRabbit的配置文件和主目錄。注意，RepositoryFactoryBean在使用本地文件系統時特別有用；對于服務器環境，倉庫可能被注冊在JNDI中，此時可以使用JndiObjectFactoryBean幫助類（Spring分發包的一部分）檢索它：

<bean id="repository" class="org.springframework.jndi.JndiObjectFactoryBean">

<property name="jndiName" value="java:comp/env/jcr/myRepository"/>

</bean>

或使用Spring 2.0的模式名字空間：

<jndi:lookup id="entityManagerFactory" jndi-name="jcr/myRepository"/>

為了簡化與JCR的工作，模塊增加了SessionFactory接口：

public interface SessionFactory {

public Session getSession() throws RepositoryException;

public SessionHolder getSessionHolder(Session session);

}

SessionFactory隱藏了實現內部的認證細節，因此一旦配置完成，使用同一證書的會話可以很容易的被檢索出來。為了利用實現的特性（沒有涵蓋在規范中的），這個接口允許檢索SessionHolder。它是一個JCR模塊特定類，主要被用于事務和會話管理（通過一種可用于每個JCR實現的缺省、通用實現），但是它不支持可選特性或自定義特性（如JackrabbitSessionHolder，它支持Jackrabbit的事務基礎結構）。JCR模塊提供一種簡易、透明的方式來發現SessionHolder實現（這些我將在以后詳細提到），使之很容易地插入對JSR-170其它兼容庫的支持。

SessionFactory的缺省實現是JcrSessionFactory，它要求一個進行工作的倉庫和證書。

<!-— SessionFactory -->

<bean id="jcrSessionFactory" class="org.springmodules.jcr.JcrSessionFactory">

<property name="repository" ref="repository"/>

<property name="credentials">

<bean class="javax.jcr.SimpleCredentials">

<constructor-arg index="0" value="bogus"/>

<!-- create the credentials using a bean factory -->

<constructor-arg index="1">

<bean factory-bean="password" factory-method="toCharArray"/>

</constructor-arg>

</bean>

</property>

</bean>


<!-- create the password to return it as a char[] -->

<bean id="password" class="java.lang.String">

<constructor-arg index="0" value="pass"/>

</bean>

這個bean聲明非常簡單，唯一需要注意的地方是，密碼被提供給SimpleCredential的構造函數：它只接受字符數組，使用Spring工廠聲明作為一種變通。

JcrTemplate

JcrTemplate是JCR模塊的核心類之一，它提供了與JCR會話一起工作的方便方法，將調用者從必須處理的打開和關閉會話、事務回滾（如果底層倉庫提供）、以及處理其它特性中的異常等工作中解放出來：

org.springmodules.jcr.jackrabbit.support.JackRabbitSessionHolderProvider

缺省，SessionHolderProviderManager被JcrSessionFactory內部使用，因此在工廠啟動時，任何客戶化實現可以被獲取，并與合適的倉庫一起使用。但是，通過設置JcrSessionFactory中的SessionHolderProviderManager，可以很容易的切換到一個不同的發現策略。一個可替代的發現服務是ListSessionHolderProviderManager，它接收一組提供者列表，可以方便地使用自定義提供（如測試）。

<bean id="listProviderManager" class="org.springmodules.jcr.support.ListSessionHolderProviderManager">
<property name="providers">
<list>
<bean class="org.mycompany.jcr.CustomHolderProvider"/>
<bean class="org.springmodules.jcr.jackrabbit.support.JackRabbitSessionHolderProvider"/>
<bean class="org.springmodules.jcr.support.GenericHolderProvider"/>
</list>
</property

</bean>

<bean id="jcrSessionFactory" class="org.springmodules.jcr.JcrSessionFactory">
...
<property name="sessionHolderProviderManager" ref="listProviderManager"/>

</bean>

注意，每個倉庫一個提供者。如果列表包含多個工作于同一倉庫的提供者，順序將非常重要，因為先匹配的先使用。

Java內容倉庫的未來

盡管JSR-170已經于2005年5月完成，Java內容倉庫的工作并沒有終止。JSR-283，官方的后繼者，將聚焦于功能增強，如聯邦，remoting，客戶端/服務器協議映射和擴展內容模型的能力。同時還存在著一些JSR之外的想法和項目：綁定/映射框架，它可以將java類轉換為一個JCR樹，反之亦然（類似ORM，后端用Java內容倉庫替代數據庫），建構于JCR之上的WebDAV服務器（參見Jackrabbit的捐獻包），以及其他。已經出現了用于不同產品的JSR-170連接器，如Alfresco、BEA Portal Server和IBM Domino。