本文记录学习在SpringBoot中使用Mybatis。
一 什么是Mybatis
MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs(Plain Old Java Objects,普通的 Java对象)映射成数据库中的记录（官方定义）;
官方使用示例代码如下：
String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
SqlSession session = sqlSessionFactory.openSession();
try {
BlogMapper mapper = session.getMapper(BlogMapper.class);
Blog blog = mapper.selectBlog(101);
} finally {
session.close();
}
通过示例程序可以看到它的执行过程主要有以下几个步骤：
1 应用程序启动时，根据配置文件生成一个SqlSessionFactory;
2 通过SqlSessionFactory的到一个SqlSession；
3 SqlSession内部通过Excutor执行对应的SQl；
4 返回处理结果；
5 释放资源；
二 SpringBoot集成Mybatis
Mybatis使用有2中方式，一种是使用注解，即在接口定义的方法上通过注解写入要执行的SQL和要完成的数据映射；一种是使用xml配置文件即在xml文件中写相关SQL和完成表与实体的映射。本文我们使用xml文件。
首先需要引入SpringBoot集成Mybatis的依赖jar包，这里我们只引入了Spring与Mybatis集成的包，springboot默认会自动帮我们引入其他依赖的jar包。
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.3.2</version>
</dependency>
在application.properties文件中配置数据库连接信息和指定mybatis的接口对应的xml
#datasoure
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=123456
#mybatis
mybatis.mapper-locations=classpath:mybatis/*.xml
如上，我们的mapper xml文件放在reources目录下的mybatis文件夹下
写一个接口，定义我们要完成的功能
@Mapper
public interface UserMapper {
/**
* 根据ID删除
*/
int deleteByPrimaryKey(Long id);
/**
* 新增
*/
int insert(UserInfo record);
/**
* 根据ID查询
*/
UserInfo selectByPrimaryKey(Long id);
/**
* 修改
*/
int updateByPrimaryKey(UserInfo record);
/**
* 查询所有
*/
List<UserInfo> selectAll();
}
@Mapper 该注解说名当前类是一个Mybatis的Mapper接口类，交给spring管理，令一种方式是使用注解 @MapperScan(basePackages="...") 说明basePackages及其子包下的接口都交给spring管理，我们多数情况下都会使用@MapperScan这个注解，这样我们就不用在每一个Mapper接口上写注解了。
在xml文件中完成SQl，实现具体的方法，如下：
<?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="org.allen.demo.dao.UserMapper" >
<resultMap id="BaseResultMap" type="org.allen.demo.domain.UserInfo" >
<id column="id" property="id" jdbcType="BIGINT" />
<result column="age" property="age" jdbcType="INTEGER" />
<result column="name" property="name" jdbcType="VARCHAR" />
</resultMap>
<sql id="Base_Column_List" >
id, age, name
</sql>
<select id="selectByPrimaryKey" resultMap="BaseResultMap" parameterType="java.lang.Long" >
select
<include refid="Base_Column_List" />
from t_user
where id = #{id,jdbcType=BIGINT}
</select>
<select id="selectAll" resultMap="BaseResultMap">
select
<include refid="Base_Column_List" />
from t_user
</select>
<delete id="deleteByPrimaryKey" parameterType="java.lang.Long" >
delete from t_user
where id = #{id,jdbcType=BIGINT}
</delete>
<insert id="insert" parameterType="org.allen.demo.domain.UserInfo" useGeneratedKeys="true" keyProperty="id">
insert into t_user (id, age, name)
values (#{id,jdbcType=BIGINT}, #{age,jdbcType=INTEGER}, #{name,jdbcType=VARCHAR})
</insert>
<update id="updateByPrimaryKey" parameterType="org.allen.demo.domain.UserInfo" >
update t_user
set age = #{age,jdbcType=INTEGER},
name = #{name,jdbcType=VARCHAR}
where id = #{id,jdbcType=BIGINT}
</update>
</mapper>
从这个xml文件，我们可以看到以下几点：
1 namespace="org.allen.demo.dao.UserMapper" 通过namespace来指定将当前xml文件的SQL实现的对应的接口Mapper
2 通过 resultMap 完成实体类与数据库表字段的映射
3 xml中的SQL语句都必须写在<select> <insert> <update><delete>内部
4 每一个标识的id都必须与接口中的方法名保持一直
5 insert 中使用的 useGeneratedKeys 设置是否使用JDBC的getGenereatedKeys方法获取主键并赋值到keyProperty设置的领域模型属性中。如果设置了true，我们就可以在insert完成后直接通过当前操作的实体类获取数据库主键。
三 测试
使用Junit做测试
@RunWith(SpringRunner.class)
@SpringBootTest
public class MybatisApplicationTests {
@Resource
private UserMapper userMapper;
@Test
public void save() {
UserInfo user = new UserInfo();
user.setName("world");
user.setAge(2);
userMapper.insert(user);
System.out.println("保存后的ID：" + user.getId());
}
@Test
public void delete() {
long id = 5;
userMapper.deleteByPrimaryKey(id);
}
@Test
public void update() {
UserInfo user = new UserInfo();
user.setName("world");
user.setAge(5);
long id = 3;
user.setId(id);
userMapper.updateByPrimaryKey(user);
}
@Test
public void selectById() {
long id = 3;
userMapper.selectByPrimaryKey(id);
}
@Test
public void selectAll() {
List<UserInfo> userList = userMapper.selectAll();
}
}