9.6. 编程式事务管理

Spring Framework

previous page next page

9.6. 编程式事务管理

Spring提供两种方式的编程式事务管理：

使用 TransactionTemplate
直接使用一个 PlatformTransactionManager 实现

如果你选择编程式事务管理，Spring小组推荐使用 TransactionTemplate。第二种方法则类似使用JTA的 UserTransaction API （除了异常处理的部分稍微简单点）。

9.6.1. 使用`TransactionTemplate`

TransactionTemplate 采用与Spring中别的模板同样的方法，如 JdbcTemplate 。它使用回调机制，将应用代码从样板式的资源获取和释放代码中解放出来，这样写出的代码是目的驱动的，把精力集中在开发者想要做的事情上。

注意

就像你马上要在后面的例子中看到的那样，使用 TransactionTemplate 绝对会增加你的代码与Spring的事务框架和API间的耦合。到底编程式事务管理是不是适合你的项目需要由你自己来决定。

应用的代码必须在一个事务性的上下文中执行，这样就会像这样一样显式的使用TransactionTemplate。你作为一个应用程序员，会写一个 TransactionCallback 的实现， (通常会用匿名类来实现 )这样的实现会包含所以你需要在该事务上下文中执行的代码。然后你会把一个你自己实现TransactionCallback的实例传递给TransactionTemplate暴露的execute(..) 方法。

public class SimpleService implements Service {

  // single TransactionTemplate shared amongst all methods in this instance
  private final TransactionTemplate transactionTemplate;

  // use constructor-injection to supply the PlatformTransactionManager
  public SimpleService(PlatformTransactionManager transactionManager) {
    Assert.notNull(transactionManager, "The 'transactionManager' argument must not be null.");
    this.transactionTemplate = new TransactionTemplate(transactionManager);
  }

  public Object someServiceMethod() {
    return transactionTemplate.execute(new TransactionCallback() {

      // the code in this method executes in a transactional context
      public Object doInTransaction(TransactionStatus status) {
        updateOperation1();
        return resultOfUpdateOperation2();
      }
    });
  }
}

如果不需要返回值，更方便的方式是创建一个 TransactionCallbackWithoutResult 的匿名类，如下：

transactionTemplate.execute(new TransactionCallbackWithoutResult() {

  protected void doInTransactionWithoutResult(TransactionStatus status) {
    updateOperation1();
    updateOperation2();
  }
});

回调方法内的代码可以通过调用 TransactionStatus 对象的 setRollbackOnly() 方法来回滚事务。

transactionTemplate.execute(new TransactionCallbackWithoutResult() {

  protected void doInTransactionWithoutResult(TransactionStatus status) {
    try {
      updateOperation1();
      updateOperation2();
    } catch (SomeBusinessExeption ex) {
      status.setRollbackOnly();
    }
  }
});

9.6.1.1. 指定事务设置

诸如传播模式、隔离等级、超时等等的事务设置都可以在TransactionTemplate中或者通过配置或者编程式地实现。 TransactionTemplate实例默认继承了默认事务设置。下面有个编程式的为一个特定的TransactionTemplate定制事务设置的例子。

public class SimpleService implements Service {

  private final TransactionTemplate transactionTemplate;

  public SimpleService(PlatformTransactionManager transactionManager) {
    Assert.notNull(transactionManager, "The 'transactionManager' argument must not be null.");
    this.transactionTemplate = new TransactionTemplate(transactionManager);

    // the transaction settings can be set here explicitly if so desired
    this.transactionTemplate.setIsolationLevel(TransactionDefinition.ISOLATION_READ_UNCOMMITTED);
    this.transactionTemplate.setTimeout(30); // 30 seconds
    // and so forth...
  }
}

在下面的例子中，我们将会演示如何使用Spring XML配置来定制TransactionTemplate的事务属性。 'sharedTransactionTemplate'可以被注入到所有需要的服务中去。

<bean id="sharedTransactionTemplate"
    class="org.springframework.transaction.support.TransactionTemplate">
  <property name="isolationLevelName" value="ISOLATION_READ_UNCOMMITTED"/>
  <property name="timeout" value="30"/>
</bean>"

最后，TransactionTemplate 类的实例是线程安全的，任何状态都不会被保存。 TransactionTemplate 实例 的确会 维护配置状态，所以当一些类选择共享一个单独的 TransactionTemplate实例时，如果一个类需要使用不同配置的TransactionTemplate(比如，不同的隔离等级)，那就需要创建和使用两个不同的TransactionTemplate。

9.6.2. 使用`PlatformTransactionManager`

你也可以使用 org.springframework.transaction.PlatformTransactionManager 来直接管理你的事务。只需通过bean的引用，简单的把你在使用的PlatformTransactionManager 传递给你的bean。然后，使用TransactionDefinition和TransactionStatus对象，你可以启动，回滚和提交事务。

DefaultTransactionDefinition def = new DefaultTransactionDefinition();
// explicitly setting the transaction name is something that can only be done programmatically
def.setName("SomeTxName");
def.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRED);

TransactionStatus status = txManager.getTransaction(def);
try {
  // execute your business logic here
}
catch (MyException ex) {
  txManager.rollback(status);
  throw ex;
}
txManager.commit(status);

previous page start next page

9.6. 编程式事务管理

Spring Framework