no message

This commit is contained in:
2025-09-14 18:23:34 +08:00
parent d991b4077b
commit fb4e103da8
28 changed files with 1375 additions and 813 deletions
@@ -24,12 +24,9 @@
package com.mingliqiye.utils
import com.mingliqiye.utils.path.OsPath
import com.mingliqiye.utils.springboot.autoconfigure.AutoConfiguration
fun main() {
AutoConfiguration.printBanner()
val path = OsPath.getCwd()
println(path.toAbsolutePath())
}
@@ -0,0 +1,123 @@
/*
* Copyright 2025 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 AesUtils.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
@file:JvmName("AesUtils")
package com.mingliqiye.utils.aes
import com.mingliqiye.utils.base64.Base64Utils
import java.nio.charset.StandardCharsets
import java.security.GeneralSecurityException
import java.security.MessageDigest
import java.security.SecureRandom
import javax.crypto.Cipher
import javax.crypto.spec.GCMParameterSpec
import javax.crypto.spec.SecretKeySpec
const val ALGORITHM = "AES"
const val TRANSFORMATION = "AES/GCM/NoPadding"
const val GCM_IV_LENGTH = 12
const val GCM_TAG_LENGTH = 16
val SECURE_RANDOM = SecureRandom()
/**
* AES加密方法(使用GCM模式)
* @param sSrc 待加密的字符串
* @param sKey 加密密钥
* @return 加密后的字符串,格式为 IV:EncryptedData+Tag(均为Base64编码)
* @throws GeneralSecurityException 加密错误
*/
@Throws(GeneralSecurityException::class)
fun encrypt(sSrc: String, sKey: String?): String? {
if (sKey == null) {
return null
}
// 生成密钥
val secretKeySpec = createSecretKey(sKey)
// 生成安全随机IV
val iv = ByteArray(GCM_IV_LENGTH)
SECURE_RANDOM.nextBytes(iv)
// 初始化加密器
val cipher = Cipher.getInstance(TRANSFORMATION)
val gcmParameterSpec = GCMParameterSpec(
GCM_TAG_LENGTH * 8, iv
)
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
val encrypted = cipher.doFinal(
sSrc.toByteArray(StandardCharsets.UTF_8)
)
return Base64Utils.encode(
"${Base64Utils.encode(iv)}:${Base64Utils.encode(encrypted)}".toByteArray()
)
}
/**
* AES解密方法(使用GCM模式)
* @param sSrc 待解密的字符串,格式为 IV:EncryptedData+Tag(均为Base64编码)
* @param sKey 解密密钥
* @return 解密后的原始字符串
*/
fun decrypt(sSrc: String, sKey: String): String? {
try {
// 分割IV和加密数据
val sSrcs = String(Base64Utils.decode(sSrc))
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
if (parts.size != 2) {
return null
}
val iv = Base64Utils.decode(parts[0])
val encryptedData = Base64Utils.decode(parts[1])
if (iv.size != GCM_IV_LENGTH) {
return null
}
val secretKeySpec = createSecretKey(sKey)
val cipher = Cipher.getInstance(TRANSFORMATION)
val gcmParameterSpec = GCMParameterSpec(
GCM_TAG_LENGTH * 8, iv
)
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
val original = cipher.doFinal(encryptedData)
return String(original, StandardCharsets.UTF_8)
} catch (e: Exception) {
return null
}
}
/**
* 创建AES密钥,支持任意长度的密钥
* @param sKey 字符串密钥
* @return SecretKeySpec对象
* @throws Exception 可能抛出的异常
*/
@Throws(GeneralSecurityException::class)
private fun createSecretKey(sKey: String): SecretKeySpec {
val key = sKey.toByteArray(StandardCharsets.UTF_8)
val md = MessageDigest.getInstance("MD5")
val digest = md.digest(key)
return SecretKeySpec(digest, ALGORITHM)
}
@@ -0,0 +1,51 @@
/*
* Copyright 2025 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 ByteUtil.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
@file:JvmName("ByteUtil")
package com.mingliqiye.utils.bytes
import com.mingliqiye.utils.collection.Lists
import com.mingliqiye.utils.stream.SuperStream
const val ESC_ASC: Byte = 0x10
const val ESC_DESC: Byte = 0x1B
const val ESC_NONE: Byte = 0x00
const val ESC_START: Byte = 0x01
const val ESC_END: Byte = 0x02
const val ESC_ESC: Byte = 0x03
const val ESC_CONTROL: Byte = 0x04
const val ESC_DATA: Byte = 0x05
const val ESC_RESERVED: Byte = 0x06
/**
* 将字节数组转换为十六进制字符串列表
*
* @param bytes 输入的字节数组
* @return 包含每个字节对应十六进制字符串的列表
*/
fun getByteArrayString(bytes: ByteArray): MutableList<String> {
return SuperStream.of(Lists.toList(bytes))
.map { a -> String.format("%02x", a!!.toInt() and 0xFF) }
.collect(SuperStream.Collectors.toList())
}
@@ -0,0 +1,60 @@
/*
* Copyright 2025 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 FieldStructure.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.jna
import com.sun.jna.Structure
import java.lang.reflect.Modifier
/**
* JNA结构体基类,自动处理字段顺序
* 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段,
* 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。
*/
class FieldStructure : Structure() {
/**
* 获取结构体字段顺序列表
* 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段,
* 按照字段在类中声明的顺序返回字段名列表。
*
* @return 包含字段名的列表,按声明顺序排列
*/
override fun getFieldOrder(): MutableList<String> {
val fieldOrderList: MutableList<String> = ArrayList()
var cls: Class<*> = javaClass
while (cls != FieldStructure::class.java) {
val fields = cls.getDeclaredFields()
var modifiers: Int
for (field in fields) {
modifiers = field.modifiers
if (Modifier.isStatic(modifiers) ||
!Modifier.isPublic(modifiers)
) {
continue
}
fieldOrderList.add(field.name)
}
cls = cls.getSuperclass()
}
return fieldOrderList
}
}
@@ -0,0 +1,421 @@
/*
* Copyright 2025 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 Loggers.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
@file:JvmName("Loggers")
package com.mingliqiye.utils.logger
import org.slf4j.Logger
import org.slf4j.LoggerFactory
import org.slf4j.Marker
import java.util.*
enum class MingLiLoggerLevel {
TRACE,
DEBUG,
INFO,
WARN,
ERROR
}
class MingLiLogger : Logger {
override fun getName(): String {
return "MingLiLogger"
}
override fun isTraceEnabled(): Boolean {
return true
}
override fun trace(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.TRACE) }
}
override fun trace(format: String?, arg: Any?) {
format?.let {
val message = format1(it, arg)
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun trace(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format2(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun trace(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun trace(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.TRACE)
}
}
override fun isTraceEnabled(marker: Marker?): Boolean {
return true
}
override fun trace(marker: Marker?, msg: String?) {
trace(msg)
}
override fun trace(marker: Marker?, format: String?, arg: Any?) {
trace(format, arg)
}
override fun trace(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
trace(format, arg1, arg2)
}
override fun trace(marker: Marker?, format: String?, vararg arguments: Any?) {
trace(format, *arguments)
}
override fun trace(marker: Marker?, msg: String?, t: Throwable?) {
trace(msg, t)
}
override fun isDebugEnabled(): Boolean {
return true
}
override fun debug(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.DEBUG) }
}
override fun debug(format: String?, arg: Any?) {
format?.let {
val message = format1(it, arg)
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun debug(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format2(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun debug(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun debug(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.DEBUG)
}
}
override fun isDebugEnabled(marker: Marker?): Boolean {
return true
}
override fun debug(marker: Marker?, msg: String?) {
debug(msg)
}
override fun debug(marker: Marker?, format: String?, arg: Any?) {
debug(format, arg)
}
override fun debug(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
debug(format, arg1, arg2)
}
override fun debug(marker: Marker?, format: String?, vararg arguments: Any?) {
debug(format, *arguments)
}
override fun debug(marker: Marker?, msg: String?, t: Throwable?) {
debug(msg, t)
}
override fun isInfoEnabled(): Boolean {
return true
}
override fun info(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.INFO) }
}
override fun info(format: String?, arg: Any?) {
format?.let {
val message = format1(it, arg)
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun info(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format2(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun info(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun info(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.INFO)
}
}
override fun isInfoEnabled(marker: Marker?): Boolean {
return true
}
override fun info(marker: Marker?, msg: String?) {
info(msg)
}
override fun info(marker: Marker?, format: String?, arg: Any?) {
info(format, arg)
}
override fun info(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
info(format, arg1, arg2)
}
override fun info(marker: Marker?, format: String?, vararg arguments: Any?) {
info(format, *arguments)
}
override fun info(marker: Marker?, msg: String?, t: Throwable?) {
info(msg, t)
}
override fun isWarnEnabled(): Boolean {
return true
}
override fun warn(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.WARN) }
}
override fun warn(format: String?, arg: Any?) {
format?.let {
val message = format1(it, arg)
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun warn(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun warn(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format2(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun warn(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.WARN)
}
}
override fun isWarnEnabled(marker: Marker?): Boolean {
return true
}
override fun warn(marker: Marker?, msg: String?) {
warn(msg)
}
override fun warn(marker: Marker?, format: String?, arg: Any?) {
warn(format, arg)
}
override fun warn(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
warn(format, arg1, arg2)
}
override fun warn(marker: Marker?, format: String?, vararg arguments: Any?) {
warn(format, *arguments)
}
override fun warn(marker: Marker?, msg: String?, t: Throwable?) {
warn(msg, t)
}
override fun isErrorEnabled(): Boolean {
return true
}
override fun error(msg: String?) {
msg?.let { toPrintln(it, MingLiLoggerLevel.ERROR) }
}
override fun error(format: String?, arg: Any?) {
format?.let {
val message = format1(it, arg)
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
override fun error(format: String?, arg1: Any?, arg2: Any?) {
format?.let {
val message = format2(it, arg1, arg2)
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
override fun error(format: String?, vararg arguments: Any?) {
format?.let {
val message = formatArray(it, arguments)
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
override fun error(msg: String?, t: Throwable?) {
msg?.let {
val message = if (t != null) "$it: ${t.message}" else it
toPrintln(message, MingLiLoggerLevel.ERROR)
}
}
override fun isErrorEnabled(marker: Marker?): Boolean {
return true
}
override fun error(marker: Marker?, msg: String?) {
error(msg)
}
override fun error(marker: Marker?, format: String?, arg: Any?) {
error(format, arg)
}
override fun error(marker: Marker?, format: String?, arg1: Any?, arg2: Any?) {
error(format, arg1, arg2)
}
override fun error(marker: Marker?, format: String?, vararg arguments: Any?) {
error(format, *arguments)
}
override fun error(marker: Marker?, msg: String?, t: Throwable?) {
error(msg, t)
}
fun toPrintln(message: String, level: MingLiLoggerLevel) {
when (level) {
MingLiLoggerLevel.TRACE -> println("[TRACE] $message")
MingLiLoggerLevel.DEBUG -> println("[DEBUG] $message")
MingLiLoggerLevel.INFO -> println("[INFO] $message")
MingLiLoggerLevel.WARN -> println("[WARN] $message")
MingLiLoggerLevel.ERROR -> println("[ERROR] $message")
}
}
private fun format1(format: String, arg: Any?): String {
return if (format.contains("{}")) {
format.replaceFirst("{}", arg?.toString() ?: "null")
} else {
"$format $arg"
}
}
private fun format2(format: String, arg1: Any?, arg2: Any?): String {
return format.replaceFirst("{}", arg1?.toString() ?: "null")
.replaceFirst("{}", arg2?.toString() ?: "null")
}
private fun formatArray(format: String, arguments: Array<out Any?>): String {
var result = format
for (arg in arguments) {
result = result.replaceFirst("{}", arg?.toString() ?: "null")
}
return result
}
}
class MingLiLoggerFactory {
private var hasSLF4JImplementation: Boolean? = null
// 线程安全的延迟初始化
private fun checkSLF4JImplementation(): Boolean {
if (hasSLF4JImplementation == null) {
synchronized(this) {
if (hasSLF4JImplementation == null) {
hasSLF4JImplementation = try {
// 更可靠的检测方式
ServiceLoader.load(
Class.forName("org.slf4j.spi.SLF4JServiceProvider")
).iterator().hasNext()
} catch (e: ClassNotFoundException) {
false
} catch (e: NoClassDefFoundError) {
false
}
}
}
}
return hasSLF4JImplementation ?: false
}
fun getLogger(name: String): Logger {
return if (checkSLF4JImplementation()) {
LoggerFactory.getLogger(name)
} else {
MingLiLogger()
}
}
fun getLogger(clazz: Class<*>): Logger {
return if (checkSLF4JImplementation()) {
LoggerFactory.getLogger(clazz)
} else {
MingLiLogger()
}
}
}
val mingLiLoggerFactory = MingLiLoggerFactory()
@@ -0,0 +1,102 @@
/*
* Copyright 2025 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 DateTimeTypeHandler.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
@file:JvmName("DateTimeConvertor")
package com.mingliqiye.utils.mybatis.typehandler.datetime
import com.mingliqiye.utils.time.DateTime
import org.apache.ibatis.type.BaseTypeHandler
import org.apache.ibatis.type.JdbcType
import org.apache.ibatis.type.MappedTypes
import java.sql.CallableStatement
import java.sql.PreparedStatement
import java.sql.ResultSet
import java.sql.SQLException
import java.time.LocalDateTime
/**
* 将LocalDateTime对象转换为DateTime对象
*
* @param localDateTime LocalDateTime对象
* @return DateTime对象,如果localDateTime为null则返回null
*/
fun toDateTime(localDateTime: LocalDateTime?): DateTime? {
return localDateTime?.let { DateTime.of(it) }
}
/**
* 将DateTime对象转换为LocalDateTime对象
*
* @param dateTime DateTime对象
* @return LocalDateTime对象,如果dateTime为null则返回null
*/
fun toLocalDateTime(dateTime: DateTime?): LocalDateTime? {
return dateTime?.toLocalDateTime()
}
/**
* DateTime类型处理器,用于在数据库和Java对象之间转换DateTime类型
* @author MingLiQiye
* @date 2025/9/12
*/
@MappedTypes(DateTime::class)
class DateTimeTypeHandler : BaseTypeHandler<DateTime>() {
@Throws(SQLException::class)
override fun setNonNullParameter(
ps: PreparedStatement,
i: Int,
parameter: DateTime, // 移除了 ?,因为这是 non-null 方法
jdbcType: JdbcType
) {
// 使用 setObject 允许传入 null,由数据库处理
ps.setObject(i, toLocalDateTime(parameter))
}
@Throws(SQLException::class)
override fun getNullableResult(rs: ResultSet, columnName: String): DateTime? {
// 安全类型转换和空检查
return when (val value = rs.getObject(columnName)) {
is LocalDateTime -> toDateTime(value)
null -> null
else -> throw SQLException("Expected LocalDateTime for column '$columnName', but got ${value.javaClass.name}")
}
}
@Throws(SQLException::class)
override fun getNullableResult(rs: ResultSet, columnIndex: Int): DateTime? {
return when (val value = rs.getObject(columnIndex)) {
is LocalDateTime -> toDateTime(value)
null -> null
else -> throw SQLException("Expected LocalDateTime at column index $columnIndex, but got ${value.javaClass.name}")
}
}
@Throws(SQLException::class)
override fun getNullableResult(cs: CallableStatement, columnIndex: Int): DateTime? {
return when (val value = cs.getObject(columnIndex)) {
is LocalDateTime -> toDateTime(value)
null -> null
else -> throw SQLException("Expected LocalDateTime at column index $columnIndex, but got ${value.javaClass.name}")
}
}
}
@@ -0,0 +1,279 @@
/*
* Copyright 2025 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 UUIDTypeHandler.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
@file:JvmName("UUIDConvertor")
package com.mingliqiye.utils.mybatis.typehandler.uuid
import com.mingliqiye.utils.uuid.UUID
import org.apache.ibatis.type.BaseTypeHandler
import org.apache.ibatis.type.JdbcType
import org.apache.ibatis.type.MappedJdbcTypes
import org.apache.ibatis.type.MappedTypes
import java.sql.CallableStatement
import java.sql.PreparedStatement
import java.sql.ResultSet
import java.util.UUID as JUUID
/**
* 将字节数组转换为UUID对象
*
* @param byteArray 字节数组
* @return UUID对象,如果字节数组为null则返回null
*/
fun byteArraytoUUID(byteArray: ByteArray?): UUID? {
return byteArray?.let { UUID.of(it) }
}
/**
* 将UUID对象转换为字节数组
*
* @param uuid UUID对象
* @return 字节数组,如果UUID为null则返回null
*/
fun uuidToByteArray(uuid: UUID?): ByteArray? {
return uuid?.toBytes()
}
/**
* 将字符串转换为UUID对象
*
* @param str 字符串
* @return UUID对象,如果字符串为null则返回null
*/
fun stringToUUID(str: String?): UUID? {
return str?.let { UUID.of(it) }
}
/**
* 将UUID对象转换为字符串
*
* @param uuid UUID对象
* @return 字符串,如果UUID为null则返回null
*/
fun uuidToString(uuid: UUID?): String? {
return uuid?.getString()
}
/**
* 将java UUID转换为UUID对象
*
* @param uuid JUUID java UUID
* @return UUID对象,如果字符串为null则返回null
*/
fun juuidToUUID(uuid: JUUID?): UUID? {
return uuid?.let { UUID(it) }
}
/**
* 将UUID对象转换为java UUID
*
* @param uuid UUID对象
* @return java UUID,如果UUID为null则返回null
*/
fun uuidToJuuid(uuid: UUID?): JUUID? {
return uuid?.getUuid()
}
/**
* JDBC类型转换 UUID BINARY
* @author MingLiQiye
* @date 2025/9/12
*/
@MappedTypes(UUID::class)
@MappedJdbcTypes(JdbcType.BINARY)
class UUIDBinaryTypeHandler : BaseTypeHandler<UUID>() {
/**
* 设置非空参数到PreparedStatement中
*
* @param ps PreparedStatement对象
* @param i 参数索引
* @param parameter UUID参数值
* @param jdbcType JDBC类型
*/
override fun setNonNullParameter(
ps: PreparedStatement, i: Int, parameter: UUID, jdbcType: JdbcType
) {
ps.setBytes(i, uuidToByteArray(parameter))
}
/**
* 从ResultSet中根据列名获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnName 列名
* @return UUID对象或null
*/
override fun getNullableResult(
rs: ResultSet, columnName: String
): UUID? {
return byteArraytoUUID(rs.getBytes(columnName))
}
/**
* 从ResultSet中根据列索引获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(rs: ResultSet, columnIndex: Int): UUID? {
return byteArraytoUUID(rs.getBytes(columnIndex))
}
/**
* 从CallableStatement中根据列索引获取可空的UUID结果
*
* @param cs CallableStatement对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(
cs: CallableStatement, columnIndex: Int
): UUID? {
return byteArraytoUUID(cs.getBytes(columnIndex))
}
}
/**
* JDBC类型转换 UUID String
* @author MingLiQiye
* @date 2025/9/12
*/
@MappedTypes(UUID::class)
@MappedJdbcTypes(JdbcType.VARCHAR)
class UUIDStringTypeHandler : BaseTypeHandler<UUID>() {
/**
* 设置非空参数到PreparedStatement中
*
* @param ps PreparedStatement对象
* @param i 参数索引
* @param parameter UUID参数值
* @param jdbcType JDBC类型
*/
override fun setNonNullParameter(
ps: PreparedStatement, i: Int, parameter: UUID, jdbcType: JdbcType
) {
ps.setString(i, uuidToString(parameter))
}
/**
* 从ResultSet中根据列名获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnName 列名
* @return UUID对象或null
*/
override fun getNullableResult(
rs: ResultSet, columnName: String
): UUID? {
return stringToUUID(rs.getString(columnName))
}
/**
* 从ResultSet中根据列索引获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(rs: ResultSet, columnIndex: Int): UUID? {
return stringToUUID(rs.getString(columnIndex))
}
/**
* 从CallableStatement中根据列索引获取可空的UUID结果
*
* @param cs CallableStatement对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(
cs: CallableStatement, columnIndex: Int
): UUID? {
return stringToUUID(cs.getString(columnIndex))
}
}
/**
* JDBC类型转换 UUID java UUID
* @author MingLiQiye
* @date 2025/9/12
*/
@MappedTypes(UUID::class)
@MappedJdbcTypes(JdbcType.OTHER)
class UUIDTypeHandler : BaseTypeHandler<UUID>() {
/**
* 设置非空参数到PreparedStatement中
*
* @param ps PreparedStatement对象
* @param i 参数索引
* @param parameter UUID参数值
* @param jdbcType JDBC类型
*/
override fun setNonNullParameter(
ps: PreparedStatement, i: Int, parameter: UUID, jdbcType: JdbcType
) {
ps.setObject(i, parameter.getUuid())
}
/**
* 从ResultSet中根据列名获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnName 列名
* @return UUID对象或null
*/
override fun getNullableResult(
rs: ResultSet,
columnName: String
): UUID? {
return juuidToUUID(rs.getObject(columnName, JUUID::class.java) as JUUID)
}
/**
* 从ResultSet中根据列索引获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(rs: ResultSet, columnIndex: Int): UUID? {
return juuidToUUID(rs.getObject(columnIndex, JUUID::class.java) as JUUID)
}
/**
* 从CallableStatement中根据列索引获取可空的UUID结果
*
* @param cs CallableStatement对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(
cs: CallableStatement, columnIndex: Int
): UUID? {
return juuidToUUID(cs.getObject(columnIndex, JUUID::class.java) as JUUID)
}
}
@@ -0,0 +1,119 @@
/*
* Copyright 2025 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 MysqlUUIDBinaryTypeHandler.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.mybatis.typehandler.uuid.mysql
import com.mingliqiye.utils.uuid.UUID
import com.mingliqiye.utils.uuid.mysqlToUuid
import com.mingliqiye.utils.uuid.uuidToMysql
import org.apache.ibatis.type.BaseTypeHandler
import org.apache.ibatis.type.JdbcType
import org.apache.ibatis.type.MappedTypes
import java.sql.CallableStatement
import java.sql.PreparedStatement
import java.sql.ResultSet
/**
* JDBC类型转换 UUID
* @author MingLiQiye
* @date 2025/9/12
*/
@MappedTypes(UUID::class)
class MysqlUUIDBinaryTypeHandler : BaseTypeHandler<UUID>() {
/**
* 将字节数组转换为UUID对象
*
* @param byteArray 字节数组
* @return UUID对象,如果字节数组为null则返回null
*/
private fun toUUID(byteArray: ByteArray?): UUID? {
return byteArray?.let { UUID.of(mysqlToUuid(it)) }
}
/**
* 将UUID对象转换为字节数组
*
* @param uuid UUID对象
* @return 字节数组,如果UUID为null则返回null
*/
fun toByteArray(uuid: UUID?): ByteArray? {
return uuid?.let { uuidToMysql(it.toBytes()) }
}
/**
* 设置非空参数到PreparedStatement中
*
* @param ps PreparedStatement对象
* @param i 参数索引
* @param parameter UUID参数值
* @param jdbcType JDBC类型
*/
override fun setNonNullParameter(
ps: PreparedStatement,
i: Int,
parameter: UUID,
jdbcType: JdbcType
) {
ps.setBytes(i, toByteArray(parameter))
}
/**
* 从ResultSet中根据列名获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnName 列名
* @return UUID对象或null
*/
override fun getNullableResult(
rs: ResultSet,
columnName: String
): UUID? {
return toUUID(rs.getBytes(columnName))
}
/**
* 从ResultSet中根据列索引获取可空的UUID结果
*
* @param rs ResultSet对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(rs: ResultSet, columnIndex: Int): UUID? {
return toUUID(rs.getBytes(columnIndex))
}
/**
* 从CallableStatement中根据列索引获取可空的UUID结果
*
* @param cs CallableStatement对象
* @param columnIndex 列索引
* @return UUID对象或null
*/
override fun getNullableResult(
cs: CallableStatement,
columnIndex: Int
): UUID? {
return toUUID(cs.getBytes(columnIndex))
}
}
@@ -0,0 +1,53 @@
/*
* Copyright 2025 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 MysqlUUIDv1.kt
* LastUpdate 2025-09-14 18:19:29
* UpdateUser MingLiPro
*/
@file:JvmName("MysqlUUIDv1")
package com.mingliqiye.utils.uuid
fun uuidToMysql(uuid: ByteArray): ByteArray {
val reuuid = ByteArray(16)
reuuid[4] = uuid[0]
reuuid[5] = uuid[1]
reuuid[6] = uuid[2]
reuuid[7] = uuid[3]
reuuid[2] = uuid[4]
reuuid[3] = uuid[5]
reuuid[0] = uuid[6]
reuuid[1] = uuid[7]
System.arraycopy(uuid, 8, reuuid, 8, 8)
return reuuid
}
fun mysqlToUuid(uuid: ByteArray): ByteArray {
val reuuid = ByteArray(16)
reuuid[6] = uuid[0]
reuuid[7] = uuid[1]
reuuid[4] = uuid[2]
reuuid[5] = uuid[3]
reuuid[0] = uuid[4]
reuuid[1] = uuid[5]
reuuid[2] = uuid[6]
reuuid[3] = uuid[7]
System.arraycopy(uuid, 8, reuuid, 8, 8)
return reuuid
}