作者:追夢1819
原文:https://www.cnblogs.com/yanfei1819/p/10881666.html
版權宣告:本文為博主原創文章,轉載請附上博文連結!
引言
一看這個名字,就能看出與 MyBatis 有關。沒錯,它就是一款 MyBatis 的增強工具。
下面我們先介紹這款工具,然後再介紹在 SpringBoot 中的使用。這樣符合博主的習慣:在學習一個新的技術或者新的框架之前,一定會思考這個技術或者框架為什麼會出現?解決了什麼問題?有沒有別的取代方案?
Mybatis Plus簡介
1、概念
MyBatis-Plus(簡稱 MP)是一個 MyBatis 的增強工具,在 MyBatis 的基礎上只做增強不做改變,為簡化開發、提高效率而生。
2、特性
官網列舉了很多特性。不過總的來說,無非就是封裝好了常規的 CRUD 操作,無需配置,同時內嵌了很多外掛(熱載入、程式碼生成、分頁、效能分析等),減少了程式碼量。
3、關於版本說明
MyBatis Plus2.0 是基於 JDK1.7 及以下版本的。MyBatis Plus3.0 是基於 JDK1.8 及以上版本的(因為外掛內部使用了JDK8 的新特性 lambda 表示式)。本系列文章的JDK版本是1.8的,故選擇的外掛版本是3.0版本的。
使用
MyBatis Plus 的核心功能有三個:
- CRUD 操作;
- 程式碼生成器;
- 條件生成器。
下面逐一介紹。
CRUD操作
我們來看看 MyBatis 在 SpringBoot 專案中的應用。
準備工作,初始化資料庫:
SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;
-- ----------------------------
-- Table structure for user
-- ----------------------------
DROP TABLE IF EXISTS `user`;
CREATE TABLE `user` (
`id` int(11) NOT NULL AUTO_INCREMENT,
`age` int(3) NOT NULL,
`name` varchar(30) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
PRIMARY KEY (`id`) USING BTREE
) ENGINE = MyISAM AUTO_INCREMENT = 3 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;
-- ----------------------------
-- Records of user
-- ----------------------------
INSERT INTO `user` VALUES (1, 21, 'admin');
INSERT INTO `user` VALUES (2, 22, 'test');
SET FOREIGN_KEY_CHECKS = 1;
首先,建立 SpringBoot 專案,引入 maven 依賴:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>2.0.1</version>
</dependency>
<!-- https://mvnrepository.com/artifact/com.baomidou/mybatis-plus-boot-starter -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
然後,配置資料庫資訊和資料庫方言:
server.port=8087
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://xx.xx.xx.xx:3306/test
spring.datasource.username=root
spring.datasource.password=root
package com.yanfei1819.mybatisplusdemo.config;
import com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* MyBatis Plus 的方言配置
* Created by 追夢1819 on 2019-05-17.
*/
@Configuration
public class MybatisPlusConfig {
@Bean
public PaginationInterceptor paginationInterceptor(){
PaginationInterceptor page = new PaginationInterceptor();
//設定方言型別
page.setDialectType("mysql");
return page;
}
}
下面再建立一個實體類,以對映資料庫欄位:
package com.yanfei1819.mybatisplusdemo.entity;
/**
* Created by 追夢1819 on 2019-05-17.
*/
public class User {
private Long id;
private String name;
private int age;
// get/set 省略
}
然後,建立代理介面:
package com.yanfei1819.mybatisplusdemo.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.yanfei1819.mybatisplusdemo.entity.User;
/**
* Created by 追夢1819 on 2019-05-17.
*/
//@Mapper
public interface UserMapper extends BaseMapper<User> {
}
這裡需要注意,需要通過啟動類的 @MapperScan
註解或者代理介面上的 @Mapper
註解(本示例中用的是前者)。
看到這一步,是不是很眼熟?很像前一篇的通用Mapper?
這裡說一句題外話,其實只要瞭解 MyBatis 的原理,自己都可以寫出想要的外掛。後續在 MyBatis 的專欄中,我將分析 Mybatis 的使用和原理。敬請關注。
最後建立一個測試介面方法:
package com.yanfei1819.mybatisplusdemo.web.controller;
import com.yanfei1819.mybatisplusdemo.entity.User;
import com.yanfei1819.mybatisplusdemo.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
/**
* Created by 追夢1819 on 2019-05-17.
*/
@RestController
public class UserController {
@Autowired
private UserMapper userMapper;
@GetMapping("/queryUsers")
public List<User> queryUsers(){
return userMapper.selectList(null);
}
}
啟動程式:
package com.yanfei1819.mybatisplusdemo;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
@MapperScan("com.yanfei1819.mybatisplusdemo.mapper")
public class MybatisPlusDemoApplication {
public static void main(String[] args) {
SpringApplication.run(MybatisPlusDemoApplication.class, args);
}
}
通過 postman 測試的結果:
常用API
該外掛封裝好的方法有很多,以上只是演示了其中的查詢列表的方法。下面是列舉幾個常用的方法。
當然,如果感興趣,想要了解更多,可以研究一下外掛中的原始碼:com.baomidou.mybatisplus.core.mapper.BaseMapper
。
/**
* 插入一條記錄
* @param entity 實體物件
*/
int insert(T entity);
/**
* 根據 ID 刪除
* @param id 主鍵ID
*/
int deleteById(Serializable id);
/**
* 根據 columnMap 條件,刪除記錄
*
* @param columnMap 表欄位 map 物件
*/
int deleteByMap(@Param(Constants.COLUMN_MAP) Map<String, Object> columnMap);
/**
* 根據 ID 修改
* @param entity 實體物件
*/
int updateById(@Param(Constants.ENTITY) T entity);
/**
* 根據 ID 查詢
* @param id 主鍵ID
*/
T selectById(Serializable id);
/**
* 根據 entity 條件,查詢全部記錄
* @param queryWrapper 實體物件封裝操作類(可以為 null)
*/
List<T> selectList(@Param(Constants.WRAPPER) Wrapper<T> queryWrapper);
程式碼生成器
這是這個外掛比較好用的一個功能。
為了更好的演示該功能,在本小節中重新新建一個工程:
首選,引入 maven 依賴:
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.1.0</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>2.2.0</version>
</dependency>
<!-- freemarker -->
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
</dependency>
此處要注意版本問題,mybatis-plus-boot-starter
用的是 3.0
以上的版本,mybatis-plus-boot-starter
用了 3.0
以下的版本。因為MyBatis-Plus 從 3.0.3
之後移除了程式碼生成器與模板引擎的預設依賴,需要手動新增相關依賴。此處為了簡化演示,故用了 3.0
以下的版本。
另外,MyBatis-Plus 支援 Velocity(預設)、Freemarker、Beetl,使用者可以選擇自己熟悉的模板引擎,也可以自定義自定義模板引擎。本篇用的是 Freemarker 。
下面,就是最程式碼生成工具了:
package com.yanfei1819.mybatisplusgeneratordemo.util;
import com.baomidou.mybatisplus.generator.AutoGenerator;
import com.baomidou.mybatisplus.generator.config.DataSourceConfig;
import com.baomidou.mybatisplus.generator.config.GlobalConfig;
import com.baomidou.mybatisplus.generator.config.PackageConfig;
import com.baomidou.mybatisplus.generator.config.StrategyConfig;
import com.baomidou.mybatisplus.generator.config.converts.MySqlTypeConvert;
import com.baomidou.mybatisplus.generator.config.rules.DbColumnType;
import com.baomidou.mybatisplus.generator.config.rules.DbType;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
/**
* <p>
* 程式碼生成器演示
* </p>
*/
public class CodeGenerator {
public static void main(String[] args) {
// assert (false) : "程式碼生成屬於危險操作,請確定配置後取消斷言執行程式碼生成!";
AutoGenerator mpg = new AutoGenerator();
// 選擇 freemarker 引擎,預設 Velocity
mpg.setTemplateEngine(new FreemarkerTemplateEngine());
// 全域性配置
GlobalConfig gc = new GlobalConfig();
gc.setAuthor("追夢1819");
gc.setOutputDir("F://私人文件/springboot/springboot-example/mybatis-plus-generator-demo/src/main/java");
gc.setFileOverride(false);// 是否覆蓋同名檔案,預設是false
gc.setActiveRecord(true);// 不需要ActiveRecord特性的請改為false
gc.setEnableCache(false);// XML 二級快取
gc.setBaseResultMap(true);// XML ResultMap
gc.setBaseColumnList(false);// XML columList
/* 自定義檔案命名,注意 %s 會自動填充表實體屬性! */
// gc.setMapperName("%sDao");
// gc.setXmlName("%sDao");
// gc.setServiceName("MP%sService");
// gc.setServiceImplName("%sServiceDiy");
// gc.setControllerName("%sAction");
mpg.setGlobalConfig(gc);
// 資料來源配置
DataSourceConfig dsc = new DataSourceConfig();
dsc.setDbType(DbType.MYSQL);
dsc.setTypeConvert(new MySqlTypeConvert() {
// 自定義資料庫表欄位型別轉換【可選】
@Override
public DbColumnType processTypeConvert(String fieldType) {
System.out.println("轉換型別:" + fieldType);
// 注意!!processTypeConvert 存在預設型別轉換,如果不是你要的效果請自定義返回、非如下直接返回。
return super.processTypeConvert(fieldType);
}
});
dsc.setDriverName("com.mysql.jdbc.Driver");
dsc.setUsername("root");
dsc.setPassword("pass123");
dsc.setUrl("jdbc:mysql://192.168.1.88:3306/test?serverTimezone=GMT%2B8");
mpg.setDataSource(dsc);
// 策略配置
StrategyConfig strategy = new StrategyConfig();
// strategy.setCapitalMode(true);// 全域性大寫命名 ORACLE 注意
strategy.setTablePrefix(new String[] { "user_" });// 此處可以修改為您的表字首
strategy.setNaming(NamingStrategy.nochange);// 表名生成策略
strategy.setInclude(new String[] { "user" }); // 需要生成的表
// strategy.setExclude(new String[]{"test"}); // 排除生成的表
// 自定義實體父類
// strategy.setSuperEntityClass("com.baomidou.demo.TestEntity");
// 自定義實體,公共欄位
// strategy.setSuperEntityColumns(new String[] { "test_id", "age" });
// 自定義 mapper 父類
// strategy.setSuperMapperClass("com.baomidou.demo.TestMapper");
// 自定義 service 父類
// strategy.setSuperServiceClass("com.baomidou.demo.TestService");
// 自定義 service 實現類父類
// strategy.setSuperServiceImplClass("com.baomidou.demo.TestServiceImpl");
// 自定義 controller 父類
// strategy.setSuperControllerClass("com.baomidou.demo.TestController");
// 【實體】是否生成欄位常量(預設 false)
// public static final String ID = "test_id";
// strategy.setEntityColumnConstant(true);
// 【實體】是否為構建者模型(預設 false)
// public User setName(String name) {this.name = name; return this;}
// strategy.setEntityBuilderModel(true);
mpg.setStrategy(strategy);
// 包配置
PackageConfig pc = new PackageConfig();
pc.setParent("com.yanfei1819.mybatisplusgeneratordemo");
// pc.setModuleName("test");
mpg.setPackageInfo(pc);
// 注入自定義配置,可以在 VM 中使用 cfg.abc 【可無】
// InjectionConfig cfg = new InjectionConfig() {
// @Override
// public void initMap() {
// Map<String, Object> map = new HashMap<String, Object>();
// map.put("abc", this.getConfig().getGlobalConfig().getAuthor() +
// "-mp");
// this.setMap(map);
// }
// };
//
// // 自定義 xxList.jsp 生成
// List<FileOutConfig> focList = new ArrayList<>();
// focList.add(new FileOutConfig("/template/list.jsp.vm") {
// @Override
// public String outputFile(TableInfo tableInfo) {
// // 自定義輸入檔名稱
// return "D://my_" + tableInfo.getEntityName() + ".jsp";
// }
// });
// cfg.setFileOutConfigList(focList);
// mpg.setCfg(cfg);
//
// // 調整 xml 生成目錄演示
// focList.add(new FileOutConfig("/templates/mapper.xml.vm") {
// @Override
// public String outputFile(TableInfo tableInfo) {
// return "/develop/code/xml/" + tableInfo.getEntityName() + ".xml";
// }
// });
// cfg.setFileOutConfigList(focList);
// mpg.setCfg(cfg);
//
// // 關閉預設 xml 生成,調整生成 至 根目錄
// TemplateConfig tc = new TemplateConfig();
// tc.setXml(null);
// mpg.setTemplate(tc);
// 自定義模板配置,可以 copy 原始碼 mybatis-plus/src/main/resources/templates 下面內容修改,
// 放置自己專案的 src/main/resources/templates 目錄下, 預設名稱一下可以不配置,也可以自定義模板名稱
// TemplateConfig tc = new TemplateConfig();
// tc.setController("...");
// tc.setEntity("...");
// tc.setMapper("...");
// tc.setXml("...");
// tc.setService("...");
// tc.setServiceImpl("...");
// 如上任何一個模組如果設定 空 OR Null 將不生成該模組。
// mpg.setTemplate(tc);
// 執行生成
mpg.execute();
// 列印注入設定【可無】
// System.err.println(mpg.getCfg().getMap().get("abc"));
}
}
可以看到,所有的配置都在這個類中(當然不是每一項配置都是必須的,“按需所取”)。
執行該類,能夠得到結果:
條件構造器
簡單說,就是通過方法把條件封裝好,直接寫入引數即可。個人並不推薦這種方式,因為可讀性並不強,有點封裝過度。如果感興趣的小夥伴,可以看看 官方文件 ,寫得很詳細。
參考
- MyBatis Plus 官網:https://mp.baomidou.com/
- 原始碼:com.baomidou.mybatisplus.core.mapper.BaseMapper
總結
其實就個人來說,我並不喜歡這個工具。因為它給我的感覺是封裝過度了,從某種程度上來說,把簡單問題複雜化了。
常規的 CRUD 操作,對應問題的解決方案有很多,比就如上一篇文章【SpringBoot第六篇:整合通用Mapper】中說到的通用Mapper,就是我比較喜歡的解決方案。
針對程式碼生成器和條件生成器,那就是“蘿蔔白菜,各有所愛”了。
當然,這只是個人的觀點。技術與框架的選擇,是多個因素的綜合考慮的結果。