Spring JDBC事务管理

JDBC事务管理

    Spring提供编程式的事务管理（Programmatic transaction manage- ment）与声明式的事务管理（Declarative transaction management），为不同的事务实现提供了一致的编程模型，这节以JDBC事务为例，介绍Spring的事务管理。

    5.3.1 Spring对事务的支持

    事务是一组原子（Atomic）操作的工作单元，以数据库存取的实例来说，就是一组SQL指令，这一组SQL指令必须全部执行成功，若因为某个原因未全部执行成功（例如其中一行SQL有错误），则先前所有执行过的SQL指令都会被撤消。

    举个简单的例子，一个客户从A银行转账至B银行，要作的动作为从A银行的账户扣款、在B银行的账户加上转账的金额，两个动作必须成功，如果有一个动作失败，则此次转账失败。

    事务还必须保持所参与资源的一致性（Consistent），例如在银行账户的例子中，两个账户的转账金额，B账户取款的金额不能大于A账户的存款金额。 每个事务彼此之间必须是隔离的（Isolated），例如在A账户中可能有两笔事务，同时进行存款与提款的动作，两个事务基本上不需意识到彼此的存在。事 务还必须是可持续的（Durable），在某一笔事务之后，这笔事务必须是被记录下来的。

    在这里将介绍JDBC如何使用事务管理。首先来看看事务的原子性实现，在JDBC中，可以操作Connection的setAutoCommit（） 方法，给定false参数，在下达一连串的SQL语句后，自行执行Connection的commit（）来送出变更，如果中间发生错误，则执行 rollback（） 来撤消所有的执行，例如：

 

