【微服务核心】MyBatis Plus

已于 2024-01-04 03:15:54 修改
阅读量1.5k 收藏 26
点赞数 28
分类专栏： # 04 微服务核心 文章标签： 微服务 mybatis
于 2023-12-28 18:41:31 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/xxx1276063856/article/details/135276053
版权

文章目录

1. 简介

MyBatis Plus，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。官网：https://baomidou.com/ ，下面功能及使用都可从官网找到

MyBatis Plus 具有以下特性：

  • 无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑
  • 损耗小：启动即会自动注入基本 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 操作智能分析阻断，也可自定义拦截规则，预防误操作

2. 入门使用

  1. 创建Maven工程

  2. 添加依赖，这里给一份 springboot3 较为完整依赖

    <parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-aop</artifactId>
    </dependency>
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-spring-boot3-starter</artifactId>
        <version>3.5.5</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid-spring-boot-3-starter</artifactId>
        <version>1.2.20</version>
    </dependency>
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.33</version>
    </dependency>
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.28</version>
    </dependency>
</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

  3. 启动类配置 @MapperScan("com.springboot.mapper") mapper接口扫描注解

  4. 配置文件 application.yaml

    spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      username: root
      password: root
      url: jdbc:mysql:///mybatisplus
      driver-class-name: com.mysql.cj.jdbc.Driver

  5. 编写 mapper 接口，继承 BaseMapper ，继承mybatis-plus提供的基础Mapper接口，将自带crud方法

部分约定配置：

map-underscore-to-camel-case ：下划线驼峰命名，默认开启

mapper扫描：classpath*:/mapper/**/*.xml

3. 核心功能

3.1 CRUD 接口

3.1.1 Mapper CRUD 接口

官网：https://baomidou.com/pages/49cc81/#mapper-crud-接口

使用时：ScheduleMapper extends BaseMapper<Schedule>

  • 通用 CRUD 封装 BaseMapper 接口，为 Mybatis-Plus 启动时自动解析实体表关系映射转换为 Mybatis 内部对象注入容器
  • 泛型 T 为任意实体对象
  • 参数 Serializable 为任意类型主键 Mybatis-Plus 不推荐使用复合主键约定每一张表都有自己的唯一 id 主键
  • 对象 Wrapper 为 条件构造器

ScheduleMapper 将包含 BaseMapper 中的一系列增删改查及分页查询方法

3.1.2 Service CRUD 接口

官网：https://baomidou.com/pages/49cc81/#service-crud-接口

  • 通用 Service CRUD 封装 IService 接口，进一步封装 CRUD 采用 get 查询单行 remove 删除 list 查询集合 page 分页 前缀命名方式区分 Mapper 层避免混淆
  • 泛型 T 为任意实体对象
  • 建议如果存在自定义通用 Service 方法的可能，请创建自己的 IBaseService 继承 Mybatis-Plus 提供的基类
  • 对象 Wrapper 为 条件构造器

3.2 条件构造器

在这里插入图片描述

Wrapper ： 条件构造抽象类，最顶端父类

  • AbstractWrapper ： 用于查询条件封装，生成 sql 的 where 条件
    • QueryWrapper ： 查询/删除条件封装
    • UpdateWrapper ： 修改条件封装
    • AbstractLambdaWrapper ： 使用Lambda 语法
      • LambdaQueryWrapper ：用于Lambda语法使用的查询Wrapper
      • LambdaUpdateWrapper ： Lambda 更新封装Wrapper

组装条件：

在这里插入图片描述

这里仅介绍基于 Lambda 的条件封装的使用，非 Lambda 自行创建对象 QueryWrapper 用类似方法进行拼接即可

LambdaQueryWrapper

@RequestMapping("query")
public Result<List<Schedule>> query() {
    LambdaQueryWrapper<Schedule> queryWrapper = new LambdaQueryWrapper<>();
    queryWrapper.eq(Schedule::getId, 2);
    return new Result<>(scheduleService.list(queryWrapper));
}

LambdaUpdateWrapper ：使用 set() 方法设置属性

@RequestMapping("update")
public Result<Boolean> update() {
    LambdaUpdateWrapper<Schedule> updateWrapper = new LambdaUpdateWrapper<>();
    updateWrapper.eq(Schedule::getId, 2).eq(Schedule::getCompleted, 0);
    updateWrapper.set(Schedule::getCompleted, 1).set(Schedule::getTitle, "学个P呀");
    return new Result<>(scheduleService.update(updateWrapper));
}

3.3 分页插件

