mirror of
https://gitee.com/mybatis-flex/mybatis-flex.git
synced 2025-12-06 16:48:24 +08:00
234 lines
16 KiB
Markdown
234 lines
16 KiB
Markdown
# MyBatis-Flex 周边
|
||
|
||
|
||
## 视频教程
|
||
|
||
**课程1：《MyBatis-Flex 视频教程》（免费、已完结、全网首发）**
|
||
> 课程简介：该课程由 [王帅](https://gitee.com/Suomm) 老师录制主讲， [王帅](https://gitee.com/Suomm) 老师也是除了作者以外，对 MyBatis-Flex 代码贡献最大的 committer。
|
||
> 其无论对 MyBatis 还是 MyBatis-Flex，都有非常深入的理解。
|
||
|
||
::: details 课程目录（点击展开）
|
||
|
||
- [MyBatis-Flex 视频教程 - 01 课程介绍](https://www.bilibili.com/video/BV11h411A7cU)
|
||
- [MyBatis-Flex 视频教程 - 02 MyBatis-Flex 简介](https://www.bilibili.com/video/BV1GW4y1f7vt)
|
||
- [MyBatis-Flex 视频教程 - 03 为什么使用 MyBatis-Flex](https://www.bilibili.com/video/BV1us4y167gk)
|
||
- [MyBatis-Flex 视频教程 - 04 基于 SpringBoot 的快速开始](https://www.bilibili.com/video/BV1yW4y1Z74j)
|
||
- [MyBatis-Flex 视频教程 - 05 自动生成类的介绍](https://www.bilibili.com/video/BV1XF411R7pQ)
|
||
- [MyBatis-Flex 视频教程 - 06 MyBatis-Flex 的配置选项](https://www.bilibili.com/video/BV1ys4y1676q)
|
||
- [MyBatis-Flex 视频教程 - 07 初识 BaseMapper 接口](https://www.bilibili.com/video/BV1Pm4y1E7PV)
|
||
- [MyBatis-Flex 视频教程 - 08 插入数据](https://www.bilibili.com/video/BV1Mz4y177jy)
|
||
- [MyBatis-Flex 视频教程 - 09 删除数据](https://www.bilibili.com/video/BV1gV4y1h7Jf)
|
||
- [MyBatis-Flex 视频教程 - 10 更新数据](https://www.bilibili.com/video/BV1Cg4y1w79y)
|
||
- [MyBatis-Flex 视频教程 - 11 复杂更新](https://www.bilibili.com/video/BV1wu411L7dF)
|
||
- [MyBatis-Flex 视频教程 - 12 基础查询](https://www.bilibili.com/video/BV1XN41117kx)
|
||
- [MyBatis-Flex 视频教程 - 13 映射查询](https://www.bilibili.com/video/BV1Cx4y1R7M8)
|
||
- [MyBatis-Flex 视频教程 - 14 QueryWrapper 的介绍](https://www.bilibili.com/video/BV1Mm4y177nq)
|
||
- [MyBatis-Flex 视频教程 - 15 QueryWrapper 的操作](https://www.bilibili.com/video/BV1R8411U7CT)
|
||
- [MyBatis-Flex 视频教程 - 16 @Table 注解的简单使用](https://www.bilibili.com/video/BV1Sk4y157ov)
|
||
- [MyBatis-Flex 视频教程 - 17 onInsert、onUpdate 的使用](https://www.bilibili.com/video/BV1rz4y1473L)
|
||
- [MyBatis-Flex 视频教程 - 18 onSet 实现字段权限](https://www.bilibili.com/video/BV1AN411e7id)
|
||
- [MyBatis-Flex 视频教程 - 19 onSet 实现字段加密](https://www.bilibili.com/video/BV12c411c74x)
|
||
- [MyBatis-Flex 视频教程 - 20 onSet 实现字典回写](https://www.bilibili.com/video/BV1uu41157bF)
|
||
- [MyBatis-Flex 视频教程 - 21 全局监听器配置](https://www.bilibili.com/video/BV1qm4y1L7Si)
|
||
- [MyBatis-Flex 视频教程 - 22 @Id 的简单使用](https://www.bilibili.com/video/BV1Hp4y1571K)
|
||
- [MyBatis-Flex 视频教程 - 23 自定义主键生成器](https://www.bilibili.com/video/BV1eM4y1p72z)
|
||
- [MyBatis-Flex 视频教程 - 24 @Column 注解的简单使用](https://www.bilibili.com/video/BV14c411w7Fr)
|
||
- [MyBatis-Flex 视频教程 - 25 isLogicDelete 逻辑删除的简单使用](https://www.bilibili.com/video/BV1K94y1e7X7)
|
||
- [MyBatis-Flex 视频教程 - 26 自定义逻辑删除处理器](https://www.bilibili.com/video/BV1oP411z7uu)
|
||
- [MyBatis-Flex 视频教程 - 27 version 乐观锁的简单使用](https://www.bilibili.com/video/BV1Rc411F7wp)
|
||
- [MyBatis-Flex 视频教程 - 28 tenantId 多租户的简单使用](https://www.bilibili.com/video/BV1eP41167TU)
|
||
- [MyBatis-Flex 视频教程 - 29 typeHandler 的简单使用](https://www.bilibili.com/video/BV1B841127ea)
|
||
- [MyBatis-Flex 视频教程 - 30 数据脱敏的简单使用](https://www.bilibili.com/video/BV1gz4y1s7Wg)
|
||
- [MyBatis-Flex 视频教程 - 31 枚举属性的使用](https://www.bilibili.com/video/BV1mm4y1W7SD)
|
||
- [MyBatis-Flex 视频教程 - 32 关联查询（Join Query）](https://www.bilibili.com/video/BV1B8411d7iC)
|
||
- [MyBatis-Flex 视频教程 - 33 关联查询（Field Query）](https://www.bilibili.com/video/BV17k4y1g7vt)
|
||
- [MyBatis-Flex 视频教程 - 34 关联查询（Relation Query）](https://www.bilibili.com/video/BV1bj411r7A4)
|
||
- [MyBatis-Flex 视频教程 - 35 关联查询对比](https://www.bilibili.com/video/BV1oF411f7dr)
|
||
- [MyBatis-Flex 视频教程 - 36 分页查询](https://www.bilibili.com/video/BV1d44y1F7JM)
|
||
- [MyBatis-Flex 视频教程 - 37 分页查询 count 查询优化](https://www.bilibili.com/video/BV1np4y1G7R9)
|
||
- [MyBatis-Flex 视频教程 - 38 基于 XML 文件的高性能分页](https://www.bilibili.com/video/BV1Zh4y1D7aj)
|
||
- [MyBatis-Flex 视频教程 - 39 Db + Row](https://www.bilibili.com/video/BV1wp4y1g7by)
|
||
- [MyBatis-Flex 视频教程 - 40 批量操作](https://www.bilibili.com/video/BV1PV4y1Y73a)
|
||
- [MyBatis-Flex 视频教程 - 41 IService 接口介绍](https://www.bilibili.com/video/BV14F411Z7EQ)
|
||
- [MyBatis-Flex 视频教程 - 42 数据权限的使用](https://www.bilibili.com/video/BV1Ju4y197xr)
|
||
- [MyBatis-Flex 视频教程 - 43 链式操作](https://www.bilibili.com/video/BV1Wu411J7Hu)
|
||
- [MyBatis-Flex 视频教程 - 44 多数据源的配置](https://www.bilibili.com/video/BV1f8411X7gW)
|
||
- [MyBatis-Flex 视频教程 - 45 多数据源的切换](https://www.bilibili.com/video/BV1544y1F7Wv)
|
||
- [MyBatis-Flex 视频教程 - 46 动态添加数据源](https://www.bilibili.com/video/BV1tm4y1H712)
|
||
- [MyBatis-Flex 视频教程 - 47 数据源加密](https://www.bilibili.com/video/BV1GF41117GC)
|
||
- [MyBatis-Flex 视频教程 - 48 事务的管理](https://www.bilibili.com/video/BV1oP411p7Wk)
|
||
- [MyBatis-Flex 视频教程 - 49 游标查询](https://www.bilibili.com/video/BV1JN4y1d7AB)
|
||
- [MyBatis-Flex 视频教程 - 50 数据缓存](https://www.bilibili.com/video/BV1cu4y1X7XL)
|
||
- [MyBatis-Flex 视频教程 - 51 数据缓存的简单使用](https://www.bilibili.com/video/BV1F8411X7EB)
|
||
- [MyBatis-Flex 视频教程 - 52 动态表名](https://www.bilibili.com/video/BV1D8411Q7tD)
|
||
- [MyBatis-Flex 视频教程 - 53 Active Record 模式](https://www.bilibili.com/video/BV1Lh4y1T7Ey)
|
||
- [MyBatis-Flex 视频教程 - 54 SQL 审计](https://www.bilibili.com/video/BV1kh4y127kz)
|
||
- [MyBatis-Flex 视频教程 - 55 SQL 打印](https://www.bilibili.com/video/BV1914y1C7Xk)
|
||
- [MyBatis-Flex 视频教程 - 56 MyBatis-Flex APT 配置](https://www.bilibili.com/video/BV1fh4y1T7o1)
|
||
- [MyBatis-Flex 视频教程 - 57 代码生成器（风格一）](https://www.bilibili.com/video/BV1o14y1C7pJ)
|
||
- [MyBatis-Flex 视频教程 - 58 代码生成器（风格二）](https://www.bilibili.com/video/BV14P411h7eM)
|
||
- [MyBatis-Flex 视频教程 - 59 自定义代码生成器](https://www.bilibili.com/video/BV1uu4y1v7Yg)
|
||
- [MyBatis-Flex 视频教程 - 60 课程总结](https://www.bilibili.com/video/BV1kN4y1R7Zx)
|
||
:::
|
||
|
||
课程地址：
|
||
|
||
https://www.bilibili.com/video/BV11h411A7cU
|
||
|
||
|
||
-----
|
||
|
||
|
||
**课程2：《MyBatis-Flex 轻松掌握，从零基础到高级应用的完整教程！持续更新中~》**
|
||
|
||
> 课程简介：该课程由周游老师录制，周游老师有多年的开发经验以及丰富的教学经验，能够把 MyBatis-Flex 的许多原理知识讲解的通俗易懂、深入浅出。
|
||
|
||
课程地址：
|
||
|
||
https://www.bilibili.com/video/BV1kF411r7ky
|
||
|
||
|
||
|
||
|
||
|
||
## 开源项目或作品
|
||
|
||
| 项目名称 | 描述 | 开源网址 |
|
||
|--------------|-------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------|
|
||
| hh-vue | 这是基于ruoyi-vue改造的项目，对flex完整封装可以参考此项项目 | https://gitee.com/min290/hh-vue |
|
||
| youcan-solon | 基于 solon 框架做的一个类似 Ruoyi 的项目，使用flex自带的 mybatis-flex-solon-plugin 插件做集成，集成方式非常简单，属于即拿即用 | https://gitee.com/gollyhu/youcan-solon |
|
||
| Ruoyi-Flex | Ruoyi-Flex是基于RuoYi-Vue v3.8.6进行的扩展，集成MyBatis-Flex、JDK17、lombok、Sa-Token、PowerJob、Hutool、OSS、ureport-keep、Flowable、vue3、TypeScript等优秀开源软件。 | https://gitee.com/dataprince/ruoyi-flex |
|
||
| 小鸣助手 |「小鸣助手」是一个生活服务类小程序，主要为用户的日常生活提供一些便捷工具，例如天气查询、时间规划、生活记录等。目前该小程序已稳定运行近4年，为近10万用户提供了生活帮助。主要技术栈：Spring Boot + Spring Security + JWT + MyBatis-Flex + MySQL + Redis + Docker | https://github.com/inlym/life-helper-server |
|
||
| RuoyiVueFlex |RuoyiVueFlex是基于RuoyiVuePlus的一个快速开发框架。将RuoyiVuePlus中使用的MybatisPlus替换为MybatisFlex,并根据两个ORM框架使用的不同修改了部分逻辑。 集成 Sa-Token、Mybatis-Flex、PowerJob、Jackson、SpringDoc、Hutool、OSS 定期同步等 | https://gitee.com/yhan219/ruoyi-vue-flex |
|
||
| RuoyiCloudFlex |RuoyiCloudFlex是基于RuoYiCloudPlus的微服务管理系统，将RuoyiCloudPlus中使用的MybatisPlus替换为MybatisFlex,并根据两个ORM框架使用的不同修改了部分逻辑。 整合 SpringCloudAlibaba、Dubbo3.0、Sa-Token、Mybatis-Flex、MQ、Flowable、ES、Docker 全方位升级 定期同步 | https://gitee.com/yhan219/ruoyi-cloud-flex |
|
||
| Sz-Admin |[Sz-Admin](https://szadmin.cn)：一个开源RBAC中后台框架，专为现代应用设计。它结合了最新的技术栈，包括后端的Spring Boot 3、JDK 21、Mybatis Flex、Sa-Token、Knife4j和Flyway，以及前端的Vue 3、Vite5、TypeScript和Element Plus，致力于为您提供一个直观、流畅且功能强大的开发体验。 | https://gitee.com/feiyuchuixue/sz-boot-parent |
|
||
|
||
## 开发插件
|
||
|
||
**Mybatis-Flex-Helper** 这是一款高度自定义的 Mybatis-Flex IDEA 插件（该工具由 Mybatis-Flex 社区的同学 [@时间淡忘一切](https://gitee.com/djxchi) 开发，
|
||
目前已经上架到应用商店，可以直接搜索安装）：
|
||
|
||
- 开源地址：https://gitee.com/djxchi/mybatis-flex-code-gen.git
|
||
- 视频简介：https://www.bilibili.com/video/BV1yV411g7Yd
|
||
- 插件交流 QQ 群：872707845
|
||
|
||
|
||
### 插件功能展示
|
||
|
||
**功能 1：完善的代码生成配置**
|
||
|
||
支持直接连接数据库，选择表后一键生成 Controller、Service、Mapper、Model 等代码，同时支持自定义代码文件和代码模板。
|
||
|
||
|
||
|
||
|
||
|
||
**功能 2：智能的 APT 配置文件自动提示功能**
|
||
|
||
直接编写 APT 配置文件，再也不担心写错，或者不明白其含义。
|
||
|
||
|
||
|
||
**功能 3：QueryWrapper SQL 预览**
|
||
|
||
我们在 Java 代码中，编写 QueryWrapper，可以直接预览 QueryWrapper 生成的 SQL，除了 QueryWrapper 以外，还支持 QueryChain、UpdateChain 等构建是的 SQL 预览功能。
|
||
|
||
|
||
|
||
|
||
## MyBatis-Flex-Admin
|
||
|
||
|
||
|
||
**MyBatis-Flex-Admin** 是一个基于 MyBatis-Flex 开发的 SQL 执行日志平台和 SQL 审计平台，整个项目只有 5 张表，也是一个绝佳的 MyBatis-Flex 学习项目。
|
||
|
||
该项目使用前后端分离的方式，后端使用 SpringBoot 2.x + MyBatis-Flex，前台有 React 和 Vue 两个版本，开源地址（当前正在开发中）：
|
||
|
||
https://gitee.com/mybatis-flex/mybatis-flex-admin
|
||
|
||
|
||
## MyBatis-Flex-Kotlin
|
||
|
||
MyBatis-Flex-Kotlin 基于 Mybatis-Flex 的 Kotlin 扩展模块，方便 Kotlin 开发者使用 MyBatis-Flex 进行开发，其主要由社区同学 [@kamo-sama](https://gitee.com/kamo-sama) 进行维护。
|
||
|
||
**特点**
|
||
|
||
- 本模块基于 [Mybatis-Flex](https://mybatis-flex.com) 核心库 ，只做扩展不做改变
|
||
- 结合 Kotlin 特性、DSL让数据库操作更简单
|
||
|
||
**开源地址：**
|
||
|
||
https://gitee.com/mybatis-flex/mybatis-flex-kotlin
|
||
|
||
## Mybatis-Flex-Reactor
|
||
|
||
MybatisFlex Reactor 为 MybatisFlex 的“响应式”拓展模块，以 Flux 封装了 Cursor 操作。方便了流式查询开发以及大数据体量项目响应数据。
|
||
|
||
### 特点
|
||
|
||
1. 无需在现有 MybatisFlex 项目增加兼容性改动，仅需将原有的 `ServiceImpl` 改为 `ReactorServiceImpl` 即可，或者直接再新建一个 `XxxReactorService` 继承于 `ReactorServiceImpl` 即可。
|
||
2. 不强绑定 Spring，也不必须在 Spring WebFlux 框架下开发。完全可以单用 MybatisFlex Reactor 以解决一些传统项目中的性能与内存占用问题。
|
||
3. 与 MybatisFlex 中的 `IService` 逻辑基本保持一致，几乎 0 学习成本即可上手。
|
||
4. 异步非堵塞，对于写入日志等重要级别较低的数据库操作，我们完全可以让步于主线程逻辑，等所有逻辑处理完以后再执行次要逻辑，加快了系统的响应速度。
|
||
|
||
### 一个解决内存占用过高问题的示例
|
||
|
||
很多人从 POI 换成 EasyExcel 的原因除了简单易用以外，还有个就是内存占用低。在 POI 会内存爆满写入失败的情况，EasyExcel 却可以写入成功，但是内存占用依然不低。如果后续项目中数据量持续增加，简单的换成 EasyExcel 也不再管用，因为你依然会将所有数据直接读到内存当中。当然，你也可以使用多次分页查询等方式解决这个问题，但是我们是否可以更优雅些呢？
|
||
|
||
```kotlin
|
||
class UserService : ReactorServiceImpl<UserMapper, User>() {
|
||
// 在 WebFlux 中，可以将此方法直接作为 Controller 的返回值，供 WebFlux 进行调度，返回数据给前端
|
||
fun writeAllToExcel(): Mono<String> {
|
||
// 目标文件
|
||
val tempFile = File.createTempFile("user", ".xlsx")
|
||
// 创建 EasyExcel 的 writer 与目标 sheet
|
||
val writer = EasyExcel.write(tempFile, UserExportVo::class.java)
|
||
// 自动列宽
|
||
.registerWriteHandler(LongestMatchColumnWidthStyleStrategy())
|
||
.build()
|
||
val sheet = EasyExcel.writerSheet(1).build()
|
||
// 调用响应式的 listAs 方法
|
||
return listAs(QueryWrapper.create(), UserExportVo::class.java)
|
||
// 这里可以预处理数据
|
||
.doOnNext { it.name = "${it.id} ${it.name}" }
|
||
// 选择缓存大小，即多少条数据一起写入 Excel
|
||
.buffer(100)
|
||
// 写入到 Excel
|
||
.doOnNext { writer.write(it, sheet) }
|
||
// 做结尾操作，使用 then 只接收信号而不接收数据
|
||
.then()
|
||
// 结束后关闭 writer
|
||
.doOnTerminate { writer.finish() }
|
||
// 返回文件路径
|
||
.thRerturn(tempFile.absolutePath)
|
||
// 即使出错也会关闭 writer，防止可能的资源泄漏
|
||
.doOnError {
|
||
writer.finish()
|
||
it.printStackTrace()
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
看完上面代码，你会发现你再也不需要关注内部实现细节与逻辑，仅需像“配置代码”一样，填写几个参数就实现了我们的需求。与原来 `IService` 一样的查询调用方法简单易懂。
|
||
|
||
在非 Webflux 项目中如何调用返回值为 `Mono` 或 `Flux` 的方法呢？MybatisFlex Reactor 提供了两个方法解决这个问题：
|
||
|
||
```kotlin
|
||
// 异步调用
|
||
ReactorUtils.runAsync(Mono<T>) // 返回 任务生命周期对象 Disposable
|
||
// 同步 / 堵塞 调用
|
||
ReactorUtils.runBlock(Mono<T>) // 返回 T
|
||
|
||
// 对于返回值为 Flux 的方法，我们可以将其转换为 Mono 即可
|
||
// 直接将所有结果集中到一个 List 中
|
||
Flux<T>.collectList() // 返回 Mono<List<T>>
|
||
// 以自定义 Collector 汇总数据
|
||
Flux<T>.collect(Collectors.joining(", ")) // 返回 String，每个数据直接用“，”链接
|
||
```
|
||
|
||
### 开源地址
|
||
[Gitee（仅同步项目）](https://gitee.com/goxiaogle/mybatis-flex-reactor)
|
||
|
||
[Github](https://github.com/Goxiaogle/mybatis-flex-reactor)
|