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

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 注解使用的注意事项。

相关项目

  https://gitee.com/LeeFJ/foxnic
  https://gitee.com/LeeFJ/foxnic-web
  https://gitee.com/lank/eam
  https://gitee.com/LeeFJ/foxnic-samples

官方文档

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

你可能感兴趣的:(后端数据库sql事务管理dao)