868 lines
32 KiB
Kotlin
868 lines
32 KiB
Kotlin
/*
|
|
* Copyright 2026 mingliqiye
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
* ProjectName mingli-utils
|
|
* ModuleName mingli-utils.main
|
|
* CurrentFile FastBaseMapper.kt
|
|
* LastUpdate 2026-10-28 22:23:47
|
|
* UpdateUser MingLiPro
|
|
*/
|
|
|
|
package com.mingliqiye.utils.mybatisplus
|
|
|
|
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper
|
|
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper
|
|
import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper
|
|
import com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper
|
|
import com.baomidou.mybatisplus.core.mapper.BaseMapper
|
|
import com.baomidou.mybatisplus.core.toolkit.support.SFunction
|
|
import com.baomidou.mybatisplus.extension.kotlin.KtQueryChainWrapper
|
|
import com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper
|
|
import com.baomidou.mybatisplus.extension.kotlin.KtUpdateChainWrapper
|
|
import com.baomidou.mybatisplus.extension.kotlin.KtUpdateWrapper
|
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page
|
|
import com.mingliqiye.utils.mybatisplus.FastBaseMapper.Companion.ktQueryChainWrapper
|
|
import com.mingliqiye.utils.mybatisplus.FastBaseMapper.Companion.ktQueryWrapper
|
|
import com.mingliqiye.utils.mybatisplus.FastBaseMapper.Companion.ktUpdateChainWrapper
|
|
import com.mingliqiye.utils.mybatisplus.FastBaseMapper.Companion.ktUpdateWrapper
|
|
import com.mingliqiye.utils.mybatisplus.FastBaseMapper.Companion.selectListByColumns
|
|
import com.mingliqiye.utils.tuple.Tuple
|
|
import kotlin.reflect.KProperty1
|
|
|
|
/**
|
|
* 扩展[com.baomidou.mybatisplus.core.mapper.BaseMapper]接口,提供便捷的查询和更新包装器创建方法
|
|
* 包含普通包装器、`Lambda`包装器和`Kotlin`专用包装器的创建方法
|
|
*/
|
|
interface FastBaseMapper<T> : BaseMapper<T> {
|
|
/**
|
|
* 创建[com.baomidou.mybatisplus.core.conditions.query.QueryWrapper]实例
|
|
* @return QueryWrapper<T> 查询包装器实例
|
|
*/
|
|
fun queryWrapper() = QueryWrapper<T>()
|
|
|
|
/**
|
|
* 创建[com.baomidou.mybatisplus.core.conditions.update.UpdateWrapper]实例
|
|
* @return UpdateWrapper<T> 更新包装器实例
|
|
*/
|
|
fun updateWrapper() = UpdateWrapper<T>()
|
|
|
|
/**
|
|
* 创建[com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper]实例
|
|
* @return LambdaQueryWrapper<T> Lambda查询包装器实例
|
|
*/
|
|
fun lambdaQueryWrapper() = LambdaQueryWrapper<T>()
|
|
|
|
/**
|
|
* 创建[com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper]实例
|
|
* @return LambdaUpdateWrapper<T> Lambda更新包装器实例
|
|
*/
|
|
fun lambdaUpdateWrapper() = LambdaUpdateWrapper<T>()
|
|
|
|
|
|
/**
|
|
* [queryWrapper]的简写形式
|
|
* @return QueryWrapper<T> 查询包装器实例
|
|
*/
|
|
fun qw() = queryWrapper()
|
|
|
|
/**
|
|
* [updateWrapper]的简写形式
|
|
* @return UpdateWrapper<T> 更新包装器实例
|
|
*/
|
|
fun uw() = updateWrapper()
|
|
|
|
/**
|
|
* [lambdaQueryWrapper]的简写形式
|
|
* @return LambdaQueryWrapper<T> Lambda查询包装器实例
|
|
*/
|
|
fun lqw() = lambdaQueryWrapper()
|
|
|
|
/**
|
|
* [lambdaUpdateWrapper]的简写形式
|
|
* @return LambdaUpdateWrapper<T> Lambda更新包装器实例
|
|
*/
|
|
fun luw() = lambdaUpdateWrapper()
|
|
|
|
|
|
/**
|
|
* 按字符串列名等值条件查询记录列表
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值,执行等值匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: String,
|
|
value: R,
|
|
): List<T> = selectListByColumn(column, value, qw())
|
|
|
|
/**
|
|
* 在给定[QueryWrapper]上追加字符串列名等值条件并查询记录列表
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值,执行等值匹配
|
|
* @param wrapper 承载查询条件的查询包装器
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: String,
|
|
value: R,
|
|
wrapper: QueryWrapper<T>,
|
|
): List<T> = selectList(wrapper.eq(column, value))
|
|
|
|
|
|
/**
|
|
* 按方法引用列等值条件查询记录列表
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值,执行等值匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: SFunction<T, R>,
|
|
value: R,
|
|
): List<T> = selectListByColumn(column, value, lqw())
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上追加方法引用列等值条件并查询记录列表
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值,执行等值匹配
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: SFunction<T, R>,
|
|
value: R,
|
|
wrapper: LambdaQueryWrapper<T>,
|
|
): List<T> = selectList(wrapper.eq(column, value))
|
|
|
|
/**
|
|
* 按方法引用列IN条件查询记录列表,集合为空时直接返回空列表而不执行查询
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: SFunction<T, R>,
|
|
value: Collection<R>,
|
|
): List<T> = selectListByColumn(column, value, lqw())
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上追加方法引用列IN条件并查询记录列表,集合为空时直接返回空列表而不执行查询
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: SFunction<T, R>,
|
|
value: Collection<R>,
|
|
wrapper: LambdaQueryWrapper<T> = lqw(),
|
|
): List<T> {
|
|
if (value.isEmpty()) return emptyList()
|
|
return selectList(wrapper.`in`(column, value))
|
|
}
|
|
|
|
/**
|
|
* 按字符串列名IN条件查询记录列表,集合为空时直接返回空列表而不执行查询
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值集合,执行IN匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: String,
|
|
value: Collection<R>,
|
|
): List<T> = selectListByColumn(column, value, qw())
|
|
|
|
/**
|
|
* 在给定[QueryWrapper]上追加字符串列名IN条件并查询记录列表,集合为空时直接返回空列表而不执行查询
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param wrapper 承载查询条件的查询包装器
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun <R> selectListByColumn(
|
|
column: String,
|
|
value: Collection<R>,
|
|
wrapper: QueryWrapper<T> = qw(),
|
|
): List<T> {
|
|
if (value.isEmpty()) return emptyList()
|
|
return selectList(wrapper.`in`(column, value))
|
|
}
|
|
|
|
/**
|
|
* 字符串列名与列值构成的二元组,用于[selectListByColumns]的可变参数传参
|
|
* @property t1 列名(数据库字段名)
|
|
* @property t2 列值
|
|
*/
|
|
class StringAnyTuple2(
|
|
val t1: String,
|
|
val t2: Any,
|
|
) : Tuple(2) {
|
|
operator fun component1() = t1
|
|
operator fun component2() = t2
|
|
}
|
|
|
|
/**
|
|
* 方法引用列与列值构成的二元组,用于[selectListByColumns]的可变参数传参
|
|
* @param T 实体类型
|
|
* @param D 列值类型
|
|
* @property t1 实体列的方法引用
|
|
* @property t2 列值
|
|
*/
|
|
class SFunctionAnyTuple2<T, D>(
|
|
val t1: SFunction<T, D>,
|
|
val t2: D,
|
|
) : Tuple(2) {
|
|
operator fun component1() = t1
|
|
operator fun component2() = t2
|
|
}
|
|
|
|
/**
|
|
* 按多个字符串列名等值条件查询记录列表,各列条件以AND连接
|
|
* @param columns 列名与列值构成的二元组,逐项执行等值匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun selectListByColumns(
|
|
vararg columns: StringAnyTuple2,
|
|
): List<T> = selectList(qw().let { wrapper ->
|
|
columns.forEach { (column, value) ->
|
|
wrapper.eq(column, value)
|
|
}
|
|
wrapper
|
|
})
|
|
|
|
/**
|
|
* 按多个方法引用列等值条件查询记录列表,各列条件以AND连接
|
|
* @param columns 方法引用列与列值构成的二元组,逐项执行等值匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun selectListByColumns(
|
|
vararg columns: SFunctionAnyTuple2<T, *>,
|
|
): List<T> = selectListByColumns(lqw(), *columns)
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上追加多个方法引用列等值条件并查询记录列表,各列条件以AND连接
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @param columns 方法引用列与列值构成的二元组,逐项执行等值匹配
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
fun selectListByColumns(
|
|
wrapper: LambdaQueryWrapper<T>,
|
|
vararg columns: SFunctionAnyTuple2<T, *>,
|
|
): List<T> = selectList(wrapper.let {
|
|
columns.forEach { (column, value) ->
|
|
it.eq(column, value)
|
|
}
|
|
it
|
|
})
|
|
|
|
/**
|
|
* 按字符串列名等值条件查询单条记录,结果数量不为1时返回null
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值,执行等值匹配
|
|
* @return T? 唯一的查询结果,不存在或多于一条时返回null
|
|
*/
|
|
fun <R> selectOneByColumn(
|
|
column: String,
|
|
value: R,
|
|
): T? = selectOneByColumn(column, value, qw())
|
|
|
|
/**
|
|
* 在给定[QueryWrapper]上追加字符串列名等值条件并查询单条记录,结果数量不为1时返回null
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值,执行等值匹配
|
|
* @param wrapper 承载查询条件的查询包装器
|
|
* @return T? 唯一的查询结果,不存在或多于一条时返回null
|
|
*/
|
|
fun <R> selectOneByColumn(
|
|
column: String,
|
|
value: R,
|
|
wrapper: QueryWrapper<T> = qw(),
|
|
): T? = selectOne(
|
|
wrapper.eq(column, value),
|
|
)
|
|
|
|
|
|
/**
|
|
* 按方法引用列等值条件查询单条记录,结果数量不为1时返回null
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值,执行等值匹配
|
|
* @return T? 唯一的查询结果,不存在或多于一条时返回null
|
|
*/
|
|
fun <R> selectOneByColumn(
|
|
column: SFunction<T, R>,
|
|
value: R,
|
|
): T? = selectOneByColumn(
|
|
column, value, lqw()
|
|
)
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上追加方法引用列等值条件并查询单条记录,结果数量不为1时返回null
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值,执行等值匹配
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @return T? 唯一的查询结果,不存在或多于一条时返回null
|
|
*/
|
|
fun <R> selectOneByColumn(
|
|
column: SFunction<T, R>,
|
|
value: R,
|
|
wrapper: LambdaQueryWrapper<T>,
|
|
): T? = selectOne(
|
|
wrapper.eq(column, value),
|
|
)
|
|
|
|
/**
|
|
* 按字符串列名等值条件判断记录是否存在
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值,执行等值匹配
|
|
* @return Boolean 存在符合条件的记录返回true,否则返回false
|
|
*/
|
|
fun <R> existsByColumn(
|
|
column: String,
|
|
value: R,
|
|
): Boolean = existsByColumn(column, value, qw())
|
|
|
|
/**
|
|
* 在给定[QueryWrapper]上追加字符串列名等值条件并判断记录是否存在
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值,执行等值匹配
|
|
* @param wrapper 承载查询条件的查询包装器
|
|
* @return Boolean 存在符合条件的记录返回true,否则返回false
|
|
*/
|
|
fun <R> existsByColumn(
|
|
column: String,
|
|
value: R,
|
|
wrapper: QueryWrapper<T> = qw(),
|
|
): Boolean = exists(
|
|
wrapper.eq(column, value),
|
|
)
|
|
|
|
/**
|
|
* 按方法引用列等值条件判断记录是否存在
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值,执行等值匹配
|
|
* @return Boolean 存在符合条件的记录返回true,否则返回false
|
|
*/
|
|
fun <R> existsByColumn(
|
|
column: SFunction<T, R>,
|
|
value: R,
|
|
): Boolean = existsByColumn(column, value, lqw())
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上追加方法引用列等值条件并判断记录是否存在
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值,执行等值匹配
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @return Boolean 存在符合条件的记录返回true,否则返回false
|
|
*/
|
|
fun <R> existsByColumn(
|
|
column: SFunction<T, R>,
|
|
value: R,
|
|
wrapper: LambdaQueryWrapper<T> = lqw(),
|
|
): Boolean = exists(
|
|
wrapper.eq(column, value),
|
|
)
|
|
|
|
/**
|
|
* 按方法引用列IN条件查询记录并构建有序映射,集合为空时直接返回空映射而不执行查询
|
|
* 返回的[LinkedHashMap]保持入参集合的迭代顺序,缺失的键对应的值为null
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @return LinkedHashMap<R, T?> 以列值为键、实体为值的有序映射
|
|
*/
|
|
fun <R> selectMapByColumn(
|
|
column: SFunction<T, R>,
|
|
value: Collection<R>,
|
|
): LinkedHashMap<R, T?> {
|
|
return selectMapByColumn(column, value, lqw())
|
|
}
|
|
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上按方法引用列IN条件查询记录并构建有序映射,集合为空时直接返回空映射而不执行查询
|
|
* 返回的[LinkedHashMap]保持入参集合的迭代顺序,缺失的键对应的值为null
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @return LinkedHashMap<R, T?> 以列值为键、实体为值的有序映射
|
|
*/
|
|
fun <R> selectMapByColumn(
|
|
column: SFunction<T, R>,
|
|
value: Collection<R>,
|
|
wrapper: LambdaQueryWrapper<T> = lqw(),
|
|
): LinkedHashMap<R, T?> {
|
|
if (value.isEmpty()) return linkedMapOf()
|
|
|
|
val data = selectList(wrapper.`in`(column, value))
|
|
|
|
val mapdata: Map<R, T> = data.associateBy { column.apply(it) }
|
|
|
|
val map = LinkedHashMap<R, T?>(value.size)
|
|
value.forEach { key ->
|
|
map[key] = mapdata[key]
|
|
}
|
|
return map
|
|
}
|
|
|
|
/**
|
|
* 按字符串列名IN条件删除记录,集合为空时直接返回0而不执行删除
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值集合,执行IN匹配
|
|
* @return Int 被删除的行数
|
|
*/
|
|
fun <R> deleteByColumn(
|
|
column: String,
|
|
value: Collection<R>,
|
|
): Int {
|
|
return deleteByColumn(column, value, qw())
|
|
}
|
|
|
|
/**
|
|
* 在给定[QueryWrapper]上按字符串列名IN条件删除记录,集合为空时直接返回0而不执行删除
|
|
* 注意:MyBatis-Plus对空集合的IN条件会整体跳过,若不拦截将导致全表删除
|
|
* @param R 列值类型
|
|
* @param column 列名(数据库字段名)
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param wrapper 承载查询条件的查询包装器
|
|
* @return Int 被删除的行数
|
|
*/
|
|
fun <R> deleteByColumn(
|
|
column: String,
|
|
value: Collection<R>,
|
|
wrapper: QueryWrapper<T> = qw(),
|
|
): Int {
|
|
if (value.isEmpty()) return 0
|
|
return delete(
|
|
wrapper.`in`(
|
|
column, value
|
|
)
|
|
)
|
|
}
|
|
|
|
/**
|
|
* 按方法引用列IN条件删除记录,集合为空时直接返回0而不执行删除
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @return Int 被删除的行数
|
|
*/
|
|
fun <R> deleteByColumn(
|
|
column: SFunction<T, R>,
|
|
value: Collection<R>,
|
|
): Int {
|
|
return deleteByColumn(
|
|
column, value, lqw()
|
|
)
|
|
}
|
|
|
|
/**
|
|
* 在给定[LambdaQueryWrapper]上按方法引用列IN条件删除记录,集合为空时直接返回0而不执行删除
|
|
* 注意:MyBatis-Plus对空集合的IN条件会整体跳过,若不拦截将导致全表删除
|
|
* @param R 列值类型
|
|
* @param column 实体列的方法引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param wrapper 承载查询条件的Lambda查询包装器
|
|
* @return Int 被删除的行数
|
|
*/
|
|
fun <R> deleteByColumn(
|
|
column: SFunction<T, R>,
|
|
value: Collection<R>,
|
|
wrapper: LambdaQueryWrapper<T>,
|
|
): Int {
|
|
if (value.isEmpty()) return 0
|
|
return delete(
|
|
wrapper.`in`(
|
|
column, value
|
|
)
|
|
)
|
|
}
|
|
|
|
|
|
companion object {
|
|
|
|
/**
|
|
* 为[BaseMapper]创建[com.baomidou.mybatisplus.extension.kotlin.KtQueryWrapper]实例
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @receiver BaseMapper<T> 基础映射器实例
|
|
* @return KtQueryWrapper<T> Kotlin查询包装器实例,使用T类作为参数
|
|
*/
|
|
inline fun <reified T : Any> BaseMapper<T>.ktQueryWrapper(): KtQueryWrapper<T> = KtQueryWrapper(T::class.java)
|
|
|
|
/**
|
|
* 为[BaseMapper]创建[com.baomidou.mybatisplus.extension.kotlin.KtQueryChainWrapper]实例
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @receiver BaseMapper<T> 基础映射器实例
|
|
* @return KtQueryChainWrapper<T> Kotlin查询链式包装器实例,使用T类作为参数
|
|
*/
|
|
inline fun <reified T : Any> BaseMapper<T>.ktQueryChainWrapper(): KtQueryChainWrapper<T> =
|
|
KtQueryChainWrapper(T::class.java)
|
|
|
|
/**
|
|
* 为[BaseMapper]创建[com.baomidou.mybatisplus.extension.kotlin.KtUpdateWrapper]实例
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @receiver BaseMapper<T> 基础映射器实例
|
|
* @return KtUpdateWrapper<T> Kotlin更新包装器实例,使用T类作为参数
|
|
*/
|
|
inline fun <reified T : Any> BaseMapper<T>.ktUpdateWrapper(): KtUpdateWrapper<T> =
|
|
KtUpdateWrapper(T::class.java)
|
|
|
|
/**
|
|
* 为[BaseMapper]创建[com.baomidou.mybatisplus.extension.kotlin.KtUpdateChainWrapper]实例
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @receiver BaseMapper<T> 基础映射器实例
|
|
* @return KtUpdateChainWrapper<T> Kotlin更新链式包装器实例,使用T类作为参数
|
|
*/
|
|
inline fun <reified T : Any> BaseMapper<T>.ktUpdateChainWrapper(): KtUpdateChainWrapper<T> =
|
|
KtUpdateChainWrapper(T::class.java)
|
|
|
|
/**
|
|
* 创建绑定当前映射器的[com.baomidou.mybatisplus.extension.kotlin.KtQueryChainWrapper]实例
|
|
* 与[ktQueryChainWrapper]不同,该链式包装器持有映射器引用,可直接调用`list`/`one`/`page`等方法执行查询
|
|
* @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>)
|
|
|
|
/**
|
|
* [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 =
|
|
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> =
|
|
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(
|
|
page: Page<T>,
|
|
funs: (wrapper: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): 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> = { it },
|
|
): 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? =
|
|
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<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 列值,执行等值匹配
|
|
* @param funs 附加查询包装器构建函数,在等值条件之前应用
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.selectListByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: R,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): List<T> = selectList { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).eq(column, value)
|
|
}
|
|
|
|
/**
|
|
* 按单列IN条件查询记录列表,集合为空时直接返回空列表而不执行查询
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @param R 列值类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param column 实体列属性引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param funs 附加查询包装器构建函数,在IN条件之前应用
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.selectListByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: Collection<R>,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): List<T> {
|
|
if (value.isEmpty()) return emptyList()
|
|
return selectList { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).`in`(column, value)
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 按多列等值条件查询记录列表
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param columns 列属性引用与列值的键值对,逐项执行等值匹配
|
|
* @param funs 附加查询包装器构建函数,在各列等值条件之前应用
|
|
* @return List<T> 查询结果列表
|
|
*/
|
|
inline fun <reified T : Any> FastBaseMapper<T>.selectListByColumns(
|
|
vararg columns: Pair<KProperty1<T, *>, Any?>,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): List<T> = selectList { wrapper: KtQueryWrapper<T> ->
|
|
val w = funs(wrapper)
|
|
columns.forEach { (column, value) -> w.eq(column, value) }
|
|
w
|
|
}
|
|
|
|
/**
|
|
* 按单列等值条件查询单条记录,结果数量不为1时返回null
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @param R 列值类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param column 实体列属性引用
|
|
* @param value 列值,执行等值匹配
|
|
* @param funs 附加查询包装器构建函数,在等值条件之前应用
|
|
* @return T? 唯一的查询结果,不存在或多于一条时返回null
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.selectOneByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: R,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): T? = selectOne { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).eq(column, value)
|
|
}
|
|
|
|
/**
|
|
* 按单列等值条件判断记录是否存在
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @param R 列值类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param column 实体列属性引用
|
|
* @param funs 附加查询包装器构建函数,在等值条件之前应用
|
|
* @param value 列值,执行等值匹配
|
|
* @return Boolean 存在符合条件的记录返回true,否则返回false
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.existsByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: R,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): Boolean = exists { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).eq(column, value)
|
|
}
|
|
|
|
/**
|
|
* 按单列IN条件查询记录并构建有序映射,集合为空时直接返回空映射而不执行查询
|
|
* 返回的[LinkedHashMap]保持入参集合的迭代顺序,缺失的键对应的值为null
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @param R 列值类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param column 实体列属性引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param funs 附加查询包装器构建函数,在IN条件之前应用
|
|
* @return LinkedHashMap<R, T?> 以列值为键、实体为值的有序映射
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.selectMapByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: Collection<R>,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): LinkedHashMap<R, T?> {
|
|
if (value.isEmpty()) return linkedMapOf()
|
|
|
|
val data = selectList { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).`in`(column, value)
|
|
}
|
|
|
|
val mapdata: Map<R, T> = data.associateBy { column(it) }
|
|
|
|
val map = LinkedHashMap<R, T?>(value.size)
|
|
value.forEach { key ->
|
|
map[key] = mapdata[key]
|
|
}
|
|
return map
|
|
}
|
|
|
|
/**
|
|
* 按单列等值条件删除记录
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @param R 列值类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param column 实体列属性引用
|
|
* @param value 列值,执行等值匹配
|
|
* @param funs 附加查询包装器构建函数,在等值条件之前应用
|
|
* @return Int 被删除的行数
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.deleteByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: R,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): Int = delete { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).eq(column, value)
|
|
}
|
|
|
|
/**
|
|
* 按单列IN条件删除记录,集合为空时直接返回0而不执行删除
|
|
* 注意:MyBatis-Plus对空集合的IN条件会整体跳过,若不拦截将导致全表删除
|
|
* @param T 范型类型,必须继承自Any,通过reified获取实际类型
|
|
* @param R 列值类型
|
|
* @receiver FastBaseMapper<T> 快速映射器实例
|
|
* @param column 实体列属性引用
|
|
* @param value 列值集合,执行IN匹配
|
|
* @param funs 附加查询包装器构建函数,在IN条件之前应用
|
|
* @return Int 被删除的行数
|
|
*/
|
|
inline fun <reified T : Any, R> FastBaseMapper<T>.deleteByColumn(
|
|
column: KProperty1<T, R>,
|
|
value: Collection<R>,
|
|
funs: (w: KtQueryWrapper<T>) -> KtQueryWrapper<T> = { it },
|
|
): Int {
|
|
if (value.isEmpty()) return 0
|
|
return delete { wrapper: KtQueryWrapper<T> ->
|
|
funs(wrapper).`in`(column, value)
|
|
}
|
|
}
|
|
}
|
|
}
|