基本介绍

MyBatis 是一款优秀的持久层框架，它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。下面我来介绍一下如何在springboot的项目中使用mybatis。

1、引入相关依赖

我们想要使用mybatis肯定就需要引入相应的jar包，由于我们需要和springboot进行整合，所以需要引入相应的starter，我们在springboot中使用mybatis要引入的jar包名称就是mybatis-spring-boot-starter，具体如下

        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.2</version>
        </dependency>

当然，处理上面这个starter肯定还需要引入相关的数据库连接的依赖，比如mysql

        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>5.1.49</version>
        </dependency>

2、数据库基本配置

这个就是固定操作，我们需要在配置文件中配置数据库的相关信息

spring:
  datasource:
    driver-class-name: com.mysql.jdbc.Driver
    url: jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=utf-8&useSSL=true
    username: root
    password: root

3、编写mapper接口和映射文件

下面是我写的一个People类

@Data
public class People {
    private Integer id;
    private String name;
    private String gender;
    private Integer age;
}

编写PeopleMapper

@Mapper
public interface PeopleMapper {

    /**
     * 查询people表所有信息
     * @return 返回所有的people信息
     */
    List<People> queryAll();
}

注意：我们要使用@Mapper注解标识Mapper接口
下一步就是编写自己对于的mapper文件，我将所有的mapper文件统一放在resources/mapper目录下

PeopleMapper.xml文件内容如下

<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.ttpfx.mapper.PeopleMapper">
    <select id="queryAll" resultType="com.ttpfx.bean.People">
        select * from people
    </select>
</mapper>

4、指定Mapper文件的位置

我们写完mapper文件后需要在指定mapper文件的位置，我们就在springboot的配置文件中指定即可

mybatis:
  mapper-locations: classpath:mapper/*.xml

上面的语句就表示mapper文件就是位于类路径下的mapper目录下的所有xml文件。
这里说明一下，Mybatis的配置项可以查看MybatisProperties这个类

该类的字段如下

这些字段都是顾名思义，对mybatis熟悉一点应该都知道是上面用法，如果不清楚去看看该字段上的注释或者官方文档即可。

5、测试

创建测试文件

@SpringBootTest
public class SqlTest {

    @Resource
    private PeopleMapper peopleMapper;

    @Test
    public void t1() {
        List<People> peopleList = peopleMapper.queryAll();
        System.out.println();
        for (People people : peopleList) {
            System.out.println(people);
        }
        System.out.println();
    }
}