从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,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()
}
}