配置方法：配置类中，将 MybatisPlusInterceptor 注入 IoC容器中，注入前添加 PaginationInnerInterceptor 拦截器

@MapperScan("com.springboot.mapper")
@SpringBootApplication
public class SpringBootApplicationMain {

	public static void main(String[] args) {
		SpringApplication.run(SpringBootApplicationMain.class);
	}

	@Bean
	public MybatisPlusInterceptor mybatisPlusInterceptor() {
		MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
		interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));//如果配置多个插件,切记分页最后添加
		//interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); 如果有多数据源可以不配具体类型 否则都建议配上具体的DbType
		return interceptor;
	}
}

使用默认实现的分页：scheduleService.page 返回的是 Page 对象，与 new Page 是同一个，只是对象中有了更多信息

@RequestMapping("query")
public Result<Page<Schedule>> query() {
    Page<Schedule> page = new Page<>(1,5);
    return new Result<>(scheduleService.page(page));
}

Page ：该类继承了 IPage 类，实现了 简单分页模型 如果你要实现自己的分页模型可以继承 Page 类或者实现 IPage 类

属性名类型默认值描述
recordsListemptyList查询数据列表
totalLong0查询列表总记录数
sizeLong10每页显示条数，默认 10
currentLong1当前页
ordersListemptyList排序字段信息，允许前端传入的时候，注意 SQL 注入问题，可以使用 SqlInjectionUtils.check(...) 检查文本
optimizeCountSqlbooleantrue自动优化 COUNT SQL 如果遇到 jSqlParser 无法解析情况，设置该参数为 false
optimizeJoinOfCountSqlbooleantrue自动优化 COUNT SQL 是否把 join 查询部分移除
searchCountbooleantrue是否进行 count 查询，如果只想查询到列表不要查询总记录数，设置该参数为 false
maxLimitLong单页分页条数限制
countIdStringxml 自定义 count 查询的 statementId 也可以不用指定在分页 statementId 后面加上 _mpCount 例如分页 selectPageById 指定 count 的查询 statementId 设置为 selectPageById_mpCount 即可默认找到该 SQL 执行

自定义分页方法接口：

//传入参数携带Ipage接口
//返回结果为IPage
IPage<User> selectPageVo(IPage<?> page, Integer id);

<select id="selectPageVo" resultType="xxx.xxx.xxx.User">
    SELECT * FROM user WHERE id > #{id}
</select>

如果返回类型是 IPage 则入参的 IPage 不能为null，因为 返回的 IPage == 入参的IPage；如果想临时不分页，可以在初始化 IPage 时 size 参数传 <0 的值；
如果返回类型是 List 则入参的 IPage 可以为 null(为 null 则不分页)，但需要你手动 入参的IPage.setRecords(返回的 List);
如果 xml 需要从 page 里取值,需要 page.属性 获取

注意：多个插件使用的情况，请将分页插件放到 插件执行链 最后面。如在租户插件前面，会出现 COUNT 执行 SQL 不准确问题

3.4 Mybatis-Plus 注解

详情可参考官网：https://baomidou.com/pages/223848/#tablename

  • @TableName ：表名注解，标识实体类对应的表
  • @TableId ：主键注解。type指定为 ASSIGN_ID 会调用主键生成默认实现类，以雪花算法生成 ID
  • @TableField ：字段注解（非主键）
  • @Version ：乐观锁注解
  • @TableLogic ：逻辑处理注解，增加注解后删除会进行逻辑删除。默认逻辑删除属性已删除值为 1，未删除值为 0。也可通过 mybatis-plus.global-config.db-config.logic-delete-field 配置全局逻辑删除属性。二者必须配置一个逻辑删除才会生效，注意也会影响默认查询逻辑，查询中会过滤逻辑删除的数据
  • @OrderBy ：内置 SQL 默认指定排序，优先级低于 wrapper 条件查询

4. 拓展

4.1 逻辑删除

  1. 配置 application.yaml ，从 3.3.0 版本开始，可以忽略不配置 @TableLogic 注解
mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: flag # 全局逻辑删除的实体字段名(since 3.3.0,配置后可以忽略不配置步骤2)
      logic-delete-value: 1 # 逻辑已删除值(默认为 1)
      logic-not-delete-value: 0 # 逻辑未删除值(默认为 0)
  1. 实体类字段上加上 @TableLogic 注解

4.2 MybatisX快速开发插件

在 idea 插件中搜索 MybatisX ，安装后右侧导航栏(Datasbase)连接数据源后，即可选择表右键直接生成代码

在这里插入图片描述

