走在架构师的大道上 Jack.Wang's home

这个bean声明非常简单，唯一需要注意的地方是，密码被提供给SimpleCredential的构造函数：它只接受字符数组，使用Spring工厂声明作为一种变通。

JcrTemplate

JcrTemplate是JCR模块的核心类之一，它提供了与JCR会话一起工作的方便方法，将调用者从必须处理的打开和关闭会话、事务回滚（如果底层仓库提供）、以及处理其它特性中的异常等工作中解放出来：

<bean id="jcrTemplate" class="org.springmodules.jcr.JcrTemplate">

    <property name="sessionFactory" ref="jcrSessionFactory"/>

    <property name="allowCreate" value="true"/>

</bean>

模板定义非常简单，类似来自Spring框架的其它模板类，如HibernateTemplate。

例子

public Node importFile(final Node folderNode, final File file, final String mimeType,

final String encoding) {



return (Node) execute(new JcrCallback() {

           

/**

* @see org.springmodules.jcr.JcrCallback#doInJcr(javax.jcr.Session)

*/

public Object doInJcr(Session session) throws

RepositoryException, IOException {

  

       

JcrConstants jcrConstants = new JcrConstants(session);

       

//create the file node - see section 6.7.22.6 of the spec

Node fileNode = folderNode.addNode(file.getName(),

jcrConstants.getNT_FILE());

 

//create the mandatory child node - jcr:content

Node resNode = fileNode.addNode(jcrConstants.getJCR_CONTENT(),

jcrConstants.getNT_RESOURCE());

   

    	resNode.setProperty(jcrConstants.getJCR_MIMETYPE(), mimeType);

    resNode.setProperty(jcrConstants.getJCR_ENCODING(), encoding);

resNode.setProperty(jcrConstants.getJCR_DATA(), new FileInputStream(file));

Calendar lastModified = Calendar.getInstance();

lastModified.setTimeInMillis (file.lastModified ());

resNode.setProperty(jcrConstants.getJCR_LASTMODIFIED(), lastModified);

             

session.save();

             

return resNode;

}

});

}

主要区别是：代码被包装在一个JCR模板中，它将我们从不得不使用的try/catch语句块（因为IO和Repository的需检查异常）和处理会话（和事务，如果有的话）清除工作中解放出来。值得提及的是硬编码字符串，如“jcr:data”，是通过JcrConstants工具类解析出来的。它知道名字空间的前缀变化，并提供一种干净的方式处理JCR常数。正如你看到的，我只是使例子更加健壮，但是对于实际业务代码影响最小。

事务支持

使用JCR模块的一个好处就是能将Spring事务基础设施（包括声明性和编程性）应用于Java内容仓库。JSR 170将事务支持视为可选特性，并没有强制一个标准的方式来暴露事务钩子，因此每个实现可以选择不同的方法。在本文撰写时，只有Jackrabbit支持事务（在它的大部分操作中），它通过为每个JcrSession暴露一个javax.transaction.XAResource做到这一点。JCR模块提供LocalTransactionManager用于本地事务：

<bean id="jcrTransactionManager" class="org.springmodules.jcr.jackrabbit.LocalTransactionManager">

<property name="sessionFactory" ref="jcrSessionFactory"/>

</bean>

为了声明事务划分，我与上述事务管理器bean声明一起使用标准Spring类：

<!-- transaction proxy for Jcr services/facades -->

<bean id="txProxyTemplate" abstract="true" class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean">

<property name="proxyTargetClass">

        <value>true</value>

     </property>

     <property name="transactionManager" ref="jcrTransactionManager"/>

     <property name="transactionAttributes">

       <props>

        <prop key="save*">PROPAGATION_REQUIRED</prop>

        <prop key="*">PROPAGATION_REQUIRED, readOnly</prop>

       </props>

     </property>

</bean>

<bean id="jcrService" parent="txProxyTemplate">

    <property name="target">

        <bean class="org.springmodules.examples.jcr.JcrService">

            <property name="template" ref="jcrTemplate"/>

        </bean>

    </property>

</bean>

TransactionAwareRepository

对于要求普通JCR代码的应用程序，JCR模块允许用直接使用JCR API的代码，透明地使用事务驱动会话。 此时，可以使用TransactionAwareRepository，它有一个参数是JcrSessionFactory。这样，在使用Session.login()（它接收定义在JcrSessionFactory中的参数）创建任何新会话时，如果发现有线程绑定的会话，就将返回它。注意：如果使用事务，JCR会话就是事务性的，否则你必须手动设置属性allowNonTxRepository为true，配置如下，要不然将抛出一个异常：

<bean id="transactionRepository" class="org.springmodules.jcr.TransactionAwareRepository">

     <property name="allowNonTxRepository" value="true"/>

     <property name="targetFactory" ref="jcrSessionFactory"/>

</bean>

transactionRepositorybean可以被用作一个普通的JCR仓库，不关心底层机制或线程绑定会话、事务性或非事务性（如果有事务，关闭会话时要提交事务）。

可选特性支持侦测

为了最大化代码重用，但仍然允许插入可选特性，如用于不同JCR实现的事务支持，JCR模块使用SessionHolder接口（前面已经提到），同时还有SessionHolderProvider和SessionHolderProviderManager接口。用户一般不用与它们打交道，因为它们是框架内部使用的；但是，它们代表了JCR模块主要的扩展点。