MyBatis-Plus是一个MyBatis的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。它可以节省大量时间,所有的CRUD代码都可以自动化完成。
特性:
无侵入:只做增强不做改变,引入它不会对现有工程产生影响,如丝般顺滑。
损耗小:启动即会自动注入基本 CURD,性能基本无损耗,直接面向对象操作。
强大的 CRUD 操作:内置通用 Mapper、通用 Service,仅仅通过少量配置即可实现单表大部分 CRUD 操作,更有强大的条件构造器,满足各类使用需求。
支持 Lambda 形式调用:通过 Lambda 表达式,方便的编写各类查询条件,无需再担心字段写错。
支持主键自动生成:支持多达 4 种主键策略(内含分布式唯一 ID 生成器 - Sequence),可自由配置,完美解决主键问题。
支持 ActiveRecord 模式:支持 ActiveRecord 形式调用,实体类只需继承 Model 类即可进行强大的 CRUD 操作。
支持自定义全局通用操作:支持全局通用方法注入( Write once, use anywhere )。
内置代码生成器:采用代码或者 Maven 插件可快速生成 Mapper 、 Model 、 Service 、 Controller 层代码,支持模板引擎,更有超多自定义配置等您来使用。
内置分页插件:基于 MyBatis 物理分页,开发者无需关心具体操作,配置好插件之后,写分页等同于普通 List 查询。
分页插件支持多种数据库:支持 MySQL、MariaDB、Oracle、DB2、H2、HSQL、SQLite、Postgre、SQLServer 等多种数据库。
内置性能分析插件:可输出 SQL 语句以及其执行时间,建议开发测试时启用该功能,能快速揪出慢查询。
内置全局拦截插件:提供全表 delete 、 update 操作智能分析阻断,也可自定义拦截规则,预防误操作。
常用方法
1.通用 CRUD 方法:
insert(entity):插入一条记录
updateById(entity):根据ID更新一条记录
deleteById(id):根据ID删除一条记录
selectById(id):根据ID查询一条记录
selectList(wrapper):根据条件查询记录列表
selectPage(page, wrapper):根据条件分页查询记录列表
2.条件构造器 Wrapper:
QueryWrapper:用于构建查询条件
UpdateWrapper:用于构建更新条件
LambdaQueryWrapper:支持 Lambda 表达式的查询条件构造器
3.分页查询:
Page<T>:分页查询结果的封装类,包含总数、当前页数据等信息
4.批量操作:
insertBatch(entities):批量插入记录
updateBatchById(entities):根据ID批量更新记录
5.逻辑删除:
deleteById(id):物理删除
deleteByIdWithFill(entity):逻辑删除,填充删除字段(如 deleted
6.乐观锁:
updateById(entity):支持乐观锁的更新方法,需要在实体类中使用 @Version 注解标记乐观锁字段
7.自动填充:
@TableField(fill = FieldFill.INSERT):自动填充字段,可用于创建时间、更新时间等场景
8.常用条件查询:
eq(column, value):等于 (=),其中 column 是字段名,value 是要比较的值。
ne(column, value):不等于 (<> 或 !=)。
gt(column, value):大于 (>).
ge(column, value):大于等于 (>=).
lt(column, value):小于 (<).
le(column, value):小于等于 (<=).
like(column, value):模糊匹配 (LIKE),自动添加 % 符号。
likeLeft(column, value):左模糊匹配 (LIKE),只在值后面添加 %。
likeRight(column, value):右模糊匹配 (LIKE),只在值前面添加 %。
in(column, Collection<?> values):在给定的集合中 (IN)。
notIn(column, Collection<?> values):不在给定的集合中 (NOT IN)。
between(column, Object val1, Object val2):在两个值之间 (BETWEEN 和 AND)。
notBetween(column, Object val1, Object val2):不在两个值之间 (NOT BETWEEN 和 AND)。
sNull(column):检查字段是否为 NULL。
isNotNull(column):检查字段是否不为 NULL。
orderByAsc(column):按字段升序排序。
orderByDesc(column):按字段降序排序。
last(String sql):执行原生 SQL 片段,如 LIMIT, OFFSET 等。
or():开始一个新的 OR 条件组。
and():开始一个新的 AND 条件组。