事务管理

Jmix 支持 Spring 应用程序中两种标准的事务控制方法：声明式（通过注解）和编程式。

声明式事务管理

Jmix 应用程序中最直接的事务管理方法是使用 @org.springframework.transaction.annotation.Transactional 注解。这个注解表示一个方法必须在一个数据库事务中运行。当该注解用在类级别时，@Transactional 应用在其本身和子类的所有方法中。

@Transactional 注解会在方法调用时自动创建一个事务，事务的提交和回滚由 Spring 管理。因此，声明式的事务管理可以减少样板代码的数量。

有许多参数可以优化 @Transactional 的行为，例如，隔离级别（isolation level）或传播特性（propagation），这些参数请参考 Spring 文档。

使用 @Transactional 在单一事务中更新多个实体的示例：

@Transactional (1)
public void makeDiscountsForAll() {
    List<Order> orders = dataManager.load(Order.class)
            .query("select o from sample_Order o where o.customer is not null")
            .list();
    for (Order order : orders) {
        BigDecimal newTotal = orderService.calculateDiscount(order);
        order.setAmount(newTotal);
        dataManager.save(order);
        Customer customer = customerService.updateCustomerGrade(order.getCustomer());
        dataManager.save(customer);
    }
}
1 只需添加注解，Spring 会自动处理：创建代理并注入事务逻辑，启动方法前开始事务，方法完成后提交或回滚事务。
请记住，声明式的事务标记仅在方法是通过将实例注入其他 bean 中或者通过 ApplicationContext.getBean() 获取实例调用才会生效，即通过容器创建的代理执行。从同一个对象内的另一个方法调用带注解的方法时，不会开启新的事务。

如需为 附加数据存储 声明一个事务，需要在 @Transactional 注解中指定数据存储的事务管理（Transaction Manager）的名称。如果数据存储是通过 Studio 创建的，则事务管理 bean 的名称是 <DATA-STORE-NAME>TransactionManager。例如，如果数据存储名称为 db1，则定义为：

@Transactional("db1TransactionManager")
public void makeChangesInDb1DataStore() {
    // ...
}

编程式事务管理

对于编程式事务管理，Spring 提供了 org.springframework.transaction.support.TransactionTemplate 类。

创建 TransactionTemplate

如需创建 TransactionTemplate 的实例，可以在主应用程序类（带 @SpringBootApplication 注解的类）中声明一个 bean，用一个 PlatformTransactionManager 初始化：

@Bean
@Primary
TransactionTemplate transactionTemplate(PlatformTransactionManager transactionManager) {
    return new TransactionTemplate(transactionManager);
}

现在可以在应用程序中的任何 bean 中注入 TransactionTemplate：

@Autowired
private TransactionTemplate transactionTemplate;

如果有附加数据存储，那么也需要为其创建 TransactionTemplate 实例。如果是通过 Studio 创建的附加数据存储，则会自动创建该数据存储的 Spring 配置类，其中已经有一些 bean 了。添加一个新的 bean，使用 Qualifier 创建 TransactionTemplate：

@Bean
TransactionTemplate db1TransactionTemplate(
        @Qualifier("db1TransactionManager") (1)
        PlatformTransactionManager transactionManager) {
    return new TransactionTemplate(transactionManager);
}
1 @Qualifier 注解用于使用 bean 名称注入特殊的 bean：这里，我们注入为附加数据存储 db1 定义的 PlatformTransactionManager。

然后，可以用 Qualifier 注解注入需要的 TransactionTemplate 来管理附加数据存储的事务：

@Autowired
@Qualifier("db1TransactionTemplate") (1)
private TransactionTemplate db1TransactionTemplate;
1 这里，@Qualifier 注解支持 Spring 选取我们上面为 db1 数据存储定义的 bean。

如果不希望 TransactionTemplate 在项目全局可用，也可以使用 PlatformTransactionManager 本地创建。下面示例展示创建两个不同传播行为的事务模板：

@Autowired
private PlatformTransactionManager transactionManager;

// joins existing transaction
public TransactionTemplate getTransactionTemplate() {
    return new TransactionTemplate(transactionManager);
}

// always creates new transaction
public TransactionTemplate getRequiresNewTransactionTemplate() {
    TransactionTemplate tt = new TransactionTemplate(transactionManager);
    tt.setPropagationBehavior(TransactionDefinition.PROPAGATION_REQUIRES_NEW);
    return tt;
}

使用 TransactionTemplate

使用 execute() 方法在一个事务内运行代码块。这个方法能处理事务的生命周期和可能产生的异常，因此，无需手动处理：

public UUID createOrderAndReturnId() {
    return transactionTemplate.execute(status -> {
        Customer customer = dataManager.create(Customer.class);
        customer.setName("Alice");
        customer = dataManager.save(customer);

        Order order = dataManager.create(Order.class);
        order.setCustomer(customer);

        order = dataManager.save(order);
        return order.getId();
    });
}

如果不需要从事务代码块中返回任何结果，可以使用 executeWithoutResult() 方法，这个方法也是从 execute() 派生的，但使用 TransactionCallbackWithoutResult 回调接口：

public void createOrder() {
    transactionTemplate.executeWithoutResult(status -> {
        Customer customer = dataManager.create(Customer.class);
        customer.setName("Alice");
        customer = dataManager.save(customer);

        Order order = dataManager.create(Order.class);
        order.setCustomer(customer);

        dataManager.save(order);
    });
}

默认的 事务配置，例如传播模式、隔离级别、超时等，可以用 TransactionTemplate 的 setters 自定义。