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