MyBatis6:MyBatis集成Spring事物管理(下篇)

时间:2023-03-08 16:06:12

前言

前一篇文章《MyBatis5:MyBatis集成Spring事物管理(上篇)》复习了MyBatis的基本使用以及使用Spring管理MyBatis的事物的做法,本文的目的是在这个的基础上稍微做一点点的进阶:多数据的事物处理。文章内容主要包含两方面:

1、单表多数据的事物处理

2、多库/多表多数据的事物处理

这两种都是企业级开发中常见的需求,有一定的类似,在处理的方法与技巧上又各有不同,在进入文章前,先做一些准备工作,因为后面会用到多表的插入事物管理,前面的文章建立了一个Student相关表及类,这里再建立一个Teacher相关的表及类。第一步是建立一张Teacher表:

create table teacher
(
teacher_id int auto_increment,
teacher_name varchar(20) not null,
primary key(teacher_id)
)

建立teacher_mapper.xml:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" > <mapper namespace="TeacherMapper">
<resultMap type="Teacher" id="TeacherMap">
<id column="teacher_id" property="teacherId" jdbcType="INTEGER" />
<result column="teacher_name" property="teacherName" jdbcType="VARCHAR" />
</resultMap> <select id="selectAllTeachers" resultMap="TeacherMap">
select teacher_id, teacher_name from teacher;
</select> <insert id="insertTeacher" useGeneratedKeys="true" keyProperty="teacher_id" parameterType="Teacher">
insert into teacher(teacher_id, teacher_name) values(null, #{teacherName, jdbcType=VARCHAR});
</insert>
</mapper>

建立Teacher.java:

public class Teacher
{
private int teacherId;
private String teacherName; public int getTeacherId()
{
return teacherId;
} public void setTeacherId(int teacherId)
{
this.teacherId = teacherId;
} public String getTeacherName()
{
return teacherName;
} public void setTeacherName(String teacherName)
{
this.teacherName = teacherName;
} public String toString()
{
return "Teacher{teacherId:" + teacherId + "], [teacherName:" + teacherName + "}";
}
}

还是再次提醒一下,推荐重写toString()方法,打印关键属性。不要忘了在config.xml里面给Teacher.java声明一个别名:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration>
<typeAliases>
<typeAlias alias="Student" type="org.xrq.domain.Student" />
<typeAlias alias="Teacher" type="org.xrq.domain.Teacher" />
</typeAliases>
</configuration>

接着是TeacherDao.java接口:

public interface TeacherDao
{
public List<Teacher> selectAllTeachers();
public int insertTeacher(Teacher teacher);
}

其实现类TeacherDaoImpl.java:

@Repository
public class TeacherDaoImpl extends SqlSessionDaoSupport implements TeacherDao
{
private static final String NAMESPACE = "TeacherMapper."; @Resource
public void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory)
{
super.setSqlSessionFactory(sqlSessionFactory);
} public List<Teacher> selectAllTeachers()
{
return getSqlSession().selectList(NAMESPACE + "selectAllTeachers");
} public int insertTeacher(Teacher teacher)
{
return getSqlSession().insert(NAMESPACE + "insertTeacher", teacher);
}
}

OK,这样准备工作就全部做完了,有需要的朋友可以实际去把TeacherDao中的方法正确性先验证一下,下面进入文章的内容。

单表事物管理

有一个很常见的需求,在同一张表里面,我想批量插入100条数据,但是由于这100条数据之间存在一定的相关性,只要其中任何一条事物的插入失败,之前插入成功的数据就全部回滚,这应当如何实现?这里有两种解决方案:

1、使用MyBatis的批量插入功能

2、使用Spring管理事物,任何一条数据插入失败

由于我们限定的前提是单表,因此比较推荐的是第一种做法

