Spring Boot 應用系列 2 -- Spring Boot 2 整合MyBatis和Druid

本系列將分別演示單數據源和多數據源的配置和應用，本文先演示單數據源(MySQL)的配置。

1. pom.xml文件配置

需要在dependencies節點添加：

<!-- MySQL -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.12</version>
</dependency>
<!-- MySQL end -->

<!-- Connection Pool -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.1.10</version>
</dependency>
<!-- Connection Pool end -->

<!-- MyBatis -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.2</version>
</dependency>
<!-- MyBatis end -->

2. 因為是單數據源，為了方便起見，我們把數據源和連接池全部放到application.yml里，當然數據源的配置也可以另起一個新文件。

server:
  port: 9007
  
spring:
  datasource:
    name: devutility-test-database-mybatis-springboot
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      driver-class-name: com.mysql.cj.jdbc.Driver
      url: ${DB_URL:jdbc:mysql://127.0.0.1:3306/Test}?useUnicode=true&useSSL=false
      username: ${DB_UID:tester}
      password: ${DB_PWD:tester}
      initial-size: 1
      min-idle: 1
      max-active: 20
      max-wait: 60000
      time-between-eviction-runs-millis: 60000
      min-evictable-idle-time-millis: 300000
      validation-query: SELECT 'x'
      test-while-idle: true
      test-on-borrow: false
      test-on-return: false
      pool-prepared-statements: false
      max-pool-prepared-statement-per-connection-size: 20
      filters: stat
mybatis:
  mapper-locations: classpath:mappers/*.xml
  type-aliases-package: devutility.test.database.mybatis.springboot.entities

第27行定義了mapper的xml文件的地址；

第28行定義了實體類的包，在mapper的xml文件中可以只寫實體類名而不必寫全實體類的命名空間。

3. MyBatis相關配置

MyBatis的配置主要涉及到mapper的xml文件，mapper的接口文件，以及數據庫相關的實體類的定義。

(1) 首先定義一個客戶實體類：

package devutility.test.database.mybatis.springboot.entities;

public class Customer extends BaseEntity {
    private long id;
    private String name1;
    private String address1;
    private String city;
    private int state;
    private int zip;
    private String phone;
    private String email;

(2) 定義mapper的xml文件，也叫XML映射文件，存放於src/main/resources/mappers目錄下。

<?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="devutility.test.database.mybatis.springboot.mappers.CustomerMapper">
    <select id="get" resultType="Customer">
        select * from Customer where id = #{id};
    </select>
</mapper>

XML映射文件的定義規則可以參考MyBatis官網，此處我們僅實現一個根據主鍵查詢Customer的功能。

(3) 定義Mapper接口：

package devutility.test.database.mybatis.springboot.mappers;

import org.apache.ibatis.annotations.Mapper;

import devutility.test.database.mybatis.springboot.entities.Customer;

@Mapper
public interface CustomerMapper {
    Customer get(long id);
}

4. 應用

package devutility.test.database.mybatis.springboot.controllers;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import devutility.test.database.mybatis.springboot.entities.Customer;
import devutility.test.database.mybatis.springboot.mappers.CustomerMapper;

@RestController
@RequestMapping("/customer")
public class CustomerController {
    @Autowired
    private CustomerMapper customerMapper;

    @RequestMapping("/get")
    public Customer get(long id) {
        return customerMapper.get(id);
    }
}

Demo地址