提高生产力,MyBatisPlus 讲解!

开发 前端
MP 全称 Mybatis-Plus ,套用官方的解释便是成为 MyBatis 最好的搭档,简称基友。它是在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。

[[355885]]

本文转载自微信公众号「小菜良记」,作者蔡不菜丶。转载本文请联系小菜良记公众号。  

一、MP 是什么

MP 全称 Mybatis-Plus ,套用官方的解释便是成为 MyBatis 最好的搭档,简称基友。它是在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。

1. 三大特性

1)润物无声

只做增强不做改变,引入它不会对现有工程产生影响,如丝般顺滑。

2)效率至上

只需简单配置,即可快速进行单表 CRUD 操作,从而节省大量时间。

3)丰富功能

代码生成、物理分页、性能分析等功能一应俱全。

2. 支持数据库

mysql 、mariadb 、oracle 、db2 、h2 、hsql 、sqlite 、postgresql 、sqlserver 、presto 、Gauss 、Firebird

Phoenix 、clickhouse 、Sybase ASE 、 OceanBase 、达梦数据库 、虚谷数据库 、人大金仓数据库 、南大通用数据库

3. 框架结构

实话说,以上这些内容只要你打开官网也能看到,那么我们接下来就先来实际操作一番!

二、MP实战

1. 手摸手式项目练习

1)数据库及表准备

