Spring Boot 2.x基础教程：使用MyBatis访问MySQL

以前咱们已经介绍了两种在Spring Boot中访问关系型数据库的方式：

• 使用spring-boot-starter-jdbc
• 使用spring-boot-starter-data-jpa

虽然Spring Data JPA在国外普遍流行，可是在国内仍是MyBatis的天下。因此，今天这篇咱们将具体说说如何在Spring Boot中整合MyBatis完成关系型数据库的增删改查操做。

整合MyBatis

第一步：新建Spring Boot项目，在pom.xml中引入MyBatis的Starter以及MySQL Connector依赖，具体以下：

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

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

关于mybatis-spring-boot-starter的版本须要注意：

• 2.1.x版本适用于：MyBatis 3.5+、Java 8+、Spring Boot 2.1+
• 2.0.x版本适用于：MyBatis 3.5+、Java 8+、Spring Boot 2.0/2.1
• 1.3.x版本适用于：MyBatis 3.4+、Java 6+、Spring Boot 1.5

其中，目前还在维护的是2.1.x版本和1.3.x版本。

第二步：同以前介绍的使用jdbc模块和jpa模块链接数据库同样，在application.properties中配置mysql的链接配置

spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.username=root
spring.datasource.password=
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

固然，也能够不用默认数据源，若是要使用Druid做为数据库链接池的话，能够参见《Spring Boot 2.x：使用国产数据库链接池Druid》一文。

第三步：Mysql中建立一张用来测试的表，好比：User表，其中包含id(BIGINT)、age(INT)、name(VARCHAR)字段。

具体建立命令以下：

CREATE TABLE `User` (
  `id` bigint NOT NULL AUTO_INCREMENT,
  `name` varchar(100) COLLATE utf8mb4_general_ci DEFAULT NULL,
  `age` int DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci

第四步：建立User表的映射对象User：

@Data
@NoArgsConstructor
public class User {

    private Long id;

    private String name;
    private Integer age;

    public User(String name, Integer age) {
        this.name = name;
        this.age = age;
    }
}

第五步：建立User表的操做接口：UserMapper。在接口中定义两个数据操做，一个插入，一个查询，用于后续单元测试验证。

@Mapper
public interface UserMapper {

    @Select("SELECT * FROM USER WHERE NAME = #{name}")
    User findByName(@Param("name") String name);

    @Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name}, #{age})")
    int insert(@Param("name") String name, @Param("age") Integer age);

}

第六步：建立Spring Boot主类

@SpringBootApplication
public class Chapter35Application {

    public static void main(String[] args) {
        SpringApplication.run(Chapter35Application.class, args);
    }

}

第七步：建立单元测试。具体测试逻辑以下：

• 插入一条name=AAA，age=20的记录，而后根据name=AAA查询，并判断age是否为20
• 测试结束回滚数据，保证测试单元每次运行的数据环境独立

@Slf4j
@RunWith(SpringRunner.class)
@SpringBootTest
public class Chapter35ApplicationTests {

    @Autowired
    private UserMapper userMapper;

    @Test
    @Rollback
    public void test() throws Exception {
        userMapper.insert("AAA", 20);
        User u = userMapper.findByName("AAA");
        Assert.assertEquals(20, u.getAge().intValue());
    }

}

注解配置说明

下面经过几种不一样传参方式来实现前文中实现的插入操做，来学习一下MyBatis中经常使用的一些注解。

使用@Param

在以前的整合示例中咱们已经使用了这种最简单的传参方式，以下：

@Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name}, #{age})")
int insert(@Param("name") String name, @Param("age") Integer age);

这种方式很好理解，@Param中定义的name对应了SQL中的#{name}，age对应了SQL中的#{age}。

使用Map

以下代码，经过Map<String, Object>对象来做为传递参数的容器：

@Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name,jdbcType=VARCHAR}, #{age,jdbcType=INTEGER})")
int insertByMap(Map<String, Object> map);

