Mybatis Plus之内置Mapper实践
MyBatis Plus，作为对MyBatis的进一步增强，大大简化了我们的开发流程，提高了开发速度
配置
由于Mybatis Plus是建立在Mybatis之上的，所以其已经依赖了Mybatis，故我们无需在项目中显式地重复添加Mybatis依赖。直接在POM文件中Mybatis Plus依赖即可
<!--Mybatis Plus-->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-boot-starter</artifactId>
<version>3.4.1</version>
</dependency>
Mapper CRUD操作
在Mybatis下，需要我们自行编写Mapper接口文件、提供sql的的xml文件。众所周知，这些CRUD的接口写起来不仅繁琐还容易出错，为此在Mybatis Plus中提供了内置的Mapper。高效实现CRUD操作
-- 创建数据表
create table t_people_info (
id int not null auto_increment comment 'ID',
name varchar(255) null comment '姓名',
sex varchar(255) null comment '性别',
primary key (id)
) comment '信息表';
POJO类定义如下，这里展示了@TableName、@TableField注解的用法
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
@TableName("t_people_info") // 指定数据库的表名
public class People {
/**
* ID
*/
private int id;
/**
* 姓名
*/
@TableField("name") // 该属性在数据表中对应的字段名
private String username;
/**
* 性别
*/
private String sex;
/**
* 职业
*/
@TableField(exist = false) // 该属性在数据表中不存在
private String job;
}
而Mapper接口文件只需继承BaseMapper即可获得Mybatis Plus提供的基本的CRUD功能，无需我们定义接口及相关的SQL。当然如果需要复杂的操作直接在PeopleMapper接口中继续添加即可
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
public interface PeopleMapper extends BaseMapper<People> {
}
增
public class ProperService {
@Autowired
private PeopleMapper peopleMapper;
public void testInsert() {
List<People> list = new LinkedList<>();
list.add( People.builder().username("小明").build() );
list.add( People.builder().id(10).username("老王").sex("男").build() );
list.add( People.builder().id(11).username("老张").sex("女").build() );
list.add( People.builder().id(12).sex("女").build() );
for (People people : list) {
peopleMapper.insert(people);
}
}
}
删
根据ID删除及批量操作，方式如下
/**
* 根据ID删除
*/
public void testDeleteById() {
peopleMapper.deleteById(10);
}
/**
* 根据ID批量删除
*/
public void testDeleteByIds() {
List ids = new LinkedList();
ids.add(11);
ids.add(12);
peopleMapper.deleteBatchIds( ids );
}
与此同时，也支持基于条件的删除
/**
* 根据条件删除
*/
public void testDeleteByParam1() {
// 表字段map
Map map = new HashMap();
// Note：这里设置条件应使用数据表的字段名，而不是Java类的属性名
map.put("name", "匿名用户");
map.put("sex", "男");
// 多个条件为and的关系
int num = peopleMapper.deleteByMap(map);
System.out.println("delete num : " + num);
}
/**
* 根据条件删除
*/
public void testDeleteByParam2() {
// Note：此时其实隐含了 id为null 的条件
People people = People.builder()
.username("翠花")
.sex("女")
.build();
// 多个条件为and的关系
QueryWrapper<People> wrapper = new QueryWrapper<>(people);
int num = peopleMapper.delete( wrapper );
System.out.println("delete num : " + num);
}
改
同理对于更新操作，支持基于ID的操作方式
/**
* 根据ID更新
*/
public void testUpdateById() {
People people = People.builder()
.id(3)
.username("孙尚香")
.build();
peopleMapper.updateById(people);
}
上述更新语句执行后会发现，id为3的记录，对于name字段确实被更新为 "孙尚香" 了，但是如果sex字段并不会被更新为 NULL。这是因为@TableField注解的updateStrategy属性默认为NOT_NULL所导致的。该属性常用的值及释义如下所示
- NOT_NULL：要求新值非NULL
- NOT_EMPTY：要求新值非NULL、非空字符串
- IGNORED：新值可以为NULL、空字符串
故我们在sex属性上使用@TableField注解，并把updateStrategy设置为FieldStrategy.IGNORED后，上述测试代码对sex字段的更新才会生效
/**
* 性别
*/
@TableField(updateStrategy = FieldStrategy.IGNORED)
private String sex;
与此同时，也支持基于条件的更新。而且可以看到在基于ID的更新方式中，需要修改@TableField注解的updateStrategy属性，来保证可以更新为NULL、空字符串。显然非常麻烦，而且容易出错。而通过updateWrapper的set方法来设置新值，显式地设置NULL值就非常直观了，不容易出错
/**
* 根据条件更新
*/
public void testUpdateByParam() {
UpdateWrapper<People> updateWrapper = new UpdateWrapper<>();
// Note：这里应使用数据表的字段名，而不是Java类的属性名
// where 条件：id 大于 50
updateWrapper.gt("id",50);
// set 新值：sex 更新为 男
updateWrapper.set("sex","男");
// set 新值：name 更新为 NULL
updateWrapper.set("name","null");
// 多个条件为and的关系
peopleMapper.update(null, updateWrapper);
}
查
根据ID查询及批量操作，方式如下
/**
* 根据ID查询
*/
public void testSelectById() {
People people = peopleMapper.selectById(1);
System.out.println("people: " + people);
}
/**
* 根据ID批量查询
*/
public void testSelectByIds() {
List list = new LinkedList();
list.add(1);
list.add(2);
list.add(3);
List<People> peopleList = peopleMapper.selectBatchIds(list);
peopleList.forEach(System.out::println);
}
与此同时，也支持基于条件的查询。其中查询条件为空，则查询全部
/**
* 根据条件查询。其中查询条件为空，则查询全部
*/
public void testSelectAll() {
List<People> list = peopleMapper.selectList(null);
list.forEach( System.out::println );
}
/**
* 根据条件查询
*/
public void testSelectByParam1() {
QueryWrapper<People> queryWrapper = new QueryWrapper<>();
// Note：这里设置条件应使用数据表的字段名，而不是Java类的属性名
// 条件：性别为男
queryWrapper.eq("sex", "男");
// 条件：id 小于等于 100
queryWrapper.le("id", 50);
// 多个条件为and的关系
List<People> list = peopleMapper.selectList(queryWrapper);
list.forEach(System.out::println);
}
/**
* 根据条件查询
*/
public void testSelectByParam2() {
// 表字段map
Map<String, Object> map = new HashMap<>();
map.put("sex", "女");
// Note：这里设置条件应使用数据表的字段名，而不是Java类的属性名
map.put("name", "佳丽");
// 多个条件为and的关系
List<People> list = peopleMapper.selectByMap(map);
list.forEach(System.out::println);
}
有时候我们还需要进行分页查询，在Mybatis Plus下也是非常方便的，只需配置下分页插件即可
@Configuration
public class MybatisPlusConfig {
/**
* Mybatis Plus 分页插件
* @return
*/
@Bean
public MybatisPlusInterceptor innerInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
return interceptor;
}
}
关于分页查询的操作方式如下所示：
/**
* 分页查询
*/
public void testSelectByPage() {
// 查询条件
QueryWrapper<People> queryWrapper = new QueryWrapper<>();
// Note：这里设置条件应使用数据表的字段名，而不是Java类的属性名
// 条件：id 大于 2
queryWrapper.gt("id", 2);
// 条件：name字段 (右)模糊匹配 "张%"
queryWrapper.likeRight("name", "张");
// 分页参数: 页码:2, 单页大小：10
Page<People> page = new Page<>(2,10);
// 分页查询, 多个条件为and的关系
Page<People> result = peopleMapper.selectPage(page2, queryWrapper);
System.out.println("people List: " + result.getRecords() );
}
逻辑删除
对于内置Mapper，Mybatis Plus可以自动支持逻辑删除的功能。通过@TableLogic注解指定逻辑删除字段即可
/**
* 逻辑删除标识，invalid:无效；valid:有效
*/
@TableLogic
private String flag;
而对于逻辑未删除的值、已删除的值即可直接通过注解配置，亦可进行全局配置
# Mybatis Plus 全局设置，逻辑已删除值
mybatis-plus.global-config.db-config.logic-delete-value=invalid
# Mybatis Plus 全局设置，逻辑未删除值
mybatis-plus.global-config.db-config.logic-not-delete-value=valid为了实现逻辑删除，内置Mapper在自动注入SQL时也会发生一些变化。具体地：
- 插入：无变化
- 查找：一方面会追加where条件以过滤掉已删除的记录，另一方面，通过wrapper指定条件也会忽略逻辑删除字段的条件
- 更新：一方面会追加where条件防止对已删除的记录进行更新，另一方面，通过wrapper指定条件也会忽略逻辑删除字段的条件
- 删除：转变为更新语句，将 逻辑删除字段 设置为 逻辑已删除值
Note
对于主键，Mybatis Plus还支持在未指定主键的时候自动生成ID或UUID。具体地，其支持对某个表的单独设置、全局设置。前者可通过在主键属性上设置@TableId注解的type属性为IdType.ASSIGN_ID、IdType.ASSIGN_UUID实现；后者则可通过在配置文件中设置配置项 mybatis-plus.global-config.db-config.id-type 为 assign_id、assign_uuid 实现