sql 语句:

 

  1. use test; 
  2. CREATE TABLE `student`  ( 
  3.   `id` int(0) NOT NULL AUTO_INCREMENT, 
  4.   `dept_id` int(0) NULL DEFAULT NULL
  5.   `namevarchar(16) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NULL DEFAULT NULL
  6.   `remark` varchar(32) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NULL DEFAULT NULL
  7.   PRIMARY KEY (`id`) USING BTREE 
  8. ) ENGINE = InnoDB AUTO_INCREMENT = 7 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_bin ROW_FORMAT = Dynamic
  9. -- ---------------------------- 
  10. -- Records of student 
  11. -- ---------------------------- 
  12. INSERT INTO `student` VALUES (1, 1, '小菜''关注小菜不迷路!'); 
  13. INSERT INTO `student` VALUES (2, 2, '小明''好好学习,天天向上!'); 

2)pom 依赖

 

  1. <dependency> 
  2.     <groupId>org.springframework.boot</groupId> 
  3.     <artifactId>spring-boot-starter-test</artifactId> 
  4. </dependency> 
  5. <!--lombok--> 
  6. <dependency> 
  7.     <groupId>org.projectlombok</groupId> 
  8.     <artifactId>lombok</artifactId> 
  9.     <version>1.16.16</version> 
  10. </dependency> 
  11. <!--MP插件--> 
  12. <dependency> 
  13.     <groupId>com.baomidou</groupId> 
  14.     <artifactId>mybatis-plus-boot-starter</artifactId> 
  15.     <version>3.2.0</version> 
  16. </dependency> 
  17. <!--Mysql--> 
  18. <dependency> 
  19.     <groupId>mysql</groupId> 
  20.     <artifactId>mysql-connector-java</artifactId> 
  21.     <version>8.0.21</version> 
  22. </dependency> 
  23. <!-- 连接池 --> 
  24. <dependency> 
  25.     <groupId>com.alibaba</groupId> 
  26.     <artifactId>druid</artifactId> 
  27.     <version>1.2.1</version> 
  28. </dependency> 
  29. <!--JUNIT--> 
  30. <dependency> 
  31.     <groupId>junit</groupId> 
  32.     <artifactId>junit</artifactId> 
  33.     <version>4.13.1</version> 
  34. </dependency> 

3)配置文件

 

  1. spring: 
  2.   datasource: 
  3.     url: jdbc:mysql://localhost:3306/test 
  4.     username: root 
  5.     password: 123456 
  6.     driver-class-name: com.mysql.cj.jdbc.Driver 

4)实体类

 

  1. @Data 
  2. @Builder 
  3. @TableName("student"
  4. public class User { 
  5.  
  6.     @TableId(type = IdType.AUTO) 
  7.     private Integer id; 
  8.  
  9.     private Integer deptId; 
  10.  
  11.     private String name
  12.  
  13.     private String remark; 

5)Mapper

  1. public interface UserMapper extends BaseMapper<User> {} 

6)测试类

 

  1. @RunWith(SpringRunner.class) 
  2. @SpringBootTest 
  3. public class MapperTest { 
  4.  
  5.     @Autowired 
  6.     private UserMapper userMapper; 
  7.  
  8.     @Test 
  9.     public void getAll() { 
  10.         List<User> users = userMapper.selectList(null); 
  11.         users.forEach(System.out::println); 
  12.     } 
  13. /** OUTPUT
  14. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  15. User(id=2, deptId=1, name=小明, remark=好好学习,天天向上!) 
  16. **/ 

小菜结:

在以上的结果,我们可以看到已经打印出了数据库中的全部数据(两条)。而并没有看到平时我们需要写的 mapper.xml 文件,只是用到了 usermapper 中的 selectList() 方法,而 UserMapper 继承了 BaseMapper 这个接口,这个接口便是 MybatisPlus 提供给我们的,我们再来看下这个接口给我们提供了哪些方法。

2. CRUD 基操

1)insert

 

  1. @Test 
  2. public void insert() { 
  3.     //这里使用了 lombok 中的建造者模式构建对象 
  4.     User user = User.builder().deptId(1).name("小华").remark("小华爱学习").build(); 
  5.     int insertFlag = userMapper.insert(user); 
  6.     log.info("插入影响行数,{} | 小华的ID: {}", insertFlag, user.getId()); 
  7. /** OUTPUT
  8. 插入影响行数,1 | 小华的ID: 8 
  9. **/ 

可以看到我们不仅插入了数据,而且还获取到了插入数据的ID,但是值得注意的是这里的 ID 虽然是自增的,但并非是 MP 默认的 ID生成策略,而是我们在实体类中指定的:

在 MP 中支持的主键生成策略有以下几种:

我们既然已经看到了 @TableId 这个注解,那我们再来关注一个常用注解 @TableField

从注解名上我们就可以看出,@TableId 是用来标记主键 ID 的,而 @TableField 是用来标记其他字段的。

可以看得出来这个注解中存在的值还是比较多的,下面介绍几个常用的值:

  • value

用于解决字段名不一致问题和驼峰命名,比如实体类中属性名为 remark,但是表中的字段名为 describe ,这个时候就可以使用 @TableField(value="describe") 来进行转换。驼峰转换如果在全局中有配置驼峰命名,这个地方可不写。

  • exist

用于在数据表中不存在的字段,我们可以使用 @TableField(exist = false) 来进行标记

  • condition

用在预处理 WHERE 实体条件自定义运算规则,比如我配置了 @TableField(condition = SqlCondition.LIKE),输出 SQL 为:select 表 where name LIKE CONCAT('%',值,'%'),其中 SqlCondition 值如下:

  • update

用在预处理 set 字段自定义注入,比如我配置了 @TableField(update = "%s+1"),其中 %s 会填充字段,输出 SQL 为:update 表名 set 字段 = 字段+1 where 条件

  • select

用于是否查询时约束,如果我们有个字段 remark 是 text 类型的,查询的时候不想查询该字段,那么就可以使用 @TableField(select = false) 来约束查询的时候不查询该字段

2)update

MybatisPlus 的更新操作存在两种:

 

  1. int updateById(Param("et") T entity); 
  2.  
  3. int update(@Param("et") T entity, @Param("ew") Wrapper<T> updateWrapper); 

根据 ID 更新

 

  1. @Test 
  2. public void update() { 
  3.     User user = User.builder().id(3).name("小华").remark("小华爱玩游戏").build(); 
  4.     userMapper.updateById(user); 
  5. /** 更新结果: 
  6. User(id=3, deptId=1, name=小华, remark=小华爱玩游戏) 
  7. **/ 

根据条件更新

 

  1. @Test 
  2. public void update() { 
  3.     UpdateWrapper<User> updateWrapper = new UpdateWrapper<>(); 
  4.     updateWrapper.eq("name","小华").set("remark","小华爱下棋"); 
  5.     userMapper.update(null, updateWrapper); 
  6. /** 更新结果: 
  7. User(id=3, deptId=1, name=小华, remark=小华爱下棋) 
  8. **/ 

我们也可以将要更新的条件放进 user 对象 里面:

 

  1. @Test 
  2. public void update() { 
  3.     UpdateWrapper<User> updateWrapper = new UpdateWrapper<>(); 
  4.     updateWrapper.eq("name","小华"); 
  5.     User user = User.builder().remark("小华爱游泳").build(); 
  6.     userMapper.update(user, updateWrapper); 
  7. /** 更新结果: 
  8. User(id=3, deptId=1, name=小华, remark=小华爱游泳) 
  9. **/ 

3)delete

在 MybatisPlus 中删除的方式相对于更新多,总共有四种:

 

  1. int deleteById(Serializable id); 
  2.  
  3. int deleteByMap(@Param("cm") Map<String, Object> columnMap); 
  4.  
  5. int delete(@Param("ew") Wrapper<T> wrapper); 
  6.  
  7. int deleteBatchIds(@Param("coll") Collection<? extends Serializable> idList); 

根据 ID 删除

 

  1. @Test 
  2. public void deleteById() { 
  3.     userMapper.deleteById(3); 
  4. /** SQL语句: 
  5. DELETE FROM student WHERE id = 3; 
  6. **/ 

根据 Map 删除

 

  1. @Test 
  2. public void deleteByMap() { 
  3.     HashMap<String, Object> columnMap = new HashMap<>(); 
  4.     columnMap.put("name","小华"); 
  5.     columnMap.put("remark","小华爱游泳"); 
  6.     userMapper.deleteByMap(columnMap); 
  7. /** SQL语句: 
  8. DELETE FROM student WHRE name = '小华' AND remark = '小华爱游泳'
  9. **/ 

根据 Wrapper 删除

 

  1. @Test 
  2. public void delete() { 
  3.     UpdateWrapper<User> wrapper = new UpdateWrapper<>(); 
  4.     wrapper.eq("remark","小华爱下棋"); 
  5.     userMapper.delete(wrapper); 
  6. /** SQL语句: 
  7. DELETE FROM student WHRE remark = '小华爱下棋'
  8. **/ 

根据 Wrapper 删除还有另外一种方式,直接将实体类放入 Wrapper 中包装:

 

  1. @Test 
  2. public void delete() { 
  3.     User user = User.builder().remark("小华爱下棋").build(); 
  4.     UpdateWrapper<User> wrapper = new UpdateWrapper<>(user); 
  5.     userMapper.delete(wrapper); 
  6. /** SQL语句: 
  7. DELETE FROM student WHRE remark = '小华爱下棋'
  8. **/ 

根据 ID 批量删除

 

  1. @Test 
  2. public void deleteBatchIds() { 
  3.     List<Integer> idList = new ArrayList<>(); 
  4.     idList.add(4); 
  5.     idList.add(7); 
  6.     userMapper.deleteBatchIds(idList); 
  7. /** SQL语句: 
  8. DELETE FROM student WHERE id In (4,7) 
  9. **/ 

4)select

查询操作在我们开发中是最经常用到的,也是重中之重。MybatisPlus 中支持查询的方法也比较多,如下:

 

  1. T selectById(Serializable id); 
  2.  
  3. List<T> selectBatchIds(@Param("coll") Collection<? extends Serializable> idList); 
  4.  
  5. List<T> selectByMap(@Param("cm") Map<String, Object> columnMap); 
  6.  
  7. T selectOne(@Param("ew") Wrapper<T> queryWrapper); 
  8.  
  9. Integer selectCount(@Param("ew") Wrapper<T> queryWrapper); 
  10.  
  11. List<T> selectList(@Param("ew") Wrapper<T> queryWrapper); 
  12.  
  13. List<Map<String, Object>> selectMaps(@Param("ew") Wrapper<T> queryWrapper); 
  14.  
  15. List<Object> selectObjs(@aram("ew") Wrapper<T> queryWrapper); 
  16.  
  17. IPage<T> selectPage(IPage<T> page, @Param("ew") Wrapper<T> queryWrapper); 
  18.  
  19. IPage<Map<String, Object>> selectMapsPage(IPage<T> page, @Param("ew") Wrapper<T> queryWrapper); 

可以看到总共有 10 个方法,我们接下来一个一个测试

查询所有

 

  1. @Test 
  2. public void selectList() { 
  3.     List<User> users = userMapper.selectList(null); 
  4.     users.forEach(System.out::println); 
  5. /**  
  6.  OUTPUT
  7. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  8. User(id=2, deptId=1, name=小明, remark=好好学习,天天向上!) 
  9.  SQL语句: 
  10. SELECT id, dept_id, name, remark FROM student; 
  11. **/ 

查询数量

 

  1. @Test 
  2. public void selectCount() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     queryWrapper.like("name","小"); 
  5.     System.out.println(userMapper.selectCount(queryWrapper)); 
  6. /**  
  7.  OUTPUT
  8.  SQL语句: 
  9. SELECT COUNT( 1 ) FROM student WHERE (name LIKE '%小%'); 
  10. **/ 

根据 ID 查询

 

  1. @Test 
  2. public void selectById() { 
  3.     User user = userMapper.selectById(1); 
  4.     System.out.println(user); 
  5. /**  
  6.  OUTPUT
  7. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  8.  SQL语句: 
  9. SELECT id, dept_id, name, remark FROM student WHERE ID = 1; 
  10. **/ 

根据 ID 批量查询

 

  1. @Test 
  2. public void selectBatchIds() { 
  3.     List<User> users = userMapper.selectBatchIds(Arrays.asList(1, 2)); 
  4.     users.forEach(System.out::println); 
  5. /**  
  6.  OUTPUT
  7. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  8. User(id=2, deptId=1, name=小明, remark=好好学习,天天向上!) 
  9.  SQL语句: 
  10. SELECT id, dept_id, name, remark FROM student WHERE ID IN (1, 2); 
  11. **/ 

根据条件查询单条

 

  1. @Test 
  2. public void selectOne() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     queryWrapper.eq("name","小菜"); 
  5.     User user = userMapper.selectOne(queryWrapper); 
  6.     System.out.println(user); 
  7. /** 
  8.  OUTPUT
  9. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  10.  SQL语句: 
  11.  SELECT id, name, dept_id, remark FROM student WHERE (name = '小菜'); 
  12. **/ 

根据条件查询多条

通过 map 传递参数,不是通过 LIKE 查询,而是通过 = 查询

 

  1. @Test 
  2. public void selectByMap() { 
  3.     HashMap<String, Object> columnMap = new HashMap<>(); 
  4.     columnMap.put("name","小"); 
  5.     List<User> users = userMapper.selectByMap(columnMap); 
  6.     users.forEach(System.out::println); 
  7. /** 
  8.  OUTPUT
  9. null 
  10.  SQL语句: 
  11. SELECT id, name, dept_id, remark FROM student WHERE name = '小'
  12. **/ 

如果我们没有新建实体类进行结果封装,我们还可以用 Map 来接收结果集:

 

  1. @Test 
  2. public void selectMaps() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     queryWrapper.like("name","小"); 
  5.     List<Map<String, Object>> maps = userMapper.selectMaps(queryWrapper); 
  6.     maps.forEach(System.out::println); 
  7. /** 
  8.  OUTPUT
  9. {name=小菜, remark=关注小菜不迷路!, id=1, dept_id=1} 
  10. {name=小明, remark=好好学习,天天向上!, id=2, dept_id=1} 
  11.  SQL语句: 
  12. SELECT id, name, dept_id, remark FROM student WHERE (name LIKE '%小%'); 
  13. **/ 

也可以用 Object 对象来接收结果集:

 

  1. @Test 
  2. public void selectObjs() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     queryWrapper.like("name""小"); 
  5.     List<Object> objects = userMapper.selectObjs(queryWrapper); 
  6. /** 
  7.  OUTPUT
  8. {name=小菜, remark=关注小菜不迷路!, id=1, dept_id=1} 
  9. {name=小明, remark=好好学习,天天向上!, id=2, dept_id=1} 
  10.  SQL语句: 
  11. SELECT id, name, dept_id, remark FROM student WHERE (name LIKE '%小%'); 
  12. **/ 

分页查询

 

  1. @Test 
  2. public void selectPage() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     queryWrapper.like("name""小"); 
  5.     Page<User> page = new Page<>(1, 1); 
  6.     IPage<User> userIPage = userMapper.selectPage(page, queryWrapper); 
  7.     System.out.println("数据总数:" + userIPage.getTotal()); 
  8.     System.out.println("总页数:" + userIPage.getPages()); 
  9.     System.out.println("当前页:" + userIPage.getCurrent()); 
  10.     System.out.println("页大小:" + userIPage.getSize()); 
  11.     userIPage.getRecords().forEach(System.out::println); 
  12. /** 
  13.  OUTPUT
  14. 数据总数:2 
  15. 总页数:2 
  16. 当前页:1 
  17. 页大小:1 
  18. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  19.  SQL语句: 
  20.  SELECT id, name, dept_id, remark 
  21.  FROM student 
  22.  WHERE (name LIKE '%小%'
  23.  LIMIT 0,1; 
  24. **/ 

3. 条件构造器

在 CRUD 的基本操作中,我们想要通过条件查询都是通过 Wrapper 类进行封装的,上面只是简单的用到 eq 和 like 操作。事实上这个类十分强大,我们在下面会详细进行介绍。

1)allEq

全部 eq 或个别 isNull

 

  1. allEq(Map<R, V> params) 
  2. allEq(Map<R, V> params, boolean null2IsNull) 
  3. allEq(boolean condition, Map<R, V> params, boolean null2IsNull) 
  4.      
  5. allEq(BiPredicate<R, V> filter, Map<R, V> params) 
  6. allEq(BiPredicate<R, V> filter, Map<R, V> params, boolean null2IsNull) 
  7. allEq(boolean condition, BiPredicate<R, V> filter, Map<R, V> params, boolean null2IsNull)  

参数说明:

 

  1. param: key 为数据库字段名,value 为字段值 
  2. **nullsIsNull:**为 true 则在 map 的 value 为 null 时调用 isNull 方法,为 false 时则忽略 value 为 null 时不调用 isNull 方法 
  3. filter: 过滤函数,判断是否允许字段传入比对条件中 

使用示例:

  • allEq(Map params)

 

  1. @Test 
  2. public void testAllEq() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     Map<String,Object> params = new HashMap<>(); 
  5.     params.put("name","小菜"); 
  6.     params.put("dept_id",1); 
  7.     params.put("remark",null); 
  8.     queryWrapper.allEq(params); //会调用 isNull 方法 
  9.     userMapper.selectList(queryWrapper); 
  10. /**  
  11.  结果: 
  12. {} 
  13.  SQL语句: 
  14.  SELECT id,name,dept_id,remark 
  15.  FROM student 
  16.  WHERE (name = '小菜' AND dept_id = 1 AND remark IS NULL); 
  17.  **/ 
  • allEq(Map params, boolean null2IsNull)

 

  1. @Test 
  2. public void testAllEq() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     Map<String,Object> params = new HashMap<>(); 
  5.     params.put("name","小菜"); 
  6.     params.put("dept_id",1); 
  7.     params.put("remark",null); 
  8.     queryWrapper.allEq(params, false); //不会调用 isNull 方法 
  9.     userMapper.selectList(queryWrapper); 
  10. /**  
  11.  结果: 
  12. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!) 
  13.  SQL语句: 
  14.  SELECT id,name,dept_id,remark 
  15.  FROM student 
  16.  WHERE (name = '小菜' AND dept_id = 1); 
  17.  **/ 
  • allEq(boolean condition, Map params, boolean null2IsNull)

 

  1. @Test 
  2. public void testAllEq() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     Map<String,Object> params = new HashMap<>(); 
  5.     params.put("name","小菜"); 
  6.     params.put("dept_id",1); 
  7.     params.put("remark",null); 
  8.     queryWrapper.allEq(false,params,false); //不会带入条件进行查询 
  9.     userMapper.selectList(queryWrapper); 
  10. /**  
  11.  结果: 
  12. {name=小菜, remark=关注小菜不迷路!, id=1, dept_id=1} 
  13. {name=小明, remark=好好学习,天天向上!, id=2, dept_id=1} 
  14.  SQL语句: 
  15.  SELECT id,name,dept_id,remark 
  16.  FROM student; 
  17.  **/ 
  • allEq(BiPredicate filter, Map params)

 

  1. @Test 
  2. public void testAllEq() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     Map<String, Object> params = new HashMap<>(); 
  5.     params.put("name""小菜"); 
  6.     params.put("dept_id", 1); 
  7.     params.put("remark"null); 
  8.     //只有 key 中含有 “m” 才会用作条件判断 
  9.     queryWrapper.allEq((k, v) -> (k.contains("m")), params); 
  10.     userMapper.selectList(queryWrapper); 
  11. /**  
  12.  结果: 
  13.  SQL语句: 
  14.  SELECT id,name,dept_id,remark 
  15.  FROM student 
  16.  WHERE (name = '小菜' AND remark IS NULL); 
  17.  **/ 

2)比较操作

  • eq: 相当于 =
  • ne: 相当于 !=
  • gt: 相当于 >
  • ge: 相当于>=
  • lt: 相当于 <
  • le: 相当于<=
  • between: 相当于between ... and ...
  • notBetween: 相当于not between ... and ...
  • in: 相当于in(.., .., ..)
  • notIn: 相当于not in(.., .., ..)

3)模糊查询

  • like: like("name","小菜") --> name like "%小菜%"
  • notLike: notLike("name","小菜") --> name not like "%小菜%"
  • likeLeft: like("name","小菜") --> name like "%小菜"
  • likeRight: like("name","小菜") --> name like "小菜%"

4)排序

  • orderBy:
  1. orderBy(boolean condition, boolean isAsc, R... columns) 

orderBy(true, true, "id", "name") --> order by id ASC, name ASC

  • orderByAsc:

orderByAsc("id","name") --> order by id ASC, name ASC

  • orderByDesc:

orderByDesc("id","name) --> order by id Desc, name Desc

5)逻辑查询

or:

拼接:主动调用 or 表示紧接着下一个方法不是用 and 连接!(不调用 or 则默认为使用 and 连接), eq("id",1).or().eq("name","老王")

嵌套:or(i -> i.eq("name", "李白").ne("status", "活着"))

and:

嵌套:and(i -> i.eq("name", "李白").ne("status", "活着"))

6)select

在MP查询中,默认查询所有的字段,如果有需要也可以通过select方法进行指定字段,如select("id", "name")

4. 配置讲解

1)基本配置

  • configLocation

用于指明 **MyBatis ** 配置文件的位置,如果我们有 MyBatis 的配置文件,需将配置文件的路径配置到 configLocation 中

SpringBoot:

  1. mybatis-plus.config-location = classpath:mybatis-config.xml 

SpringMvc:

  1. <bean id="sqlSessionFactory" 
  2. class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"
  3. <property name="configLocation" value="classpath:mybatis-config.xml"/> 
  4. </bean 
  • mapperLocations

用于指明 Mapper 所对应的 XML 的文件位置,我们在 通用 CRUD 中用到的 Mapper 是直接继承 MP 提供的 BaseMapper ,我们也可以自定义方法,然后在 XML 文件中自定义 SQL,而这时我们需要告诉 Mapper 所对应 XML 文件的位置

  • SpringBoot:
  1. mybatis-plus.mapper-locations = classpath*:mybatis/*.xml 

SpringMVC:

  1. <bean id="sqlSessionFactory" 
  2. class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"
  3. <property name="mapperLocations" value="classpath*:mybatis/*.xml"/> 
  4. </bean> 

用于 MyBatis 别名包扫描路径,通过该属性可以给包中的类注册别名,注册后在 Mapper 对应的 XML 文件中可以直接使用类名,而不用使用全限定的类名

SpringBoot:

  1. mybatis-plus.type-aliases-package = cbuc.life.bean 

SpringMVC:

  1. <bean id="sqlSessionFactory" 
  2. class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"
  3. <property name="typeAliasesPackage" 
  4. value="com.baomidou.mybatisplus.samples.quickstart.entity"/> 
  5. </bean> 

2)进阶配置

  • mapUnderScoreToCamelCase

是否开启自动驼峰命名规则映射,这个配置的默认值是 true,但是这个属性在 MyBatis 中的默认值是 false,所以在我们平时的开发中都会将这个配置开启。

 

  1. #关闭自动驼峰映射,该参数不能和mybatis-plus.config-location同时存在 
  2. mybatis-plus.configuration.map-underscore-to-camel-case = false 
  • cacheEnabled

全局地开启或关闭配置文件中的所有映射器已经配置的任何缓存,默认为 true。

  1. mybatis-plus.configuration.cache-enabled = false 

3)DB 策略配置

  • idType

全局默认主键类型,设置后,即可省略实体对象中的@TableId(type = IdType.AUTO)配置。该配置的默认值为 ID_WORKER

SpringBoot:

  1. mybatis-plus.global-config.db-config.id-type = auto 

SpringMVC:

  1. <bean id="sqlSessionFactory" 
  2. class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"
  3.  <property name="dataSource" ref="dataSource"/> 
  4.     <property name="globalConfig"
  5.         <bean class="com.baomidou.mybatisplus.core.config.GlobalConfig"
  6.             <property name="dbConfig"
  7.                 <bean         class="com.baomidou.mybatisplus.core.config.GlobalConfig$DbConfig"
  8.                  <property name="idType" value="AUTO"/> 
  9.                 </bean> 
  10.             </property> 
  11.         </bean> 
  12.     </property> 
  13. </bean> 
  • tablePrefix

表名前缀,全局配置后可省略@TableName()配置。该配置的默认值为 null

SpringBoot:

  1. mybatis-plus.global-config.db-config.table-prefix = yq_ 

SpringMVC:

  1. <bean id="sqlSessionFactory" 
  2. class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"
  3.     <property name="dataSource" ref="dataSource"/> 
  4.     <property name="globalConfig"
  5.         <bean class="com.baomidou.mybatisplus.core.config.GlobalConfig"
  6.             <property name="dbConfig"
  7.                 <bean            class="com.baomidou.mybatisplus.core.config.GlobalConfig$DbConfig"
  8.                  <property name="idType" value="AUTO"/> 
  9.                  <property name="tablePrefix" value="yq_"/> 
  10.                 </bean> 
  11.             </property> 
  12.         </bean> 
  13.     </property> 
  14. </bean> 

5. 其他扩展

1)自动填充

有时候我们在插入或更新数据的时候,希望有些字段可以自动填充。比如我们平时数据表里面会有个 插入时间 或者 更新时间 这种字段,我们会默认以当前时间填充,在 MP 中我们也可以进行配置。

首先我们需要借助 @TableField(fill = FieldFill.INSERT) 这个注解,在插入时进行填充。

 

  1. @TableField(fill = FieldFill.INSERT
  2. private String remark; 

其中自动填充的模式如下:

 

  1. public enum FieldFill { 
  2.     /** 
  3.     * 默认不处理 
  4.     */ 
  5.     DEFAULT
  6.     /** 
  7.     * 插入时填充字段 
  8.     */ 
  9.     INSERT
  10.     /** 
  11.     * 更新时填充字段 
  12.     */ 
  13.     UPDATE
  14.     /** 
  15.     * 插入和更新时填充字段 
  16.     */ 
  17.     INSERT_UPDATE 

然后我们再编写自定义的填充处理模式:

 

  1. @Component 
  2. public class MyMetaObjectHandler implements MetaObjectHandler { 
  3.     @Override 
  4.     public void insertFill(MetaObject metaObject) { 
  5.         Object remark = getFieldValByName("remark", metaObject); 
  6.         if (null == remark) { 
  7.             setFieldValByName("remark""好好学习", metaObject); 
  8.         } 
  9.     } 
  10.  
  11.     @Override 
  12.     public void updateFill(MetaObject metaObject) { 
  13.   //自定义更新时填充 
  14.     } 

测试:

 

  1. @Test 
  2. public void testObjectHandler() { 
  3.     User user = User.builder().deptId(1).name("小明").build(); 
  4.     userMapper.insert(user); 
  5. /** 
  6.  SQL语句: 
  7. INSERT INTO student ( name, dept_id, remark ) 
  8. VALUES ( '小明', 1, '好好学习' ); 
  9. **/ 

可以看到插入时,已经自动将我们填充的字段合并进去。

2)逻辑删除

在开发中,很多时候我们删除数据并不需要真正意义上的物理删除,而是使用逻辑删除,这样子查询的时候需要状态条件,确保被标记的数据不被查询到。MP 当然也支持这样的功能。

我们需要先为 student 表添加一个字段 status 来声明数据是否被删除,0 表示被删除,1表示未删除,然后也需要在实体类上增加这个属性:

 

  1. @TableLogic 
  2. private Integer status; 

在 application.yaml 中配置:

 

  1. mybatis-plus: 
  2.   global-config: 
  3.     db-config: 
  4.       logic-delete-value: 0 
  5.       logic-not-delete-value: 1 

测试:

 

  1. @Test 
  2. public void testLogicDelete() { 
  3.     userMapper.deleteById(1); 
  4. /** 
  5.  SQL语句: 
  6. UPDATE student SET status=0 
  7. WHERE id=1 AND status=1; 
  8. **/ 

可以看出这段 SQL 并没有真正删除,而是进行了逻辑删除,只是更新了删除标识

3)通用枚举

如果有性别之类的字段,我们通常会用 0 和 1 来表示,但是查出来我们得进行值转换,这个时候我们就可以使用枚举来解决这个问题:

首先为 student 表添加一个 sex 字段来表示性别,0 表示女性,1 表示男性,然后定义一个枚举类:

 

  1. public enum SexEnum implements IEnum<Integer> { 
  2.     MAN(1, "男"), 
  3.     WOMEN(0, "女"); 
  4.  
  5.     private int code; 
  6.  
  7.     private String value; 
  8.  
  9.     SexEnum(int code, String value) { 
  10.         this.code = code; 
  11.         this.value = value; 
  12.     } 
  13.  
  14.     @Override 
  15.     public Integer getValue() { 
  16.         return this.code; 
  17.     } 
  18.      
  19.     //注意要重写此方法,不然会将值转换成 ‘MAN’,而不是 ‘男’ 
  20.     @Override 
  21.     public String toString() { 
  22.         return this.value; 
  23.     } 

然后在实体类中添加对应属性:

  1. private SexEnum sex; 

在 application.yaml 中配置:

 

  1. mybatis-plus: 
  2.   type-enums-package: cbuc.life.enums 

测试:

 

  1. @Test 
  2. public void selectOne() { 
  3.     QueryWrapper<User> queryWrapper = new QueryWrapper<>(); 
  4.     queryWrapper.eq("name""小菜"); 
  5.     User user = userMapper.selectOne(queryWrapper); 
  6.     System.out.println(user); 
  7. /** 
  8.  输出结果: 
  9. User(id=1, deptId=1, name=小菜, remark=关注小菜不迷路!, status=1, sex=男) 
  10.  SQL语句: 
  11.  SELECT id,sex,name,dept_id,remark,status 
  12.  FROM student 
  13.  WHERE status=1 AND (name = '小菜'); 
  14. **/ 

END

这篇文章写到这里就告一段落了哦,内容有点长,不过如果能完整看下来,我相信你肯定能够很好的使用 MybatisPlus 啦!路漫漫,小菜与你一同求索!

 

责任编辑:武晓燕 来源: 小菜良记
相关推荐

2023-02-13 08:34:26

Linux键盘快捷键

2020-10-28 10:25:11

云端云计算云迁移

2024-04-01 14:24:05

数字信任人工智能

2023-04-06 09:53:21

Harbor企业级服务

2010-07-28 15:02:52

Compuwareworkbench

2023-07-07 14:51:34

2023-10-31 18:01:26

安全扫描代码

2022-01-10 10:45:16

大数据大数据动向数据技术

2021-05-24 10:25:25

AR虚拟技术

2018-01-03 11:51:06

KotlinTipsJava

2023-07-04 09:00:00

开发SPACE框架

2022-03-04 11:22:37

Vim编辑器编辑文件

2019-11-22 15:59:49

JavaScript开发工具

2012-08-27 13:30:21

BYOD

2013-04-22 18:14:27

LANDesk蓝代斯克

2020-07-24 07:00:00

Scrum工具

2016-06-15 14:19:45

Visual Stud插件

2020-03-08 21:37:13

JavaScript前端工具

2023-12-27 11:40:07

2018-04-18 10:04:56

数字化 CIO
点赞
收藏

51CTO技术栈公众号