SpringBoot整合MyBatis

SpringData是Spring提供的一个用户简化数据库访问、支持云服务的开源框架。它是一个伞形项目，包含了大量关系型数据库及非关系型数据库的数据访问解决方案，其设计目的是使我们开源快速且简单地使用各种数据访问技术。SpringBoot默认采用整合SpringData的方式统一处理数据访问层，通过添加大量自动配置，引入各种数据访问模板xxxTemplate以及统一的Repository接口，从而达到简化数据访问层的操作。
SpringData提供了多种类型数据库支持，对支持的数据库进行了整合管理，提供了各种依赖启动器，接下来，通过一张表罗列提供的常见数据库依赖启动器，如表所示：

image.png

除此之外，还有一些框架技术，SpringData项目并没有进行统一管理，SpringBoot官方也没有提供对应的依赖启动器，但是为了迎合市场开发需求、这些框架技术开发团队自己适配了对应的依赖启动器，例如，mybatis-spring-boot-starter支持MyBatis的使用。

基础环境搭建

在MySQL数据库里创建一个springbootdata库，然后创建两个表t_article和t_comment并向表中插入数据，脚本如下：

 # 创建数据库
 CREATE DATABASE springbootdata;
 # 选择使用数据库
USE springbootdata;
 # 创建表t_article并插入相关数据
 DROP TABLE IF EXISTS t_article;
CREATE TABLE t_article (
  id int(20) NOT NULL AUTO_INCREMENT COMMENT '文章id',
  title varchar(200) DEFAULT NULL COMMENT '文章标题 ',
  content longtext COMMENT '文章内容',
  PRIMARY KEY (id)
) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
 INSERT INTO t_article VALUES ('1', 'Spring Boot基础入门', '从入门到精通讲解...');
 INSERT INTO t_article VALUES ('2', 'Spring Cloud基础入门 ', '从入门到精通讲解...');
 # 创建表t_comment并插入相关数据
 DROP TABLE IF EXISTS t_comment;
 CREATE TABLE t_comment (
   id int(20) NOT NULL AUTO_INCREMENT COMMENT '评论id',
   content longtext COMMENT '评论内容',
   author varchar(200) DEFAULT NULL COMMENT '评论作者',
   a_id int(20) DEFAULT NULL COMMENT '关联的文章id',
   PRIMARY KEY (id)
 ) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8;
 INSERT INTO t_comment VALUES ('1', '很全、很详细', 'luccy', '1');
 INSERT INTO t_comment VALUES ('2', '赞一个', 'tom', '1');
 INSERT INTO t_comment VALUES ('3', '很详细', 'eric', '1');
 INSERT INTO t_comment VALUES ('4', '很好，非常详细', '张三', '1');
 INSERT INTO t_comment VALUES ('5', '很不错', '李四', '2');

创建项目，引入相应的启动器

image.png

编写与数据库表t_comment和t_article对应的实体类Comment和Article

Comment实体类文件

@Entity
@Table(name = "t_comment")
public class Comment {

    @Id //表明映射主键id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Integer id;  //评论id
    private String content; //评论内容
    private String author; //评论作者
    @Column(name = "a_id")
    private Integer aId; //外键：表示当前这条评论是属于那篇文章

    @Override
    public String toString() {
        return "Comment{" +
                "id=" + id +
                ", content='" + content + '\'' +
                ", author='" + author + '\'' +
                ", aId=" + aId +
                '}';
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }

    public Integer getaId() {
        return aId;
    }

    public void setaId(Integer aId) {
        this.aId = aId;
    }
}

Article实体类文件：

public class Article {
    private Integer id; //文章id
    private String title; //文章标题
    private String content; //文章内容

    @Override
    public String toString() {
        return "Article{" +
                "id=" + id +
                ", title='" + title + '\'' +
                ", content='" + content + '\'' +
                '}';
    }

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getTitle() {
        return title;
    }

    public void setTitle(String title) {
        this.title = title;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }
}

编写配置文件

1）在application.properties配置文件中进行数据库连接配置

# Mysql数据库连接配置 : com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/springbootdata?serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=david

注解方式整合Mybatis
1）创建一个用于对数据库表 t_comment数据操作的CommentMapper

@Mapper
public interface CommentMapper {
   @Select("SELECT * FROM t_comment WHERE id =#{id}")
   public Comment findById(Integer id);
}

@Mapper主键表示该类是一个MyBatis 接口文件，并保证能够被SpringBoot自动扫描到Spring容器中，对应的接口类上添加了@Mapper注解，如果编写的Mapper接口过多时，需要重复为每一个接口文件添加@Mapper注解，为了解决这种麻烦，可以直接在SpringBoot项目启动类上添加@SpringScan("xxx")注解，不需要在逐个添加，@Mapper注解，@MapperScan("xxx")注解的作用和@Mapper注解类似，但是它必须制定需要扫描的具体包名。
2）测试类实现

@RunWith(SpringRunner.class)
@SpringBootTest
class Springboot03DataApplicationTests {

    @Autowired
    private CommentMapper commentMapper;

    @Test
    void contextLoads() {
        Comment comment = commentMapper.findById(1);
        System.out.println(comment);
    }
｝

打印结果：

image.png

控制台中查询的Comment的aId属性为null，没有映射成功。这是因为编写的实体类Comment中使用了驼峰命名方式将t_comment中的a_id字段设计成了aId属性，所以无法正确映射查询结果。为了解决上述由于驼峰命名方式造成的表字段值无法正确映射到类属性的情况，可以在SpringBoot全局配置文件application.properties中添加开启驼峰命名匹配映射配置，示例代码如下：

# 开启驼峰命名匹配映射
mybatis.configuration.map-underscore-to-camel-case=true

打印结果：

image.png

ֵ使用配置文件的方式整合MyBatis
1）创建一个用于对数据库表t_article数据操作的接口ArticleMapper

@Mapper
public interface ArticleMapper {
    //根据id查询对应的文章
    public Article selectArticle(Integer id);
}

2）创建XML映射文件
resources目录下创建一个统一管理映射文件的包mapper，并在该包下编写与AticleMapper接口方的用社文件AticleMapper.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="com.david.mapper.ArticleMapper">

    <select id="selectArticle" parameterType="int" resultType="article">
        select * from t_article where id = #{id}
    </select>
</mapper>

3）配置XML映射文件路径。在项目编写的XML映射文件，SpringBoot并无从知晓。所以无法扫描到该自定义编写的XML配置文件，还必须在全局配置文件appication.properties中添加MyBatis映射文件路径的配置，同时需要添加实体类别名映射路径，示例如下：

#配置mybatis的xml映射配置文件路径
mybatis.mapper-locations=classpath:mapper/*.xml
#配置mybatis映射配置文件中实体类别名
mybatis.type-aliases-package=com.david.pojo

4）测试类实现

@Autowired
private ArticleMapper articleMapper;

@Test
public void selectArticle(){
    Article article = articleMapper.selectArticle(1);
    System.out.println(article);
}

打印结果：

image.png