refactor(mybatisplus): 优化 FastBaseMapper 并补充便捷查询函数

- 修复集合查询误用 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 以防误删全表
This commit is contained in:
2026-10-26 23:37:32 +08:00
parent 0e5ce5597b
commit 38ad9884d0
@@ -63,13 +63,6 @@ interface FastBaseMapper<T> : BaseMapper<T> {
*/ */
fun lambdaUpdateWrapper() = LambdaUpdateWrapper<T>() fun lambdaUpdateWrapper() = LambdaUpdateWrapper<T>()
fun <T : Any> FastBaseMapper<T>.qw() = queryWrapper()
fun <T : Any> FastBaseMapper<T>.uw() = updateWrapper()
fun <T : Any> FastBaseMapper<T>.qcw() = lambdaQueryWrapper()
fun <T : Any> FastBaseMapper<T>.ucw() = lambdaUpdateWrapper()
companion object { companion object {
/** /**
@@ -142,30 +135,204 @@ interface FastBaseMapper<T> : BaseMapper<T> {
inline fun <reified T : Any> BaseMapper<T>.ktUpdateChainWrapper(): KtUpdateChainWrapper<T> = inline fun <reified T : Any> BaseMapper<T>.ktUpdateChainWrapper(): KtUpdateChainWrapper<T> =
KtUpdateChainWrapper(T::class.java) KtUpdateChainWrapper(T::class.java)
inline fun <reified T : Any> FastBaseMapper<T>.kqw() = ktQueryWrapper() /**
inline fun <reified T : Any> FastBaseMapper<T>.kuw() = ktUpdateWrapper() * 创建绑定当前映射器的[com.baomidou.mybatisplus.extension.kotlin.KtQueryChainWrapper]实例
inline fun <reified T : Any> FastBaseMapper<T>.kqcw() = ktQueryChainWrapper() * 与[ktQueryChainWrapper]不同,该链式包装器持有映射器引用,可直接调用`list`/`one`/`page`等方法执行查询
inline fun <reified T : Any> FastBaseMapper<T>.kucw() = ktUpdateChainWrapper() * @param T 范型类型,必须继承自Any
* @receiver FastBaseMapper<T> 快速映射器实例
* @return KtQueryChainWrapper<T> 可执行的Kotlin查询链式包装器实例
*/
fun <T : Any> FastBaseMapper<T>.ktQueryChain(): KtQueryChainWrapper<T> =
KtQueryChainWrapper<T>(this as BaseMapper<T>)
/**
* 创建绑定当前映射器的[com.baomidou.mybatisplus.extension.kotlin.KtUpdateChainWrapper]实例
* 与[ktUpdateChainWrapper]不同,该链式包装器持有映射器引用,可直接调用`update`/`remove`等方法执行操作
* @param T 范型类型,必须继承自Any
* @receiver FastBaseMapper<T> 快速映射器实例
* @return KtUpdateChainWrapper<T> 可执行的Kotlin更新链式包装器实例
*/
fun <T : Any> FastBaseMapper<T>.ktUpdateChain(): KtUpdateChainWrapper<T> =
KtUpdateChainWrapper<T>(this as BaseMapper<T>)
/**
* [queryWrapper]的简写形式
* @param T 范型类型,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return QueryWrapper<T> 查询包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.qw(): QueryWrapper<T> = queryWrapper()
/**
* [updateWrapper]的简写形式
* @param T 范型类型,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return UpdateWrapper<T> 更新包装器实例
*/
inline fun <reified T : Any> FastBaseMapper<T>.uw(): UpdateWrapper<T> = updateWrapper()
/**
* [lambdaQueryWrapper]的简写形式
* @param T 范型类型,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return LambdaQueryWrapper<T> Lambda查询包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.qcw(): LambdaQueryWrapper<T> = lambdaQueryWrapper()
/**
* [lambdaUpdateWrapper]的简写形式
* @param T 范型类型,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return LambdaUpdateWrapper<T> Lambda更新包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.ucw(): LambdaUpdateWrapper<T> = lambdaUpdateWrapper()
/**
* [ktQueryWrapper]的简写形式
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return KtQueryWrapper<T> Kotlin查询包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.kqw(): KtQueryWrapper<T> = ktQueryWrapper()
/**
* [ktUpdateWrapper]的简写形式
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return KtUpdateWrapper<T> Kotlin更新包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.kuw(): KtUpdateWrapper<T> = ktUpdateWrapper()
/**
* [ktQueryChainWrapper]的简写形式
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return KtQueryChainWrapper<T> Kotlin查询链式包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.kqcw(): KtQueryChainWrapper<T> = ktQueryChainWrapper()
/**
* [ktUpdateChainWrapper]的简写形式
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @return KtUpdateChainWrapper<T> Kotlin更新链式包装器实例,使用T类作为参数
*/
inline fun <reified T : Any> FastBaseMapper<T>.kucw(): KtUpdateChainWrapper<T> = ktUpdateChainWrapper()
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtUpdateWrapper]并执行更新
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param funs 更新包装器构建函数,返回构建完成的更新包装器
* @return Int 受影响的行数
*/
inline fun <reified T : Any> FastBaseMapper<T>.update(funs: (wrapper: KtUpdateWrapper<T>) -> KtUpdateWrapper<T>): Int = inline fun <reified T : Any> FastBaseMapper<T>.update(funs: (wrapper: KtUpdateWrapper<T>) -> KtUpdateWrapper<T>): Int =
this.update(funs(kuw())) this.update(funs(kuw()))
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtUpdateWrapper]并携带实体执行更新
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param entity 承载待更新字段值的实体对象
* @param funs 更新包装器构建函数,返回构建完成的更新包装器
* @return Int 受影响的行数
*/
inline fun <reified T : Any> FastBaseMapper<T>.update(
entity: T,
funs: (wrapper: KtUpdateWrapper<T>) -> KtUpdateWrapper<T>,
): Int = this.update(entity, funs(kuw()))
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并执行查询
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return List<T> 查询结果列表
*/
inline fun <reified T : Any> FastBaseMapper<T>.selectList(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): List<T> = inline fun <reified T : Any> FastBaseMapper<T>.selectList(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): List<T> =
this.selectList(funs(kqw())) this.selectList(funs(kqw()))
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并执行分页查询
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param page 分页参数对象
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return Page<T> 分页查询结果
*/
inline fun <reified T : Any> FastBaseMapper<T>.selectPage( inline fun <reified T : Any> FastBaseMapper<T>.selectPage(
page: Page<T>, page: Page<T>,
funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>, funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>,
): Page<T> = this.selectPage(page, funs(kqw())) ): Page<T> = this.selectPage(page, funs(kqw()))
/**
* 通过页码与每页大小直接执行分页查询
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param current 当前页码,从1开始
* @param size 每页记录数
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return Page<T> 分页查询结果
*/
inline fun <reified T : Any> FastBaseMapper<T>.selectPage(
current: Long,
size: Long,
funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>,
): Page<T> = this.selectPage(Page(current, size), funs(kqw()))
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并查询单条记录
* 结果数量不为1时返回null,不抛出异常
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return T? 唯一的查询结果,不存在或多于一条时返回null
*/
inline fun <reified T : Any> FastBaseMapper<T>.selectOne(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): T? = inline fun <reified T : Any> FastBaseMapper<T>.selectOne(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): T? =
this.selectList(funs).let { this.selectList(funs).let {
if (it.size != 1) null if (it.size != 1) null
else it[0] else it[0]
} }
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并统计记录数
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return Long 符合条件的记录总数
*/
inline fun <reified T : Any> FastBaseMapper<T>.selectCount(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): Long =
this.selectCount(funs(kqw()))
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并判断记录是否存在
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return Boolean 存在符合条件的记录返回true,否则返回false
*/
inline fun <reified T : Any> FastBaseMapper<T>.exists(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): Boolean =
this.exists(funs(kqw()))
/**
* 通过Lambda构建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]并执行删除
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param funs 查询包装器构建函数,返回构建完成的查询包装器
* @return Int 被删除的行数
*/
inline fun <reified T : Any> FastBaseMapper<T>.delete(funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T>): Int =
this.delete(funs(kqw()))
/**
* 按单列等值条件查询记录列表
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值,执行等值匹配
* @return List<T> 查询结果列表
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.selectListByColumn( inline fun <reified T : Any, R> FastBaseMapper<T>.selectListByColumn(
column: KProperty1<T, R>, column: KProperty1<T, R>,
value: R, value: R,
@@ -173,16 +340,81 @@ interface FastBaseMapper<T> : BaseMapper<T> {
it.eq(column, value) it.eq(column, value)
} }
/**
* 按单列IN条件查询记录列表,集合为空时直接返回空列表而不执行查询
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值集合,执行IN匹配
* @return List<T> 查询结果列表
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.selectListByColumn( inline fun <reified T : Any, R> FastBaseMapper<T>.selectListByColumn(
column: KProperty1<T, R>, column: KProperty1<T, R>,
value: Collection<R>, value: Collection<R>,
): List<T> { ): List<T> {
if (value.isEmpty()) return emptyList() if (value.isEmpty()) return emptyList()
return selectList { return selectList {
it.eq(column, value) it.`in`(column, value)
} }
} }
/**
* 按多列等值条件查询记录列表
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param columns 列属性引用与列值的键值对,逐项执行等值匹配
* @return List<T> 查询结果列表
*/
inline fun <reified T : Any> FastBaseMapper<T>.selectListByColumns(
vararg columns: Pair<KProperty1<T, *>, Any?>,
): List<T> = selectList { wrapper ->
columns.forEach { (column, value) -> wrapper.eq(column, value) }
wrapper
}
/**
* 按单列等值条件查询单条记录,结果数量不为1时返回null
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值,执行等值匹配
* @return T? 唯一的查询结果,不存在或多于一条时返回null
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.selectOneByColumn(
column: KProperty1<T, R>,
value: R,
): T? = selectOne {
it.eq(column, value)
}
/**
* 按单列等值条件判断记录是否存在
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值,执行等值匹配
* @return Boolean 存在符合条件的记录返回true,否则返回false
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.existsByColumn(
column: KProperty1<T, R>,
value: R,
): Boolean = exists {
it.eq(column, value)
}
/**
* 按单列IN条件查询记录并构建有序映射,集合为空时直接返回空映射而不执行查询
* 返回的[LinkedHashMap]保持入参集合的迭代顺序,缺失的键对应的值为null
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值集合,执行IN匹配
* @return LinkedHashMap<R, T?> 以列值为键、实体为值的有序映射
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.selectMapByColumn( inline fun <reified T : Any, R> FastBaseMapper<T>.selectMapByColumn(
column: KProperty1<T, R>, column: KProperty1<T, R>,
value: Collection<R>, value: Collection<R>,
@@ -190,7 +422,7 @@ interface FastBaseMapper<T> : BaseMapper<T> {
if (value.isEmpty()) return linkedMapOf() if (value.isEmpty()) return linkedMapOf()
val data = selectList { val data = selectList {
it.eq(column, value) it.`in`(column, value)
} }
val mapdata: Map<R, T> = data val mapdata: Map<R, T> = data
@@ -202,6 +434,42 @@ interface FastBaseMapper<T> : BaseMapper<T> {
} }
return map return map
} }
/**
* 按单列等值条件删除记录
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值,执行等值匹配
* @return Int 被删除的行数
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.deleteByColumn(
column: KProperty1<T, R>,
value: R,
): Int = delete {
it.eq(column, value)
}
/**
* 按单列IN条件删除记录,集合为空时直接返回0而不执行删除
* 注意:MyBatis-Plus对空集合的IN条件会整体跳过,若不拦截将导致全表删除
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
* @param R 列值类型
* @receiver FastBaseMapper<T> 快速映射器实例
* @param column 实体列属性引用
* @param value 列值集合,执行IN匹配
* @return Int 被删除的行数
*/
inline fun <reified T : Any, R> FastBaseMapper<T>.deleteByColumn(
column: KProperty1<T, R>,
value: Collection<R>,
): Int {
if (value.isEmpty()) return 0
return delete {
it.`in`(column, value)
}
}
} }