概述
Mybatis支持定制化SQL、存储过程以及高级映射,避免几乎所有的 JDBC 代码和手动设置参数以及获取结果集。可以使用简单的 XML 或注解来配置和映射原生信息,将接口和Java的POJO映射成数据库中的记录。
缺点:
SQL工作量很大,尤其是字段较多时。单表的增删改查操作可以通过mybatis generator工具来生成(或自己写模板工具生成),但项目开发的过程中总免不了要新添加新字段,得把新字段写到原来的所有增删改查的sql中。
mybatis的单表操作比较麻烦,因为筛选的条件可能会各种各样,所以不得不写很多动态sql来兼容查询条件。
MybatisPlus(简称MP)的出现,可以一定程度上优化上述问题,MP集Mybatis与Hibernate的优点。提供Hibernate的单表CRUD操作的方便同时,又保留Mybatis的特性。在Mybatis的基础上只做增强不做改变,为简化开发、提高效率而生。
特点:
- 无侵入:只做增强不做改变
- 损耗小:启动即自动注入基本CRUD,直接面向对象操作
- 强大的CRUD操作:内置通用Mapper、Service,通过少量配置即可实现单表大部分CRUD操作,还有条件构造器
- 支持多种数据库:
- 支持Lambda形式调用:
- 支持主键自动生成:4中主键策略(包括分布式唯一ID生成器-Sequence),可以自由配置,解决主键问题
- 支持XML热加载:
mapper.xml
支持热加载,简单的CRUD操作无需重启,甚至支持无XML启动 - 支持ActiveRecord模式
- 内置代码生成器:
- 支持关键词自动转义:
- 支持自定义全局通用操作:
- 解除SQL与程序代码的耦合
- 提供映射标签
- 提高对象关系映射标签
- 通过xml标签,支持编写动态SQL
具体的:
架构
架构原理,可参考
功能
注解
@TableId
, 用于主键,MP 支持4种主键策略 IdType
@TableName
,用于表名
@TableField
,字段,exist=true/false,是否对应数据表字段
@Version
,乐观锁标记
@KeySequence
,序列主键策略,主要
@TableLogic
,用于逻辑删除的字段
全局配置 GlobalConfiguration
需要注入到MybatisSqlSessionFactoryBean里面,才能生效
dbColumnUnderline,MP2.3默认为true
idType配置后无需对所有的主键加注解
tablePrefix,仅适用于所有表名前缀相同的情况下
直接获取主键值,无需任何配置,基于BaseMapper
Mapper,顶级Mapper,继承该接口后,无需编写mapper.xml
文件,即可获得CRUD功能,支持 id 泛型
insertAllColumn(); // 无需对全部字段进行setter,然后反应到DB层,落值为null
insert(); // 对全部字段有非空判断
updateById();
updateAllColumnById(); // 没有setter时会覆盖原有数据为null
T selectById(Serializable id);
T selectOne(@Param("ew") T entity);
List<T> selectBatchIds(List<? extends Serializable> idList);
List<T> selectByMap(@Param("cm") Map<String, Object> columnMap);
List<T> selectPage(RowBounds rowBounds, @Param("ew") Wrapper<T> wrapper);
RowBounds,分页查询条件,SQL语句没有limit关键字,不是真实的物理分页?!
Page,分页辅助类,
分页插件
Spring Boot配置方式:
@Bean
public PaginationInterceptor paginationInterceptor() {
return new PaginationInterceptor();
}
UserMapper.java:
List<User> getList(Pagination page, Integer status);
UserServiceImpl.java
调用分页方法,需要page.setRecords
回传给页面:
public Page<User> getList(Page<User> page, Integer status) {
return page.setRecords(userMapper.getList(page, status));
}
Mybatis PageHelper对比MP PaginationInterceptor
Mybatis PageHelper是独立于Mybatis的依赖包,需要引入多个maven依赖。而MP PaginationInterceptor是MP自带插件,是否启用插件取决于是否配置。底层原理都是使用拦截器实现。
公共字段自动填充
平时在建对象表时都会有最后修改时间last_update_time
,最后修改人last_update_name
这两个字段,对于这些大部分表都有的字段,每次在新增和修改的时候都要考虑到这几个字段有没有传进去,很麻烦。
MybatisPlus公共字段自动填充的功能可以解决此问题。一般满足下面条件的字段就可以使用此功能:
- 这个字段是大部分表都会有的。
- 这个字段的值是固定的,或则字段值是可以在后台动态获取的。
MybatisPlus 2.0.6版本支持更新数据公共字段自动填充,之前都是只支持新增数据的时候可以使用。
配置:
继承IMetaObjectHandler抽象类,实现两个方法,insertFill()
用于新增数据时需要填充的字段,updateFill()
用于更新数据时需要填充的字段:
import org.apache.ibatis.reflection.MetaObject;
import org.apache.shiro.SecurityUtils;
import org.springframework.stereotype.Component;
import com.baomidou.mybatisplus.mapper.MetaObjectHandler;
/** mybatisplus自定义填充公共字段, 即没有传的字段自动填充*/
@Component
public class MyMetaObjectHandler extends MetaObjectHandler {
// 新增填充
@Override
public void insertFill(MetaObject metaObject) {
Object lastUpdateNameId = metaObject.getValue("lastUpdateNameId");
Object lastUpdateTime = metaObject.getValue("lastUpdateTime");
// 获取当前登录用户
SysUser user = (SysUser)SecurityUtils.getSubject().getPrincipal();
if (null == lastUpdateNameId) {
metaObject.setValue("lastUpdateNameId", user.getId());
}
if (null == lastUpdateTime) {
metaObject.setValue("lastUpdateTime", new Date());
}
}
// 更新填充
@Override
public void updateFill(MetaObject metaObject) {
insertFill(metaObject);
}
}
getValue()
方法的参数是POJO类里面的变量(驼峰的命名方式)。
在MybatisPlus的配置文件中公共字段生成类的bean:
// 全局配置
GlobalConfiguration globalConfig = new GlobalConfiguration();
// 配置公共字段自动填写
globalConfig.setMetaObjectHandler(new MyMetaObjectHandler());
也就是将刚刚写的公共字段填充的设置设置到MP全局配置的对象中。
填充的字段需要忽略验证,在表对象pojo类的对应属性上添加下面注解:
@TableField(value = "last_update_id", validate = FieldStrategy.NOT_EMPTY)
private String lastUpdateNameId;
@TableField(value = "last_update_time", validate = FieldStrategy.NOT_EMPTY)
private Date lastUpdateTime;
原因:因为调用更新和插入的方法时,会验证你所传的属性是否为空,来判断是否该更新和插入这个属性,这个就和公共字段自动填充相冲突,所以需要这个注解来标识此属性不需要验证。不然在插入的时候就会填充失败。
测试
// 公共字段自动填充
// 1.在mybatisplus的配置文件中公共字段生成类的bean
// 2.实现IMetaObjectHandler类
// 3.忽略对应字段的为空检测,在pojo类的属性上添加@TableField(value="last_update_name_id",validate=FieldStrategy.IGNORED)
@Test
public void publicTest(){
SysUser user = new SysUser();
sysUserService.insert(user);
sysUserService.selectById(user.getId());
SysUser user1 = new SysUser();
user1.setId(user.getId());
sysUserService.updateById(user1);
sysUserService.selectById(user.getId());
}
本来是打算创建人和创建时间,也使用这种方法处理的,最后发现,如果将这两个字段也忽略为空的判断,也就是加上validate=FieldStrategy.NOT_EMPTY
,在更新数据的时候会将创建人和创建时间一起更新,不传的话就会更新为空。但是在正真用的上的需求上面使用的时候还不够完善。
逻辑删除
使用此插件后的效果:
- 在mp自带查询和更新方法的SQL后面,追加
<逻辑删除字段>=<LogicNotDeleteValue默认值>
- 删除方法: deleteById()和其他delete方法,底层SQL为:
update tbl_xxx set <逻辑删除字段>=<logicDeleteValue默认值>
配置如下:
- 修改集成全局注入器为 LogicSqlInjector
application.yml
全局注入值:logicDeleteValue // 逻辑删除全局值 logicNotDeleteValue // 逻辑未删除全局值
自定义注入器的一种,
需要@TableLogic
问题:不能配置多个AutoSqlInjector注入器?
支持XML热加载
在使用MyBatis本地开发时,需要经常性地修改调整mapper.xml
文件。IDEA虽然自带热更新(热加载)功能,但是对于mapper.xml
文件却不奏效,也就是说在修改mapper.xml
文件后,需要重启应用。
哪怕应用足够轻量级或者优化得足够好,启动也需要好几秒时间。此时有个mapper.xml
文件热加载功能就可以提高开发效率。
经过调研,是可以实现的,参考:MyBatis系列之mapper.xml实现热加载HotSwap。
而MP自带mapper.xml
文件热加载功能。
模糊查询
like
notlike
likeLeft
likeRight
代码生成
配置好generator.properties
文件:
# 包前缀
package=com.github
# 模块名
moduleName=shop
# 作者名
author=johnny
email=
# 表前缀,如表tb_sys_user 生成类 sys_user
tablePrefix=m_,r_,s_
# 数据转换类型
tinyint=Boolean
smallint=Integer
mediumint=Integer
int=Integer
integer=Integer
bigint=Long
float=Float
double=Double
decimal=BigDecimal
bit=Boolean
char=String
varchar=String
tinytext=String
text=String
blob=String
mediumtext=String
longtext=String
date=Date
datetime=Date
timestamp=Date
定义好velocity模板文件(pom文件需要引入velocity依赖),从数据表PO实体类到Controller接口方法都支持自动生成:Model.java.vm
、Mapper.java.vm
、Mapper.xml.vm
、Service.java.vm
、ServiceImpl.java.vm
、Controller.java.vm
。
如:
package ${package}.${moduleName}.model;
import ${package}.common.model.SuperEntity;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
#if(${hasBigDecimal})
import java.math.BigDecimal;
#end
import java.util.Date;
/**
* ${comments}
*
* @author ${author}
*/
@Data
@TableName("${tableName}")
public class ${className} extends SuperEntity {
#foreach ($column in $columns)
#if($column.columnName != $pk.columnName && $column.columnName != "createTime" && $column.columnName !=
"updateTime")
private $column.attrType $column.attrname;
#end
#end
}
其他
执行分析,性能分析,乐观锁,XML热加载,自定义全局操作,逻辑删除,读写分离&多数据源,主键Sequence,多租户SQL解析器,通用枚举自动注入,IDEA快速开发;
条件构造器
EntityWrapper/Condition,都是基于Wrapper,Wrapper抽象类的方法:
.last()
有SQL注入的风险
AR
Active Record,一种数据访问设计模式,它可以帮助你实现数据对象Object到关系数据库的映射。
Model,实现pkVal抽象方法,指定当前实体类的主键属性
EntityWrapper,支持泛型,builder模式,
不用注入aaaMapper,
AutoGenerator
Oracle 主键问题
使用@KeySequence解决,用在实体类上,
数据库层面:
create sequence seq_user start with 100 increment by 2;
-- 查询序列的下一个值
select seq_user.nextval from dual;
-- 查询序列的当前值
select seq_user.currval from dual;
2.问题
mybatis-plus怎么实现单表URUD操作?
mybatis-plus的底层实现原理是什么?
mybatis-plus与其他同类框架如mybatis helper有很什么优势?
如何集成mybatis-plus快速搭建一个spring boot项目。
参考
MyBatis-Plus源码分析