第二种做法尽管也可以实现我们的目标,但是每插入一条数据就要发起一次数据库连接,即使使用了数据库连接池,但在性能上依然有一定程度的损失。而使用MyBatis的批量插入功能,只需要发起一次数据库的连接,这100次的插入操作在MyBatis看来是一个整体,其中任何一个插入的失败都将导致整体插入操作的失败,即:要么全部成功,要么全部失败

下面来看一下实现,首先在student_mapper.xml中新增一个批量新增的方法<insert>:

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-mapper.dtd" > <mapper namespace="StudentMapper">
<resultMap type="Student" id="StudentMap">
<id column="student_id" property="studentId" jdbcType="INTEGER" />
<result column="student_name" property="studentName" jdbcType="VARCHAR" />
</resultMap> ... <insert id="batchInsert" useGeneratedKeys="true" parameterType="java.util.List">
<selectKey resultType="int" keyProperty="studentId" order="AFTER">
SELECT
LAST_INSERT_ID()
</selectKey>
insert into student(student_id, student_name) values
<foreach collection="list" item="item" index="index" separator=",">
(#{item.studentId, jdbcType=INTEGER}, #{item.studentName, jdbcType=VARCHAR})
</foreach>
</insert>
</mapper>

这里主要是利用MyBatis提供的foreach,对传入的List做了一次遍历,并取得其中的属性进行插入。

然后在StudentDao.java中新增一个批量新增的方法batchInsert:

public interface StudentDao
{
public List<Student> selectAllStudents();
public int insertStudent(Student student);
public int batchInsertStudents(List<Student> studentList);
}

StudentDaoImpl.java实现它:

@Repository
public class StudentDaoImpl extends SqlSessionDaoSupport implements StudentDao
{
private static final String NAMESPACE = "StudentMapper."; @Resource
public void setSqlSessionFactory(SqlSessionFactory sqlSessionFactory)
{
super.setSqlSessionFactory(sqlSessionFactory);
}

... public int batchInsertStudents(List<Student> studentList)
{
return getSqlSession().insert(NAMESPACE + "batchInsert", studentList);
}
}

接着验证一下,首先drop一下student这张表并重新建一下,然后写一段测试程序:

public class StudentTest
{
@SuppressWarnings("resource")
public static void main(String[] args)
{
ApplicationContext ac = new ClassPathXmlApplicationContext("spring.xml");
StudentDao studentDao = (StudentDao)ac.getBean("studentDaoImpl");
List<Student> studentList = null; Student student0 = new Student();
student0.setStudentName("Smith");
Student student1 = new Student();
student1.setStudentName("ArmStrong");
studentList = new ArrayList<>();
studentList.add(student0);
studentList.add(student1);
studentDao.batchInsertStudents(studentList); System.out.println("-----Display students------");
studentList = studentDao.selectAllStudents();
for (int i = 0, length = studentList.size(); i < length; i++)
System.out.println(studentList.get(i));
}
}

运行结果为:

-----Display students------
Student{[studentId:1], [studentName:Smith]}
Student{[studentId:2], [studentName:ArmStrong]}

看到批量插入成功。

从另外一个角度来看,假如我们这么建立这个studentList:

Student student0 = new Student();
student0.setStudentName("Smith");
Student student1 = new Student();
student1.setStudentName(null);
studentList = new ArrayList<>();
studentList.add(student0);
studentList.add(student1);
studentDao.batchInsertStudents(studentList);

故意制造第一条插入OK,第二条插入报错的场景,此时再运行一下程序,程序会抛出异常,即使第一条数据是OK的,依然不会插入。

最后,这里是批量插入,批量修改、批量删除也是一样的做法,可以自己试验一下。

多库/多表事物管理

上面的场景是对于单表的事物管理做法的推荐:实际上这并没有用到事物管理,而是使用MyBatis批量操作数据的做法,目的是为了减少和数据库的交互次数。

现在有另外一种场景,我要对单库/多库的两张表(Student表、Teacher表)同时插入一条数据,要么全部成功,要么全部失败,该如何处理?此时明显就不可以使用MyBatis批量操作的方法了,要实现这个功能,可以使用Spring的事物管理。

前面文章有讲,Dao层中的方法更多的是一种对数据库的增删改查的原子性操作,而Service层中的方法相当于对这些原子性的操作做一个组合,这里要同时操作TeacherDao、StudentDao中的insert方法,因此建立一个SchoolService接口:

public interface SchoolService
{
public void insertTeacherAndStudent(Teacher teacher, Student student);
}

写一下这个接口的实现类:

@Service
public class SchoolServiceImpl implements SchoolService
{
@Resource
private StudentDao studentDao; @Resource
private TeacherDao teacherDao; @Transactional
public void insertTeacherAndStudent(Teacher teacher, Student student)
{
studentDao.insertStudent(student);
teacherDao.insertTeacher(teacher);
}
}

这里用到了两个注解,解释一下。

(1)@Service注解

严格地说这里使用@Service注解不是特别好,因为Service作为服务层,更多的是应该对同一个Dao中的多个方法进行组合,如果要用到多个Dao中的方法,建议应该是放到Controller层中,引入两个Service,这里为了简单,就简单在一个Service中注入了StudentDao和TeacherDao两个了。

(2)@Transactional注解

这个注解用于开启事物管理,注意@Transactional注解的使用前提是该方法所在的类是一个Spring Bean,因此(1)中的@Service注解是必须的。换句话说,假如你给方法加了@Transactional注解却没有给类加@Service、@Repository、@Controller、@Component四个注解其中之一将类声明为一个Spring的Bean,那么对方法的事物管理,是不会起作用的。关于@Transactional注解,会在下面进一步解读。

接着写一个测试类测试一下:

public class SchoolTest
{
@SuppressWarnings("resource")
public static void main(String[] args)
{
ApplicationContext ac = new ClassPathXmlApplicationContext("spring.xml");
SchoolService schoolService =
(SchoolService)ac.getBean("schoolServiceImpl"); Student student = new Student();
student.setStudentName("Billy");
Teacher teacher = new Teacher();
teacher.setTeacherName("Luna"); schoolService.insertTeacherAndStudent(teacher, student);
}
}

可以看一下数据库,Student表和Teacher表会同时多一条记录。接着继续从另外一个角度讲,我这么建立Student和Teacher:

Student student = new Student();
student.setStudentName("White");
Teacher teacher = new Teacher();
teacher.setTeacherName(null);

故意制造Teacher报错的场景,此时尽管Student没有问题,但是由于Teacher插入报错,因此Student的插入进行回滚,查看Student表,是不会有student_name为"White"这条记录的。

@Transactional注解

@Transactional这个注解绝对是Java程序员的一个福音,如果没有@Transactional注解,我们使用配置文件的做法进行声明式事务管理,我网上随便找一段配置文件:

<!-- 事物切面配置 -->
<tx:advice id="advice" transaction-manager="transactionManager">
<tx:attributes>
<tx:method name="update*" propagation="REQUIRED" read-only="false" rollback-for="java.lang.Exception"/>
<tx:method name="insert" propagation="REQUIRED" read-only="false"/>
</tx:attributes>
</tx:advice> <aop:config>
<aop:pointcut id="testService" expression="execution (* com.baobao.service.MyBatisService.*(..))"/>
<aop:advisor advice-ref="advice" pointcut-ref="testService"/>
</aop:config>

这种声明式的做法不得不说非常不好控制以及进行调试,尤其在要进行事物管理的内容不断增多之后,尤其体现出它的不方便。

使用@Transactional注解就不一样了,它可以精细到具体的类甚至具体的方法上(区别是同一个类,对方法的事物管理配置会覆盖对类的事务管理配置),另外,声明式事物中的一些属性,在@Transaction注解中都可以进行配置,下面总结一下常用的一些属性。

(1) @Transactional(propagation = Propagation.REQUIRED)

最重要的先说,propagation属性表示的是事物的传播特性,一共有以下几种:

事物传播特性 作      用
Propagation.REQUIRED 方法运行时如果已经处在一个事物中,那么就加入到这个事物中,否则自己新建一个事物,REQUIRED是默认的事物传播特性
Propagation.NOT_SUPPORTED 如果方法没有关联到一个事物,容器不会为它开启一个事物,如果方法在一个事物中被调用,该事物会被挂起直到方法调用结束再继续执行
Propagation.REQUIRES_NEW 不管是否存在事物,该方法总会为自己发起一个新的事物,如果方法已经运行在一个事物中,则原有事物挂起,新的事物被创建
Propagation.MANDATORY 该方法只能在一个已经存在的事物中执行,业务方法不能发起自己的事物,如果在没有事物的环境下被调用,容器抛出异常
Propagation.SUPPORTS 该方法在某个事物范围内被调用,则方法成为该事物的一部分,如果方法在该事物范围内被调用,该方法就在没有事物的环境下执行
Propagation.NEVER 该方法绝对不能在事物范围内执行,如果在就抛出异常,只有该方法没有关联到任何事物,才正常执行
Propagation.NESTED 如果一个活动的事物存在,则运行在一个嵌套的事物中。如果没有活动事物,则按REQUIRED属性执行,它只对DataSourceTransactionManager事物管理器有效

因此我们可以来简单分析一下上面的insertTeacherAndStudent方法:

  1. 由于没有指定propagation属性,因此事物传播特性为默认的REQUIRED
  2. StudentDao的insertStudent方法先运行,此时没有事物,因此新建一个事物
  3. TeacherDao的insertTeacher方法接着运行,此时由于StudentDao的insertStudent方法已经开启了一个事物,insertTeacher方法加入到这个事物中
  4. StudentDao的insertStudent方法和TeacherDao的insertTeacher方法组成了一个事物,两个方法要么同时执行成功,要么同时执行失败

(2)@Transactional(isolation = Isolation.DEFAULT)

事物隔离级别,这个不细说了,可以参看事物及事物隔离级别一文。

(3)@Transactional(readOnly = true)

该事物是否为一个只读事物,配置这个属性可以提高方法执行效率。

(4)@Transactional(rollbackFor = {ArrayIndexOutOfBoundsException.class, NullPointerException.class})

遇到方法抛出ArrayIndexOutOfBoundsException、NullPointerException两种异常会回滚数据,仅支持RuntimeException的子类

(5)@Transactional(noRollbackFor = {ArrayIndexOutOfBoundsException.class, NullPointerException.class})

这个和上面的相反,遇到ArrayIndexOutOfBoundsException、NullPointerException两种异常不会回滚数据,同样也是仅支持RuntimeException的子类。对(4)、(5)不是很理解的朋友,我给一个例子:

@Transactional(rollbackForClassName = {"NullPointerException"})
public void insertTeacherAndStudent(Teacher teacher, Student student)
{
studentDao.insertStudent(student);
teacherDao.insertTeacher(teacher);
String s = null;
s.length();
}

构造Student、Teacher的数据运行一下,然后查看下库里面有没有对应的记录就好了,然后再把rollbackForClassName改为noRollbackForClassName,对比观察一下。

(6)@Transactional(rollbackForClassName = {"NullPointerException"})、@Transactional(noRollbackForClassName = {"NullPointerException"})

这两个放在一起说了,和上面的(4)、(5)差不多,无非是(4)、(5)是通过.class来指定要回滚和不要回滚的异常,这里是通过字符串形式的名字来制定要回滚和不要回滚的异常。

(7)@Transactional(timeout = 30)

事物超时时间,单位为秒。

(8)@Transactional(value = "tran_1")

value这个属性主要就是给某个事物一个名字而已,这样在别的地方就可以使用这个事物的配置。