对于Insert语句中须要的参数，咱们只须要在map中填入同名的内容便可，具体以下面代码所示：

Map<String, Object> map = new HashMap<>();
map.put("name", "CCC");
map.put("age", 40);
userMapper.insertByMap(map);

使用对象

除了Map对象，咱们也可直接使用普通的Java对象来做为查询条件的传参，好比咱们能够直接使用User对象:

@Insert("INSERT INTO USER(NAME, AGE) VALUES(#{name}, #{age})")
int insertByUser(User user);

这样语句中的#{name}、#{age}就分别对应了User对象中的name和age属性。

增删改查

MyBatis针对不一样的数据库操做分别提供了不一样的注解来进行配置，在以前的示例中演示了@Insert，下面针对User表作一组最基本的增删改查做为示例：

public interface UserMapper {

    @Select("SELECT * FROM user WHERE name = #{name}")
    User findByName(@Param("name") String name);

    @Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")
    int insert(@Param("name") String name, @Param("age") Integer age);

    @Update("UPDATE user SET age=#{age} WHERE name=#{name}")
    void update(User user);

    @Delete("DELETE FROM user WHERE id =#{id}")
    void delete(Long id);
}

在完成了一套增删改查后，不妨咱们试试下面的单元测试来验证上面操做的正确性：

@Transactional
@RunWith(SpringRunner.class)
@SpringBootTest
public class ApplicationTests {

    @Autowired
    private UserMapper userMapper;

    @Test
    @Rollback
    public void testUserMapper() throws Exception {
        // insert一条数据，并select出来验证
        userMapper.insert("AAA", 20);
        User u = userMapper.findByName("AAA");
        Assert.assertEquals(20, u.getAge().intValue());
        // update一条数据，并select出来验证
        u.setAge(30);
        userMapper.update(u);
        u = userMapper.findByName("AAA");
        Assert.assertEquals(30, u.getAge().intValue());
        // 删除这条数据，并select验证
        userMapper.delete(u.getId());
        u = userMapper.findByName("AAA");
        Assert.assertEquals(null, u);
    }
}

返回结果绑定

对于增、删、改操做相对变化较小。而对于“查”操做，咱们每每须要进行多表关联，汇总计算等操做，那么对于查询的结果每每就再也不是简单的实体对象了，每每须要返回一个与数据库实体不一样的包装类，那么对于这类状况，就能够经过@Results和@Result注解来进行绑定，具体以下：

@Results({
    @Result(property = "name", column = "name"),
    @Result(property = "age", column = "age")
})
@Select("SELECT name, age FROM user")
List<User> findAll();

在上面代码中，@Result中的property属性对应User对象中的成员名，column对应SELECT出的字段名。在该配置中故意没有查出id属性，只对User对应中的name和age对象作了映射配置，这样能够经过下面的单元测试来验证查出的id为null，而其余属性不为null：

@Test
@Rollback
public void testUserMapper() throws Exception {
    List<User> userList = userMapper.findAll();
    for(User user : userList) {
        Assert.assertEquals(null, user.getId());
        Assert.assertNotEquals(null, user.getName());
    }
}

本文主要介绍几种最为经常使用的方式，更多其余注解的使用可参见文档，下一篇咱们将介绍如何使用XML配置SQL的传统使用方式。

更多本系列免费教程连载「点击进入汇总目录」

代码示例

本文的相关例子能够查看下面仓库中的chapter3-5目录：

• Github：https://github.com/dyc87112/SpringBoot-Learning/
• Gitee：https://gitee.com/didispace/SpringBoot-Learning/

若是您以为本文不错，欢迎Star支持，您的关注是我坚持的动力！

欢迎关注个人公众号：程序猿DD，得到独家整理的学习资源和平常干货推送。
若是您对个人专题内容感兴趣，也能够关注个人博客：didispace.com