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