Foxnic-SQL (11) —— DAO 特性 : 事务管理

概述

事务管理是任何一个数据层工具所必须的，Foxnic-SQL 既然是基于 Spring JDBC 的自然默认就支持 @Transactional 注解，另外 Foxnic-SQL 的 DAO 对象还支持手动事务。
本文中的示例代码均可在 https://gitee.com/LeeFJ/foxnic-samples 项目中找到。

手动事务

手动事务通过 DAO 对象的 beginTransaction() 方法、commit() 方法、rollback() 方法完成，下面是一个手动事务的例子：

public class DAO_ManualTransactionDemo {

    public static void main(String[] args) {
        demo1(true);
        demo1(false);
    }

    /**
* 1、查询不分页记录集
* */
    public static void demo1(boolean exp) {
        // 通过 DBInstance 拿到 DAO 对象
        DAO dao=DBInstance.DEFAULT.dao();
        String id = null;
        try {
            // 启动事务
            dao.beginTransaction();
            System.out.println("开始事务");
            // 插入数据
            id=insertAddress(dao,"13777-"+exp);
            if(exp) {
                throw new RuntimeException("模拟异常");
            }
            // 提交
            dao.commit();
            System.out.println("提交事务");
        } catch (Exception e) {
            // 回滚
            dao.rollback();
            System.out.println("回滚事务");
        }

        Rcd address=queryAddress(dao,id);
        if(address==null) {
            System.out.println("数据未插入");
        } else {
            System.out.println("数据已插入");
        }
    }

    /**
* 插入数据
* */
    public static String insertAddress(DAO dao,String phone) {
        // 创建语句对象
        Insert insert=new Insert("example_address");
        String id= IDGenerator.getSnowflakeIdString();
        // 设置值
        insert.set("id",id)
            .set("name","leefj")
            // 如果是 null 则不连入SQL语句
            .setIf("phone_number",phone)
            .set("address","宁波")
            .set("region_type","国内")
            .set("create_time",new Date())
            // 设置数据库表达式
            .setExpr("update_time","now()");
        // 输出语句
        System.out.println(insert.getSQL());
        // 执行语句
        Integer suc=dao.execute(insert);
        // 如果执行成功，返回ID，否则返回 null
        if(suc==1) {
            return id;
        } else {
            return null;
        }
    }

    /**
* 查询
* */
    public static Rcd queryAddress(DAO dao,String id) {
        // 创建语句对象
        Select select=new Select("example_address");
        // 设置值
        select.where().and("id=?",id);
        // 输出语句
        System.out.println(select.getSQL());
        // 执行语句
        Rcd address=dao.queryRecord(select);
        // 如果执行成功，返回记录对象，否则返回 null
        return address;
    }
}

自动事务

自动事务的前提是被注解 @Transactional 的对象需要是 Spring 容器管理的 Bean。所以自动事务通常会在 Web 应用中使用。自动事务需要首先定义数据源和事务管理器，并将两者绑定，如下代码所示：

@Configuration
    public class DatasourceConfig {

        public static final String PRIMARY_DATASOURCE_CONFIG_KEY = "spring.datasource.druid.primary";
        public static final String PRIMARY_DATA_SOURCE_NAME = "primaryDataSource";

        @Bean(name = PRIMARY_DATA_SOURCE_NAME)
        @ConfigurationProperties(PRIMARY_DATASOURCE_CONFIG_KEY)
        public DruidDataSource primaryDataSource() {
            return DruidDataSourceBuilder.create().build();
        }

        @Bean
        @Primary
        public DataSourceTransactionManager primaryTransactionManager(
            @Qualifier(PRIMARY_DATA_SOURCE_NAME) DataSource dataSource) {
            return new DataSourceTransactionManager(dataSource);
        }

    }

@Transactional注解

