一、MybatisPlus简介
1.1.简介
Mybatis-Plus(简称MP)是一个 Mybatis 的增强工具
,在 Mybatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
1.2.文档地址
1.3.MybatisPlus的特性
- 无侵入:Mybatis-Plus 在 Mybatis 的基础上进行扩展,只做增强不做改变,引入 Mybatis-Plus 不会对您现有的 Mybatis 构架产生任何影响,而且 MP 支持所有 Mybatis 原生的特性
- 依赖少:仅仅依赖 Mybatis 以及 Mybatis-Spring
- 损耗小:
启动即会自动注入基本 CURD,性能基本无损耗,直接面向对象操作
- 预防Sql注入:内置 Sql 注入剥离器,有效预防Sql注入攻击
- 通用CRUD操作:
内置通用 Mapper
、通用 Service,仅仅通过少量配置即可实现单表大部分 CRUD 操作,更有强大的条件构造器,满足各类使用需求 - 多种主键策略:支持多达4种主键策略(内含分布式唯一ID生成器),可自由配置,完美解决主键问题
- 支持热加载:Mapper 对应的 XML 支持热加载,对于简单的 CRUD 操作,甚至可以无 XML 启动
- 支持ActiveRecord:支持 ActiveRecord 形式调用,实体类只需继承 Model 类即可实现基本 CRUD 操作
- 支持代码生成:采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码,支持模板引擎,更有超多自定义配置等您来使用(P.S. 比 Mybatis 官方的 Generator 更加强大!)
- 支持自定义全局通用操作:支持全局通用方法注入( Write once, use anywhere )
- 支持关键词自动转义:支持数据库关键词(order、key……)自动转义,还可自定义关键词
- 内置分页插件:基于 Mybatis 物理分页,开发者无需关心具体操作,配置好插件之后,写分页等同于普通List查询
- 内置性能分析插件:
可输出 Sql 语句以及其执行时间,建议开发测试时启用该功能,能有效解决慢查询
- 内置全局拦截插件:提供全表 delete 、 update 操作智能分析阻断,预防误操作
二、集成MybatisPlus
2.1.Maven导入MybatisPlus依赖
1 | <dependency> |
2.2.修改sqpsessionFactoryBean
1 | <!-- 配置SqlSessionFactoryBean |
三、入门的Hello World
3.1.准备数据表
1 | DROP TABLE IF EXISTS `tbl_user`; |
3.2.准备Java实体类
1 | public class User { |
3.3.加入依赖的jar包
1 | <dependencies> |
3.5.mybatis-config.xml文件
1 |
|
3.6.log4j.xml文件
1 |
|
3.7.db.properties文件
1 | jdbc.driver=com.mysql.jdbc.Driver |
3.8.applicationContext.xml文件
1 | <!-- 数据源 --> |
3.9.通用的CRUD操作
假设我们有一张user表,我们需要对这个表进行增删改查操作,如果说没有代码生成的话,在mybatis我们需要编写UserMapper接口,手写CRUD方法,在UserMapper.xml文件中写对应的sql语句
,但是,在MybatisPlus中,我们只需要创建UserMapper接口,继承BaseMapper接口,就可以完成CRUD操作,甚至不需要创建SQl映射文件。
1 | public interface UserMapper extends BaseMapper<User>{ |
然后,我们就写一些基本的单元测试方法,测试我们的CRUD,来到我们的测试类中,如下:
1 | public class TestMp { |
说明:在测试类中我们将使用从SpringIOC容器中获取的userMapper进行CRUD一系列操作
保存一条数据userMapper.insert(user);
1 |
|
插入数据的方法有两个:insert和insertAllColumn
,二者的执行结果是一样的,区别在于,前者会根据实体类的每一个属性值进行一个非空校验,在插入的sql语句中不会出现实体类属性为空的字段;
注意:在没有使用全局配置之前,我们需要指定实体类对应的数据库表和主键生成策略
- 主键生成策略:
@TableId(type = IdType.AUTO,value = "id")
,value属性值当实体类字段名和数据库一致时可以不写,这里的value指的是数据库字段名称,type的类型有以下几种:- IdType.AUTO:数据库ID自增
- IdType.INPUT:用户输入ID
- IdType.ID_WORKER:全局唯一ID,内容为空自动填充(默认配置)
- IdType.UUID:全局唯一ID,内容为空自动填充
- 实体对应表名注解:
@TableName(value = "tbl_user")
;指定当前实体类对应的数据库表 - 数据库字段映射名称:
@TableField(value = "user_name")
,当禁止驼峰映射规则后可以使用 - 忽略插入到表的字段:
@ableField(exist = false)
,如下,数据库没有money这个字段,如果不忽略,那么插入就会报错,找不到这个字段;
1 | false) (exist = |
更新一条数据
1 |
|
同理:更新方法也有两个updateById和updateAllColumnById
,前者会对实体类属性名进行非空校验,为空的就不会出现在sql语句中,也就是不会更新原有数据,后者是会更新所有列,如果实体类属性值为空,则数据库对应字段名更新为null;
查询一条数据
1 |
|
删除一条数据
1 |
|
3.10.MybatisPlus全局配置
在前面的CRUD操作中,我们会使用直接注解指定主键生成策略和表名到实体类的映射,但是配置的仅仅会对当前实体类起作用,所以,引入了全局配置,如下:
1 | <!-- 定义MybatisPlus的全局策略配置--> |
然后,将MybatisPlus全局配置注入到sqlSessionFactoryBean中
1 | <!-- 注入全局MP策略配置 --> |
3.11.mybatisPlusCRUD总结
在前面,我们实现了基本的CRUD操作,操作简单,仅仅只需继承一个BaseMapper就可以完成,实现单一,批量,分页等等一系列操作,很大的减少了开发负担,但这仅仅是Mybatisplus的冰山一角,当我们需要多条件查询的时候,就会使用到MybatisPlus中强大的条件构造器EntityWrapper;
四、条件查询
条件构造器就是EntityWrapper,就是一个封装查询条件对象,让开发者自由的定义查询条件,主要用于sql的拼接,排序或者实体参数等;条件构造器
注意:使用的参数是数据库字段名称,不是Java类属性名
4.1.selectPage中的条件查询
1 |
|
4.2.模糊查询和或查询
1 |
|
使用或条件查询可以使用or()
也可以使用orNew()
,二者的区别在于sql中的条件部分不一样,如下:
使用or()的sql语句
1 | SELECT id AS id,user_name AS userName,email,gender,age FROM tbl_user WHERE (gender = ? AND user_name LIKE ? OR email LIKE ?) |
使用orNew()的sql语句
1 | SELECT id AS id,user_name AS userName,email,gender,age FROM tbl_user WHERE (gender = ? AND user_name LIKE ?) OR (email LIKE ?) |
4.3.修改满足条件的数据
1 |
|
4.4.删除满足条件的数据
1 |
|
4.5.条件查询之Condition
Condition继承了Wrapper类,另外,我们不需要再new一个Condition对象,直接调用condition类的静态方法create就可以得到一个condition对象,然后使用wrapper的所有方法,简单使用如下:
1 |
|
五、活动记录AR
Active Record(活动记录),简称AR,是一种领域模型模式,特点就是一个模型类对应关系型数据库中的一个表,而模型类的一个实例对应表中的一条记录;
5.1.开启AR模式
开启AR模式的方法很简单,就是让我们的实体类继承Model类,并实现其抽象方法,指定主键即可,如下
1 | public class User extends Model<User> { |
5.2.插入一条数据
1 |
|
5.3.修改一条数据
1 |
|
说明:和通用的CRUD中的更新方法一样,
updateAllColumnById()
会更新所有列
5.4.查询数据
1 |
|
5.5.删除一条数据
1 |
|
当然,也可以根据条件删除多条数据,这里需要注意的是:当删除不存在的数据时候,返回的结果也是true;
1 | // 删除不存在逻辑属于成功 |
5.6.分页查询数据
在前面的CRUD中的分页查询返回的是list数据集合,但是在AR中返回的却是Page对象,如下
1 |
|
5.7.AR总结
AR提供的是一种更为快速的实现CRUD操作,本质很是调用Mybatis对应的方法,说的简单一点就是语法糖;
糖虽然好吃,但是,不要管不住嘴;
六、代码生成器
我们知道mybatis有一个代码生成器MBG,可以生成Java实体类mapper接口和映射文件,但是MybatisPlus却更加强大,可以生成service和controller,可以配置实体类是否支持AR等,代码生成器
说明:建议数据库表名和字段名采用驼峰命名方式,和实体来一致,可以避免在对应实体类产生的性能损耗
6.1.导入依赖
1 | <dependency> |
说明:MybatisPlus默认使用的是velocity模版引
6.2.编写配置类
1 |
|
6.3.生成的service代码查看
1 |
|
DeptService继承了ServiceImpl,在ServiceImpl中就已经注入了DeptMapper,所以,我们就不需要再次注入,在ServiceImpl中也帮我们提供了常用的CRUD方法,我们可以直接使用,
1 |
|
七、插件扩展
7.1.注册分页插件
1 | <bean id="sqlSessionFactoryBean" class="com.baomidou.mybatisplus.spring.MybatisSqlSessionFactoryBean"> |
真正的分页查询
1 | ApplicationContext ioc = new ClassPathXmlApplicationContext("applicationContext.xml"); |
说明:我们可以将分页查询的数据放在page对象中,返回前端一个page对象即可
7.2.执行分析插件
1 | <bean class="com.baomidou.mybatisplus.plugins.SqlExplainInterceptor"> |
测试如下:
1 |
|
sql分析插件只支持mysql5.6.3以上的版本,本质就是通过sql分析命令Explain分析当前的sql语句,根据结果集中的Extra列来断定当前是否全表操作;
7.3.性能分析插件
性能分析插件用于输出每秒sql语句和其执行时间,首先注册插件,如下:
1 | <bean class="com.baomidou.mybatisplus.plugins.PerformanceInterceptor"> |
测试如下:
1 |
|
结果如下:
1 | Time:142 ms - ID:com.luo.mapper.DeptMapper.insert |
7.4.乐观锁插件
当我们在开发中,有时需要判断,当我们更新一条数据库记录时,希望这条记录没有被别人更新,这个时候就可以使用乐观锁插件,他的原理就是,取出记录时,获取当前的version,更新的时候带上这个version,执行更新的时候set version = yourVersion+1 where version = yourVersion
,如果version不对,则更新失败,注意的是:@version用于注解实体字段,必须要有
;
首先,注册插件
1 | <bean class="com.baomidou.mybatisplus.plugins.OptimisticLockerInterceptor"></bean> |
实体类添加对应属性,同时数据库表也要添加对应字段
1 |
|
测试如下:
1 |
|
如果:这个时候将数据库version改为2,在执行更新就会显示更新记录数为0;
八、自定义全局操作
8.1.自定义全局实例
自定义全局操作,就是将我们需要的sql在项目启动的时候就注入到全局中,操作步骤如下:
- 在Mapper接口中定义我们需要注入的方法;
- 扩展AutoSqlInjector中的inject方法,实现Mapper中我们自定义方法要注入的sql;
- 最后,在全局配置中,配置我们自定义的注入器即可;
第一步:mapper中定义方法
1 | public interface UserMapper extends BaseMapper<User> { |
第二步:重写inject方法
1 | public class MySqlInjector extends AutoSqlInjector { |
第三步:注入自定义配置
1 | <bean id ="globalConfiguration" class="com.baomidou.mybatisplus.entity.GlobalConfiguration"> |
测试
1 | ApplicationContext ioc = new ClassPathXmlApplicationContext("applicationContext.xml"); |
8.2.逻辑删除
所谓逻辑删除,就是不真正的删除数据的记录,而是变为无效状态,在MybatisPlus中,给我们提供logicSqlInjector
第一步:数据库添加逻辑字段
第二步:实体类添加对应属性和注解
1 |
|
第三步:MybatisPlus全局配置中加入logicSqlInjector
1 | <bean id ="globalConfiguration" class="com.baomidou.mybatisplus.entity.GlobalConfiguration"> |
测试
1 |
|
说明:我们做的是删除操作,但是,执行的却是update操作,同时,
查询的时候自动添加了有效判断
九、公共字段填充
这里涉及到一个元数据处理接口MetaObjectHandler
,元对象是Mybatis提供的一个用于更加方便,更加优雅的访问对象的属性,给对象的属性赋值的一个对象,本质上metaObject获取对象的值或者是给对象的属性赋值,都是通过反射获取到属性对应方法的Invoker;
9.1.使用实例
第一步:注解需要填充的字段
1 | "user_name",fill = FieldFill.INSERT_UPDATE) (value = |
第二步:自定义填充处理器
1 | public class MetaHandler extends MetaObjectHandler { |
第三步:注入全局配置
1 | <bean id ="globalConfiguration" class="com.baomidou.mybatisplus.entity.GlobalConfiguration"> |
第四步:测试
1 |
|
十、IEDA开发插件
10.1.安装方法
打开IDEA设置–Plugins–Browse repositories –搜索mybatisx,安装即可
10.2.支持的功能
根据mapper接口方法自动生成xml文件,接口方法定位xml,xml自动定位mapper接口;