1. 簡介
在上一篇文章《Spring Boot （七）： Mybatis極簡配置》 中我們介紹了在 Spring Boot 中 Mybatis 的基礎使用方式，其中有一部分美中不足的是 Mybatis 本身並未提供分頁功能，還需要我們自己手動添加 PageHelper 插件或者自己實現分頁的工具類，並且對單表的操作並不友好，簡單的 insert 、 update 、 delete 還需我們添加 SQL 語句，在目前微服務的架構模式下，每個服務擁有自己的單獨的數據庫，單表的使用場景會越來越多， Mybatis 的使用無疑會產生很多重復勞動。
Mybatis Plus 在這樣的背景下應運而生了，MyBatis-Plus（簡稱 MP）是一個 MyBatis 的增強工具，在 MyBatis 的基礎上只做增強不做改變，為簡化開發、提高效率而生。而開源團隊對這個開源項目的願景如下：
願景
我們的願景是成為 MyBatis 最好的搭檔，就像 魂斗羅 中的 1P、2P，基友搭配，效率翻倍。
2. 特性
- 無侵入：只做增強不做改變，引入它不會對現有工程產生影響，如絲般順滑
- 損耗小：啟動即會自動注入基本 CURD，性能基本無損耗，直接面向對象操作
- 強大的 CRUD 操作：內置通用 Mapper、通用 Service，僅僅通過少量配置即可實現單表大部分 CRUD 操作，更有強大的條件構造器，滿足各類使用需求
- 支持 Lambda 形式調用：通過 Lambda 表達式，方便的編寫各類查詢條件，無需再擔心字段寫錯
- 支持主鍵自動生成：支持多達 4 種主鍵策略（內含分布式唯一 ID 生成器 - Sequence），可自由配置，完美解決主鍵問題
- 支持 ActiveRecord 模式：支持 ActiveRecord 形式調用，實體類只需繼承 Model 類即可進行強大的 CRUD 操作
- 支持自定義全局通用操作：支持全局通用方法注入（ Write once, use anywhere ）
- 內置代碼生成器：采用代碼或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 層代碼，支持模板引擎，更有超多自定義配置等您來使用
- 內置分頁插件：基於 MyBatis 物理分頁，開發者無需關心具體操作，配置好插件之后，寫分頁等同於普通 List 查詢
- 分頁插件支持多種數據庫：支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer2005、SQLServer 等多種數據庫
- 內置性能分析插件：可輸出 Sql 語句以及其執行時間，建議開發測試時啟用該功能，能快速揪出慢查詢
- 內置全局攔截插件：提供全表 delete 、 update 操作智能分析阻斷，也可自定義攔截規則，預防誤操作
Mybatis-Plus 相比較 Mybatis 更好的支持了單表的相關操作，並且直接支持分頁功能，還加入了一系列有助於開發的插件，相關詳細內容推薦各位讀者訪問官方網站獲得：https://mybatis.plus/guide/ 。下面將會介紹 Mybatis-Plus 的單表操作和引入 SQL 分析插件。
3. 工程實戰
3.1 工程依賴 pom.xml 如下：
代碼清單：spring-boot-mybatis-plus/pom.xml
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.2.0</version>
</dependency>
<!-- https://mvnrepository.com/artifact/p6spy/p6spy -->
<dependency>
<groupId>p6spy</groupId>
<artifactId>p6spy</artifactId>
<version>3.8.6</version>
</dependency>
- mybatis-plus-boot-starter 為 mybatis-plus 所需依賴
- p6spy 為 SQL 分析打印依賴，如不需要，可以單獨引入 mybatis-plus-boot-starter 。
3.2 配置
配置文件 application.yml 如下：
代碼清單：spring-boot-mybatis-plus/src/main/resources/application.yml
server:
port: 8080
spring:
application:
name: spring-boot-mybatis-xml
datasource:
url: jdbc:p6spy:mysql://172.16.96.112:3306/test?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=UTF-8&useSSL=false
username: root
password: 123456
driver-class-name: com.p6spy.engine.spy.P6SpyDriver
type: com.zaxxer.hikari.HikariDataSource
hikari:
auto-commit: true
minimum-idle: 2
idle-timeout: 60000
connection-timeout: 30000
max-lifetime: 1800000
pool-name: DatebookHikariCP
maximum-pool-size: 5
# 配置slq打印日志
mybatis-plus:
configuration:
log-impl: org.apache.ibatis.logging.stdout.StdOutImpl
注意：開啟 mybatis-plus 的 SQL 分析打印
- 需要配置
mybatis-plus.configuration.log-impl。 - 修改配置
spring.datasource.driver-class-name為com.p6spy.engine.spy.P6SpyDriver,這個配置是使用 p6spy 提供的驅動類。 - url 前綴為 jdbc:p6spy 跟着冒號為對應數據庫連接地址。
- 該插件有性能損耗，不建議生產環境使用。
- 還需增加 spy.properties ，如下：
代碼清單：spring-boot-mybatis-plus/src/main/resources/spy.properties
module.log=com.p6spy.engine.logging.P6LogFactory,com.p6spy.engine.outage.P6OutageFactory
# 自定義日志打印
logMessageFormat=com.baomidou.mybatisplus.extension.p6spy.P6SpyLogger
#日志輸出到控制台
appender=com.baomidou.mybatisplus.extension.p6spy.StdoutLogger
# 使用日志系統記錄 sql
#appender=com.p6spy.engine.spy.appender.Slf4JLogger
# 設置 p6spy driver 代理
deregisterdrivers=true
# 取消JDBC URL前綴
useprefix=true
# 配置記錄 Log 例外,可去掉的結果集有error,info,batch,debug,statement,commit,rollback,result,resultset.
excludecategories=info,debug,result,batch,resultset
# 日期格式
dateformat=yyyy-MM-dd HH:mm:ss
# 實際驅動可多個
#driverlist=org.h2.Driver
# 是否開啟慢SQL記錄
outagedetection=true
# 慢SQL記錄標准 2 秒
outagedetectioninterval=2
3.3 Mapper 類
代碼清單：spring-boot-mybatis-plus/src/main/java/com/springboot/springbootmybatisplus/mapper/UserMapper.java
public interface UserMapper extends BaseMapper<User> {
}
這里只需要繼承 BaseMapper 即可， BaseMapper 為我們提供了豐富的單表操作，具體的操作可以查看源碼 com.baomidou.mybatisplus.core.mapper.BaseMapper<T> ，其中的注釋非常詳盡。
3.4 Service 類
Mybatis-Plus 除了為我們提供了基礎的 Mapper 類以外，還為我們提供了 IService ，通用 Service CRUD 封裝IService接口，進一步封裝 CRUD 采用 get 查詢單行 remove 刪除 list 查詢集合 page 分頁 前綴命名方式區分 Mapper 層避免混淆。並且官方建議我們如果存在自定義通用 Service 方法的可能，請創建自己的 IBaseService 繼承 Mybatis-Plus 提供的基類。
UserService.java 代碼如下：
代碼清單：spring-boot-mybatis-plus/src/main/java/com/springboot/springbootmybatisplus/service/UserService.java
public interface UserService extends IService<User> {
}
UserServiceImpl.java 代碼如下;
代碼清單：spring-boot-mybatis-plus/src/main/java/com/springboot/springbootmybatisplus/service/impl/UserServiceImpl.java
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}
相關測試代碼已經創建測試 controller ，這里就不列出了，有需要的讀者可以訪問 Github 代碼倉庫自行取用。
3.5 分頁配置類
代碼清單：spring-boot-mybatis-plus/src/main/java/com/springboot/springbootmybatisplus/config/MybatisPlusConfig.java
@Configuration
public class MybatisPlusConfig {
/**
* 注冊分頁插件
* @return
*/
@Bean
public PaginationInterceptor paginationInterceptor(){
return new PaginationInterceptor();
}
}
4. 測試
啟動工程后，打開瀏覽器訪問：http://localhost:8080/findPage ，可以看到 json 正常返回，如下：
{
"records":[
{
"id":"a0ac692d-e1f1-11e9-9a69-0242ac110002",
"nickName":"geekdigging.com",
"age":108,
"createDate":"2019-09-28T13:12:31.000+0000"
},
{
"id":"b9168576-e1f1-11e9-9a69-0242ac110002",
"nickName":"www.geekdigging.com",
"age":18,
"createDate":"2019-09-28T13:13:12.000+0000"
}
],
"total":2,
"size":5,
"current":1,
"orders":[
],
"searchCount":true,
"pages":1
}
這時我們查看控制台的日志，可以看到 SQL 分析的相關日志，如下：
從日志中，我們可以清楚的看到當前日志執行的過程，先執行了什么后執行了什么，並且耗時是多少，有助於我們的進行 SQL 的性能分析，知道具體是哪些 SQL 耗時會比較長。
5. 小結
Mybatis-Plus 整體使用都比較簡單，Mybatis 支持的使用方式 Mybatis-Plus 都支持，只是原本配置文件 application.yml 中的 mybatis.*** 需要替換成為 mybatis-plus.*** ，並且增強了 Mybatis 原本單表操作的不足之處，對於官方的宣言：只做增強不做改變，為簡化開發、提高效率而生。筆者認為是十分貼切的。本文僅介紹了 Mybatis-Plus 的一些基礎使用方式，官方除了增強了單表操作、分頁、 SQL 分析等功能外，還提供了很多實用的插件，例如：熱加載、邏輯刪除、SQL 注入器、攻擊 SQL 阻斷解析器等功能，如有需要的讀者朋友可以訪問官方文檔自取。