如果需要更高级的事务控制，则使用@Transactional注解，@Transactional 注解虽然方便地实现事务托管，但是还是有很多地方需要注意的，下面我们来了解一下在使用@Transactional注解时需要注意的点。
1、多数据源时需指定事务管理器名称；
2、Spring事务是通过ThreadLocal类来实现,所以只有主线程有事务管理，一个线程一个事务。
3、@Transactiona 注解需要事务管理器支持，若无事务管理器支持，则不生效。
4、@Transactional 注解可用于接口定义、接口方法、类定义、类public方法四个位置，非public方法事务不生效。
5、Spring事务控制是基于AOP的，请明确代理类型。proxy-target-class=true时，使用cglib的基于类的代理；proxy-target-class=false时，使用JDK的基于接口的代理。基于上述情况，@Transactional 注解建议放到类定义或类方法上。
6、如果类定义中无 @Transactional 注解，它的方法A无 @Transactional 注解，但方法B有 @Transactional 注解，此时若在同一个类中，由A调用B，则B上的事务无效。如果类定义中有@Transactional注解，则它的方法，无论有无 @Transactional 注解，事务均有效。总之，如果要使事务有效，调用时进入类的第一个类方法必须有 @Transactional 注解。
7、Spring 使用声明式事务处理，默认情况下，如果被注解的数据库操作方法中发生了 unchecked 异常(编译器不检查的异常，如 RuntimeException)，所有的数据库操作将 rollback；如果发生的异常是 checked 异常(编译器检查,需要用try cathch 捕获处理的异常,如 Exception)，默认情况下数据库操作还是会提交的。当然也可在 @Transactional 注解中指定回滚的异常类型。
下面是使用 @Transactional 事务托管的几个示例：

@Transactional(AppDAO.TRANSACTION_MANAGER)
public String te1(String act) throws Exception
{
    if(act==null) act="none";
    dao.execute("update trans set name=?  where code='119'",act+":"+System.currentTimeMillis());
    if(act.equals("checked")) {
        //事务不回滚
        throw new Exception("异常"); 
    }
    if(act.equals("unchecked")) {
        //事务回滚
        throw new RuntimeException("异常");
    }
    return "OK";
}

变更默认的回滚异常，指定回滚或不回滚的异常类型：

@Transactional(transactionManager=AppDAO.TRANSACTION_MANAGER,rollbackFor= {Exception.class},noRollbackFor= {RuntimeException.class})
public String te2(String act) throws Exception
{
    if(act==null) act="none";
    dao.execute("update trans set name=?  where code='119'",act+":"+System.currentTimeMillis());
    if(act.equals("checked")) {
        //事务回滚
        throw new Exception("异常");
    }
    if(act.equals("unchecked")) {
        //事务不回滚
        throw new RuntimeException("异常");
    }
    return "OK";
}

事务传播

Spring 的事务的传播行为，默认值为 Propagation.REQUIRED。可选的值有：
1、Propagation.REQUIRED：如果当前存在事务，则加入该事务，如果当前不存在事务，则创建一个新的事务。
2、Propagation.SUPPORTS：如果当前存在事务，则加入该事务；如果当前不存在事务，则以非事务的方式继续运行。
3、Propagation.MANDATORY：如果当前存在事务，则加入该事务；如果当前不存在事务，则抛出异常。
4、Propagation.REQUIRES_NEW：重新创建一个新的事务，如果当前存在事务，暂停当前的事务。
5、Propagation.NOT_SUPPORTED：以非事务的方式运行，如果当前存在事务，暂停当前的事务。
6、Propagation.NEVER：以非事务的方式运行，如果当前存在事务，则抛出异常。
7、Propagation.NESTED：和 Propagation.REQUIRED 效果一样。

事务隔离

isolation 属性，事务的隔离级别，默认值为 Isolation.DEFAULT。可选的值有：
1、Isolation.DEFAULT：使用底层数据库默认的隔离级别。MYSQL：默认为 REPEATABLE_READ 级别；SQLSERVER：默认为 READ_COMMITTED 级别；Oracle：默认为 READ_COMMITTED 级别。
2、Isolation.READ_UNCOMMITTED
3、Isolation.READ_COMMITTED
4、Isolation.REPEATABLE_READ
5、Isolation.SERIALIZABLE

其它参数

1、timeout 属性：事务的超时时间，默认值为-1。如果超过该时间限制但事务还没有完成，则自动回滚事务。
2、readOnly 属性：指定事务是否为只读事务，默认值为 false；为了忽略那些不需要事务的方法，比如读取数据，可以设置 read-only 为 true。

小结

本节主要介绍了在 Foxni-SQL 中的事务管理，包括了手动事务个 Spring 托管的自动事务。在使用自动事务时要注意本文中提到的针对 @Transactional 注解使用的注意事项。

官方文档

http://foxnicweb.com/docs/doc.html

Foxnic-SQL (11) —— DAO 特性 : 事务管理