spring對ibatis整合事務採用spring代理類

Spring對IBatis提供了完善的內建支援。使用Spring提供的IBatis輔助類，可以大大簡化原有的IBatis訪問程式碼。這些輔助類位於org.springframework.orm.ibatis包下，目前Spring可同時支援IBatis1.3.x和2.0。 此外，針對IBatis，Spring也提供了和JdbcTemplate一致的異常處理方式

10.3.1 標準JavaBean實體和對映
     Spring寵物店非常典型的展現了Spring和IBatis的整合，下文將圍繞寵物店展開介紹。
首先來看寵物店中的一個領域物件（它是一個標準的JavaBean）和它的對映檔案，如程式碼10.13~10.14所示。

程式碼10.13 Product.java（JavaBean）
public class Product implements Serializable {
  private String productId;
  private String categoryId;
  private String name;
  private String description;

  省略getter/setter...
}

程式碼10.14 Product.xml（對映檔案）
<sqlMap namespace="Product">
  ...
  <resultMap id="result"class="org.springframework.samples.jpetstore.domain.Product">
    <result property="productId" column="productid"columnIndex="1"/>
    ...
  </resultMap>
  <select id="getProduct" resultMap="result">
    select productid, name, descn, category from product whereproductid = #value#
  </select>
  <select id="getProductListByCategory"resultMap="result">
    select productid, name, descn, category from product wherecategory = #value#
  </select>
    ...
</sqlMap>

10.3.2  銜接IBatis配置和DAO實現
     接著給出IBatis的基本配置檔案，如程式碼10.15所示。

程式碼10.15 sql-map-config.xml（配置檔案）
<sqlMapConfig>
  ...
  <sqlMap resource="org/springframework/samples/jpetstore/dao/ibatis/maps/Product.xml"/>
  ...
</sqlMapConfig>
     在寵物店中，該檔案僅包含了所有領域物件的對映檔案，而挪走了關於IBatis的事務和資料來源配置（即IBatis配置檔案中的transactionManager元素和它的子元素dataSource）。
     注意：在稍後將要給出的Spring配置檔案中接手了這些配置，這是一個整合點。

     在寵物店中，持久和資料訪問都是通過DAO來實現的。對於Product，存在一個與其對應的SqlMapProductDao，如程式碼10.16所示。
程式碼10.16 SqlMapProductDao.java
package org.springframework.samples.jpetstore.dao.ibatis;
import java.util.ArrayList;
import java.util.List;
import java.util.StringTokenizer;
import org.springframework.dao.DataAccessException;
import org.springframework.orm.ibatis.support.SqlMapClientDaoSupport;
import org.springframework.samples.jpetstore.dao.ProductDao;
import org.springframework.samples.jpetstore.domain.Product;

public class SqlMapProductDao extends SqlMapClientDaoSupport implementsProductDao {
  public List getProductListByCategory(String categoryId) throwsDataAccessException {
    returngetSqlMapClientTemplate().queryForList("getProductListByCategory",categoryId);
  }
  public Product getProduct(String productId) throws DataAccessException {
    return (Product)getSqlMapClientTemplate().queryForObject("getProduct", productId);
  }
  ...
}
     上述程式碼中出現了Spring提供的IBatis DAO支援類和獲取SqlMapClientTemplate的父類别範本方法，這和JdbcDaoSupport及JdbcTemplate的使用具有一致的概念。並且，這些操作都統一的丟擲Spring的通用資料訪問異常DataAccessException。
注意：在早期的IBatis1.3.x版本中Dao支援類和模板類分別被命名為SqlMapDaoSupport和SqlMapTemplate，在使用時不要混淆。

10.3.3  關鍵整合點：Spring配置檔案
有了以上的DAO元件後，來看一下Spring的配置，這是一個關鍵的整合點，如程式碼10.17所示。
程式碼10.17 dataAccessContext-local.xml（Spring配置檔案）
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd">
<beans>

  <!-- 相關資料來源和事務管理的定義 -->
  <bean id="dataSource"class="org.apache.commons.dbcp.BasicDataSource"destroy-method="close">
    <property name="driverClassName"value="${jdbc.driverClassName}"/>
    <property name="url"value="${jdbc.url}"/>
    <property name="username"value="${jdbc.username}"/>
    <property name="password"value="${jdbc.password}"/>
  </bean>

  <!-- Transaction manager for a single JDBCDataSource -->
  <bean id="transactionManager"
  class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource"ref="dataSource"/>
  </bean>

  <!-- Spring提供的iBatis的SqlMap配置-->
  <bean id="sqlMapClient"
class="org.springframework.orm.ibatis.SqlMapClientFactoryBean">
    <property name="configLocation"value="WEB-INF/sql-map-config.xml"/>
    <property name="dataSource"ref="dataSource"/>
  </bean>

  <!-- DAO定義-->
  ...
  <bean id="productDao"class="org.springframework.samples.jpetstore.dao.ibatis.SqlMapProductDao">
    <property name="sqlMapClient" ref="sqlMapClient"/>
  </bean>
  ...
</beans>

     可以發現，Spring在上述檔案中分別配置了資料來源和事務管理的策略，其中挪去了原先在IBatis檔案中的配置。
說明：這樣做的好處是可以通過Spring IoC容器統一的管理資源，在稍後還可以看到，Spring提供的宣告性事務管理就是藉助於統一的資料來源和事務管理配置。
SqlMapClientFactoryBean又是一個工廠bean，它暴露了兩個關鍵屬性用於注射IBatis配置檔案和相關的資料來源。在工廠內部，通過讀取IBatis配置檔案，Spring會建立出IBatis的核心元件SqlMapClient，並向相關的DAO進行注射。
SqlMapProductDao繼承了SqlMapClientDaoSupport，後者暴露出一個sqlMapClient屬性，用於接受Spring的注射。SqlMapClientDaoSupport會對其中封裝的SqlMapClientTemplate做相應的設定，所以DAO子類便可在取用SqlMapClientTemplate時正常地工作了。

10.3.4  新增宣告式事務管理
以上的IBatisDAO可以很自方便地被注射到相應的業務物件，並參與到Spring提供的宣告性事務中，配置如程式碼10.18所示。
程式碼10.18  applicationContext.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN"
"http://www.springframework.org/dtd/spring-beans.dtd">
<beans>

  <!-- 通用屬性檔案定義 -->
  <bean id="propertyConfigurer"class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
    <property name="locations">
      <list>
         ...
       <value>WEB-INF/jdbc.properties</value>
      </list>
    </property>
  </bean>

  <!-- 業務物件定義 -->
  ...
  <bean id="baseTransactionProxy"class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean"abstract="true">
    <property name="transactionManager" ref="transactionManager"/>
    <property name="transactionAttributes">
      <props>
        <propkey="insert*">PROPAGATION_REQUIRED</prop>
        <propkey="update*">PROPAGATION_REQUIRED</prop>
        <propkey="*">PROPAGATION_REQUIRED,readOnly</prop>
      </props>
    </property>
  </bean>
  <bean id="petStore"parent="baseTransactionProxy">
    <property name="target">
      <bean class="org.springframework.samples.jpetstore.domain.logic.PetStoreImpl">
       ...
       <property name="productDao"ref="productDao"/>
        ...
      </bean>
  </bean>
</beans>