如果需要生成是子模块代码，这里需要手动填一下子模块目录，目前版本选中子模块不会自动填入，如我这里是 T01

  • relative package ：实体类的生成包

在这里插入图片描述

之后需选中 Model 才会生成实体类

在这里插入图片描述

5. 插件

目前已有的功能:

  • 自动分页: PaginationInnerInterceptor
  • 乐观锁: OptimisticLockerInnerInterceptor
  • 多租户: TenantLineInnerInterceptor
  • 动态表名: DynamicTableNameInnerInterceptor
  • 非法SQL拦截: IllegalSQLInnerInterceptor
  • 防止全表更新与删除: BlockAttackInnerInterceptor
  • 数据权限：DataPermissionInterceptor
  • 数据变动记录：DataChangeRecorderInnerInterceptor

插件配置：注入 MybatisPlusInterceptor 对象即可，注入前把需要的对应拦截器添加到该对象中

@MapperScan("com.springboot.mapper")
@SpringBootApplication
public class SpringBootApplicationMain {

	public static void main(String[] args) {
		SpringApplication.run(SpringBootApplicationMain.class);
	}

	@Bean
	public MybatisPlusInterceptor mybatisPlusInterceptor() {
		MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
		interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));//如果配置多个插件,切记分页最后添加
		//interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); 如果有多数据源可以不配具体类型 否则都建议配上具体的DbType
		return interceptor;
	}
}

注意:

使用多个功能需要注意顺序关系，建议使用如下顺序

  • 多租户，动态表名
  • 分页，乐观锁
  • sql 性能规范，防止全表更新与删除

总结: 对 sql 进行单次改造的优先放入，不对 sql 进行改造的最后放入

具体可参考官网使用：https://baomidou.com/pages/2976a3/

5.1 分页插件

5.2 乐观锁插件

配置完拦截器后在实体类的字段上加上 @Version 注解即可

说明:

  • 支持的数据类型只有:int,Integer,long,Long,Date,Timestamp,LocalDateTime
  • 整数类型下 newVersion = oldVersion + 1 ， newVersion 会回写到 entity 中
  • 仅支持 updateById(id) 与 update(entity, wrapper) 方法
  • 在 update(entity, wrapper) 方法下, wrapper 不能复用!!!
