Mybatis-Plus学习笔记
一、Mybatis-Plus
1、mybatis-plus
MyBatis-Plus (opens new window)(简称 MP)是一个 MyBatis (opens new window)的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
国内的公司,苞米豆。在mybatis的基础上开发的。
2、支持数据库
1 | mysql,oracle,db2,h2,hsql,sqlite,postgresql,sqlserver,Phoenix,Gauss ,clickhouse,Sybase,OceanBase,Firebird,cubrid,goldilocks,csiidb |
3、框架结构

二、快速搭建
1、创建springboot项目
2、搭建mybatis-plus
(1)依赖
1 | <!--mybatis plus--> |
(2)配置数据源
1 | #数据源 |
(3)启动测试
1 | @SpringBootApplication |
3、开发体验
(1)实体类
建立映射
1 | package com.example.mybatisplusdemo.domain; |
(2)mapper
1 | package com.example.mybatisplusdemo.mapper; |
(3)测试类
1 | @SpringBootTest |
三、常用注解
1、@TableName
- 描述:表名注解
| 属性 | 类型 | 必须指定 | 默认值 | 描述 |
|---|---|---|---|---|
| value | String | 否 | “” | 表名 |
| schema | String | 否 | “” | schema |
| keepGlobalPrefix | boolean | 否 | false | 是否保持使用全局的 tablePrefix 的值(如果设置了全局 tablePrefix 且自行设置了 value 的值) |
| resultMap | String | 否 | “” | xml 中 resultMap 的 id |
| autoResultMap | boolean | 否 | false | 是否自动构建 resultMap 并使用(如果设置 resultMap 则不会进行 resultMap 的自动构建并注入) |
| excludeProperty | String[] | 否 | {} | 需要排除的属性名(@since 3.3.1) |
2、@TableId
- 描述:主键注解
| 属性 | 类型 | 必须指定 | 默认值 | 描述 |
|---|---|---|---|---|
| value | String | 否 | “” | 主键字段名 |
| type | Enum | 否 | IdType.NONE | 主键类型 |
IdType
| 值 | 描述 |
|---|---|
| AUTO | 数据库ID自增 |
| NONE | 无状态,该类型为未设置主键类型(注解里等于跟随全局,全局里约等于 INPUT) |
| INPUT | insert前自行set主键值 |
| ASSIGN_ID | 分配ID(主键类型为Number(Long和Integer)或String)(since 3.3.0),使用接口IdentifierGenerator的方法nextId(默认实现类为DefaultIdentifierGenerator雪花算法) |
| ASSIGN_UUID | 分配UUID,主键类型为String(since 3.3.0),使用接口IdentifierGenerator的方法nextUUID(默认default方法) |
| ID_WORKER | 分布式全局唯一ID 长整型类型(please use ASSIGN_ID) |
| UUID | 32位UUID字符串(please use ASSIGN_UUID) |
| ID_WORKER_STR | 分布式全局唯一ID 字符串类型(please use ASSIGN_ID) |
3、@TableField
- 描述:字段注解(非主键)
| 属性 | 类型 | 必须指定 | 默认值 | 描述 |
|---|---|---|---|---|
| value | String | 否 | “” | 数据库字段名 |
| el | String | 否 | “” | 映射为原生 #{ ... } 逻辑,相当于写在 xml 里的 #{ ... } 部分 |
| exist | boolean | 否 | true | 是否为数据库表字段 |
| condition | String | 否 | “” | 字段 where 实体查询比较条件,有值设置则按设置的值为准,没有则为默认全局的 %s=#{%s},参考(opens new window) |
| update | String | 否 | “” | 字段 update set 部分注入, 例如:update=”%s+1”:表示更新时会set version=version+1(该属性优先级高于 el 属性) |
| insertStrategy | Enum | N | DEFAULT | 举例:NOT_NULL: insert into table_a(<if test="columnProperty != null">column</if>) values (<if test="columnProperty != null">#{columnProperty}</if>) |
| updateStrategy | Enum | N | DEFAULT | 举例:IGNORED: update table_a set column=#{columnProperty} |
| whereStrategy | Enum | N | DEFAULT | 举例:NOT_EMPTY: where <if test="columnProperty != null and columnProperty!=''">column=#{columnProperty}</if> |
| fill | Enum | 否 | FieldFill.DEFAULT | 字段自动填充策略 |
| select | boolean | 否 | true | 是否进行 select 查询 |
| keepGlobalFormat | boolean | 否 | false | 是否保持使用全局的 format 进行处理 |
| jdbcType | JdbcType | 否 | JdbcType.UNDEFINED | JDBC类型 (该默认值不代表会按照该值生效) |
| typeHandler | Class<? extends TypeHandler> | 否 | UnknownTypeHandler.class | 类型处理器 (该默认值不代表会按照该值生效) |
| numericScale | String | 否 | “” | 指定小数点后保留的位数 |
FieldStrategy
| 值 | 描述 |
|---|---|
| IGNORED | 忽略判断 |
| NOT_NULL | 非NULL判断 |
| NOT_EMPTY | 非空判断(只对字符串类型字段,其他类型字段依然为非NULL判断) |
| DEFAULT | 追随全局配置 |
FieldFill
| 值 | 描述 |
|---|---|
| DEFAULT | 默认不处理 |
| INSERT | 插入时填充字段 |
| UPDATE | 更新时填充字段 |
| INSERT_UPDATE | 插入和更新时填充字段 |
4、@OrderBy
- 描述:内置 SQL 默认指定排序,优先级低于 wrapper 条件查询
| 属性 | 类型 | 必须指定 | 默认值 | 描述 |
|---|---|---|---|---|
| isDesc | boolean | 否 | 是 | 是否倒序查询 |
| sort | short | 否 | Short.MAX_VALUE | 数字越小越靠前 |
四、对Mapper的封装
1 | 说明: |
编写Mapper:
1 | @Mapper |
1、 Insert方法

1 | /** |
2、Delete方法

1 | /** |
1 | /** |
1 | /** |
1 | /** |
3、Update方法

1 | /** |
1 | /** |
4、Select方法


1 | /** |
1 | /** |
1 | /** |
1 | /** |
五、对Service的封装
1 | 说明: |
1 | package com.example.springbootmybatisplusdemo.service; |
1 | package com.example.springbootmybatisplusdemo.service.impl; |
1、Save方法
1 | // 插入一条记录(选择字段,策略插入) |
2、Remove方法
1 | // 根据 entity 条件,删除记录 |
3、Update方法
1 | // 根据 whereWrapper 条件,更新记录 |
4、Get方法
查询单条
1 | // 根据 ID 查询 |
5、List方法
查询多条
1 | // 查询所有 |
6、Page方法
1 | // 无条件分页查询 |
7、Count方法
1 | // 查询总记录数 |
8、Chain链式操作
1 | // 链式查询 普通 |
1 | // 链式更改 普通 |
六、条件查询器
1、AbstractWrapper
1 | 说明: |
2、条件
七、主键生成
八、分页插件
1、设置分页插件
1 | package com.example.mybatisplusdemo.config; |
2、分页查询mapper
1 | /** |