From 38ad9884d06a976a579a0f81ea3cb5eb71324b98 Mon Sep 17 00:00:00 2001 From: minglipro Date: Mon, 26 Oct 2026 23:37:32 +0800 Subject: [PATCH] =?UTF-8?q?refactor(mybatisplus):=20=E4=BC=98=E5=8C=96=20F?= =?UTF-8?q?astBaseMapper=20=E5=B9=B6=E8=A1=A5=E5=85=85=E4=BE=BF=E6=8D=B7?= =?UTF-8?q?=E6=9F=A5=E8=AF=A2=E5=87=BD=E6=95=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 修复集合查询误用 eq 的问题,改为 in 条件 - 将接口内失效的成员扩展 qw/uw/qcw/ucw 迁移至 companion 并加显式返回类型 - 用显式类型参数消除 ktQueryChain/ktUpdateChain 构造器重载歧义 - 新增 ktQueryChain/ktUpdateChain、update(entity)、selectPage(current,size)、 selectCount、exists、delete、selectListByColumns、selectOneByColumn、 existsByColumn、deleteByColumn 等便捷函数,deleteByColumn 对空集合返回 0 以防误删全表 --- .../utils/mybatisplus/FastBaseMapper.kt | 294 +++++++++++++++++- 1 file changed, 281 insertions(+), 13 deletions(-) diff --git a/src/main/kotlin/com/mingliqiye/utils/mybatisplus/FastBaseMapper.kt b/src/main/kotlin/com/mingliqiye/utils/mybatisplus/FastBaseMapper.kt index 4a11644..70bbd28 100644 --- a/src/main/kotlin/com/mingliqiye/utils/mybatisplus/FastBaseMapper.kt +++ b/src/main/kotlin/com/mingliqiye/utils/mybatisplus/FastBaseMapper.kt @@ -63,13 +63,6 @@ interface FastBaseMapper : BaseMapper { */ fun lambdaUpdateWrapper() = LambdaUpdateWrapper() - - fun FastBaseMapper.qw() = queryWrapper() - fun FastBaseMapper.uw() = updateWrapper() - fun FastBaseMapper.qcw() = lambdaQueryWrapper() - fun FastBaseMapper.ucw() = lambdaUpdateWrapper() - - companion object { /** @@ -142,30 +135,204 @@ interface FastBaseMapper : BaseMapper { inline fun BaseMapper.ktUpdateChainWrapper(): KtUpdateChainWrapper = KtUpdateChainWrapper(T::class.java) - inline fun FastBaseMapper.kqw() = ktQueryWrapper() - inline fun FastBaseMapper.kuw() = ktUpdateWrapper() - inline fun FastBaseMapper.kqcw() = ktQueryChainWrapper() - inline fun FastBaseMapper.kucw() = ktUpdateChainWrapper() + /** + * 创建绑定当前映射器的[com.baomidou.mybatisplus.extension.kotlin.KtQueryChainWrapper]实例 + * 与[ktQueryChainWrapper]不同,该链式包装器持有映射器引用,可直接调用`list`/`one`/`page`等方法执行查询 + * @param T 范型类型,必须继承自Any + * @receiver FastBaseMapper 快速映射器实例 + * @return KtQueryChainWrapper 可执行的Kotlin查询链式包装器实例 + */ + fun FastBaseMapper.ktQueryChain(): KtQueryChainWrapper = + KtQueryChainWrapper(this as BaseMapper) + /** + * 创建绑定当前映射器的[com.baomidou.mybatisplus.extension.kotlin.KtUpdateChainWrapper]实例 + * 与[ktUpdateChainWrapper]不同,该链式包装器持有映射器引用,可直接调用`update`/`remove`等方法执行操作 + * @param T 范型类型,必须继承自Any + * @receiver FastBaseMapper 快速映射器实例 + * @return KtUpdateChainWrapper 可执行的Kotlin更新链式包装器实例 + */ + fun FastBaseMapper.ktUpdateChain(): KtUpdateChainWrapper = + KtUpdateChainWrapper(this as BaseMapper) + + /** + * [queryWrapper]的简写形式 + * @param T 范型类型,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return QueryWrapper 查询包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.qw(): QueryWrapper = queryWrapper() + + /** + * [updateWrapper]的简写形式 + * @param T 范型类型,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return UpdateWrapper 更新包装器实例 + */ + inline fun FastBaseMapper.uw(): UpdateWrapper = updateWrapper() + + /** + * [lambdaQueryWrapper]的简写形式 + * @param T 范型类型,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return LambdaQueryWrapper Lambda查询包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.qcw(): LambdaQueryWrapper = lambdaQueryWrapper() + + /** + * [lambdaUpdateWrapper]的简写形式 + * @param T 范型类型,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return LambdaUpdateWrapper Lambda更新包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.ucw(): LambdaUpdateWrapper = lambdaUpdateWrapper() + + /** + * [ktQueryWrapper]的简写形式 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return KtQueryWrapper Kotlin查询包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.kqw(): KtQueryWrapper = ktQueryWrapper() + + /** + * [ktUpdateWrapper]的简写形式 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return KtUpdateWrapper Kotlin更新包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.kuw(): KtUpdateWrapper = ktUpdateWrapper() + + /** + * [ktQueryChainWrapper]的简写形式 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return KtQueryChainWrapper Kotlin查询链式包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.kqcw(): KtQueryChainWrapper = ktQueryChainWrapper() + + /** + * [ktUpdateChainWrapper]的简写形式 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @return KtUpdateChainWrapper Kotlin更新链式包装器实例,使用T类作为参数 + */ + inline fun FastBaseMapper.kucw(): KtUpdateChainWrapper = ktUpdateChainWrapper() + + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtUpdateWrapper]并执行更新 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param funs 更新包装器构建函数,返回构建完成的更新包装器 + * @return Int 受影响的行数 + */ inline fun FastBaseMapper.update(funs: (wrapper: KtUpdateWrapper) -> KtUpdateWrapper): Int = this.update(funs(kuw())) + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtUpdateWrapper]并携带实体执行更新 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param entity 承载待更新字段值的实体对象 + * @param funs 更新包装器构建函数,返回构建完成的更新包装器 + * @return Int 受影响的行数 + */ + inline fun FastBaseMapper.update( + entity: T, + funs: (wrapper: KtUpdateWrapper) -> KtUpdateWrapper, + ): Int = this.update(entity, funs(kuw())) + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并执行查询 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return List 查询结果列表 + */ inline fun FastBaseMapper.selectList(funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper): List = this.selectList(funs(kqw())) + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并执行分页查询 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param page 分页参数对象 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return Page 分页查询结果 + */ inline fun FastBaseMapper.selectPage( page: Page, funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper, ): Page = this.selectPage(page, funs(kqw())) + /** + * 通过页码与每页大小直接执行分页查询 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param current 当前页码,从1开始 + * @param size 每页记录数 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return Page 分页查询结果 + */ + inline fun FastBaseMapper.selectPage( + current: Long, + size: Long, + funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper, + ): Page = this.selectPage(Page(current, size), funs(kqw())) + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并查询单条记录 + * 结果数量不为1时返回null,不抛出异常 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return T? 唯一的查询结果,不存在或多于一条时返回null + */ inline fun FastBaseMapper.selectOne(funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper): T? = this.selectList(funs).let { if (it.size != 1) null else it[0] } + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并统计记录数 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return Long 符合条件的记录总数 + */ + inline fun FastBaseMapper.selectCount(funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper): Long = + this.selectCount(funs(kqw())) + + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并判断记录是否存在 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return Boolean 存在符合条件的记录返回true,否则返回false + */ + inline fun FastBaseMapper.exists(funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper): Boolean = + this.exists(funs(kqw())) + + /** + * 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并执行删除 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param funs 查询包装器构建函数,返回构建完成的查询包装器 + * @return Int 被删除的行数 + */ + inline fun FastBaseMapper.delete(funs: (wrapper: KtQueryWrapper) -> KtQueryWrapper): Int = + this.delete(funs(kqw())) + + /** + * 按单列等值条件查询记录列表 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值,执行等值匹配 + * @return List 查询结果列表 + */ inline fun FastBaseMapper.selectListByColumn( column: KProperty1, value: R, @@ -173,16 +340,81 @@ interface FastBaseMapper : BaseMapper { it.eq(column, value) } + /** + * 按单列IN条件查询记录列表,集合为空时直接返回空列表而不执行查询 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值集合,执行IN匹配 + * @return List 查询结果列表 + */ inline fun FastBaseMapper.selectListByColumn( column: KProperty1, value: Collection, ): List { if (value.isEmpty()) return emptyList() return selectList { - it.eq(column, value) + it.`in`(column, value) } } + /** + * 按多列等值条件查询记录列表 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param columns 列属性引用与列值的键值对,逐项执行等值匹配 + * @return List 查询结果列表 + */ + inline fun FastBaseMapper.selectListByColumns( + vararg columns: Pair, Any?>, + ): List = selectList { wrapper -> + columns.forEach { (column, value) -> wrapper.eq(column, value) } + wrapper + } + + /** + * 按单列等值条件查询单条记录,结果数量不为1时返回null + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值,执行等值匹配 + * @return T? 唯一的查询结果,不存在或多于一条时返回null + */ + inline fun FastBaseMapper.selectOneByColumn( + column: KProperty1, + value: R, + ): T? = selectOne { + it.eq(column, value) + } + + /** + * 按单列等值条件判断记录是否存在 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值,执行等值匹配 + * @return Boolean 存在符合条件的记录返回true,否则返回false + */ + inline fun FastBaseMapper.existsByColumn( + column: KProperty1, + value: R, + ): Boolean = exists { + it.eq(column, value) + } + + /** + * 按单列IN条件查询记录并构建有序映射,集合为空时直接返回空映射而不执行查询 + * 返回的[LinkedHashMap]保持入参集合的迭代顺序,缺失的键对应的值为null + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值集合,执行IN匹配 + * @return LinkedHashMap 以列值为键、实体为值的有序映射 + */ inline fun FastBaseMapper.selectMapByColumn( column: KProperty1, value: Collection, @@ -190,7 +422,7 @@ interface FastBaseMapper : BaseMapper { if (value.isEmpty()) return linkedMapOf() val data = selectList { - it.eq(column, value) + it.`in`(column, value) } val mapdata: Map = data @@ -202,6 +434,42 @@ interface FastBaseMapper : BaseMapper { } return map } + + /** + * 按单列等值条件删除记录 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值,执行等值匹配 + * @return Int 被删除的行数 + */ + inline fun FastBaseMapper.deleteByColumn( + column: KProperty1, + value: R, + ): Int = delete { + it.eq(column, value) + } + + /** + * 按单列IN条件删除记录,集合为空时直接返回0而不执行删除 + * 注意:MyBatis-Plus对空集合的IN条件会整体跳过,若不拦截将导致全表删除 + * @param T 范型类型,必须继承自Any,通过reified获取实际类型 + * @param R 列值类型 + * @receiver FastBaseMapper 快速映射器实例 + * @param column 实体列属性引用 + * @param value 列值集合,执行IN匹配 + * @return Int 被删除的行数 + */ + inline fun FastBaseMapper.deleteByColumn( + column: KProperty1, + value: Collection, + ): Int { + if (value.isEmpty()) return 0 + return delete { + it.`in`(column, value) + } + } }