比尔高特
关注
  • 28
    点赞
  • 踩
  • 26
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
SpringBoot代码示例，结合Swagger、MyBatis Plus、RestTemplate等技术，是学习微服务的基础demo示例
01-10
该示例结合Swagger生成在线API，MyBatis Plus快速分页查询、RestTemplate实现远程访问服务端接口等基于SpringBoot框架的demo示例，对大家学习SpringCloud打下良好基础
改版的若依微服务架构，使用mybatis-Plus
03-14
7. **开发实践**：使用若依微服务架构，开发者需要了解如何配置和使用Spring Cloud的各种组件，如何编写MyBatis-Plus的Mapper和Service，以及如何实现前后端交互。此外，还需要掌握Docker容器化部署和持续集成/持续...
Mybatis-Plus在微服务中的使用
weixin_44534562的博客
06-20 172
这些工具类放到整个项目的公共代码中【bamboowisdom-basic-common】引入pojo类就相当于引入了Mybatis-Plus依赖和common依赖。注意确认扫描路径，此处扫描mapper接口，不需要在启动类加了。可单独创建一个项目装Mybatis-Plus。对应生成的pojo类需要引入依赖。
微服务开发与实战Day01 - MyBatisPlus
最新发布
ltt159264的博客
06-04 1072
我们可以利用MyBatisPlus的Wrapper来构建复杂的Where条件，然后自己定义SQL语句中剩下的部分。案例1：自定义SQL需求：将id在指定范围内的用户（如1、2、4）的余额扣减指定值①基于Wrapper构建where条件②在mapper方法参数中用Param注解声明wrapper变量名称，必须是ew③自定义SQL，并使用Wrapper条件。
微服务集成MyBatisPlus
qq_33755230的博客
05-17 1488
【代码】微服务集成MyBatisPlus。
引入MybatisPlus与实操
程序员阿红的博客
11-09 4879
特色特性无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑损耗小：启动即会自动注入基本 CURD，性能基本无损耗，直接面向对象操作， BaseMapper强大的 CRUD 操作：内置通用 Mapper、通用 Service，仅仅通过少量配置即可实现单表大部分CRUD 操作，更有强大的条件构造器，满足各类使用需求, 以后简单的CRUD操作，它不用自己编写了！支持 Lambda 形式调用：通过 Lambda 表达式，方便的编写各类查询条件，无需再担心字段写。
SpringBoot整合Mybatis-Plus+Oracle+Mysql
01-05
结合Mybatis-Plus和数据库如Oracle与MySQL，可以构建出强大的数据访问层。本教程将深入探讨如何利用SpringBoot整合Mybatis-Plus，同时支持Oracle和MySQL数据库，并通过Nacos作为注册中心，以及使用Swagger2进行API...
mybatis-plus-3.0
04-13
MyBatis-Plus的核心功能包括： 1. **自动化CRUD操作**：通过简单的配置或注解，即可实现对数据库的增删改查操作，无需编写大量重复的SQL代码。例如，只需定义实体类和Mapper接口，MyBatis-Plus会自动生成对应的SQL...
mybatis plus+springboot反向生成代码
09-05
3. **引入依赖**：在项目的`pom.xml`文件中，引入Mybatis Plus的依赖，包括核心库、Mybatis Plus Generator以及相关的数据库驱动。 4. **配置Generator**：创建一个配置类，继承`...
002 springboot整合mybatis-plus
04-10
public class MybatisPlusConfig { @Value("${mybatis-plus.global-config.db-config.logic-delete-value}") private int logicDeleteValue; @Value("${mybatis-plus.global-config.db-config.logic-not-delete-...
史上最简单：SpringCloud 集成 mybatis-plus（以若依微服务版本为例）
jacky_zhuyuanlu的博客
11-20 3643
springclould 集成 mybatis-plus
整合微服务Mybatis plus快速上手增删改查
weixin_44806772的博客
05-07 522
整合微服务Mybatis plus Mybatis plus 是Mybatis的升级版，只对Mybatis升级不改变源码，Mybatis能用的他都可以使用，而Mybatis plus最强大之处就是它封装了单表查询。能够使简单的查询更加简单快捷。 1.使用Mybatis plus 1.导入jar包 <dependencies> <dependency> ...
微服务学习系列六：MyBatis-Plus用法
yangyanping20108的博客
03-05 1136
MyBatis-Plus (opens new window)（简称 MP）是一个 MyBatis (opens new window)的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。
010-从零搭建微服务-系统服务（三）
csp732171109的博客
06-07 678
源码地址（前端）：https://gitee.com/csps/mingyue-ui。文档地址：https://gitee.com/csps/mingyue/wikis。如果这个项目让你有所收获，记得 Star 关注哦，这对我是非常不错的鼓励与支持。源码地址（后端）：https://gitee.com/csps/mingyue。整理一下，模块和代码结构舒服多了～～～，用户名查询的接口已经开发完成啦。是时候引入接口文档并聚合各模块，方便提供给前端童鞋联调喽～～～
在微服务项目中用Mybatis代码生成器--教程
qq_52001191的博客
03-20 349
使用mybatis的代码生成器
若依spring-cloud 接入mybatis-plus
qq_58363572的博客
09-29 2598
若依spring-cloud介入mybatis-plus，让crud更简单，更高效。
SpringCloud微服务01-MybatisPlus-Docker
qq_52439738的博客
05-13 788
一、微服务介绍 单体架构所有功能集群在一个架构中，难以维护复杂需求微服务之间是不同的TomCat要跨服务查询，学习是如何拆分单体架构为微服务这个mapper继承BaseMapper后就可以直接使用它的方法，增删改查。继承就可以直接操作对应的数据表原因在于实体类，我们需要遵循一些约定才能自动实现如果有不想遵循这些约定的内容就需要在实体类中注解。除了实体包名和mapper地址，其余都是默认设置即可。 MyBatisPlus适合单表查询，多表还是需要自己写SQLwhere的条件不一定是id可能更加负责，Wrap
大型微服务+前后端分离之MyBatis-Plus教程
04-18
MyBatis-Plus（简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。 愿景我们的愿景是成为 MyBatis 超好的搭档，就像 魂斗罗 中的 1P、2P，基友搭配，效率翻倍。 特性无侵入：只做增强不做改变，引入它不会对现有工程产生影响，如丝般顺滑损耗小：启动即会自动注入基本 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 操作智能分析阻断，也可自定义拦截规则，预防误操作 我们将通过理论与实操的方式来阐述 MyBatis-Plus 的强大功能，体验和学习MyBatis-Plus技术。
mybatis plus的核心API
04-23
Mybatis Plus 的核心 API 包括： 1. BaseMapper：定义了基本的 CRUD 操作方法，如 insert、update、delete、select 等。 2. Wrapper：用于构建查询条件，支持链式调用和动态 SQL。 3. QueryWrapper：Wrapper 的...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值