Spring Boot 2.x基礎教程：使用MyBatis訪問MySQL

之前我們已經介紹了兩種在Spring Boot中訪問關係型資料庫的方式：

雖然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目錄：

如果您覺得本文不錯，歡迎Star支援，您的關注是我堅持的動力！

歡迎關注我的公眾號：程式猿DD，獲得獨家整理的學習資源和日常乾貨推送。
如果您對我的專題內容感興趣，也可以關注我的部落格：didispace.com

VirMach 便宜 VPS

QNews

QNews