从java移动代码到kotlin

This commit is contained in:
2025-09-12 17:12:32 +08:00
parent d12fbe0cce
commit 56080634c7
16 changed files with 693 additions and 629 deletions
@@ -0,0 +1,32 @@
/*
* 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 Main.kt
* LastUpdate 2025-09-12 17:11:48
* UpdateUser MingLiPro
*/
@file:JvmName("Main")
package com.mingliqiye.utils
import com.mingliqiye.utils.springboot.autoconfigure.AutoConfiguration
fun main() {
AutoConfiguration.printBanner()
}
@@ -0,0 +1,83 @@
/*
* 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 RandomBytes.kt
* LastUpdate 2025-09-12 17:11:19
* UpdateUser MingLiPro
*/
@file:JvmName("RandomBytes")
package com.mingliqiye.utils.random
import com.mingliqiye.utils.collection.ForEach
import com.mingliqiye.utils.iterator.Range
/**
* 生成指定长度的随机字节数组
* @param length 数组长度
* @return 包含随机字节的数组
*/
fun randomBytes(length: Int): ByteArray {
val bytes = ByteArray(length)
ForEach.forEach(
Range(0, length - 1)
) { i: Int -> bytes[i] = randomByte(0x00.toByte(), 0xff.toByte()) }
return bytes
}
/**
* 生成指定长度的随机字节数组
* 从给定的字节数组中随机选择字节来填充新数组
*
* @param length 要生成的随机字节数组的长度
* @param bytes 用于随机选择的源字节数组
* @return 包含随机字节的新数组
*/
fun randomBytes(length: Int, bytes: ByteArray): ByteArray {
val rbytes = ByteArray(length)
// 从源数组中随机选择字节填充到结果数组中
for (i in 0..<length) {
rbytes[i] = bytes[randomInt(i, bytes.size - 1)]
}
return rbytes
}
/**
* 生成指定范围内的随机字节
* @param from 起始字节值(包含)
* @param to 结束字节值(包含)
* @return 指定范围内的随机字节
*/
fun randomByte(from: Byte, to: Byte): Byte {
val fromInt = from.toInt() and 0xFF
val toInt = to.toInt() and 0xFF
val randomValue = randomInt(fromInt, toInt)
return (randomValue and 0xFF).toByte()
}
/**
* 生成指定范围内的随机字节(不包含边界值)
* @param from 起始字节值(不包含)
* @param to 结束字节值(不包含)
* @return 指定范围内的随机字节
*/
fun randomByteNoHave(from: Byte, to: Byte): Byte {
val fromInt = from.toInt() and 0xFF
val toInt = to.toInt() and 0xFF
val randomValue = randomIntNoHave(fromInt, toInt)
return (randomValue and 0xFF).toByte()
}
@@ -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 RandomInt.kt
* LastUpdate 2025-09-12 17:08:32
* UpdateUser MingLiPro
*/
@file:JvmName("RandomInt")
package com.mingliqiye.utils.random
import java.util.concurrent.ThreadLocalRandom
/**
* 生成指定范围内的随机整数
* @param min 最小值(包含)
* @param max 最大值(不包含)
* @return 随机整数
*/
fun randomIntNoHave(min: Int, max: Int): Int {
var min = min
var max = max
if (min > max) {
val t = min
min = max
max = t
}
if (min == max) {
return min
}
return ThreadLocalRandom.current().nextInt(min, max)
}
/**
* 生成指定范围内的随机整数
* @param min 最小值(包含)
* @param max 最大值(包含)
* @return 随机整数
*/
fun randomInt(min: Int, max: Int): Int {
var max = max
return randomIntNoHave(min, ++max)
}
@@ -0,0 +1,54 @@
/*
* 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 RandomString.kt
* LastUpdate 2025-09-12 17:10:43
* UpdateUser MingLiPro
*/
@file:JvmName("RandomString")
package com.mingliqiye.utils.random
/**
* 生成指定长度和字符集的随机字符串
*
* @param length 要生成的随机字符串长度
* @param chars 用于生成随机字符串的字符集
* @return 指定长度的随机字符串
*/
fun randomString(length: Int, chars: String): String {
val charsd: Array<String?> = chars.split("".toRegex()).dropLastWhile { it.isEmpty() }.toTypedArray()
val sb = StringBuilder(length)
// 循环生成随机字符并拼接
for (i in 0..<length) {
val index = randomInt(0, charsd.size - 1)
sb.append(charsd[index])
}
return sb.toString()
}
/**
* 生成指定长度的随机字符串,使用默认字符集(数字+大小写字母)
*
* @param length 要生成的随机字符串长度
* @return 指定长度的随机字符串
*/
fun randomString(length: Int): String {
return randomString(
length, "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"
)
}
@@ -0,0 +1,244 @@
/*
* 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 UUID.kt
* LastUpdate 2025-09-12 16:57:52
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.uuid
import com.github.f4b6a3.uuid.UuidCreator
import com.mingliqiye.utils.time.DateTime
import com.mingliqiye.utils.time.DateTimeOffset
import java.io.Serializable
import java.nio.ByteBuffer
import java.time.temporal.ChronoUnit
import java.util.*
import java.util.UUID as JUUID
class UUID : Serializable {
private val uuid: JUUID
companion object {
/**
* 获取 UUIDV1 版本的随机实例
* @return UUID
*/
@JvmStatic
fun getV1(): UUID {
return UUID(UuidCreator.getTimeBased())
}
/**
* 获取 UUIDV4 版本的随机实例
* @return UUID
*/
@JvmStatic
fun getV4(): UUID {
return UUID(UuidCreator.getRandomBased())
}
/**
* 获取 UUIDV1Fast 版本的随机实例
* @return UUID
*/
@JvmStatic
fun getV4Fast(): UUID {
return UUID(UuidCreator.getRandomBasedFast())
}
/**
* 从2个8个字节转换到UUID
* @param lsb 高位 8 字节的 Long
* @param msb 低位 8 字节的 Long
* @return UUID
*/
@JvmStatic
fun of(msb: Long, lsb: Long): UUID {
return UUID(msb, lsb)
}
/**
* 从字符串格式化
* @param uuid 字符串
* @return UUID
*/
@JvmStatic
fun of(uuid: String): UUID {
return UUID(uuid)
}
/**
* 从字节码转换到UUID
* @param array 16字节
* @return UUID
*/
@JvmStatic
fun of(array: ByteArray): UUID {
return UUID(array)
}
}
internal constructor(msb: Long, lsb: Long) {
uuid = JUUID(msb, lsb)
}
internal constructor(uuid: JUUID) {
this.uuid = uuid
}
internal constructor(array: ByteArray) {
val bb = ByteBuffer.wrap(array)
this.uuid = JUUID(bb.getLong(), bb.getLong())
}
internal constructor(uuid: String) {
this.uuid = JUUID.fromString(uuid)
}
/**
* 获取对应的字节码
* @return 字节码
*/
fun toBytes(): ByteArray {
val bb = ByteBuffer.wrap(ByteArray(16))
bb.putLong(uuid.mostSignificantBits)
bb.putLong(uuid.leastSignificantBits)
return bb.array()
}
/**
* 获取Java的UUID对象
* @return Java的UUID对象
*/
fun getUuid(): JUUID {
return uuid
}
/**
* 将 UUID 转换为字符串表示,默认使用小写格式。
* @param u 是否大写
* @return UUID 字符串
*/
fun getString(u: Boolean): String {
return if (u) {
uuid.toString().uppercase(Locale.ROOT)
} else {
uuid.toString()
}
}
/**
* 将 UUID 转换为字符串表示,默认使用小写格式。
*
* @return UUID 字符串
*/
fun getString(): String {
return getString(false)
}
@Deprecated("使用 getString()", ReplaceWith("getString"), level = DeprecationLevel.WARNING)
fun toUUIDString(): String {
return this.getString()
}
@Deprecated("使用 getString(u:Boolean)", ReplaceWith("getString(u)"), level = DeprecationLevel.WARNING)
fun toUUIDString(u: Boolean): String {
return this.getString(u)
}
/**
* 从时间戳型 UUID 中提取时间戳并转换为 DateTime 对象。
*
* @return 对应的 DateTime 对象;如果 不是 时间戳V1版本 返回 null
*/
fun getDateTime(): DateTime? {
if (uuid.version() != 1) {
return null
}
return DateTime.of(uuid.timestamp() / 10000).add(
DateTimeOffset.of(-141427L, ChronoUnit.DAYS)
)
}
/**
* 从时间戳型 UUID 中提取 MAC 地址,默认使用冒号分隔符。
*
* @return MAC 地址字符串
*/
fun extractMACFromUUID(): String {
return extractMACFromUUID(null)
}
/**
* 从时间戳型 UUID 中提取 MAC 地址,并允许自定义分隔符。
*
* @param spec 分隔符字符,默认为 ":"
* @return MAC 地址字符串
*/
fun extractMACFromUUID(spec: String?): String {
var spec = spec
if (spec == null) {
spec = ":"
}
val leastSigBits = uuid.leastSignificantBits
val macLong = leastSigBits and 0xFFFFFFFFFFFFL
val macBytes = ByteArray(6)
for (i in 0..5) {
macBytes[5 - i] = (macLong shr (8 * i)).toByte()
}
val mac = StringBuilder()
for (i in 0..5) {
mac.append(String.format("%02X", macBytes[i]))
if (i < 5) {
mac.append(spec)
}
}
return mac.toString()
}
/**
* 返回此 UUID 的字符串表示,包含版本信息和时间戳(如果是版本1)。
*
* @return UUID 的详细字符串表示
*/
override fun toString(): String {
return "UUID(uuid=${getString()},version=${uuid.version()})"
}
/**
* 判断两个 UUID 是否相等。
*
* @param other 比较对象
* @return 如果相等返回 true,否则返回 false
*/
override fun equals(other: Any?): Boolean {
return uuid == other
}
/**
* 计算此 UUID 的哈希码。
*
* @return 哈希码值
*/
override fun hashCode(): Int {
return uuid.hashCode()
}
}
@@ -0,0 +1,99 @@
/*
* 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 VersionUtils.kt
* LastUpdate 2025-09-12 15:09:57
* UpdateUser MingLiPro
*/
@file:JvmName("VersionUtils")
package com.mingliqiye.utils.version
import kotlin.math.max
/**
* 判断是否需要更新
* @param now 当前版本
* @param other 比较版本
* @return 当前版本需要更新
* @since 3.2.7
*/
fun isNew(now: String, other: String): Boolean {
val otherA = now.split(".")
val otherB = other.split(".")
val maxLen = max(otherA.size, otherB.size)
for (i in 0..<maxLen) {
val a = if (otherA.size > i) otherA[i].toInt() else null
val b = if (otherB.size > i) otherB[i].toInt() else null
if (a == null) {
return true
}
if (b == null) {
return false
}
if (a != b) {
return a < b
}
}
return false
}
/**
* 判断版本是否小于当前
* @param now 当前版本
* @param other 比较版本
* @return 是否小于
*
*/
fun isOld(now: String, other: String): Boolean {
return (now != other) && !isNew(now, other)
}
/**
* 判断是否版本相同
* @param now 当前版本
* @param other 比较版本
* @return 是否相同
*/
fun equals(now: String, other: String): Boolean {
return now == other
}
/**
* 判断是否需要更新
* @param now 当前版本
* @param other 比较版本
* @return null->版本相同 true->需要更新 false->不需要更新
*/
@JvmName("is")
fun isOther(now: String, other: String): Boolean? {
return if (isNew(now, other)) {
true
} else if (isOld(now, other)) {
false
} else {
null
}
}