try {        . . . . .        connection . setAutoCommit ( false) ;        . . . . .         // 一连串SQL操作        connection . commit ( ) ;    } catch ( SQLException ) {         // 发生错误，撤消所有变更        connection . rollback ( ) ;    }

    在Spring中对JDBC的事务管理加以封装，Spring事务管理的抽象关键在于org.springframework.transaction.PlatformTransactionManager接口的实现：

 

public interface PlatformTransactionManager {        TransactionStatus getTransaction( TransactionDefinition                        definition) throws TransactionException;        void commit ( TransactionStatus status )                                       throws TransactionException;        void rollback ( TransactionStatus status )                                       throws TransactionException;    }

    PlatformTransactionManager 接口有许多具体的事务实现类，例如DataSourceTransactionManager、 HibernateTransactionManager、JdoTransaction- Manager、JtaTransactionManager等，通过依赖于PlatformTransactionManager接口及各种的技术实 现，Spring在事务管理上可以让开发人员使用一致的编程模型，即使所使用的是不同的事务管理技术。

    TransactionException是Unchecked Exception.事务的失败通常都是致命的错误，Spring不强迫您一定要处理，而是让您自行选择是否要捕捉异常。

    getTransaction（） 方法根据一个TransactionDefinition对象来回传一个TransactionStatus对 象，TransactionDefinition接口的实例定义了事务的隔离程度（Isolation level）、传播行为（Propagation behavior）、超时（Timeout）、只读（Read-only）等，TransactionStatus代表着一个新的事务发起或已经存在的事 务，您可以通过它来控制事务的执行或调查的状态：

 

public interface TransactionStatus {        boolean isNewTransaction( ) ;        void setRollbackOnly( ) ;        boolean isRollbackOnly( ) ;    }

 

Spring提供编程式的事务管理（Programmatic transaction management）与声明式的事务管理（Declarative transaction management）：

    l 编程式的事务管理

    编程式的事务管理可以清楚地控制事务的边界，也就是让您自行实现事务开始时间、撤消操作的时机、结束时间等，可以实现细粒度的事务控制。

    l 声明式的事务管理

    然而多数的情况下，事务并不需要细粒度的控制，而是采用声明式的事务管理，好处是Spring事务管理的相关API可以不用介入程序之中，从对象的角度来 看，它并不知道自己正被纳入事务管理之中，在不需要事务管理的时候，只要在设置文件上修改一下设置，即可移去事务管理服务。

    5.3.2 JDBC编程事务管理Spring提供两种方式实现编程式的事务管理，一是直接使用PlatformTransaction- Manager实现，二是使用org.springframework.transaction.support.Transaction- Template.

    先来看看如何使用PlatformTransactionManager，在这里使用它的实现类 DataSourceTransactionManager，可以改写一下之前5.2.1节中的JdbcTemplateDemo项目，让它具有事务管理 功能，修改一下UserDAO类的insert（） 方法来作示范：ProgrammaticTransactionDemo UserDAO.java

 

package onlyfun. caterpillar;
  
import java . util . Iterator ;
  
import java . util . List ;
  
import java . util . Map ;
  
import javax . sql . DataSource ;
  
import org . springframework. dao. DataAccessException;
  
import org . springframework. jdbc. core. JdbcTemplate;
  
import org . springframework. jdbc.
  
            datasource . DataSourceTransactionManager;
  
import org . springframework. transaction . TransactionDefinition;
  
import org . springframework. transaction . TransactionStatus;
  
import org . springframework. transaction .
  
            support. DefaultTransactionDefinition;
  
public class UserDAO implements IUserDAO {
  
    private DataSourceTransactionManager transactionManager;
  
    private DefaultTransactionDefinition def;
  
    private JdbcTemplate jdbcTemplate;
  
       
  
    public void setDataSource( DataSource dataSource ) {
  
        jdbcTemplate = new JdbcTemplate( dataSource ) ;
  
        transactionManager =
  
            new DataSourceTransactionManager( dataSource ) ;
  
         // 建立事务的定义

  
        def = new DefaultTransactionDefinition( ) ;
  
        def. setPropagationBehavior(
  
                TransactionDefinition. PROPAGATION_REQUIRED) ;
  
    }
  
       
  
    public void insert ( User user) {
  
       String name = user. getName ( ) ;
  
       int age = user. getAge( ) . intValue ( ) ;
  
          
  
       TransactionStatus status =
  
           transactionManager. getTransaction( def) ;
  
       try {
  
           jdbcTemplate. update ( "INSERT INTO user (name,age) "
  
                   + "VALUES('" + name + "'," + age + ")" ) ;
  
            // 下面的SQL有错误，用以测试 事务

  
           jdbcTemplate. update ( "INSER INTO user (name,age) "
  
                   + "VALUES('" + name + "'," + age + ")" ) ;
  
       }
  
       catch ( DataAccessException e) {
  
           transactionManager. rollback ( status ) ;
  
           throw e;
  
       }
  
       transactionManager. commit ( status ) ;
  
    }
  
    public User find ( Integer id ) {
  
        List rows = jdbcTemplate. queryForList(
  
          "SELECT * FROM user WHERE id=" + id . intValue ( ) ) ;
  
           
  
        Iterator it = rows. iterator ( ) ;
  
        if ( it. hasNext ( ) ) {
  
            Map userMap = ( Map ) it. next ( ) ;
  
            Integer i = new Integer (
  
                    userMap. get ( "id" ) . toString ( ) ) ;
  
            String name = userMap. get ( "name" ) . toString ( ) ;
  
            Integer age = new Integer (
  
                    userMap. get ( "age" ) . toString ( ) ) ;
  
            User user = new User( ) ;
  
               
  
            user. setId ( i) ;
  
            user. setName ( name ) ;
  
            user. setAge( age) ;
  
               
  
            return user;
  
        }
  
        return null ;
  
    }
  
}

在 insert（）方法中使用了DataSourceTransactionManager来进行事务管理，如果发生了异常，则catch区块中会进行事务 的Rollback，在insert（） 方法中故意写入错误的SQL（注意INSERT方法少写了一个T），因此实际上数据并不会被储存至数据库中。

    要使用MySQL数据库进行事务处理，必须建立支持事务的表格类型，例如InnoDB的表格类型，这里用来建立表格的SQL如下所示：

 

CREATE TABLE user (        id INT( 11) NOT NULL auto_increment PRIMARY KEY ,        name VARCHAR ( 100) NOT NULL default '' ,        age INT    ) TYPE = InnoDB;

    另一个实现编程式事务管理的方法是使用TransactionTemplate，它需要一个TransactionManager实例，如下所示：

 

TransactionTemplate transactionTemplate =            new TransactionTemplate( transactionManager) ;    . . .    transactionTemplate. execute ( new TransactionCallback( ) {        public Object doInTransaction( TransactionStatus status ) {             return jdbcTemplate. update ( "INSERT INTO user (name,age) "                   + "VALUES('" + name + "'," + age + ")" ) ;        }    } ) ;

    如果发生了异常，则会进行Rollback，否则提交事务，如果没有回传值，则也可以使用TransactionCallbackWithoutResult：

 

transactionTemplate. execute (            new TransactionCallbackWithoutResult( ) {                    public void doInTransactionWithoutResult(                                    TransactionStatus status ) {                . . . .                    }                } ) ;

    5.3.3 JDBC声明事务管理

    Spring声明式的事务管理依赖它的AOP框架来完成。使用声明事务管理的好处是，事务管理不能侵入您所开发的组件，具体来说，DAO对象不会意识到正 在事务管理之中，事实上也应当如此，因为事务管理是属于系统层面的服务，而不是业务逻辑的一部分，如果想要改变事务管理策略的话，也只需要在定义文件中重 新配置。

    举个例子来说，可以将5.2.1节中的JdbcTemplateDemo 项目修改一下，在不修改UserDAO类的情况下，可以为它加入事务管理的服务，一个简单的方法是使用 TransactionProxyFactoryBean，指定要介入的事务管理对象及其方法，这需要在定义文件中修改，如下所示：

    DeclarativeTransactionDemo beans-config.xml

 

< ? xml version = "1.0" encoding = "UTF-8" ? >    < beans xmlns= "http://www.springframework.org/schema/beans"      xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"      xsi:schemaLocation= "http://www.springframework.org/schema/beans      http://www.springframework.org/schema/beans/spring-beans-2.0.xsd" >                 < bean id= "dataSource"              class= "org.springframework.jdbc.                       → datasource.DriverManagerDataSource"              destroy-method= "close" >            < property name= "driverClassName"                      value= "com.mysql.jdbc.Driver" / >            < property name= "url"                      value= "jdbc:mysql://localhost:3306/demo" / >            < property name= "username" value= "caterpillar" / >            < property name= "password" value= "123456" / >        < / bean>                   < bean id= "transactionManager"              class= "org.springframework.jdbc.                       → datasource.DataSourceTransactionManager" >            < property name= "dataSource" ref= "dataSource" / >        < / bean>                   < bean id= "userDAO"              class= "onlyfun.caterpillar.UserDAO" >            < property name= "dataSource" ref= "dataSource" / >        < / bean>                   < bean id= "userDAOProxy"              class= "org.springframework.transaction.                       → interceptor.TransactionProxyFactoryBean" >            < property name= "proxyInterfaces" >                < list>                    < value> onlyfun. caterpillar. IUserDAO< / value>                < / list>            < / property>            < property name= "target" ref= "userDAO" / >            < property name= "transactionManager"                      ref= "transactionManager" / >            < property name= "transactionAttributes" >                < props>                    < prop key= "insert*" > PROPAGATION_REQUIRED< / prop>                < / props>            < / property>        < / bean>    < / beans>

    TransactionProxyFactoryBean需要一个TransactionManager，由于这里使用的是JDBC，所以使用 DataSourceTransactionManager，TransactionProxyFactoryBean是个代理对象，"target" 属性指定要代理的对象，事务管理会自动介入指定的方法前后，这里使用 "transactionAttributes" 属性指定，"insert*" 表示指定方法名称以insert开头的都要纳入事务管理，您也可以指定方法全名，如果在方法执行过程中发生错误，则所有先前的操作自动撤回，否则正常提 交。

在"insert*" 等方法上指定了 "PROPAGATION_REQUIRED"，表示在目前的事务中执行操作，如果事务不存在就建立一个新的，相关的常数意义都可以在API文件的 TransactionDefinition接口中找到。您可以加上多个事务定义，中间使用逗号 "，" 区隔，例如可以加上只读，或者是指定某个异常发生时撤回操作：

    PROPAGATION_REQUIRED，readOnly，-MyCheckedException

    MyCheckedException前面加上 "-" 时，表示发生指定异常时撤消操作，如果前面加上 "+"，表示发生异常时立即提交。

    由于"userDAO"被"userDAOProxy"代理了，所以要做的是取得"userDAOProxy"，而不是"userDAO"，例如：

    DeclarativeTransactionDemo SpringDAODemo.java

 

package onlyfun. caterpillar;    import org . springframework. context . ApplicationContext;    import org . springframework. context .                  support. ClassPathXmlApplicationContext;    public class SpringDAODemo {        public static void main( String [ ] args) {            ApplicationContext context =                new ClassPathXmlApplicationContext(                        "beans-config.xml" ) ;                           User user = new User( ) ;                           user. setName ( "caterpillar" ) ;            user. setAge( new Integer ( 30) ) ;                           IUserDAO userDAO =                ( IUserDAO) context . getBean( "userDAOProxy" ) ;                           userDAO. insert ( user) ;                           user = userDAO. find ( new Integer ( 1) ) ;                           System . out. println ( "name: " + user. getName ( ) ) ;        }    }

    您也可以设置不同的TransactionInterceptor来得到更多的管理细节，例如：

 

< ? xml version = "1.0" encoding = "UTF-8" ? >    < beans xmlns= "http://www.springframework.org/schema/beans"      xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"      xsi:schemaLocation= "http://www.springframework.org/schema/beans      http://www.springframework.org/schema/beans/spring-beans-2.0.xsd" >                 < bean id= "dataSource"              class= "org.springframework.jdbc.                       → datasource.DriverManagerDataSource"              destroy-method= "close" >            < property name= "driverClassName"                      value= "com.mysql.jdbc.Driver" / >            < property name= "url"                      value= "jdbc:mysql://localhost:3306/demo" / >            < property name= "username" value= "caterpillar" / >            < property name= "password" value= "123456" / >        < / bean>        < bean id= "transactionManager"              class= "org.springframework.jdbc.                       → datasource.DataSourceTransactionManager" >            < property name= "dataSource" ref= "dataSource" / >        < / bean>                   < bean id= "userDAO"              class= "onlyfun.caterpillar.UserDAO" >            < property name= "dataSource" ref= "dataSource" / >        < / bean>        < bean id= "transactionInterceptor"              class= "org.springframework.transaction.                       → interceptor.TransactionInterceptor" >            < property name= "transactionManager" ref= "transactionManager" / >            < property name= "transactionAttributeSource"                      value= "onlyfun.caterpillar.UserDAO.insert*=                                → PROPAGATION_REQUIRED " / >        < / bean>                   < bean id= "userDAOProxy"              class= "org.springframework.aop.                       → framework.ProxyFactoryBean" >            < property name= "proxyInterfaces" >                < list>                    < value> onlyfun. caterpillar. IUserDAO< / value>                < / list>            < / property>            < property name= "target" ref= "userDAO" / >            < property name= "interceptorNames" >                < list>                    < value> transactionInterceptor< / value>                < / list>            < / property>        < / bean>

    同样的，由于不再于设置文件中设置代理对象，所以直接取得"userDAO"实例进行操作即可。