走在架構師的大道上 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模塊主要的擴展點。