Compare commits

..
7 Commits
Author SHA1 Message Date
minglipro 510ff69e2c v5.4.3
Gitea Actions Build / Build (push) Canceled after 0s
2026-11-10 16:53:35 +08:00
minglipro 184db461d7 修复 JSONA.jsonApi 编译错误
Gitea Actions Build / Build (push) Canceled after 0s
2026-11-07 13:59:42 +08:00
minglipro 535c03d14a feat(mybatisplus): 新增 FastBaseIServiceNew3518 并发布 mingli-utils 5.4.2
Gitea Actions Build / Build (push) Canceled after 0s
2026-11-07 13:55:20 +08:00
minglipro 5714aef444 style: 全项目统一 Tab 缩进并补全尾随逗号 2026-11-07 13:54:46 +08:00
minglipro 7a3bc01b11 a 2026-11-07 13:54:05 +08:00
minglipro 792ddf0255 feat(mybatisplus): 新增 FastBaseIService 并发布 mingli-utils 5.4.0
Gitea Actions Build / Build (push) Canceled after 0s
- 新增 FastBaseIService 服务层便捷基类,与 FastBaseMapper 对齐常用增删改查,移除旧的 BaseMapperQuery
- Jackson 自动配置改用 Jackson2ObjectMapperBuilderCustomizer Bean 注册模块,避免直接依赖 ObjectMapper
- SpringBeanUtils 新增 lazyBean 延迟获取 Bean 便捷函数
- SystemUtil 新增 lineSeparator 相关常量并整理链式调用格式
- FileUtils.writeLines(charset) 修复自递归问题
- build.gradle.kts 增加 mybatis-plus-spring 编译依赖
2026-10-28 23:36:35 +08:00
minglipro f4025cbad9 chore(release): 发布 mingli-utils 5.3.7
Gitea Actions Build / Build (push) Canceled after 0s
配合 FastBaseMapper 便捷函数补全与列条件 bug 修复提升补丁版本号
2026-10-27 10:35:30 +08:00
205 changed files with 38813 additions and 36730 deletions
+3 -2
View File
@@ -13,10 +13,10 @@
* See the License for the specific language governing permissions and * See the License for the specific language governing permissions and
* limitations under the License. * limitations under the License.
* *
* ProjectName FastBaseMapper.kt * ProjectName mingli-utils
* ModuleName mingli-utils * ModuleName mingli-utils
* CurrentFile build.gradle.kts * CurrentFile build.gradle.kts
* LastUpdate 2026-10-26 23:22:18 * LastUpdate 2026-10-28 21:50:32
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -85,6 +85,7 @@ dependencies {
compileOnly("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8") compileOnly("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8")
compileOnly("com.baomidou:mybatis-plus-extension:3.5.15") compileOnly("com.baomidou:mybatis-plus-extension:3.5.15")
compileOnly("com.baomidou:mybatis-plus-jsqlparser:3.5.15") compileOnly("com.baomidou:mybatis-plus-jsqlparser:3.5.15")
compileOnly("com.baomidou:mybatis-plus-spring:3.5.9")
testImplementation("org.junit.jupiter:junit-jupiter:5.7.1") testImplementation("org.junit.jupiter:junit-jupiter:5.7.1")
testRuntimeOnly("org.junit.platform:junit-platform-launcher") testRuntimeOnly("org.junit.platform:junit-platform-launcher")
testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.9") testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.9")
+3 -3
View File
@@ -13,13 +13,13 @@
# See the License for the specific language governing permissions and # See the License for the specific language governing permissions and
# limitations under the License. # limitations under the License.
# #
# ProjectName FastBaseMapper.kt # ProjectName mingli-utils
# ModuleName mingli-utils # ModuleName mingli-utils
# CurrentFile gradle.properties # CurrentFile gradle.properties
# LastUpdate 2026-10-26 23:22:18 # LastUpdate 2026-11-09 19:49:52
# UpdateUser MingLiPro # UpdateUser MingLiPro
# #
JDKVERSIONS=17 JDKVERSIONS=17
GROUPSID=com.mingliqiye.utils GROUPSID=com.mingliqiye.utils
ARTIFACTID=mingli-utils ARTIFACTID=mingli-utils
VERSIONS=5.3.6 VERSIONS=5.4.3
Binary file not shown.
@@ -50,30 +50,30 @@ val SECURE_RANDOM = SecureRandom()
*/ */
@Throws(GeneralSecurityException::class) @Throws(GeneralSecurityException::class)
fun encrypt(sSrc: String, sKey: String?): String? { fun encrypt(sSrc: String, sKey: String?): String? {
if (sKey == null) { if (sKey == null) {
return null return null
} }
// 生成密钥 // 生成密钥
val secretKeySpec = createSecretKey(sKey) val secretKeySpec = createSecretKey(sKey)
// 生成安全随机IV // 生成安全随机IV
val iv = ByteArray(GCM_IV_LENGTH) val iv = ByteArray(GCM_IV_LENGTH)
SECURE_RANDOM.nextBytes(iv) SECURE_RANDOM.nextBytes(iv)
// 初始化加密器 // 初始化加密器
val cipher = Cipher.getInstance(TRANSFORMATION) val cipher = Cipher.getInstance(TRANSFORMATION)
val gcmParameterSpec = GCMParameterSpec( val gcmParameterSpec = GCMParameterSpec(
GCM_TAG_LENGTH * 8, iv GCM_TAG_LENGTH * 8, iv
) )
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec) cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
val encrypted = cipher.doFinal( val encrypted = cipher.doFinal(
sSrc.toByteArray(StandardCharsets.UTF_8) sSrc.toByteArray(StandardCharsets.UTF_8)
) )
return BaseType.BASE64.encode( return BaseType.BASE64.encode(
"${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray() "${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray()
) )
} }
/** /**
@@ -83,29 +83,29 @@ fun encrypt(sSrc: String, sKey: String?): String? {
* @return 解密后的原始字符串 * @return 解密后的原始字符串
*/ */
fun decrypt(sSrc: String, sKey: String): String? { fun decrypt(sSrc: String, sKey: String): String? {
try { try {
// 分割IV和加密数据 // 分割IV和加密数据
val sSrcs = String(BaseType.BASE64.decode(sSrc)) val sSrcs = String(BaseType.BASE64.decode(sSrc))
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray() val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
if (parts.size != 2) { if (parts.size != 2) {
return null return null
} }
val iv = BaseType.BASE64.decode(parts[0]!!) val iv = BaseType.BASE64.decode(parts[0]!!)
val encryptedData = BaseType.BASE64.decode(parts[1]!!) val encryptedData = BaseType.BASE64.decode(parts[1]!!)
if (iv.size != GCM_IV_LENGTH) { if (iv.size != GCM_IV_LENGTH) {
return null return null
} }
val secretKeySpec = createSecretKey(sKey) val secretKeySpec = createSecretKey(sKey)
val cipher = Cipher.getInstance(TRANSFORMATION) val cipher = Cipher.getInstance(TRANSFORMATION)
val gcmParameterSpec = GCMParameterSpec( val gcmParameterSpec = GCMParameterSpec(
GCM_TAG_LENGTH * 8, iv GCM_TAG_LENGTH * 8, iv
) )
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec) cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
val original = cipher.doFinal(encryptedData) val original = cipher.doFinal(encryptedData)
return String(original, StandardCharsets.UTF_8) return String(original, StandardCharsets.UTF_8)
} catch (e: Exception) { } catch (e: Exception) {
return null return null
} }
} }
/** /**
@@ -116,8 +116,8 @@ fun decrypt(sSrc: String, sKey: String): String? {
*/ */
@Throws(Exception::class) @Throws(Exception::class)
private fun createSecretKey(sKey: String): SecretKeySpec { private fun createSecretKey(sKey: String): SecretKeySpec {
val key = sKey.toByteArray(StandardCharsets.UTF_8) val key = sKey.toByteArray(StandardCharsets.UTF_8)
val md = MessageDigest.getInstance("MD5") val md = MessageDigest.getInstance("MD5")
val digest = md.digest(key) val digest = md.digest(key)
return SecretKeySpec(digest, ALGORITHM) return SecretKeySpec(digest, ALGORITHM)
} }
@@ -37,5 +37,5 @@ import kotlin.reflect.KClass
@Target(AnnotationTarget.CLASS) @Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.SOURCE) @Retention(AnnotationRetention.SOURCE)
annotation class AutoService( annotation class AutoService(
val value: Array<KClass<*>> = [] val value: Array<KClass<*>> = [],
) )
@@ -33,7 +33,7 @@ import com.mingliqiye.utils.time.Formatter
*/ */
@Target(AnnotationTarget.FIELD) @Target(AnnotationTarget.FIELD)
annotation class DateTimeJsonFormat( annotation class DateTimeJsonFormat(
val value: Formatter = Formatter.NONE, val value: Formatter = Formatter.NONE,
val formatter: String = "", val formatter: String = "",
val repcZero: Boolean = true, val repcZero: Boolean = true,
) )
@@ -33,6 +33,6 @@ import com.mingliqiye.utils.uuid.UUIDFormatType
*/ */
@Target(AnnotationTarget.FIELD) @Target(AnnotationTarget.FIELD)
annotation class UUIDJsonFormat( annotation class UUIDJsonFormat(
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE, val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
val base: BaseType = BaseType.BASE16 val base: BaseType = BaseType.BASE16,
) )
@@ -35,70 +35,70 @@ import javax.tools.StandardLocation
@SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService") @SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService")
class AutoServiceProcessor : AbstractProcessor() { class AutoServiceProcessor : AbstractProcessor() {
override fun init(processingEnv: ProcessingEnvironment) { override fun init(processingEnv: ProcessingEnvironment) {
super.init(processingEnv) super.init(processingEnv)
} }
override fun process( override fun process(
annotations: Set<TypeElement>, annotations: Set<TypeElement>,
roundEnv: RoundEnvironment, roundEnv: RoundEnvironment,
): Boolean { ): Boolean {
val service = mutableMapOf<String, MutableList<String>>() val service = mutableMapOf<String, MutableList<String>>()
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java) val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
if (elements.isEmpty()) return false if (elements.isEmpty()) return false
for (element in elements) { for (element in elements) {
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java) val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
var asd = (try { var asd = (try {
autoServiceAnnotation!!.value.map { it.java.name } autoServiceAnnotation!!.value.map { it.java.name }
} catch (e: MirroredTypesException) { } catch (e: MirroredTypesException) {
e.typeMirrors.map(TypeMirror::toString) e.typeMirrors.map(TypeMirror::toString)
}) })
if (asd.isEmpty()) { if (asd.isEmpty()) {
if (element is TypeElement) { if (element is TypeElement) {
asd = element.interfaces.map { it.toString() } asd = element.interfaces.map { it.toString() }
} }
} }
for (data in asd) { for (data in asd) {
var ldata: MutableList<String>? = service[data] var ldata: MutableList<String>? = service[data]
if (ldata == null) { if (ldata == null) {
ldata = mutableListOf() ldata = mutableListOf()
service[data] = ldata service[data] = ldata
} }
ldata.add(element.toString()) ldata.add(element.toString())
} }
} }
processClassAnnotation(service) processClassAnnotation(service)
return true return true
} }
fun processClassAnnotation(map: Map<String, MutableList<String>>) { fun processClassAnnotation(map: Map<String, MutableList<String>>) {
map.forEach { (interfaceName, implementations) -> map.forEach { (interfaceName, implementations) ->
if (implementations.isEmpty()) { if (implementations.isEmpty()) {
println("警告: $interfaceName 的实现列表为空!") println("警告: $interfaceName 的实现列表为空!")
return@forEach return@forEach
} }
try { try {
val serviceFile = processingEnv.filer.createResource( val serviceFile = processingEnv.filer.createResource(
StandardLocation.CLASS_OUTPUT, StandardLocation.CLASS_OUTPUT,
"", "",
"META-INF/services/$interfaceName" "META-INF/services/$interfaceName"
) )
val content = StringBuilder() val content = StringBuilder()
serviceFile.openWriter().use { writer -> serviceFile.openWriter().use { writer ->
implementations.forEach { impl -> implementations.forEach { impl ->
val line = "$impl\n" val line = "$impl\n"
content.append(line) content.append(line)
writer.write(line) writer.write(line)
} }
writer.flush() writer.flush()
} }
} catch (e: Exception) { } catch (e: Exception) {
println("文件创建失败: ${e.javaClass.name} - ${e.message}") println("文件创建失败: ${e.javaClass.name} - ${e.message}")
e.printStackTrace() e.printStackTrace()
} }
} }
} }
} }
@@ -61,7 +61,7 @@ fun String.toHexByteArray(): ByteArray = BaseType.BASE16.decode(this.lowercase()
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also { fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -76,12 +76,12 @@ fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Ar
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> = fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also { java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
System.arraycopy(this, srcPos, it, distPos, len) System.arraycopy(this, srcPos, it, distPos, len)
}.let { }.let {
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
it as Array<T> it as Array<T>
} }
/** /**
* 将源数组的指定范围复制到当前数组 * 将源数组的指定范围复制到当前数组
@@ -96,7 +96,7 @@ fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also { fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== BooleanArray 扩展 ==================== */ /* ==================== BooleanArray 扩展 ==================== */
@@ -107,7 +107,7 @@ fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): A
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also { fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -116,9 +116,9 @@ fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int)
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray = fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
BooleanArray(len).also { newArray -> BooleanArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -126,7 +126,7 @@ fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also { fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== ByteArray 扩展 ==================== */ /* ==================== ByteArray 扩展 ==================== */
@@ -137,7 +137,7 @@ fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also { fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -146,9 +146,9 @@ fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): Byte
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray = fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
ByteArray(len).also { newArray -> ByteArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -156,7 +156,7 @@ fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also { fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== CharArray 扩展 ==================== */ /* ==================== CharArray 扩展 ==================== */
@@ -167,7 +167,7 @@ fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): Byt
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also { fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -176,9 +176,9 @@ fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): Char
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray = fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
CharArray(len).also { newArray -> CharArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -186,7 +186,7 @@ fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also { fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== DoubleArray 扩展 ==================== */ /* ==================== DoubleArray 扩展 ==================== */
@@ -197,7 +197,7 @@ fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): Cha
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also { fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -206,9 +206,9 @@ fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int):
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray = fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
DoubleArray(len).also { newArray -> DoubleArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -216,7 +216,7 @@ fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also { fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== FloatArray 扩展 ==================== */ /* ==================== FloatArray 扩展 ==================== */
@@ -227,7 +227,7 @@ fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int):
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also { fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -236,9 +236,9 @@ fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): Fl
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray = fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
FloatArray(len).also { newArray -> FloatArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -246,7 +246,7 @@ fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also { fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== IntArray 扩展 ==================== */ /* ==================== IntArray 扩展 ==================== */
@@ -257,7 +257,7 @@ fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): F
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also { fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -266,9 +266,9 @@ fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArr
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray = fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
IntArray(len).also { newArray -> IntArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -276,7 +276,7 @@ fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also { fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== LongArray 扩展 ==================== */ /* ==================== LongArray 扩展 ==================== */
@@ -287,7 +287,7 @@ fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntAr
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also { fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -296,9 +296,9 @@ fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): Long
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray = fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
LongArray(len).also { newArray -> LongArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -306,7 +306,7 @@ fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also { fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== ShortArray 扩展 ==================== */ /* ==================== ShortArray 扩展 ==================== */
@@ -317,7 +317,7 @@ fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): Lon
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also { fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -326,9 +326,9 @@ fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): Sh
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray = fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
ShortArray(len).also { newArray -> ShortArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -336,5 +336,5 @@ fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also { fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
@@ -26,43 +26,43 @@ import java.math.BigInteger
internal class Base10Codec : BaseCodec { internal class Base10Codec : BaseCodec {
/** /**
* 将字节数组编码为Base10字符串(十进制) * 将字节数组编码为Base10字符串(十进制)
* *
* @param bytes 需要编码的字节数组 * @param bytes 需要编码的字节数组
* @return 编码后的Base10字符串(十进制数字) * @return 编码后的Base10字符串(十进制数字)
*/ */
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return "0" if (bytes.isEmpty()) return "0"
// 将字节数组转换为正的大整数 // 将字节数组转换为正的大整数
val bigInt = BigInteger(1, bytes) // 参数1表示正数 val bigInt = BigInteger(1, bytes) // 参数1表示正数
return bigInt.toString(10) // 转换为10进制字符串 return bigInt.toString(10) // 转换为10进制字符串
} }
/** /**
* 将Base10字符串解码为字节数组 * 将Base10字符串解码为字节数组
* *
* @param string 需要解码的Base10字符串(十进制数字) * @param string 需要解码的Base10字符串(十进制数字)
* @return 解码后的字节数组 * @return 解码后的字节数组
*/ */
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
// 验证输入是否为有效的十进制数字 // 验证输入是否为有效的十进制数字
if (!string.matches(Regex("\\d+"))) { if (!string.matches(Regex("\\d+"))) {
throw IllegalArgumentException("Base10字符串只能包含数字0-9") throw IllegalArgumentException("Base10字符串只能包含数字0-9")
} }
val bigInt = BigInteger(string, 10) // 从10进制解析 val bigInt = BigInteger(string, 10) // 从10进制解析
// 转换为字节数组,并确保保留前导零 // 转换为字节数组,并确保保留前导零
var byteArray = bigInt.toByteArray() var byteArray = bigInt.toByteArray()
// BigInteger.toByteArray() 可能会添加一个符号字节 // BigInteger.toByteArray() 可能会添加一个符号字节
// 对于正数,如果第一个字节是0,需要移除它 // 对于正数,如果第一个字节是0,需要移除它
if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) { if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) {
byteArray = byteArray.copyOfRange(1, byteArray.size) byteArray = byteArray.copyOfRange(1, byteArray.size)
} }
return byteArray return byteArray
} }
} }
@@ -27,28 +27,28 @@ package com.mingliqiye.utils.base
* 提供字节数组与十六进制字符串之间的相互转换功能 * 提供字节数组与十六进制字符串之间的相互转换功能
*/ */
internal class Base16Codec : BaseCodec { internal class Base16Codec : BaseCodec {
/** /**
* 将字节数组编码为十六进制字符串 * 将字节数组编码为十六进制字符串
* @param bytes 待编码的字节数组 * @param bytes 待编码的字节数组
* @return 编码后的十六进制字符串,每个字节对应两位十六进制字符 * @return 编码后的十六进制字符串,每个字节对应两位十六进制字符
*/ */
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
// 将每个字节转换为两位十六进制字符串并拼接 // 将每个字节转换为两位十六进制字符串并拼接
return bytes.joinToString("") { return bytes.joinToString("") {
it.toInt().and(0xff).toString(16).padStart(2, '0') it.toInt().and(0xff).toString(16).padStart(2, '0')
} }
} }
/** /**
* 将十六进制字符串解码为字节数组 * 将十六进制字符串解码为字节数组
* @param string 待解码的十六进制字符串 * @param string 待解码的十六进制字符串
* @return 解码后的字节数组 * @return 解码后的字节数组
*/ */
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
// 按每两个字符分组,转换为字节 // 按每两个字符分组,转换为字节
return string.chunked(2).map { return string.chunked(2).map {
it.toInt(16).toByte() it.toInt(16).toByte()
}.toByteArray() }.toByteArray()
} }
} }
@@ -32,282 +32,282 @@ package com.mingliqiye.utils.base
*/ */
internal class Base256Codec : BaseCodec { internal class Base256Codec : BaseCodec {
companion object { companion object {
val code = arrayOf( val code = arrayOf(
'!', '!',
'#', '#',
'$', '$',
'%', '%',
'&', '&',
'(', '(',
')', ')',
'*', '*',
'+', '+',
',', ',',
'-', '-',
'.', '.',
'/', '/',
'0', '0',
'1', '1',
'2', '2',
'3', '3',
'4', '4',
'5', '5',
'6', '6',
'7', '7',
'8', '8',
'9', '9',
':', ':',
';', ';',
'<', '<',
'=', '=',
'>', '>',
'?', '?',
'@', '@',
'A', 'A',
'B', 'B',
'C', 'C',
'D', 'D',
'E', 'E',
'F', 'F',
'G', 'G',
'H', 'H',
'I', 'I',
'J', 'J',
'K', 'K',
'L', 'L',
'M', 'M',
'N', 'N',
'O', 'O',
'P', 'P',
'Q', 'Q',
'R', 'R',
'S', 'S',
'T', 'T',
'U', 'U',
'V', 'V',
'W', 'W',
'X', 'X',
'Y', 'Y',
'Z', 'Z',
'[', '[',
']', ']',
'^', '^',
'_', '_',
'`', '`',
'a', 'a',
'b', 'b',
'c', 'c',
'd', 'd',
'e', 'e',
'f', 'f',
'g', 'g',
'h', 'h',
'i', 'i',
'j', 'j',
'k', 'k',
'l', 'l',
'm', 'm',
'n', 'n',
'o', 'o',
'p', 'p',
'q', 'q',
'r', 'r',
's', 's',
't', 't',
'u', 'u',
'v', 'v',
'w', 'w',
'x', 'x',
'y', 'y',
'z', 'z',
'{', '{',
'|', '|',
'}', '}',
'~', '~',
'§', '§',
'±', '±',
'×', '×',
'÷', '÷',
'←', '←',
'↑', '↑',
'→', '→',
'↓', '↓',
'⇒', '⇒',
'⇔', '⇔',
'∀', '∀',
'∃', '∃',
'∅', '∅',
'∆', '∆',
'∇', '∇',
'∈', '∈',
'∉', '∉',
'∋', '∋',
'∌', '∌',
'∏', '∏',
'∑', '∑',
'−', '−',
'∓', '∓',
'∕', '∕',
'∗', '∗',
'∘', '∘',
'∙', '∙',
'√', '√',
'∛', '∛',
'∜', '∜',
'∞', '∞',
'∟', '∟',
'∠', '∠',
'∣', '∣',
'∥', '∥',
'∧', '∧',
'∨', '∨',
'∩', '∩',
'∪', '∪',
'∫', '∫',
'∬', '∬',
'∭', '∭',
'∮', '∮',
'∯', '∯',
'∰', '∰',
'∱', '∱',
'∲', '∲',
'∳', '∳',
'∴', '∴',
'∵', '∵',
'∶', '∶',
'∷', '∷',
'≈', '≈',
'≠', '≠',
'≡', '≡',
'≤', '≤',
'≥', '≥',
'≦', '≦',
'≧', '≧',
'≪', '≪',
'≫', '≫',
'≺', '≺',
'≻', '≻',
'⊂', '⊂',
'⊃', '⊃',
'⊆', '⊆',
'⊇', '⊇',
'⊈', '⊈',
'⊉', '⊉',
'⊊', '⊊',
'⊋', '⊋',
'⊕', '⊕',
'⊖', '⊖',
'⊗', '⊗',
'⊘', '⊘',
'⊙', '⊙',
'⊚', '⊚',
'⊛', '⊛',
'⊜', '⊜',
'⊝', '⊝',
'⊞', '⊞',
'⊟', '⊟',
'⊠', '⊠',
'⊡', '⊡',
'⊢', '⊢',
'⊣', '⊣',
'⊤', '⊤',
'⊥', '⊥',
'⊦', '⊦',
'⊧', '⊧',
'⊨', '⊨',
'⊩', '⊩',
'⊪', '⊪',
'⊫', '⊫',
'⊬', '⊬',
'⊭', '⊭',
'⊮', '⊮',
'⊯', '⊯',
'⋀', '⋀',
'⋁', '⋁',
'⋂', '⋂',
'⋃', '⋃',
'⋄', '⋄',
'⋅', '⋅',
'⋆', '⋆',
'⋇', '⋇',
'⋈', '⋈',
'⋉', '⋉',
'⋊', '⋊',
'⋋', '⋋',
'⋌', '⋌',
'⋍', '⋍',
'⋎', '⋎',
'⋏', '⋏',
'⋐', '⋐',
'⋑', '⋑',
'⋒', '⋒',
'⋓', '⋓',
'⋔', '⋔',
'⋕', '⋕',
'⋖', '⋖',
'⋗', '⋗',
'⋘', '⋘',
'⋙', '⋙',
'⋚', '⋚',
'⋛', '⋛',
'⋜', '⋜',
'⋝', '⋝',
'⋞', '⋞',
'⋟', '⋟',
'⋠', '⋠',
'⋡', '⋡',
'⋢', '⋢',
'⋣', '⋣',
'⋤', '⋤',
'⋥', '⋥',
'⋦', '⋦',
'⋧', '⋧',
'⋨', '⋨',
'⋩', '⋩',
'▁', '▁',
'▂', '▂',
'▃', '▃',
'▄', '▄',
'▅', '▅',
'▆', '▆',
'▇', '▇',
'█', '█',
'▉', '▉',
'▊', '▊',
'▋', '▋',
'▌', '▌',
'▍', '▍',
'▎', '▎',
'▏', '▏',
'▐', '▐',
'░', '░',
'▒', '▒',
'▓', '▓',
'▔', '▔',
'▕', '▕',
'▖', '▖',
'▗', '▗',
'▘', '▘',
'▙' '▙'
) )
val codeMap = code.mapIndexed { index, c -> c to index }.toMap() val codeMap = code.mapIndexed { index, c -> c to index }.toMap()
} }
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
val result = CharArray(bytes.size) val result = CharArray(bytes.size)
for (i in bytes.indices) { for (i in bytes.indices) {
val unsignedByte = bytes[i].toInt() and 0xFF val unsignedByte = bytes[i].toInt() and 0xFF
result[i] = code[unsignedByte] result[i] = code[unsignedByte]
} }
return String(result) return String(result)
} }
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
val result = ByteArray(string.length) val result = ByteArray(string.length)
for (i in string.indices) { for (i in string.indices) {
result[i] = codeMap[string[i]]!!.toByte() result[i] = codeMap[string[i]]!!.toByte()
} }
return result return result
} }
} }
@@ -23,37 +23,37 @@
package com.mingliqiye.utils.base package com.mingliqiye.utils.base
internal class Base2Codec : BaseCodec { internal class Base2Codec : BaseCodec {
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return "" if (bytes.isEmpty()) return ""
val result = StringBuilder() val result = StringBuilder()
for ((index, byte) in bytes.withIndex()) { for ((index, byte) in bytes.withIndex()) {
val unsignedByte = byte.toInt() and 0xFF val unsignedByte = byte.toInt() and 0xFF
val binary = unsignedByte.toString(2).padStart(8, '0') val binary = unsignedByte.toString(2).padStart(8, '0')
result.append(binary) result.append(binary)
} }
return result.toString() return result.toString()
} }
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
if (string.length % 8 != 0) { if (string.length % 8 != 0) {
throw IllegalArgumentException( throw IllegalArgumentException(
"BASE1字符串长度必须是8的倍数,当前长度: ${string.length}" "BASE1字符串长度必须是8的倍数,当前长度: ${string.length}"
) )
} }
if (!string.matches(Regex("[01]+"))) { if (!string.matches(Regex("[01]+"))) {
throw IllegalArgumentException( throw IllegalArgumentException(
"BASE1字符串只能包含字符'0'和'1'" "BASE1字符串只能包含字符'0'和'1'"
) )
} }
val byteCount = string.length / 8 val byteCount = string.length / 8
val result = ByteArray(byteCount) val result = ByteArray(byteCount)
for (i in 0 until byteCount) { for (i in 0 until byteCount) {
val startIndex = i * 8 val startIndex = i * 8
val endIndex = startIndex + 8 val endIndex = startIndex + 8
val binaryStr = string.substring(startIndex, endIndex) val binaryStr = string.substring(startIndex, endIndex)
val byteValue = binaryStr.toInt(2) val byteValue = binaryStr.toInt(2)
result[i] = byteValue.toByte() result[i] = byteValue.toByte()
} }
return result return result
} }
} }
@@ -30,35 +30,35 @@ import java.util.*
*/ */
internal class Base64Codec : BaseCodec { internal class Base64Codec : BaseCodec {
/* /*
* Base64编码器实例 * Base64编码器实例
* 用于执行字节数组到Base64字符串的编码操作 * 用于执行字节数组到Base64字符串的编码操作
*/ */
val encoder: Base64.Encoder = Base64.getEncoder() val encoder: Base64.Encoder = Base64.getEncoder()
/* /*
* Base64解码器实例 * Base64解码器实例
* 用于执行Base64字符串到字节数组的解码操作 * 用于执行Base64字符串到字节数组的解码操作
*/ */
val decoder: Base64.Decoder = Base64.getDecoder() val decoder: Base64.Decoder = Base64.getDecoder()
/* /*
* 将字节数组编码为Base64字符串 * 将字节数组编码为Base64字符串
* *
* @param bytes 待编码的字节数组 * @param bytes 待编码的字节数组
* @return 编码后的Base64字符串 * @return 编码后的Base64字符串
*/ */
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
return encoder.encodeToString(bytes) return encoder.encodeToString(bytes)
} }
/* /*
* 将Base64字符串解码为字节数组 * 将Base64字符串解码为字节数组
* *
* @param string 待解码的Base64字符串 * @param string 待解码的Base64字符串
* @return 解码后的字节数组 * @return 解码后的字节数组
*/ */
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
return decoder.decode(string) return decoder.decode(string)
} }
} }
@@ -26,35 +26,35 @@ import java.util.*
internal class Base64UrlCodec : BaseCodec { internal class Base64UrlCodec : BaseCodec {
/* /*
* Base64编码器实例 * Base64编码器实例
* 用于执行字节数组到Base64字符串的编码操作 * 用于执行字节数组到Base64字符串的编码操作
*/ */
val encoder: Base64.Encoder = Base64.getUrlEncoder() val encoder: Base64.Encoder = Base64.getUrlEncoder()
/* /*
* Base64解码器实例 * Base64解码器实例
* 用于执行Base64字符串到字节数组的解码操作 * 用于执行Base64字符串到字节数组的解码操作
*/ */
val decoder: Base64.Decoder = Base64.getUrlDecoder() val decoder: Base64.Decoder = Base64.getUrlDecoder()
/* /*
* 将字节数组编码为Base64字符串 * 将字节数组编码为Base64字符串
* *
* @param bytes 待编码的字节数组 * @param bytes 待编码的字节数组
* @return 编码后的Base64字符串 * @return 编码后的Base64字符串
*/ */
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
return encoder.encodeToString(bytes) return encoder.encodeToString(bytes)
} }
/* /*
* 将Base64字符串解码为字节数组 * 将Base64字符串解码为字节数组
* *
* @param string 待解码的Base64字符串 * @param string 待解码的Base64字符串
* @return 解码后的字节数组 * @return 解码后的字节数组
*/ */
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
return decoder.decode(string) return decoder.decode(string)
} }
} }
@@ -29,376 +29,376 @@ package com.mingliqiye.utils.base
*/ */
internal class Base91Codec : BaseCodec { internal class Base91Codec : BaseCodec {
companion object { companion object {
/** /**
* Base91 编码表,共 91 个可打印 ASCII 字符。 * Base91 编码表,共 91 个可打印 ASCII 字符。
*/ */
val ENCODING_TABLE: CharArray = charArrayOf( val ENCODING_TABLE: CharArray = charArrayOf(
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M', 'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z', 'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '!', '#', '$', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '!', '#', '$',
'%', '&', '(', ')', '*', '+', ',', '.', '/', ':', ';', '<', '=', '%', '&', '(', ')', '*', '+', ',', '.', '/', ':', ';', '<', '=',
'>', '?', '@', '[', ']', '^', '_', '`', '{', '|', '}', '~', '"' '>', '?', '@', '[', ']', '^', '_', '`', '{', '|', '}', '~', '"'
) )
/** /**
* Base91 解码表,大小为 256,用于快速查找字符对应的数值。 * Base91 解码表,大小为 256,用于快速查找字符对应的数值。
* 初始化时将所有元素设为 -1,表示无效字符;然后根据 ENCODING_TABLE 填充有效字符的索引。 * 初始化时将所有元素设为 -1,表示无效字符;然后根据 ENCODING_TABLE 填充有效字符的索引。
*/ */
val DECODING_TABLE: Array<Int> = arrayOf( val DECODING_TABLE: Array<Int> = arrayOf(
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
62, 62,
90, 90,
63, 63,
64, 64,
65, 65,
66, 66,
-1, -1,
67, 67,
68, 68,
69, 69,
70, 70,
71, 71,
-1, -1,
72, 72,
73, 73,
52, 52,
53, 53,
54, 54,
55, 55,
56, 56,
57, 57,
58, 58,
59, 59,
60, 60,
61, 61,
74, 74,
75, 75,
76, 76,
77, 77,
78, 78,
79, 79,
80, 80,
0, 0,
1, 1,
2, 2,
3, 3,
4, 4,
5, 5,
6, 6,
7, 7,
8, 8,
9, 9,
10, 10,
11, 11,
12, 12,
13, 13,
14, 14,
15, 15,
16, 16,
17, 17,
18, 18,
19, 19,
20, 20,
21, 21,
22, 22,
23, 23,
24, 24,
25, 25,
81, 81,
-1, -1,
82, 82,
83, 83,
84, 84,
85, 85,
26, 26,
27, 27,
28, 28,
29, 29,
30, 30,
31, 31,
32, 32,
33, 33,
34, 34,
35, 35,
36, 36,
37, 37,
38, 38,
39, 39,
40, 40,
41, 41,
42, 42,
43, 43,
44, 44,
45, 45,
46, 46,
47, 47,
48, 48,
49, 49,
50, 50,
51, 51,
86, 86,
87, 87,
88, 88,
89, 89,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1, -1,
-1 -1
) )
} }
/** /**
* 将字节数组编码为 Base91 字符串。 * 将字节数组编码为 Base91 字符串。
* *
* @param bytes 待编码的字节数组 * @param bytes 待编码的字节数组
* @return 编码后的 Base91 字符串 * @return 编码后的 Base91 字符串
*/ */
override fun encode(bytes: ByteArray): String { override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return "" if (bytes.isEmpty()) return ""
val sb = StringBuilder() val sb = StringBuilder()
var ebq = 0 // 编码缓冲区,用于暂存待处理的位数据 var ebq = 0 // 编码缓冲区,用于暂存待处理的位数据
var en = 0 // 当前缓冲区中的有效位数 var en = 0 // 当前缓冲区中的有效位数
for (b in bytes) { for (b in bytes) {
// 将当前字节加入缓冲区 // 将当前字节加入缓冲区
ebq = ebq or ((b.toInt() and 0xFF) shl en) ebq = ebq or ((b.toInt() and 0xFF) shl en)
en += 8 en += 8
// 每当缓冲区中有超过 13 位的数据时,尝试进行编码 // 每当缓冲区中有超过 13 位的数据时,尝试进行编码
if (en > 13) { if (en > 13) {
var ev = ebq and 0x1FFF // 取出低 13 位作为候选值 var ev = ebq and 0x1FFF // 取出低 13 位作为候选值
if (ev > 88) { if (ev > 88) {
// 如果候选值大于 88,则使用 13 位编码 // 如果候选值大于 88,则使用 13 位编码
ebq = ebq shr 13 ebq = ebq shr 13
en -= 13 en -= 13
} else { } else {
// 否则使用 14 位编码 // 否则使用 14 位编码
ev = ebq and 0x3FFF ev = ebq and 0x3FFF
ebq = ebq shr 14 ebq = ebq shr 14
en -= 14 en -= 14
} }
// 将两个字符追加到结果中 // 将两个字符追加到结果中
sb.append(ENCODING_TABLE[ev % 91]) sb.append(ENCODING_TABLE[ev % 91])
sb.append(ENCODING_TABLE[ev / 91]) sb.append(ENCODING_TABLE[ev / 91])
} }
} }
// 处理剩余未编码的数据 // 处理剩余未编码的数据
if (en > 0) { if (en > 0) {
sb.append(ENCODING_TABLE[ebq % 91]) sb.append(ENCODING_TABLE[ebq % 91])
if (en > 7 || ebq > 90) { if (en > 7 || ebq > 90) {
sb.append(ENCODING_TABLE[ebq / 91]) sb.append(ENCODING_TABLE[ebq / 91])
} }
} }
return sb.toString() return sb.toString()
} }
/** /**
* 将 Base91 字符串解码为原始字节数组。 * 将 Base91 字符串解码为原始字节数组。
* *
* @param string 待解码的 Base91 字符串 * @param string 待解码的 Base91 字符串
* @return 解码后的字节数组 * @return 解码后的字节数组
*/ */
override fun decode(string: String): ByteArray { override fun decode(string: String): ByteArray {
if (string.isEmpty()) return ByteArray(0) if (string.isEmpty()) return ByteArray(0)
var dbq = 0 // 解码缓冲区,用于暂存待处理的位数据 var dbq = 0 // 解码缓冲区,用于暂存待处理的位数据
var dn = 0 // 当前缓冲区中的有效位数 var dn = 0 // 当前缓冲区中的有效位数
var dv = -1 // 当前读取到的 Base91 值 var dv = -1 // 当前读取到的 Base91 值
val buffer = ByteArray(string.length * 13 / 8) // 预分配输出缓冲区 val buffer = ByteArray(string.length * 13 / 8) // 预分配输出缓冲区
var index = 0 // 输出缓冲区写入位置 var index = 0 // 输出缓冲区写入位置
for (c in string.toCharArray()) { for (c in string.toCharArray()) {
// 忽略不在编码表中的字符 // 忽略不在编码表中的字符
if (DECODING_TABLE[c.code] == -1) continue if (DECODING_TABLE[c.code] == -1) continue
if (dv == -1) { if (dv == -1) {
// 第一次读取字符,保存为 dv // 第一次读取字符,保存为 dv
dv = DECODING_TABLE[c.code] dv = DECODING_TABLE[c.code]
} else { } else {
// 第二次读取字符,组合成完整的 Base91 值 // 第二次读取字符,组合成完整的 Base91 值
dv += DECODING_TABLE[c.code] * 91 dv += DECODING_TABLE[c.code] * 91
dbq = dbq or (dv shl dn) dbq = dbq or (dv shl dn)
// 根据值大小判断是 13 位还是 14 位编码 // 根据值大小判断是 13 位还是 14 位编码
dn += if ((dv and 0x1FFF) > 88) 13 else 14 dn += if ((dv and 0x1FFF) > 88) 13 else 14
// 将缓冲区中完整的字节写入输出数组 // 将缓冲区中完整的字节写入输出数组
do { do {
buffer[index++] = (dbq and 0xFF).toByte() buffer[index++] = (dbq and 0xFF).toByte()
dbq = dbq shr 8 dbq = dbq shr 8
dn -= 8 dn -= 8
} while (dn > 7) } while (dn > 7)
dv = -1 // 重置 dv,准备下一轮读取 dv = -1 // 重置 dv,准备下一轮读取
} }
} }
// 处理最后剩余的一个字符(如果存在) // 处理最后剩余的一个字符(如果存在)
if (dv != -1) { if (dv != -1) {
buffer[index++] = ((dbq or (dv shl dn)) and 0xFF).toByte() buffer[index++] = ((dbq or (dv shl dn)) and 0xFF).toByte()
} }
// 返回实际使用的部分 // 返回实际使用的部分
return buffer.copyOf(index) return buffer.copyOf(index)
} }
} }
@@ -33,146 +33,146 @@ import java.nio.file.Path
*/ */
interface BaseCodec { interface BaseCodec {
/** /**
* 对字节数组进行编码,并捕获可能发生的异常。 * 对字节数组进行编码,并捕获可能发生的异常。
* *
* @param bytes 需要编码的字节数组 * @param bytes 需要编码的字节数组
* @return 编码后的字符串结果 * @return 编码后的字符串结果
* @throws CodecException 如果编码过程中发生异常 * @throws CodecException 如果编码过程中发生异常
*/ */
fun catchEncode(bytes: ByteArray) = try { fun catchEncode(bytes: ByteArray) = try {
encode(bytes) encode(bytes)
} catch (e: Exception) { } catch (e: Exception) {
throw CodecException(throwable = e) throw CodecException(throwable = e)
} }
/** /**
* 对字符串进行解码,并捕获可能发生的异常。 * 对字符串进行解码,并捕获可能发生的异常。
* *
* @param string 需要解码的字符串 * @param string 需要解码的字符串
* @return 解码后的字节数组结果 * @return 解码后的字节数组结果
* @throws CodecException 如果解码过程中发生异常 * @throws CodecException 如果解码过程中发生异常
*/ */
fun catchDecode(string: String) = try { fun catchDecode(string: String) = try {
decode(string) decode(string)
} catch (e: Exception) { } catch (e: Exception) {
throw CodecException(throwable = e) throw CodecException(throwable = e)
} }
/** /**
* 将字节数组编码为字符串。 * 将字节数组编码为字符串。
* *
* @param bytes 需要编码的字节数组 * @param bytes 需要编码的字节数组
* @return 编码后的字符串结果 * @return 编码后的字符串结果
*/ */
fun encode(bytes: ByteArray): String fun encode(bytes: ByteArray): String
/** /**
* 将字符串解码为字节数组。 * 将字符串解码为字节数组。
* *
* @param string 需要解码的字符串 * @param string 需要解码的字符串
* @return 解码后的字节数组结果 * @return 解码后的字节数组结果
*/ */
fun decode(string: String): ByteArray fun decode(string: String): ByteArray
/** /**
* 对文件内容进行编码。 * 对文件内容进行编码。
* *
* @param file 需要编码的文件对象 * @param file 需要编码的文件对象
* @return 文件内容编码后的字符串结果 * @return 文件内容编码后的字符串结果
*/ */
fun encode(file: File) = catchEncode(file.readBytes()) fun encode(file: File) = catchEncode(file.readBytes())
/** /**
* 将字符串解码后写入指定文件。 * 将字符串解码后写入指定文件。
* *
* @param file 目标文件对象 * @param file 目标文件对象
* @param string 需要解码的字符串 * @param string 需要解码的字符串
*/ */
fun decode(file: File, string: String) = fun decode(file: File, string: String) =
file.writeBytes(catchDecode(string)) file.writeBytes(catchDecode(string))
/** /**
* 安全地对文件内容进行编码,如果发生异常则返回 null。 * 安全地对文件内容进行编码,如果发生异常则返回 null。
* *
* @param file 需要编码的文件对象 * @param file 需要编码的文件对象
* @return 文件内容编码后的字符串结果,若失败则返回 null * @return 文件内容编码后的字符串结果,若失败则返回 null
*/ */
fun encodeSafe(file: File) = try { fun encodeSafe(file: File) = try {
encode(file) encode(file)
} catch (_: Exception) { } catch (_: Exception) {
null null
} }
/** /**
* 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。 * 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。
* *
* @param file 目标文件对象 * @param file 目标文件对象
* @param string 需要解码的字符串 * @param string 需要解码的字符串
* @return 操作是否成功的布尔值 * @return 操作是否成功的布尔值
*/ */
fun decodeSafe(file: File, string: String) = try { fun decodeSafe(file: File, string: String) = try {
decode(file, string) decode(file, string)
true true
} catch (_: Exception) { } catch (_: Exception) {
false false
} }
/** /**
* 对路径指向的文件内容进行编码。 * 对路径指向的文件内容进行编码。
* *
* @param path 需要编码的文件路径 * @param path 需要编码的文件路径
* @return 文件内容编码后的字符串结果 * @return 文件内容编码后的字符串结果
*/ */
fun encode(path: Path) = catchEncode(path.toFile().readBytes()) fun encode(path: Path) = catchEncode(path.toFile().readBytes())
/** /**
* 将字符串解码后写入指定路径的文件。 * 将字符串解码后写入指定路径的文件。
* *
* @param path 目标文件路径 * @param path 目标文件路径
* @param string 需要解码的字符串 * @param string 需要解码的字符串
*/ */
fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string)) fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string))
/** /**
* 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。 * 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。
* *
* @param path 需要编码的文件路径 * @param path 需要编码的文件路径
* @return 文件内容编码后的字符串结果,若失败则返回 null * @return 文件内容编码后的字符串结果,若失败则返回 null
*/ */
fun encodeSafe(path: Path) = try { fun encodeSafe(path: Path) = try {
encode(path) encode(path)
} catch (_: Exception) { } catch (_: Exception) {
null null
} }
/** /**
* 安全地将字符串解码并写入指定路径的文件,如果成功则返回 true,否则返回 false。 * 安全地将字符串解码并写入指定路径的文件,如果成功则返回 true,否则返回 false。
* *
* @param path 目标文件路径 * @param path 目标文件路径
* @param string 需要解码的字符串 * @param string 需要解码的字符串
* @return 操作是否成功的布尔值 * @return 操作是否成功的布尔值
*/ */
fun decodeSafe(path: Path, string: String) = try { fun decodeSafe(path: Path, string: String) = try {
decode(path, string) decode(path, string)
true true
} catch (_: Exception) { } catch (_: Exception) {
false false
} }
/** /**
* 对字符串进行编码。 * 对字符串进行编码。
* *
* @param string 需要编码的字符串 * @param string 需要编码的字符串
* @return 编码后的字符串结果 * @return 编码后的字符串结果
*/ */
fun encode(string: String) = catchEncode(string.toByteArray()) fun encode(string: String) = catchEncode(string.toByteArray())
/** /**
* 将字符串解码为 UTF-8 格式的字符串。 * 将字符串解码为 UTF-8 格式的字符串。
* *
* @param string 需要解码的字符串 * @param string 需要解码的字符串
* @return 解码后的 UTF-8 字符串结果 * @return 解码后的 UTF-8 字符串结果
*/ */
fun decodetoString(string: String) = catchDecode(string).toString(Charsets.UTF_8) fun decodetoString(string: String) = catchDecode(string).toString(Charsets.UTF_8)
} }
@@ -24,15 +24,15 @@ package com.mingliqiye.utils.base
enum class BaseType(val baseCodec: BaseCodec) : BaseCodec { enum class BaseType(val baseCodec: BaseCodec) : BaseCodec {
BASE2(com.mingliqiye.utils.base.code.BASE2), BASE2(com.mingliqiye.utils.base.code.BASE2),
BASE10(com.mingliqiye.utils.base.code.BASE10), BASE10(com.mingliqiye.utils.base.code.BASE10),
BASE16(com.mingliqiye.utils.base.code.BASE16), BASE16(com.mingliqiye.utils.base.code.BASE16),
BASE64(com.mingliqiye.utils.base.code.BASE64), BASE64(com.mingliqiye.utils.base.code.BASE64),
BASE64URL(com.mingliqiye.utils.base.code.BASE64URL), BASE64URL(com.mingliqiye.utils.base.code.BASE64URL),
BASE91(com.mingliqiye.utils.base.code.BASE91), BASE91(com.mingliqiye.utils.base.code.BASE91),
BASE256(com.mingliqiye.utils.base.code.BASE256); BASE256(com.mingliqiye.utils.base.code.BASE256);
override fun encode(bytes: ByteArray) = baseCodec.encode(bytes) override fun encode(bytes: ByteArray) = baseCodec.encode(bytes)
override fun decode(string: String) = baseCodec.decode(string) override fun decode(string: String) = baseCodec.decode(string)
} }
@@ -32,7 +32,7 @@ import com.mingliqiye.utils.base.*
*/ */
@get:JvmName("base2") @get:JvmName("base2")
val BASE2: BaseCodec by lazy { val BASE2: BaseCodec by lazy {
Base2Codec() Base2Codec()
} }
/** /**
@@ -41,7 +41,7 @@ val BASE2: BaseCodec by lazy {
*/ */
@get:JvmName("base10") @get:JvmName("base10")
val BASE10: BaseCodec by lazy { val BASE10: BaseCodec by lazy {
Base10Codec() Base10Codec()
} }
/** /**
@@ -50,7 +50,7 @@ val BASE10: BaseCodec by lazy {
*/ */
@get:JvmName("base16") @get:JvmName("base16")
val BASE16: BaseCodec by lazy { val BASE16: BaseCodec by lazy {
Base16Codec() Base16Codec()
} }
/** /**
@@ -59,12 +59,12 @@ val BASE16: BaseCodec by lazy {
*/ */
@get:JvmName("base64") @get:JvmName("base64")
val BASE64: BaseCodec by lazy { val BASE64: BaseCodec by lazy {
Base64Codec() Base64Codec()
} }
@get:JvmName("base64Url") @get:JvmName("base64Url")
val BASE64URL: BaseCodec by lazy { val BASE64URL: BaseCodec by lazy {
Base64UrlCodec() Base64UrlCodec()
} }
/** /**
@@ -73,7 +73,7 @@ val BASE64URL: BaseCodec by lazy {
*/ */
@get:JvmName("base91") @get:JvmName("base91")
val BASE91: BaseCodec by lazy { val BASE91: BaseCodec by lazy {
Base91Codec() Base91Codec()
} }
/** /**
@@ -82,5 +82,5 @@ val BASE91: BaseCodec by lazy {
*/ */
@get:JvmName("base256") @get:JvmName("base256")
val BASE256: BaseCodec by lazy { val BASE256: BaseCodec by lazy {
Base256Codec() Base256Codec()
} }
@@ -30,30 +30,30 @@ import org.mindrot.jbcrypt.BCrypt as JBCrypt
fun hashpw(string: String): String { fun hashpw(string: String): String {
return hashpw(string, gensalt()) return hashpw(string, gensalt())
} }
fun hashpw(string: String, salt: String = gensalt()): String { fun hashpw(string: String, salt: String = gensalt()): String {
return JBCrypt.hashpw(string, salt) return JBCrypt.hashpw(string, salt)
} }
fun checkpw(string: String, bcrypted: String): Boolean { fun checkpw(string: String, bcrypted: String): Boolean {
return JBCrypt.checkpw(string, bcrypted) return JBCrypt.checkpw(string, bcrypted)
} }
fun gensalt(): String { fun gensalt(): String {
return JBCrypt.gensalt() return JBCrypt.gensalt()
} }
fun gensalt(long: Int): String { fun gensalt(long: Int): String {
return JBCrypt.gensalt(long) return JBCrypt.gensalt(long)
} }
fun gensalt(long: Int, secureRandom: SecureRandom): String { fun gensalt(long: Int, secureRandom: SecureRandom): String {
return JBCrypt.gensalt(long, secureRandom) return JBCrypt.gensalt(long, secureRandom)
} }
File diff suppressed because it is too large Load Diff
@@ -34,243 +34,243 @@ import java.util.concurrent.ConcurrentHashMap
import java.util.UUID as JUUID import java.util.UUID as JUUID
interface ByteBufferWrapperConvertorInterface<T : Any> { interface ByteBufferWrapperConvertorInterface<T : Any> {
fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) fun write(obj: T, byteBufferWrapper: ByteBufferWrapper)
fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T
fun getType(): Class<T> fun getType(): Class<T>
} }
abstract class ByteBufferWrapperConvertor<T : Any> : ByteBufferWrapperConvertorInterface<T> { abstract class ByteBufferWrapperConvertor<T : Any> : ByteBufferWrapperConvertorInterface<T> {
override fun toString(): String { override fun toString(): String {
return "ByteBufferWrapperConvertor(type=${getType()})" return "ByteBufferWrapperConvertor(type=${getType()})"
} }
companion object { companion object {
private val _instantiations = private val _instantiations =
ConcurrentHashMap<Class<ByteBufferWrapperConvertor<*>>, ByteBufferWrapperConvertor<*>>() ConcurrentHashMap<Class<ByteBufferWrapperConvertor<*>>, ByteBufferWrapperConvertor<*>>()
@JvmStatic @JvmStatic
fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> { fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> {
return _instantiations.getOrPut(clazz) { return _instantiations.getOrPut(clazz) {
clazz.getConstructor().newInstance() clazz.getConstructor().newInstance()
} }
} }
@JvmStatic @JvmStatic
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> { inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> {
return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>) return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>)
} }
fun defaultConvertorInstall() { fun defaultConvertorInstall() {
ByteBufferWrapper.addConvertor<BigDecimalBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<BigDecimalBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BigIntegerBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<BigIntegerBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BooleanBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<BooleanBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BytedBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<BytedBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ByteFlagsBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<ByteFlagsBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<CharBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<CharBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DateBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<DateBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DateTimeFlagsBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<DateTimeFlagsBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DoubleBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<DoubleBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<FloatBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<FloatBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<IntBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<IntBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<JUUIDBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<JUUIDBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<LocalDateTimeBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<LocalDateTimeBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<LongBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<LongBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ShortBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<ShortBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<StringBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<StringBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<UUIDBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<UUIDBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ByteArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<ByteArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<CharArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<CharArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ShortArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<ShortArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<IntArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<IntArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<LongArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<LongArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<FloatArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<FloatArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DoubleArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<DoubleArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BooleanArrayBufferWrapperConvertor>() ByteBufferWrapper.addConvertor<BooleanArrayBufferWrapperConvertor>()
} }
} }
} }
abstract class ObjectBufferWrapperConvertor<T : Any>( abstract class ObjectBufferWrapperConvertor<T : Any>(
val write: ByteBufferWrapper.(obj: T) -> Unit, val write: ByteBufferWrapper.(obj: T) -> Unit,
val read: ByteBufferWrapper.() -> T, val read: ByteBufferWrapper.() -> T,
val typer: Class<T>, val typer: Class<T>,
) : ByteBufferWrapperConvertor<T>() { ) : ByteBufferWrapperConvertor<T>() {
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj) override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T = override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T =
read.invoke(byteBufferWrapper) read.invoke(byteBufferWrapper)
override fun getType(): Class<T> = typer override fun getType(): Class<T> = typer
} }
class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>( class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>(
ByteBufferWrapper::putByte, ByteBufferWrapper::putByte,
ByteBufferWrapper::getByte, ByteBufferWrapper::getByte,
Byte::class.java, Byte::class.java,
) )
class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>( class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>(
ByteBufferWrapper::putChar, ByteBufferWrapper::putChar,
ByteBufferWrapper::getChar, ByteBufferWrapper::getChar,
Char::class.java, Char::class.java,
) )
class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>( class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>(
ByteBufferWrapper::putShort, ByteBufferWrapper::putShort,
ByteBufferWrapper::getShort, ByteBufferWrapper::getShort,
Short::class.java, Short::class.java,
) )
class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>( class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>(
ByteBufferWrapper::putInt, ByteBufferWrapper::putInt,
ByteBufferWrapper::getInt, ByteBufferWrapper::getInt,
Int::class.java, Int::class.java,
) )
class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>( class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>(
ByteBufferWrapper::putLong, ByteBufferWrapper::putLong,
ByteBufferWrapper::getLong, ByteBufferWrapper::getLong,
Long::class.java, Long::class.java,
) )
class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>( class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>(
ByteBufferWrapper::putDouble, ByteBufferWrapper::putDouble,
ByteBufferWrapper::getDouble, ByteBufferWrapper::getDouble,
Double::class.java, Double::class.java,
) )
class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>( class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>(
ByteBufferWrapper::putFloat, ByteBufferWrapper::putFloat,
ByteBufferWrapper::getFloat, ByteBufferWrapper::getFloat,
Float::class.java, Float::class.java,
) )
class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>( class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>(
ByteBufferWrapper::putBigInteger, ByteBufferWrapper::putBigInteger,
ByteBufferWrapper::getBigInteger, ByteBufferWrapper::getBigInteger,
BigInteger::class.java, BigInteger::class.java,
) )
class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>( class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>(
ByteBufferWrapper::putBigDecimal, ByteBufferWrapper::putBigDecimal,
ByteBufferWrapper::getBigDecimal, ByteBufferWrapper::getBigDecimal,
BigDecimal::class.java, BigDecimal::class.java,
) )
class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>( class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>(
ByteBufferWrapper::putBoolean, ByteBufferWrapper::putBoolean,
ByteBufferWrapper::getBoolean, ByteBufferWrapper::getBoolean,
Boolean::class.java, Boolean::class.java,
) )
class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>( class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>(
ByteBufferWrapper::putString, ByteBufferWrapper::putString,
ByteBufferWrapper::getString, ByteBufferWrapper::getString,
String::class.java, String::class.java,
) )
class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>( class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>(
ByteBufferWrapper::putFlag, ByteBufferWrapper::putFlag,
ByteBufferWrapper::getFlag, ByteBufferWrapper::getFlag,
ByteFlags::class.java, ByteFlags::class.java,
) )
class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>( class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>(
ByteBufferWrapper::putUUID, ByteBufferWrapper::putUUID,
ByteBufferWrapper::getJUUID, ByteBufferWrapper::getJUUID,
JUUID::class.java, JUUID::class.java,
) )
class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>( class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>(
ByteBufferWrapper::putUUID, ByteBufferWrapper::putUUID,
ByteBufferWrapper::getUUID, ByteBufferWrapper::getUUID,
UUID::class.java, UUID::class.java,
) )
class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>( class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>(
ByteBufferWrapper::putDateTime, ByteBufferWrapper::putDateTime,
ByteBufferWrapper::getDateTime, ByteBufferWrapper::getDateTime,
DateTime::class.java, DateTime::class.java,
) )
class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>( class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>(
ByteBufferWrapper::putLocalDateTime, ByteBufferWrapper::putLocalDateTime,
ByteBufferWrapper::getLocalDateTime, ByteBufferWrapper::getLocalDateTime,
LocalDateTime::class.java, LocalDateTime::class.java,
) )
class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>( class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>(
ByteBufferWrapper::putDate, ByteBufferWrapper::putDate,
ByteBufferWrapper::getDate, ByteBufferWrapper::getDate,
Date::class.java, Date::class.java,
) )
abstract class ArrayBufferWrapperConvertor<T : Any>( abstract class ArrayBufferWrapperConvertor<T : Any>(
val write: ByteBufferWrapper.(obj: T) -> Unit, val write: ByteBufferWrapper.(obj: T) -> Unit,
val read: ByteBufferWrapper.(size: Int) -> T, val read: ByteBufferWrapper.(size: Int) -> T,
val typer: Class<T>, val typer: Class<T>,
) : ByteBufferWrapperConvertor<T>() { ) : ByteBufferWrapperConvertor<T>() {
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj) override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T { override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T {
if (parameters.isEmpty()) { if (parameters.isEmpty()) {
throw IllegalArgumentException("parameters cannot be empty, must has a Int") throw IllegalArgumentException("parameters cannot be empty, must has a Int")
} }
val size = parameters[0] val size = parameters[0]
if (size !is Int) if (size !is Int)
throw IllegalArgumentException("parameters[0] cannot be Int, must has a Int") throw IllegalArgumentException("parameters[0] cannot be Int, must has a Int")
return read.invoke(byteBufferWrapper, size) return read.invoke(byteBufferWrapper, size)
} }
override fun getType(): Class<T> = typer override fun getType(): Class<T> = typer
} }
class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>( class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>(
ByteBufferWrapper::putByteArray, ByteBufferWrapper::putByteArray,
ByteBufferWrapper::getByteArray, ByteBufferWrapper::getByteArray,
ByteArray::class.java, ByteArray::class.java,
) )
class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>( class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>(
ByteBufferWrapper::putCharArray, ByteBufferWrapper::putCharArray,
ByteBufferWrapper::getCharArray, ByteBufferWrapper::getCharArray,
CharArray::class.java, CharArray::class.java,
) )
class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>( class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>(
ByteBufferWrapper::putShortArray, ByteBufferWrapper::putShortArray,
ByteBufferWrapper::getShortArray, ByteBufferWrapper::getShortArray,
ShortArray::class.java, ShortArray::class.java,
) )
class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>( class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>(
ByteBufferWrapper::putIntArray, ByteBufferWrapper::putIntArray,
ByteBufferWrapper::getIntArray, ByteBufferWrapper::getIntArray,
IntArray::class.java, IntArray::class.java,
) )
class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>( class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>(
ByteBufferWrapper::putLongArray, ByteBufferWrapper::putLongArray,
ByteBufferWrapper::getLongArray, ByteBufferWrapper::getLongArray,
LongArray::class.java, LongArray::class.java,
) )
class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>( class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>(
ByteBufferWrapper::putFloatArray, ByteBufferWrapper::putFloatArray,
ByteBufferWrapper::getFloatArray, ByteBufferWrapper::getFloatArray,
FloatArray::class.java, FloatArray::class.java,
) )
class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>( class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>(
ByteBufferWrapper::putDoubleArray, ByteBufferWrapper::putDoubleArray,
ByteBufferWrapper::getDoubleArray, ByteBufferWrapper::getDoubleArray,
DoubleArray::class.java, DoubleArray::class.java,
) )
class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>( class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>(
ByteBufferWrapper::putBooleanArray, ByteBufferWrapper::putBooleanArray,
ByteBufferWrapper::getBooleanArray, ByteBufferWrapper::getBooleanArray,
BooleanArray::class.java, BooleanArray::class.java,
) )
@@ -40,7 +40,7 @@ import java.nio.charset.Charset
* @return 当前 [ByteBuffer] 实例(支持链式调用) * @return 当前 [ByteBuffer] 实例(支持链式调用)
*/ */
fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer = fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer =
this.put(string.toByteArray(charset)).put(0x00) this.put(string.toByteArray(charset)).put(0x00)
/** /**
* 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。 * 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。
@@ -53,15 +53,15 @@ fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): Byt
* @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符) * @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符)
*/ */
fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String { fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
val data = ArrayList<Byte>() val data = ArrayList<Byte>()
while (true) { while (true) {
val byte = this.get() val byte = this.get()
if (byte == 0x00.toByte()) { if (byte == 0x00.toByte()) {
break break
} }
data.add(byte) data.add(byte)
} }
return String(data.toByteArray(), charset) return String(data.toByteArray(), charset)
} }
/** /**
@@ -72,9 +72,9 @@ fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
* @return 包含剩余字节的新字节数组 * @return 包含剩余字节的新字节数组
*/ */
fun ByteBuffer.toByteArray(): ByteArray { fun ByteBuffer.toByteArray(): ByteArray {
val ba = ByteArray(this.remaining()) val ba = ByteArray(this.remaining())
this.get(ba) this.get(ba)
return ba return ba
} }
/** /**
@@ -87,18 +87,18 @@ fun ByteBuffer.toByteArray(): ByteArray {
* @throws IndexOutOfBoundsException 如果列表长度不足 8 * @throws IndexOutOfBoundsException 如果列表长度不足 8
*/ */
fun ByteBuffer.putByteFlags( fun ByteBuffer.putByteFlags(
bit: List<Boolean> = List(8) { false }, bit: List<Boolean> = List(8) { false },
): ByteBuffer = this.putByteFlags( ): ByteBuffer = this.putByteFlags(
ByteFlags( ByteFlags(
bit[0], bit[0],
bit[1], bit[1],
bit[2], bit[2],
bit[3], bit[3],
bit[4], bit[4],
bit[5], bit[5],
bit[6], bit[6],
bit[7], bit[7],
) )
) )
/** /**
@@ -111,18 +111,18 @@ fun ByteBuffer.putByteFlags(
* @throws IndexOutOfBoundsException 如果数组长度不足 8 * @throws IndexOutOfBoundsException 如果数组长度不足 8
*/ */
fun ByteBuffer.putByteFlags( fun ByteBuffer.putByteFlags(
bit: BooleanArray = BooleanArray(8), bit: BooleanArray = BooleanArray(8),
): ByteBuffer = this.putByteFlags( ): ByteBuffer = this.putByteFlags(
ByteFlags( ByteFlags(
bit[0], bit[0],
bit[1], bit[1],
bit[2], bit[2],
bit[3], bit[3],
bit[4], bit[4],
bit[5], bit[5],
bit[6], bit[6],
bit[7], bit[7],
) )
) )
/** /**
@@ -149,25 +149,25 @@ fun ByteBuffer.putByteFlags(byteFlags: ByteFlags): ByteBuffer = this.put(byteFla
* @return 当前 [ByteBuffer] 实例(支持链式调用) * @return 当前 [ByteBuffer] 实例(支持链式调用)
*/ */
fun ByteBuffer.putByteFlags( fun ByteBuffer.putByteFlags(
bit0: Boolean = false, bit0: Boolean = false,
bit1: Boolean = false, bit1: Boolean = false,
bit2: Boolean = false, bit2: Boolean = false,
bit3: Boolean = false, bit3: Boolean = false,
bit4: Boolean = false, bit4: Boolean = false,
bit5: Boolean = false, bit5: Boolean = false,
bit6: Boolean = false, bit6: Boolean = false,
bit7: Boolean = false, bit7: Boolean = false,
): ByteBuffer = this.putByteFlags( ): ByteBuffer = this.putByteFlags(
ByteFlags( ByteFlags(
bit0, bit0,
bit1, bit1,
bit2, bit2,
bit3, bit3,
bit4, bit4,
bit5, bit5,
bit6, bit6,
bit7, bit7,
) )
) )
/** /**
@@ -204,7 +204,7 @@ fun ByteBuffer.putBoolean(boolean: Boolean): ByteBuffer = this.put(if (boolean)
* @return 包装后的 [ByteBuffer] 实例 * @return 包装后的 [ByteBuffer] 实例
*/ */
fun ByteArray.toByteBuffer(): ByteBuffer { fun ByteArray.toByteBuffer(): ByteBuffer {
return ByteBuffer.wrap(this) return ByteBuffer.wrap(this)
} }
/** /**
@@ -219,19 +219,19 @@ fun ByteArray.toByteBuffer(): ByteBuffer {
* @throws IOException 当读取过程中发生IO异常时抛出。 * @throws IOException 当读取过程中发生IO异常时抛出。
*/ */
fun ByteBuffer.getVarLong(size: Int = 8): Long { fun ByteBuffer.getVarLong(size: Int = 8): Long {
var numRead = 0 var numRead = 0
var result: Long = 0 var result: Long = 0
var read: Byte var read: Byte
do { do {
read = this.get() read = this.get()
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算 // 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
result = result or ((read.toLong() and 127) shl (7 * numRead)) result = result or ((read.toLong() and 127) shl (7 * numRead))
numRead++ numRead++
if (numRead > size) { if (numRead > size) {
throw IOException("VarNumber is too big") throw IOException("VarNumber is too big")
} }
} while ((read.toLong() and 128) != 0L) } while ((read.toLong() and 128) != 0L)
return result return result
} }
/** /**
@@ -269,13 +269,13 @@ fun ByteBuffer.getVarLong(): Long = this.getVarLong(8)
* @return 当前ByteBuffer实例(支持链式调用) * @return 当前ByteBuffer实例(支持链式调用)
*/ */
fun ByteBuffer.putVarLong(value: Long): ByteBuffer { fun ByteBuffer.putVarLong(value: Long): ByteBuffer {
var v = value var v = value
while (v >= 0x80) { while (v >= 0x80) {
this.put((v and 0x7F or 0x80).toByte()) this.put((v and 0x7F or 0x80).toByte())
v = v shr 7 v = v shr 7
} }
this.put(v.toByte()) this.put(v.toByte())
return this return this
} }
/** /**
@@ -28,23 +28,23 @@ import java.nio.ByteBuffer
interface ByteConvertible : Serializable { interface ByteConvertible : Serializable {
fun toBytes(): ByteArray fun toBytes(): ByteArray
fun writeToStream(outputStream: OutputStream) { fun writeToStream(outputStream: OutputStream) {
outputStream.write(toBytes()) outputStream.write(toBytes())
} }
fun putToByteBuffer(byteBuffer: ByteBuffer) { fun putToByteBuffer(byteBuffer: ByteBuffer) {
byteBuffer.put(toBytes()) byteBuffer.put(toBytes())
} }
companion object { companion object {
fun OutputStream.write(byteConvertible: ByteConvertible) { fun OutputStream.write(byteConvertible: ByteConvertible) {
byteConvertible.writeToStream(this) byteConvertible.writeToStream(this)
} }
fun ByteBuffer.put(byteConvertible: ByteConvertible) { fun ByteBuffer.put(byteConvertible: ByteConvertible) {
byteConvertible.putToByteBuffer(this) byteConvertible.putToByteBuffer(this)
} }
} }
} }
@@ -32,429 +32,429 @@ package com.mingliqiye.utils.bytes
* 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。 * 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。
*/ */
data class ByteFlags( data class ByteFlags(
/** 第 0 位(最低位,0x01) */ /** 第 0 位(最低位,0x01) */
var b0: Boolean = false, var b0: Boolean = false,
/** 第 1 位(0x02) */ /** 第 1 位(0x02) */
var b1: Boolean = false, var b1: Boolean = false,
/** 第 2 位(0x04) */ /** 第 2 位(0x04) */
var b2: Boolean = false, var b2: Boolean = false,
/** 第 3 位(0x08) */ /** 第 3 位(0x08) */
var b3: Boolean = false, var b3: Boolean = false,
/** 第 4 位(0x10) */ /** 第 4 位(0x10) */
var b4: Boolean = false, var b4: Boolean = false,
/** 第 5 位(0x20) */ /** 第 5 位(0x20) */
var b5: Boolean = false, var b5: Boolean = false,
/** 第 6 位(0x40) */ /** 第 6 位(0x40) */
var b6: Boolean = false, var b6: Boolean = false,
/** 第 7 位(最高位,0x80) */ /** 第 7 位(最高位,0x80) */
var b7: Boolean = false, var b7: Boolean = false,
) { ) {
/** /**
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。 * 通过一个 [Byte] 值构造 [ByteFlags] 实例。
* *
* @param byte 用于初始化的字节值(仅使用低 8 位) * @param byte 用于初始化的字节值(仅使用低 8 位)
*/ */
constructor(byte: Byte) : this() { constructor(byte: Byte) : this() {
fromByte(byte) fromByte(byte)
} }
/** /**
* 从给定的 [Byte] 值解析并设置各个位标志。 * 从给定的 [Byte] 值解析并设置各个位标志。
* *
* @param byte 要解析的字节 * @param byte 要解析的字节
*/ */
fun fromByte(byte: Byte) { fun fromByte(byte: Byte) {
val value = byte.toInt() and 0xFF val value = byte.toInt() and 0xFF
b0 = (value and 0x01) != 0 b0 = (value and 0x01) != 0
b1 = (value and 0x02) != 0 b1 = (value and 0x02) != 0
b2 = (value and 0x04) != 0 b2 = (value and 0x04) != 0
b3 = (value and 0x08) != 0 b3 = (value and 0x08) != 0
b4 = (value and 0x10) != 0 b4 = (value and 0x10) != 0
b5 = (value and 0x20) != 0 b5 = (value and 0x20) != 0
b6 = (value and 0x40) != 0 b6 = (value and 0x40) != 0
b7 = (value and 0x80) != 0 b7 = (value and 0x80) != 0
} }
/** /**
* 将当前标志状态转换为一个 [Byte] 值。 * 将当前标志状态转换为一个 [Byte] 值。
* *
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回) * @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
*/ */
fun toByte(): Byte { fun toByte(): Byte {
var result = 0 var result = 0
if (b0) result = result or 0x01 if (b0) result = result or 0x01
if (b1) result = result or 0x02 if (b1) result = result or 0x02
if (b2) result = result or 0x04 if (b2) result = result or 0x04
if (b3) result = result or 0x08 if (b3) result = result or 0x08
if (b4) result = result or 0x10 if (b4) result = result or 0x10
if (b5) result = result or 0x20 if (b5) result = result or 0x20
if (b6) result = result or 0x40 if (b6) result = result or 0x40
if (b7) result = result or 0x80 if (b7) result = result or 0x80
return result.toByte() return result.toByte()
} }
/** /**
* 通过索引(0~7)获取对应位的布尔值。 * 通过索引(0~7)获取对应位的布尔值。
* *
* @param index 位索引(0 = LSB, 7 = MSB) * @param index 位索引(0 = LSB, 7 = MSB)
* @return 该位是否为 true * @return 该位是否为 true
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内 * @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
*/ */
operator fun get(index: Int): Boolean { operator fun get(index: Int): Boolean {
return when (index) { return when (index) {
0 -> b0 0 -> b0
1 -> b1 1 -> b1
2 -> b2 2 -> b2
3 -> b3 3 -> b3
4 -> b4 4 -> b4
5 -> b5 5 -> b5
6 -> b6 6 -> b6
7 -> b7 7 -> b7
else -> throw IndexOutOfBoundsException("索引必须在0-7之间") else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
} }
} }
/** /**
* 通过索引(0~7)设置对应位的布尔值。 * 通过索引(0~7)设置对应位的布尔值。
* *
* @param index 位索引(0 = LSB, 7 = MSB) * @param index 位索引(0 = LSB, 7 = MSB)
* @param value 要设置的布尔值 * @param value 要设置的布尔值
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内 * @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
*/ */
operator fun set(index: Int, value: Boolean) { operator fun set(index: Int, value: Boolean) {
when (index) { when (index) {
0 -> b0 = value 0 -> b0 = value
1 -> b1 = value 1 -> b1 = value
2 -> b2 = value 2 -> b2 = value
3 -> b3 = value 3 -> b3 = value
4 -> b4 = value 4 -> b4 = value
5 -> b5 = value 5 -> b5 = value
6 -> b6 = value 6 -> b6 = value
7 -> b7 = value 7 -> b7 = value
else -> throw IndexOutOfBoundsException("索引必须在0-7之间") else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
} }
} }
/** /**
* 将所有 8 个位设置为 `true`。 * 将所有 8 个位设置为 `true`。
*/ */
fun setAll() { fun setAll() {
b0 = true b0 = true
b1 = true b1 = true
b2 = true b2 = true
b3 = true b3 = true
b4 = true b4 = true
b5 = true b5 = true
b6 = true b6 = true
b7 = true b7 = true
} }
/** /**
* 将所有 8 个位设置为 `false`。 * 将所有 8 个位设置为 `false`。
*/ */
fun clearAll() { fun clearAll() {
b0 = false b0 = false
b1 = false b1 = false
b2 = false b2 = false
b3 = false b3 = false
b4 = false b4 = false
b5 = false b5 = false
b6 = false b6 = false
b7 = false b7 = false
} }
/** /**
* 对所有位执行逻辑取反(true ↔ false)。 * 对所有位执行逻辑取反(true ↔ false)。
*/ */
fun toggleAll() { fun toggleAll() {
b0 = !b0 b0 = !b0
b1 = !b1 b1 = !b1
b2 = !b2 b2 = !b2
b3 = !b3 b3 = !b3
b4 = !b4 b4 = !b4
b5 = !b5 b5 = !b5
b6 = !b6 b6 = !b6
b7 = !b7 b7 = !b7
} }
/** /**
* 切换指定索引位的状态(true 变 false,反之亦然)。 * 切换指定索引位的状态(true 变 false,反之亦然)。
* *
* @param index 要切换的位索引(0~7) * @param index 要切换的位索引(0~7)
* @throws IndexOutOfBoundsException 如果索引无效 * @throws IndexOutOfBoundsException 如果索引无效
*/ */
fun toggle(index: Int) { fun toggle(index: Int) {
this[index] = !this[index] this[index] = !this[index]
} }
/** /**
* 检查是否所有位都为 `true`。 * 检查是否所有位都为 `true`。
* *
* @return 若全部为 true 则返回 true,否则 false * @return 若全部为 true 则返回 true,否则 false
*/ */
fun allTrue(): Boolean { fun allTrue(): Boolean {
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7 return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
} }
/** /**
* 检查是否所有位都为 `false`。 * 检查是否所有位都为 `false`。
* *
* @return 若全部为 false 则返回 true,否则 false * @return 若全部为 false 则返回 true,否则 false
*/ */
fun allFalse(): Boolean { fun allFalse(): Boolean {
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7 return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
} }
/** /**
* 统计值为 `true` 的位数量。 * 统计值为 `true` 的位数量。
* *
* @return true 位的个数(0~8) * @return true 位的个数(0~8)
*/ */
fun countTrue(): Int { fun countTrue(): Int {
var count = 0 var count = 0
if (b0) count++ if (b0) count++
if (b1) count++ if (b1) count++
if (b2) count++ if (b2) count++
if (b3) count++ if (b3) count++
if (b4) count++ if (b4) count++
if (b5) count++ if (b5) count++
if (b6) count++ if (b6) count++
if (b7) count++ if (b7) count++
return count return count
} }
/** /**
* 统计值为 `false` 的位数量。 * 统计值为 `false` 的位数量。
* *
* @return false 位的个数(0~8) * @return false 位的个数(0~8)
*/ */
fun countFalse(): Int = 8 - countTrue() fun countFalse(): Int = 8 - countTrue()
/** /**
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。 * 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
* *
* 支持别名:`bN` 或 `bitN`(不区分大小写)。 * 支持别名:`bN` 或 `bitN`(不区分大小写)。
* *
* @param name 位的名称(例如 "b0", "BIT5") * @param name 位的名称(例如 "b0", "BIT5")
* @return 对应位的布尔值 * @return 对应位的布尔值
* @throws IllegalArgumentException 如果名称无效 * @throws IllegalArgumentException 如果名称无效
*/ */
fun getByName(name: String): Boolean { fun getByName(name: String): Boolean {
return when (name.lowercase()) { return when (name.lowercase()) {
"b0", "bit0" -> b0 "b0", "bit0" -> b0
"b1", "bit1" -> b1 "b1", "bit1" -> b1
"b2", "bit2" -> b2 "b2", "bit2" -> b2
"b3", "bit3" -> b3 "b3", "bit3" -> b3
"b4", "bit4" -> b4 "b4", "bit4" -> b4
"b5", "bit5" -> b5 "b5", "bit5" -> b5
"b6", "bit6" -> b6 "b6", "bit6" -> b6
"b7", "bit7" -> b7 "b7", "bit7" -> b7
else -> throw IllegalArgumentException("未知的位名称: $name") else -> throw IllegalArgumentException("未知的位名称: $name")
} }
} }
/** /**
* 将当前状态转换为标准二进制字符串(MSB 在前)。 * 将当前状态转换为标准二进制字符串(MSB 在前)。
* *
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001" * 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
* *
* @return 8 位二进制字符串(高位在左) * @return 8 位二进制字符串(高位在左)
*/ */
fun toBinaryString(): String { fun toBinaryString(): String {
return buildString { return buildString {
if (b7) append('1') else append('0') if (b7) append('1') else append('0')
if (b6) append('1') else append('0') if (b6) append('1') else append('0')
if (b5) append('1') else append('0') if (b5) append('1') else append('0')
if (b4) append('1') else append('0') if (b4) append('1') else append('0')
if (b3) append('1') else append('0') if (b3) append('1') else append('0')
if (b2) append('1') else append('0') if (b2) append('1') else append('0')
if (b1) append('1') else append('0') if (b1) append('1') else append('0')
if (b0) append('1') else append('0') if (b0) append('1') else append('0')
} }
} }
/** /**
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。 * 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
* *
* 例如:若值为 10,则返回 "0x0A" * 例如:若值为 10,则返回 "0x0A"
* *
* @return 格式如 "0xXX" 的十六进制字符串 * @return 格式如 "0xXX" 的十六进制字符串
*/ */
fun toHexString(): String { fun toHexString(): String {
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase() return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
} }
/** /**
* 将当前位状态转换为布尔数组。 * 将当前位状态转换为布尔数组。
* *
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。 * 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
* *
* @return 长度为 8 的布尔数组 * @return 长度为 8 的布尔数组
*/ */
fun toBooleanArray(): BooleanArray { fun toBooleanArray(): BooleanArray {
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7) return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
} }
/** /**
* 从布尔数组初始化位状态。 * 从布尔数组初始化位状态。
* *
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。 * 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
* *
* @param array 布尔数组(长度至少为 8) * @param array 布尔数组(长度至少为 8)
* @throws IllegalArgumentException 如果数组长度不足 8 * @throws IllegalArgumentException 如果数组长度不足 8
*/ */
fun fromBooleanArray(array: BooleanArray) { fun fromBooleanArray(array: BooleanArray) {
require(array.size >= 8) { "数组长度至少为8" } require(array.size >= 8) { "数组长度至少为8" }
b0 = array[0] b0 = array[0]
b1 = array[1] b1 = array[1]
b2 = array[2] b2 = array[2]
b3 = array[3] b3 = array[3]
b4 = array[4] b4 = array[4]
b5 = array[5] b5 = array[5]
b6 = array[6] b6 = array[6]
b7 = array[7] b7 = array[7]
} }
/** /**
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。 * 对两个 [ByteFlags] 执行按位“与”操作(AND)。
* *
* 结果的每一位 = this位 && other位 * 结果的每一位 = this位 && other位
* *
* @param other 另一个 ByteFlags 实例 * @param other 另一个 ByteFlags 实例
* @return 新的 ByteFlags 实例,表示 AND 结果 * @return 新的 ByteFlags 实例,表示 AND 结果
*/ */
infix fun and(other: ByteFlags): ByteFlags { infix fun and(other: ByteFlags): ByteFlags {
return ByteFlags( return ByteFlags(
this.b0 && other.b0, this.b0 && other.b0,
this.b1 && other.b1, this.b1 && other.b1,
this.b2 && other.b2, this.b2 && other.b2,
this.b3 && other.b3, this.b3 && other.b3,
this.b4 && other.b4, this.b4 && other.b4,
this.b5 && other.b5, this.b5 && other.b5,
this.b6 && other.b6, this.b6 && other.b6,
this.b7 && other.b7 this.b7 && other.b7
) )
} }
/** /**
* 对两个 [ByteFlags] 执行按位“或”操作(OR)。 * 对两个 [ByteFlags] 执行按位“或”操作(OR)。
* *
* 结果的每一位 = this位 || other位 * 结果的每一位 = this位 || other位
* *
* @param other 另一个 ByteFlags 实例 * @param other 另一个 ByteFlags 实例
* @return 新的 ByteFlags 实例,表示 OR 结果 * @return 新的 ByteFlags 实例,表示 OR 结果
*/ */
infix fun or(other: ByteFlags): ByteFlags { infix fun or(other: ByteFlags): ByteFlags {
return ByteFlags( return ByteFlags(
this.b0 || other.b0, this.b0 || other.b0,
this.b1 || other.b1, this.b1 || other.b1,
this.b2 || other.b2, this.b2 || other.b2,
this.b3 || other.b3, this.b3 || other.b3,
this.b4 || other.b4, this.b4 || other.b4,
this.b5 || other.b5, this.b5 || other.b5,
this.b6 || other.b6, this.b6 || other.b6,
this.b7 || other.b7 this.b7 || other.b7
) )
} }
/** /**
* 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。 * 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。
* *
* 结果的每一位 = this位 != other位 * 结果的每一位 = this位 != other位
* *
* @param other 另一个 ByteFlags 实例 * @param other 另一个 ByteFlags 实例
* @return 新的 ByteFlags 实例,表示 XOR 结果 * @return 新的 ByteFlags 实例,表示 XOR 结果
*/ */
infix fun xor(other: ByteFlags): ByteFlags { infix fun xor(other: ByteFlags): ByteFlags {
return ByteFlags( return ByteFlags(
this.b0 != other.b0, this.b0 != other.b0,
this.b1 != other.b1, this.b1 != other.b1,
this.b2 != other.b2, this.b2 != other.b2,
this.b3 != other.b3, this.b3 != other.b3,
this.b4 != other.b4, this.b4 != other.b4,
this.b5 != other.b5, this.b5 != other.b5,
this.b6 != other.b6, this.b6 != other.b6,
this.b7 != other.b7 this.b7 != other.b7
) )
} }
/** /**
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。 * 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
* *
* 每一位取反。 * 每一位取反。
* *
* @return 新的 ByteFlags 实例,所有位取反 * @return 新的 ByteFlags 实例,所有位取反
*/ */
operator fun not(): ByteFlags { operator fun not(): ByteFlags {
return ByteFlags( return ByteFlags(
!b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7 !b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7
) )
} }
/** /**
* 返回可读的字符串表示,包含二进制和十六进制形式。 * 返回可读的字符串表示,包含二进制和十六进制形式。
* *
* 示例:`ByteFlags(10100001 = 0xA1)` * 示例:`ByteFlags(10100001 = 0xA1)`
* *
* @return 字符串描述 * @return 字符串描述
*/ */
override fun toString(): String { override fun toString(): String {
return "ByteFlags(${toBinaryString()} = ${toHexString()})" return "ByteFlags(${toBinaryString()} = ${toHexString()})"
} }
companion object { companion object {
/** /**
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。 * 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
* *
* @return 全 1 的 ByteFlags(值为 0xFF) * @return 全 1 的 ByteFlags(值为 0xFF)
*/ */
fun allTrue(): ByteFlags { fun allTrue(): ByteFlags {
return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true) return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true)
} }
/** /**
* 创建一个所有位均为 `false` 的 [ByteFlags] 实例。 * 创建一个所有位均为 `false` 的 [ByteFlags] 实例。
* *
* @return 全 0 的 ByteFlags(值为 0x00) * @return 全 0 的 ByteFlags(值为 0x00)
*/ */
fun allFalse(): ByteFlags { fun allFalse(): ByteFlags {
return ByteFlags() return ByteFlags()
} }
/** /**
* 从 8 位二进制字符串创建 [ByteFlags] 实例。 * 从 8 位二进制字符串创建 [ByteFlags] 实例。
* *
* 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。 * 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。
* *
* @param binary 8 位二进制字符串(仅含 '0' 和 '1') * @param binary 8 位二进制字符串(仅含 '0' 和 '1')
* @return 对应的 ByteFlags 实例 * @return 对应的 ByteFlags 实例
* @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符 * @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符
*/ */
fun fromBinaryString(binary: String): ByteFlags { fun fromBinaryString(binary: String): ByteFlags {
require(binary.length == 8) { "二进制字符串长度必须为8" } require(binary.length == 8) { "二进制字符串长度必须为8" }
require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" } require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" }
return ByteFlags( return ByteFlags(
binary[7] == '1', // b0 是最低位(对应字符串最后一位) binary[7] == '1', // b0 是最低位(对应字符串最后一位)
binary[6] == '1', binary[6] == '1',
binary[5] == '1', binary[5] == '1',
binary[4] == '1', binary[4] == '1',
binary[3] == '1', binary[3] == '1',
binary[2] == '1', binary[2] == '1',
binary[1] == '1', binary[1] == '1',
binary[0] == '1' // b7 是最高位(对应字符串第一位) binary[0] == '1' // b7 是最高位(对应字符串第一位)
) )
} }
/** /**
* 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。 * 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。
* *
* @param value 输入整数 * @param value 输入整数
* @return 对应的 ByteFlags 实例 * @return 对应的 ByteFlags 实例
*/ */
fun fromInt(value: Int): ByteFlags { fun fromInt(value: Int): ByteFlags {
return ByteFlags((value and 0xFF).toByte()) return ByteFlags((value and 0xFF).toByte())
} }
} }
} }
@@ -87,8 +87,8 @@ const val ESC_RESERVED: Byte = 0x06
* @return 包含每个字节对应十六进制字符串的列表 * @return 包含每个字节对应十六进制字符串的列表
*/ */
fun ByteArray.getByteArrayString(): MutableList<String> { fun ByteArray.getByteArrayString(): MutableList<String> {
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) } return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
.collect(SuperStream.toListCollector()) as MutableList<String> .collect(SuperStream.toListCollector()) as MutableList<String>
} }
@@ -99,12 +99,12 @@ fun ByteArray.getByteArrayString(): MutableList<String> {
* @throws NumberFormatException 当字符不是有效的十六进制字符时抛出 * @throws NumberFormatException 当字符不是有效的十六进制字符时抛出
*/ */
fun Char.hexDigitToValue(): Int { fun Char.hexDigitToValue(): Int {
return when (this) { return when (this) {
in '0'..'9' -> this - '0' in '0'..'9' -> this - '0'
in 'A'..'F' -> this - 'A' + 10 in 'A'..'F' -> this - 'A' + 10
in 'a'..'f' -> this - 'a' + 10 in 'a'..'f' -> this - 'a' + 10
else -> throw NumberFormatException("Invalid hex character: $this") else -> throw NumberFormatException("Invalid hex character: $this")
} }
} }
/** /**
@@ -114,7 +114,7 @@ fun Char.hexDigitToValue(): Int {
* @return 转换后的字节数组 * @return 转换后的字节数组
*/ */
fun hexStringToByteArray(string: String): ByteArray { fun hexStringToByteArray(string: String): ByteArray {
return string.hexToByteArray() return string.hexToByteArray()
} }
@@ -125,5 +125,5 @@ fun hexStringToByteArray(string: String): ByteArray {
* @return 对应的十六进制字符串 * @return 对应的十六进制字符串
*/ */
fun bytesToHex(bytes: ByteArray): String { fun bytesToHex(bytes: ByteArray): String {
return BaseType.BASE16.encode(bytes) return BaseType.BASE16.encode(bytes)
} }
@@ -41,23 +41,23 @@ import java.io.OutputStream
*/ */
@Throws(IOException::class) @Throws(IOException::class)
fun InputStream.readVarNumber(size: Int = 8): Long { fun InputStream.readVarNumber(size: Int = 8): Long {
var numRead = 0 var numRead = 0
var result: Long = 0 var result: Long = 0
var read: Byte var read: Byte
do { do {
read = this.read().let { read = this.read().let {
if (it == -1) { if (it == -1) {
throw IOException("Reached end of stream") throw IOException("Reached end of stream")
} }
it.toByte() it.toByte()
} }
result = result or ((read.toLong() and 127) shl (7 * numRead)) result = result or ((read.toLong() and 127) shl (7 * numRead))
numRead++ numRead++
if (numRead > size) { if (numRead > size) {
throw IOException("VarNumber is too big") throw IOException("VarNumber is too big")
} }
} while ((read.toLong() and 128) != 0L) } while ((read.toLong() and 128) != 0L)
return result return result
} }
/** /**
@@ -102,20 +102,20 @@ fun InputStream.readVarLong(): Long = this.readVarNumber()
*/ */
@Throws(IOException::class) @Throws(IOException::class)
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) { fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
var v = value var v = value
var numWritten = 0 var numWritten = 0
while (v >= 0x80 && numWritten < size - 1) { while (v >= 0x80 && numWritten < size - 1) {
this.write((v and 0x7F or 0x80).toInt()) this.write((v and 0x7F or 0x80).toInt())
v = v ushr 7 v = v ushr 7
numWritten++ numWritten++
} }
if (numWritten >= size) { if (numWritten >= size) {
throw IOException("VarNumber is too big") throw IOException("VarNumber is too big")
} }
this.write(v.toInt()) this.write(v.toInt())
} }
/** /**
@@ -30,33 +30,33 @@ import java.io.*
@JvmName("_inline_deepClone") @JvmName("_inline_deepClone")
inline fun <reified T : Serializable> T.deepClone(): T { inline fun <reified T : Serializable> T.deepClone(): T {
return deepClone(this) return deepClone(this)
} }
inline fun <reified T> T.deepJsonClone(): T { inline fun <reified T> T.deepJsonClone(): T {
try { try {
return JSONA.convert(this as Any, this!!.javaClass) as T return JSONA.convert(this as Any, this!!.javaClass) as T
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException( throw JsonException(
"Failed to deep clone object using JSON", e "Failed to deep clone object using JSON", e
) )
} }
} }
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
fun <T : Serializable?> deepClone(obj: T): T { fun <T : Serializable?> deepClone(obj: T): T {
try { try {
val bao = ByteArrayOutputStream() val bao = ByteArrayOutputStream()
val oos = ObjectOutputStream(bao) val oos = ObjectOutputStream(bao)
oos.writeObject(obj) oos.writeObject(obj)
val bis = ByteArrayInputStream( val bis = ByteArrayInputStream(
bao.toByteArray() bao.toByteArray()
) )
val ois = ObjectInputStream(bis) val ois = ObjectInputStream(bis)
return ois.readObject() as T return ois.readObject() as T
} catch (e: IOException) { } catch (e: IOException) {
throw RuntimeException(e) throw RuntimeException(e)
} catch (e: ClassNotFoundException) { } catch (e: ClassNotFoundException) {
throw RuntimeException(e) throw RuntimeException(e)
} }
} }
@@ -36,7 +36,7 @@ import java.util.stream.Collectors
* @return 转换后的数组 * @return 转换后的数组
*/ */
inline fun <reified T> Collection<T>.toArray(): Array<T> { inline fun <reified T> Collection<T>.toArray(): Array<T> {
return arrayOf(*this.toTypedArray()) return arrayOf(*this.toTypedArray())
} }
/** /**
@@ -49,11 +49,11 @@ inline fun <reified T> Collection<T>.toArray(): Array<T> {
*/ */
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> { inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
return this.stream().collect( return this.stream().collect(
SuperStream.toMap( SuperStream.toMap(
v v
) )
) as Map<T, V> ) as Map<T, V>
} }
/** /**
@@ -67,11 +67,11 @@ inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
* @return 转换后的 Map * @return 转换后的 Map
*/ */
inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> { inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> {
return this.stream().collect( return this.stream().collect(
Collectors.toMap( Collectors.toMap(
k, v k, v
) )
) )
} }
/** /**
@@ -82,7 +82,7 @@ inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline
* @return 转换后的 Set * @return 转换后的 Set
*/ */
fun <T> toSet(array: Array<T>): Set<T> { fun <T> toSet(array: Array<T>): Set<T> {
return array.toSet() return array.toSet()
} }
@@ -93,13 +93,13 @@ fun <T> toSet(array: Array<T>): Set<T> {
* @return 第一个元素或 null * @return 第一个元素或 null
*/ */
inline fun <reified T> Collection<T>.getFirst(): T? { inline fun <reified T> Collection<T>.getFirst(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
if (this is MutableList<T>) { if (this is MutableList<T>) {
return this.first() return this.first()
} }
return this.iterator().next() return this.iterator().next()
} }
/** /**
@@ -109,10 +109,10 @@ inline fun <reified T> Collection<T>.getFirst(): T? {
* @return 第一个元素或 null * @return 第一个元素或 null
*/ */
inline fun <reified T> Array<T>.getFirst(): T? { inline fun <reified T> Array<T>.getFirst(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
return this.first() return this.first()
} }
/** /**
@@ -122,17 +122,17 @@ inline fun <reified T> Array<T>.getFirst(): T? {
* @return 最后一个元素或 null * @return 最后一个元素或 null
*/ */
inline fun <reified T> Collection<T>.getLast(): T? { inline fun <reified T> Collection<T>.getLast(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
if (this is MutableList<T>) { if (this is MutableList<T>) {
return this.last() return this.last()
} }
var lastElement: T? = null var lastElement: T? = null
for (element in this) { for (element in this) {
lastElement = element lastElement = element
} }
return lastElement return lastElement
} }
/** /**
@@ -142,10 +142,10 @@ inline fun <reified T> Collection<T>.getLast(): T? {
* @return 最后一个元素或 null * @return 最后一个元素或 null
*/ */
inline fun <reified T> Array<T>.getLast(): T? { inline fun <reified T> Array<T>.getLast(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
return this.last() return this.last()
} }
@@ -158,22 +158,22 @@ inline fun <reified T> Array<T>.getLast(): T? {
* @return 指定索引处的元素或默认值 * @return 指定索引处的元素或默认值
*/ */
inline fun <reified T> Collection<T>.getOrDefault( inline fun <reified T> Collection<T>.getOrDefault(
index: Int, defaultValue: T index: Int, defaultValue: T,
): T { ): T {
if (!(!this.isEmpty() && index < this.size)) { if (!(!this.isEmpty() && index < this.size)) {
return defaultValue return defaultValue
} }
if (this is List<T>) { if (this is List<T>) {
return this[index] return this[index]
} }
var i = 0 var i = 0
for (element in this) { for (element in this) {
if (i == index) { if (i == index) {
return element return element
} }
i++ i++
} }
return defaultValue return defaultValue
} }
/** /**
@@ -183,7 +183,7 @@ inline fun <reified T> Collection<T>.getOrDefault(
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(): ArrayList<T> { fun <T> newArrayList(): ArrayList<T> {
return ArrayList() return ArrayList()
} }
/** /**
@@ -194,7 +194,7 @@ fun <T> newArrayList(): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(size: Int): ArrayList<T> { fun <T> newArrayList(size: Int): ArrayList<T> {
return ArrayList() return ArrayList()
} }
/** /**
@@ -205,7 +205,7 @@ fun <T> newArrayList(size: Int): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(vararg elements: T): ArrayList<T> { fun <T> newArrayList(vararg elements: T): ArrayList<T> {
return newArrayList(elements.asList()) return newArrayList(elements.asList())
} }
/** /**
@@ -215,7 +215,7 @@ fun <T> newArrayList(vararg elements: T): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> Collection<T>.newArrayLists(): ArrayList<T> { fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
return newArrayList(this) return newArrayList(this)
} }
/** /**
@@ -226,7 +226,7 @@ fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayLists(elements: Array<T>): ArrayList<T> { fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
return newArrayList(elements.asList()) return newArrayList(elements.asList())
} }
/** /**
@@ -237,7 +237,7 @@ fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(elements: Collection<T>): ArrayList<T> { fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -248,7 +248,7 @@ fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> { fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
return newArrayList(elements.toList()) return newArrayList(elements.toList())
} }
/** /**
@@ -259,7 +259,7 @@ fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> { fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
return newArrayList(elements.toList()) return newArrayList(elements.toList())
} }
/** /**
@@ -269,7 +269,7 @@ fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(): LinkedList<T> { fun <T> newLinkedList(): LinkedList<T> {
return LinkedList() return LinkedList()
} }
/** /**
@@ -280,9 +280,9 @@ fun <T> newLinkedList(): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(vararg elements: T): LinkedList<T> { fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
val list = newLinkedList<T>() val list = newLinkedList<T>()
list.addAll(elements.asList()) list.addAll(elements.asList())
return list return list
} }
/** /**
@@ -293,9 +293,9 @@ fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> { fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
val list = newLinkedList<T>() val list = newLinkedList<T>()
list.addAll(elements) list.addAll(elements)
return list return list
} }
/** /**
@@ -306,11 +306,11 @@ fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> { fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
val list = newLinkedList<T>() val list = newLinkedList<T>()
for (element in elements) { for (element in elements) {
list.add(element) list.add(element)
} }
return list return list
} }
/** /**
@@ -321,7 +321,7 @@ fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> { fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
return newLinkedList(elements.toList()) return newLinkedList(elements.toList())
} }
/** /**
@@ -331,7 +331,7 @@ fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(): Vector<T> { fun <T> newVector(): Vector<T> {
return Vector() return Vector()
} }
/** /**
@@ -342,9 +342,9 @@ fun <T> newVector(): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(vararg elements: T): Vector<T> { fun <T> newVector(vararg elements: T): Vector<T> {
val vector = newVector<T>() val vector = newVector<T>()
vector.addAll(elements.asList()) vector.addAll(elements.asList())
return vector return vector
} }
/** /**
@@ -355,9 +355,9 @@ fun <T> newVector(vararg elements: T): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(elements: Collection<T>): Vector<T> { fun <T> newVector(elements: Collection<T>): Vector<T> {
val vector = newVector<T>() val vector = newVector<T>()
vector.addAll(elements) vector.addAll(elements)
return vector return vector
} }
/** /**
@@ -368,11 +368,11 @@ fun <T> newVector(elements: Collection<T>): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(elements: Iterable<T>): Vector<T> { fun <T> newVector(elements: Iterable<T>): Vector<T> {
val vector = newVector<T>() val vector = newVector<T>()
for (element in elements) { for (element in elements) {
vector.add(element) vector.add(element)
} }
return vector return vector
} }
/** /**
@@ -383,7 +383,7 @@ fun <T> newVector(elements: Iterable<T>): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(elements: Sequence<T>): Vector<T> { fun <T> newVector(elements: Sequence<T>): Vector<T> {
return newVector(elements.toList()) return newVector(elements.toList())
} }
@@ -394,7 +394,7 @@ fun <T> newVector(elements: Sequence<T>): Vector<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(): HashSet<T> { fun <T> newHashSet(): HashSet<T> {
return HashSet() return HashSet()
} }
/** /**
@@ -405,7 +405,7 @@ fun <T> newHashSet(): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(size: Int): HashSet<T> { fun <T> newHashSet(size: Int): HashSet<T> {
return HashSet(size) return HashSet(size)
} }
/** /**
@@ -416,9 +416,9 @@ fun <T> newHashSet(size: Int): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(vararg elements: T): HashSet<T> { fun <T> newHashSet(vararg elements: T): HashSet<T> {
val set = newHashSet<T>() val set = newHashSet<T>()
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -429,9 +429,9 @@ fun <T> newHashSet(vararg elements: T): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(elements: Collection<T>): HashSet<T> { fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
val set = newHashSet<T>() val set = newHashSet<T>()
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -442,11 +442,11 @@ fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(elements: Iterable<T>): HashSet<T> { fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
val set = newHashSet<T>() val set = newHashSet<T>()
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -457,7 +457,7 @@ fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(elements: Sequence<T>): HashSet<T> { fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
return newHashSet(elements.toSet()) return newHashSet(elements.toSet())
} }
/** /**
@@ -467,7 +467,7 @@ fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(): LinkedHashSet<T> { fun <T> newLinkedHashSet(): LinkedHashSet<T> {
return LinkedHashSet() return LinkedHashSet()
} }
/** /**
@@ -478,7 +478,7 @@ fun <T> newLinkedHashSet(): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> { fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
return LinkedHashSet(size) return LinkedHashSet(size)
} }
/** /**
@@ -489,9 +489,9 @@ fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> { fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
val set = newLinkedHashSet<T>() val set = newLinkedHashSet<T>()
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -502,9 +502,9 @@ fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> { fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
val set = newLinkedHashSet<T>() val set = newLinkedHashSet<T>()
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -515,11 +515,11 @@ fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> { fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
val set = newLinkedHashSet<T>() val set = newLinkedHashSet<T>()
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -530,7 +530,7 @@ fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> { fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
return newLinkedHashSet(elements.toSet()) return newLinkedHashSet(elements.toSet())
} }
/** /**
@@ -540,7 +540,7 @@ fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
return TreeSet() return TreeSet()
} }
/** /**
@@ -551,9 +551,9 @@ fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
val set = newTreeSet<T>() val set = newTreeSet<T>()
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -564,9 +564,9 @@ fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
val set = newTreeSet<T>() val set = newTreeSet<T>()
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -577,11 +577,11 @@ fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
val set = newTreeSet<T>() val set = newTreeSet<T>()
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -592,7 +592,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
return newTreeSet(elements.toSet()) return newTreeSet(elements.toSet())
} }
@@ -603,7 +603,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: ByteArray): ArrayList<Byte> { fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -613,7 +613,7 @@ fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: ShortArray): ArrayList<Short> { fun newArrayLists(elements: ShortArray): ArrayList<Short> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -623,7 +623,7 @@ fun newArrayLists(elements: ShortArray): ArrayList<Short> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: IntArray): ArrayList<Int> { fun newArrayLists(elements: IntArray): ArrayList<Int> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -633,7 +633,7 @@ fun newArrayLists(elements: IntArray): ArrayList<Int> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: LongArray): ArrayList<Long> { fun newArrayLists(elements: LongArray): ArrayList<Long> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -643,7 +643,7 @@ fun newArrayLists(elements: LongArray): ArrayList<Long> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: FloatArray): ArrayList<Float> { fun newArrayLists(elements: FloatArray): ArrayList<Float> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -653,7 +653,7 @@ fun newArrayLists(elements: FloatArray): ArrayList<Float> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: DoubleArray): ArrayList<Double> { fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -663,7 +663,7 @@ fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> { fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -673,7 +673,7 @@ fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: CharArray): ArrayList<Char> { fun newArrayLists(elements: CharArray): ArrayList<Char> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -683,7 +683,7 @@ fun newArrayLists(elements: CharArray): ArrayList<Char> {
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList() return java.util.concurrent.CopyOnWriteArrayList()
} }
/** /**
@@ -694,7 +694,7 @@ fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T>
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList(elements.asList()) return java.util.concurrent.CopyOnWriteArrayList(elements.asList())
} }
/** /**
@@ -705,7 +705,7 @@ fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOn
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList(elements) return java.util.concurrent.CopyOnWriteArrayList(elements)
} }
/** /**
@@ -715,7 +715,7 @@ fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.C
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> newStack(): Stack<T> { fun <T> newStack(): Stack<T> {
return Stack() return Stack()
} }
/** /**
@@ -726,9 +726,9 @@ fun <T> newStack(): Stack<T> {
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> newStack(vararg elements: T): Stack<T> { fun <T> newStack(vararg elements: T): Stack<T> {
val stack = newStack<T>() val stack = newStack<T>()
stack.addAll(elements.asList()) stack.addAll(elements.asList())
return stack return stack
} }
/** /**
@@ -739,9 +739,9 @@ fun <T> newStack(vararg elements: T): Stack<T> {
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> newStack(elements: Collection<T>): Stack<T> { fun <T> newStack(elements: Collection<T>): Stack<T> {
val stack = newStack<T>() val stack = newStack<T>()
stack.addAll(elements) stack.addAll(elements)
return stack return stack
} }
@@ -753,7 +753,7 @@ fun <T> newStack(elements: Collection<T>): Stack<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
return TreeSet(comparator) return TreeSet(comparator)
} }
/** /**
@@ -765,9 +765,9 @@ fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
val set = newTreeSet(comparator) val set = newTreeSet(comparator)
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -779,9 +779,9 @@ fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> {
val set = newTreeSet(comparator) val set = newTreeSet(comparator)
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -793,11 +793,11 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> {
val set = newTreeSet(comparator) val set = newTreeSet(comparator)
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -809,7 +809,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T>
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> {
return newTreeSet(comparator, elements.toSet()) return newTreeSet(comparator, elements.toSet())
} }
/** /**
@@ -819,7 +819,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T>
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList(this) return java.util.concurrent.CopyOnWriteArrayList(this)
} }
/** /**
@@ -829,9 +829,9 @@ fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWri
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> Collection<T>.newStacks(): Stack<T> { fun <T> Collection<T>.newStacks(): Stack<T> {
val stack = Stack<T>() val stack = Stack<T>()
stack.addAll(this) stack.addAll(this)
return stack return stack
} }
/** /**
@@ -841,9 +841,9 @@ fun <T> Collection<T>.newStacks(): Stack<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> { fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
val set = TreeSet<T>() val set = TreeSet<T>()
set.addAll(this) set.addAll(this)
return set return set
} }
/** /**
@@ -854,9 +854,9 @@ fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> { fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
val set = TreeSet(comparator) val set = TreeSet(comparator)
set.addAll(this) set.addAll(this)
return set return set
} }
/** /**
@@ -866,11 +866,11 @@ fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
* @return 转换后的字节数组 * @return 转换后的字节数组
*/ */
fun toArray(list: List<Byte>): ByteArray { fun toArray(list: List<Byte>): ByteArray {
val arr = ByteArray(list.size) val arr = ByteArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
@@ -881,11 +881,11 @@ fun toArray(list: List<Byte>): ByteArray {
* @return 转换后的短整型数组 * @return 转换后的短整型数组
*/ */
fun toArray(list: List<Short>): ShortArray { fun toArray(list: List<Short>): ShortArray {
val arr = ShortArray(list.size) val arr = ShortArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -895,11 +895,11 @@ fun toArray(list: List<Short>): ShortArray {
* @return 转换后的整型数组 * @return 转换后的整型数组
*/ */
fun toArray(list: List<Int>): IntArray { fun toArray(list: List<Int>): IntArray {
val arr = IntArray(list.size) val arr = IntArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -909,11 +909,11 @@ fun toArray(list: List<Int>): IntArray {
* @return 转换后的长整型数组 * @return 转换后的长整型数组
*/ */
fun toArray(list: List<Long>): LongArray { fun toArray(list: List<Long>): LongArray {
val arr = LongArray(list.size) val arr = LongArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -923,11 +923,11 @@ fun toArray(list: List<Long>): LongArray {
* @return 转换后的浮点数组 * @return 转换后的浮点数组
*/ */
fun toArray(list: List<Float>): FloatArray { fun toArray(list: List<Float>): FloatArray {
val arr = FloatArray(list.size) val arr = FloatArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -937,11 +937,11 @@ fun toArray(list: List<Float>): FloatArray {
* @return 转换后的双精度浮点数组 * @return 转换后的双精度浮点数组
*/ */
fun toArray(list: List<Double>): DoubleArray { fun toArray(list: List<Double>): DoubleArray {
val arr = DoubleArray(list.size) val arr = DoubleArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -951,11 +951,11 @@ fun toArray(list: List<Double>): DoubleArray {
* @return 转换后的布尔数组 * @return 转换后的布尔数组
*/ */
fun toArray(list: List<Boolean>): BooleanArray { fun toArray(list: List<Boolean>): BooleanArray {
val arr = BooleanArray(list.size) val arr = BooleanArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -965,11 +965,11 @@ fun toArray(list: List<Boolean>): BooleanArray {
* @return 转换后的字符数组 * @return 转换后的字符数组
*/ */
fun toArray(list: List<Char>): CharArray { fun toArray(list: List<Char>): CharArray {
val arr = CharArray(list.size) val arr = CharArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
@@ -981,13 +981,13 @@ fun toArray(list: List<Char>): CharArray {
* @return 转换后的数组 * @return 转换后的数组
*/ */
inline fun <reified T> toArray(list: List<T>): Array<T> { inline fun <reified T> toArray(list: List<T>): Array<T> {
if (list.isEmpty()) if (list.isEmpty())
return arrayOf<T>() return arrayOf<T>()
return SuperStream.of<T>(list) return SuperStream.of<T>(list)
.toArray(T::class.java) .toArray(T::class.java)
} }
fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> { fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> {
return SuperStream.of<T>(list) return SuperStream.of<T>(list)
.toArray(clazz) .toArray(clazz)
} }
@@ -34,68 +34,68 @@ import java.util.concurrent.atomic.AtomicReference
*/ */
class IsChanged<T> { class IsChanged<T> {
/** /**
* 使用 AtomicReference 来保证对数据的原子操作 * 使用 AtomicReference 来保证对数据的原子操作
*/ */
private val atomicReferenceData: AtomicReference<T> = AtomicReference() private val atomicReferenceData: AtomicReference<T> = AtomicReference()
constructor() constructor()
/** /**
* 带参数的构造函数,使用指定的初始值初始化 * 带参数的构造函数,使用指定的初始值初始化
* *
* @param data 初始数据值 * @param data 初始数据值
*/ */
constructor(data: T) : super() { constructor(data: T) : super() {
atomicReferenceData.set(data) atomicReferenceData.set(data)
} }
/** /**
* 设置新的数据值,不检查是否发生变化 * 设置新的数据值,不检查是否发生变化
* *
* @param data 要设置的新数据值 * @param data 要设置的新数据值
*/ */
fun set(data: T) { fun set(data: T) {
atomicReferenceData.set(data) atomicReferenceData.set(data)
} }
/** /**
* 获取当前数据值 * 获取当前数据值
* *
* @return 当前数据值 * @return 当前数据值
*/ */
fun get(): T { fun get(): T {
return atomicReferenceData.get() return atomicReferenceData.get()
} }
/** /**
* 设置新的数据值并返回旧的数据值 * 设置新的数据值并返回旧的数据值
* *
* @param data 要设置的新数据值 * @param data 要设置的新数据值
* @return 设置前的旧数据值 * @return 设置前的旧数据值
*/ */
fun setAndGet(data: T): T { fun setAndGet(data: T): T {
return atomicReferenceData.getAndSet(data) return atomicReferenceData.getAndSet(data)
} }
/** /**
* 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false * 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false
* 使用 CAS(Compare-And-Swap) 操作确保线程安全 * 使用 CAS(Compare-And-Swap) 操作确保线程安全
* *
* @param data 要设置的新数据值 * @param data 要设置的新数据值
* @return 如果值发生变化返回 true,否则返回 false * @return 如果值发生变化返回 true,否则返回 false
*/ */
fun setAndChanged(data: T): Boolean { fun setAndChanged(data: T): Boolean {
var currentData: T var currentData: T
do { do {
currentData = get() currentData = get()
// 如果新值与当前值相等,则认为没有变化,直接返回 false // 如果新值与当前值相等,则认为没有变化,直接返回 false
if (Objects.equals(data, currentData)) { if (Objects.equals(data, currentData)) {
return false return false
} }
// 使用 CAS 操作尝试更新值,如果失败则重试 // 使用 CAS 操作尝试更新值,如果失败则重试
} while (!atomicReferenceData.compareAndSet(currentData, data)) } while (!atomicReferenceData.compareAndSet(currentData, data))
// 成功更新值,返回 true 表示发生了变化 // 成功更新值,返回 true 表示发生了变化
return true return true
} }
} }
@@ -31,10 +31,10 @@ package com.mingliqiye.utils.configuration
*/ */
@Retention(AnnotationRetention.RUNTIME) @Retention(AnnotationRetention.RUNTIME)
@Target( @Target(
AnnotationTarget.TYPE_PARAMETER, AnnotationTarget.TYPE_PARAMETER,
AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.VALUE_PARAMETER,
AnnotationTarget.FIELD, // 添加字段支持 AnnotationTarget.FIELD, // 添加字段支持
AnnotationTarget.PROPERTY // 添加属性支持 AnnotationTarget.PROPERTY // 添加属性支持
) )
annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true) annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true)
@@ -45,7 +45,7 @@ annotation class ConfigurationProp(val name: String = "", val description: Strin
* @return 对应的 setter 方法名。 * @return 对应的 setter 方法名。
*/ */
private fun getSetterName(fieldName: String): String { private fun getSetterName(fieldName: String): String {
return "set" + fieldName.take(1).uppercase() + fieldName.substring(1) return "set" + fieldName.take(1).uppercase() + fieldName.substring(1)
} }
/** /**
@@ -55,7 +55,7 @@ private fun getSetterName(fieldName: String): String {
* @return 对应的 getter 方法名。 * @return 对应的 getter 方法名。
*/ */
private fun getGetterName(fieldName: String): String { private fun getGetterName(fieldName: String): String {
return "get" + fieldName.take(1).uppercase() + fieldName.substring(1) return "get" + fieldName.take(1).uppercase() + fieldName.substring(1)
} }
/** /**
@@ -63,211 +63,211 @@ private fun getGetterName(fieldName: String): String {
*/ */
open class ConfigurationProps { open class ConfigurationProps {
companion object { companion object {
/** /**
* 初始化配置类实例,并根据命令行参数填充其字段。 * 初始化配置类实例,并根据命令行参数填充其字段。
* *
* @param clazz 配置类的 Class 对象。 * @param clazz 配置类的 Class 对象。
* @param args 命令行参数数组。 * @param args 命令行参数数组。
* @return 初始化后的配置类实例。 * @return 初始化后的配置类实例。
*/ */
@JvmStatic @JvmStatic
fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T { fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
val mapsArgs = parseArguments(args) val mapsArgs = parseArguments(args)
val instance = clazz.getDeclaredConstructor().newInstance() val instance = clazz.getDeclaredConstructor().newInstance()
processFields(clazz, instance, mapsArgs) processFields(clazz, instance, mapsArgs)
return instance return instance
} }
/** /**
* 解析命令行参数,将其转换为键值对映射。 * 解析命令行参数,将其转换为键值对映射。
* *
* 支持以下格式: * 支持以下格式:
* - `--key=value` 或 `-k=value`:键值对形式。 * - `--key=value` 或 `-k=value`:键值对形式。
* - `--key value` 或 `-k value`:键和值分开的形式。 * - `--key value` 或 `-k value`:键和值分开的形式。
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。 * - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
* *
* @param args 命令行参数数组。 * @param args 命令行参数数组。
* @return 解析后的键值对映射。 * @return 解析后的键值对映射。
*/ */
private fun parseArguments(args: Array<String>): Map<String, List<String>> { private fun parseArguments(args: Array<String>): Map<String, List<String>> {
val mapsArgs = mutableMapOf<String, MutableList<String>>() val mapsArgs = mutableMapOf<String, MutableList<String>>()
var i = 0 var i = 0
while (i < args.size) { while (i < args.size) {
val arg = args[i] val arg = args[i]
when { when {
arg.startsWith("--") -> { arg.startsWith("--") -> {
// 处理 --key=value 格式 // 处理 --key=value 格式
if (arg.contains("=")) { if (arg.contains("=")) {
val (key, value) = arg.substring(2).split("=", limit = 2) val (key, value) = arg.substring(2).split("=", limit = 2)
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
} }
// 处理 --key value 格式 // 处理 --key value 格式
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) { else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
val key = arg.substring(2) val key = arg.substring(2)
val value = args[i + 1] val value = args[i + 1]
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
i++ // 跳过下一个参数 i++ // 跳过下一个参数
} }
// 处理 --flag 格式的布尔标志 // 处理 --flag 格式的布尔标志
else { else {
val key = arg.substring(2) val key = arg.substring(2)
mapsArgs.getOrPut(key) { mutableListOf() }.add("true") mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
} }
} }
arg.startsWith("-") -> { arg.startsWith("-") -> {
// 处理 -k=value 格式 // 处理 -k=value 格式
if (arg.contains("=")) { if (arg.contains("=")) {
val (key, value) = arg.substring(1).split("=", limit = 2) val (key, value) = arg.substring(1).split("=", limit = 2)
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
} }
// 处理 -k value 格式 // 处理 -k value 格式
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) { else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
val key = arg.substring(1) val key = arg.substring(1)
val value = args[i + 1] val value = args[i + 1]
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
i++ i++
} }
// 处理 -f 格式的布尔标志 // 处理 -f 格式的布尔标志
else { else {
val key = arg.substring(1) val key = arg.substring(1)
mapsArgs.getOrPut(key) { mutableListOf() }.add("true") mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
} }
} }
} }
i++ i++
} }
return mapsArgs return mapsArgs
} }
/** /**
* 处理配置类中的字段,根据解析出的参数设置字段值。 * 处理配置类中的字段,根据解析出的参数设置字段值。
* *
* @param clazz 配置类的 Class 对象。 * @param clazz 配置类的 Class 对象。
* @param instance 配置类的实例。 * @param instance 配置类的实例。
* @param mapsArgs 解析后的命令行参数映射。 * @param mapsArgs 解析后的命令行参数映射。
*/ */
private fun <T : ConfigurationProps> processFields( private fun <T : ConfigurationProps> processFields(
clazz: Class<T>, clazz: Class<T>,
instance: T, instance: T,
mapsArgs: Map<String, List<String>>, mapsArgs: Map<String, List<String>>,
) { ) {
val fields = clazz.declaredFields val fields = clazz.declaredFields
for (field in fields) { for (field in fields) {
val configurationProp = field.getAnnotation(ConfigurationProp::class.java) val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
if (configurationProp != null) { if (configurationProp != null) {
val fieldName = configurationProp.name.ifEmpty { field.name } val fieldName = configurationProp.name.ifEmpty { field.name }
val values = mapsArgs[fieldName] val values = mapsArgs[fieldName]
if (values != null) { if (values != null) {
try { try {
val setter = clazz.getDeclaredMethod( val setter = clazz.getDeclaredMethod(
getSetterName(field.name), getSetterName(field.name),
field.type field.type
) )
val value = convertValue(field.type, values, configurationProp) val value = convertValue(field.type, values, configurationProp)
setter.invoke(instance, value) setter.invoke(instance, value)
} catch (e: Exception) { } catch (e: Exception) {
println("Warning: Failed to set field ${field.name}: ${e.message}") println("Warning: Failed to set field ${field.name}: ${e.message}")
} }
} }
} }
} }
} }
/** /**
* 将字符串值转换为目标类型。 * 将字符串值转换为目标类型。
* *
* @param type 目标类型。 * @param type 目标类型。
* @param values 字符串值列表。 * @param values 字符串值列表。
* @param annotation 配置属性注解。 * @param annotation 配置属性注解。
* @return 转换后的值。 * @return 转换后的值。
*/ */
private fun convertValue( private fun convertValue(
type: Class<*>, type: Class<*>,
values: List<String>, values: List<String>,
annotation: ConfigurationProp, annotation: ConfigurationProp,
): Any? { ): Any? {
val lastValue = values.lastOrNull() ?: return null val lastValue = values.lastOrNull() ?: return null
return when (type) { return when (type) {
String::class.java -> lastValue String::class.java -> lastValue
Integer::class.java, Int::class.java -> try { Integer::class.java, Int::class.java -> try {
lastValue.toInt() lastValue.toInt()
} catch (e: NumberFormatException) { } catch (e: NumberFormatException) {
println("Warning: Invalid integer value '$lastValue'") println("Warning: Invalid integer value '$lastValue'")
null null
} }
Long::class.java, java.lang.Long::class.java -> try { Long::class.java, java.lang.Long::class.java -> try {
lastValue.toLong() lastValue.toLong()
} catch (e: NumberFormatException) { } catch (e: NumberFormatException) {
println("Warning: Invalid long value '$lastValue'") println("Warning: Invalid long value '$lastValue'")
null null
} }
Double::class.java, java.lang.Double::class.java -> try { Double::class.java, java.lang.Double::class.java -> try {
lastValue.toDouble() lastValue.toDouble()
} catch (e: NumberFormatException) { } catch (e: NumberFormatException) {
println("Warning: Invalid double value '$lastValue'") println("Warning: Invalid double value '$lastValue'")
null null
} }
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) { Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
"true", "1", "yes", "on" -> true "true", "1", "yes", "on" -> true
"false", "0", "no", "off" -> false "false", "0", "no", "off" -> false
else -> { else -> {
println("Warning: Invalid boolean value '$lastValue'") println("Warning: Invalid boolean value '$lastValue'")
null null
} }
} }
List::class.java -> values List::class.java -> values
else -> { else -> {
println("Warning: Unsupported type ${type.simpleName}") println("Warning: Unsupported type ${type.simpleName}")
null null
} }
} }
} }
} }
fun printHelp() { fun printHelp() {
val fields = this::class.java.declaredFields val fields = this::class.java.declaredFields
val help = StringBuilder() val help = StringBuilder()
for (field in fields) { for (field in fields) {
val configurationProp = field.getAnnotation(ConfigurationProp::class.java) val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
if (configurationProp != null && configurationProp.showHelper) { if (configurationProp != null && configurationProp.showHelper) {
val fieldName = configurationProp.name.ifEmpty { field.name } val fieldName = configurationProp.name.ifEmpty { field.name }
help.append("$fieldName -> Type: ${field.type.simpleName}") help.append("$fieldName -> Type: ${field.type.simpleName}")
if (configurationProp.description.isNotEmpty()) { if (configurationProp.description.isNotEmpty()) {
help.append(" Description: ${configurationProp.description}") help.append(" Description: ${configurationProp.description}")
} }
help.append("\n") help.append("\n")
} }
} }
println(help) println(help)
} }
val fields: Map<String, Any?> val fields: Map<String, Any?>
get() { get() {
val fields = this::class.java.declaredFields val fields = this::class.java.declaredFields
val fieldValues = mutableMapOf<String, Any?>() val fieldValues = mutableMapOf<String, Any?>()
for (field in fields) { for (field in fields) {
field.isAccessible = true field.isAccessible = true
val fieldName = field.name val fieldName = field.name
val fieldValue = field.get(this) val fieldValue = field.get(this)
fieldValues[fieldName] = fieldValue fieldValues[fieldName] = fieldValue
} }
return fieldValues return fieldValues
} }
} }
@@ -32,67 +32,67 @@ package com.mingliqiye.utils.data
*/ */
class ThreadLocalDataHolder<T> { class ThreadLocalDataHolder<T> {
private val threadLocal: ThreadLocal<T?> = ThreadLocal() private val threadLocal: ThreadLocal<T?> = ThreadLocal()
/** /**
* 获取当前线程存储的值 * 获取当前线程存储的值
* *
* @return 当前线程存储的值,如果没有则返回null * @return 当前线程存储的值,如果没有则返回null
*/ */
fun get(): T? { fun get(): T? {
return threadLocal.get() return threadLocal.get()
} }
/** /**
* 设置当前线程的值 * 设置当前线程的值
* *
* @param value 要存储的值 * @param value 要存储的值
*/ */
fun set(value: T) { fun set(value: T) {
threadLocal.set(value) threadLocal.set(value)
} }
/** /**
* 移除当前线程存储的值 * 移除当前线程存储的值
* *
* 防止内存泄漏,使用完毕后应调用此方法清理资源。 * 防止内存泄漏,使用完毕后应调用此方法清理资源。
*/ */
fun remove() { fun remove() {
threadLocal.remove() threadLocal.remove()
} }
/** /**
* 获取当前线程存储的值,如果不存在则返回默认值 * 获取当前线程存储的值,如果不存在则返回默认值
* *
* @param defaultValue 默认值 * @param defaultValue 默认值
* @return 当前线程存储的值或默认值 * @return 当前线程存储的值或默认值
*/ */
fun getOrDefault(defaultValue: T): T { fun getOrDefault(defaultValue: T): T {
val value = threadLocal.get() val value = threadLocal.get()
return value ?: defaultValue return value ?: defaultValue
} }
/** /**
* 安全获取值(避免NPE) * 安全获取值(避免NPE)
* *
* 在某些异常情况下防止抛出异常,直接返回 null。 * 在某些异常情况下防止抛出异常,直接返回 null。
* *
* @return 值或null * @return 值或null
*/ */
fun safeGet(): T? { fun safeGet(): T? {
return try { return try {
threadLocal.get() threadLocal.get()
} catch (e: Exception) { } catch (e: Exception) {
null null
} }
} }
/** /**
* 检查当前线程是否有值 * 检查当前线程是否有值
* *
* @return 是否有值 * @return 是否有值
*/ */
fun isPresent(): Boolean { fun isPresent(): Boolean {
return threadLocal.get() != null return threadLocal.get() != null
} }
} }
@@ -34,40 +34,40 @@ import java.lang.reflect.Field
* @return 返回一个新的对象实例,其字段值与原对象一致。 * @return 返回一个新的对象实例,其字段值与原对象一致。
*/ */
fun <T : Any> clone(obj: T): T { fun <T : Any> clone(obj: T): T {
val clazz = obj.javaClass val clazz = obj.javaClass
val constructor = clazz.getDeclaredConstructor().apply { val constructor = clazz.getDeclaredConstructor().apply {
isAccessible = true isAccessible = true
} }
val instance = constructor.newInstance() val instance = constructor.newInstance()
// 遍历类及其父类的所有字段进行赋值 // 遍历类及其父类的所有字段进行赋值
var currentClass: Class<*>? = clazz var currentClass: Class<*>? = clazz
while (currentClass != null) { while (currentClass != null) {
currentClass.declaredFields.forEach { field -> currentClass.declaredFields.forEach { field ->
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) { if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
field.isAccessible = true field.isAccessible = true
field.set(instance, field.get(obj)) field.set(instance, field.get(obj))
} }
} }
currentClass = currentClass.superclass currentClass = currentClass.superclass
} }
return instance return instance
} }
/** /**
* 定义 DTO 拷贝行为的枚举类型。 * 定义 DTO 拷贝行为的枚举类型。
*/ */
enum class DotCopyType { enum class DotCopyType {
/** /**
* 表示使用点拷贝(.copy)方式处理字段。 * 表示使用点拷贝(.copy)方式处理字段。
*/ */
DOT_COPY, DOT_COPY,
/** /**
* 表示普通拷贝方式处理字段。 * 表示普通拷贝方式处理字段。
*/ */
COPY COPY
} }
/** /**
@@ -77,10 +77,10 @@ enum class DotCopyType {
*/ */
@Retention(AnnotationRetention.RUNTIME) @Retention(AnnotationRetention.RUNTIME)
@Target( @Target(
AnnotationTarget.TYPE_PARAMETER, AnnotationTarget.TYPE_PARAMETER,
AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.VALUE_PARAMETER,
AnnotationTarget.FIELD, AnnotationTarget.FIELD,
AnnotationTarget.PROPERTY AnnotationTarget.PROPERTY
) )
annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY) annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
@@ -92,40 +92,40 @@ annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
* @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。 * @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。
*/ */
fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R { fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
val instance = dtoClass.getDeclaredConstructor().apply { val instance = dtoClass.getDeclaredConstructor().apply {
isAccessible = true isAccessible = true
}.newInstance() }.newInstance()
val sourceFields = getAllFields(obj.javaClass) val sourceFields = getAllFields(obj.javaClass)
for (sourceField in sourceFields) { for (sourceField in sourceFields) {
sourceField.isAccessible = true sourceField.isAccessible = true
val fieldName = sourceField.name val fieldName = sourceField.name
val fieldValue = sourceField.get(obj) val fieldValue = sourceField.get(obj)
try { try {
val targetField = dtoClass.getDeclaredField(fieldName).apply { val targetField = dtoClass.getDeclaredField(fieldName).apply {
isAccessible = true isAccessible = true
} }
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) { if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
continue continue
} }
val ta = targetField.getAnnotation(DtoCopy::class.java) val ta = targetField.getAnnotation(DtoCopy::class.java)
if (ta != null) { if (ta != null) {
if (ta.type == DotCopyType.DOT_COPY) { if (ta.type == DotCopyType.DOT_COPY) {
continue continue
} }
} }
targetField.set(instance, fieldValue) targetField.set(instance, fieldValue)
} catch (e: NoSuchFieldException) { } catch (e: NoSuchFieldException) {
continue continue
} catch (e: IllegalArgumentException) { } catch (e: IllegalArgumentException) {
continue continue
} }
} }
return instance return instance
} }
/** /**
@@ -135,12 +135,11 @@ fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
* @return 包含所有字段的列表。 * @return 包含所有字段的列表。
*/ */
private fun getAllFields(clazz: Class<*>): List<Field> { private fun getAllFields(clazz: Class<*>): List<Field> {
val fields = mutableListOf<Field>() val fields = mutableListOf<Field>()
var currentClass: Class<*>? = clazz var currentClass: Class<*>? = clazz
while (currentClass != null && currentClass != Any::class.java) { while (currentClass != null && currentClass != Any::class.java) {
fields.addAll(currentClass.declaredFields) fields.addAll(currentClass.declaredFields)
currentClass = currentClass.superclass currentClass = currentClass.superclass
} }
return fields return fields
} }
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class BadGatewayException @JvmOverloads constructor( class BadGatewayException @JvmOverloads constructor(
override val message: String? = "Bad Gateway", override val message: String? = "Bad Gateway",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(502, message, cause) ) : HttpStatusException(502, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class BadRequestException @JvmOverloads constructor( class BadRequestException @JvmOverloads constructor(
override val message: String? = "Bad Request", override val message: String? = "Bad Request",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(400, message, cause) ) : HttpStatusException(400, message, cause)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class CodecException @JvmOverloads constructor( class CodecException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ConflictException @JvmOverloads constructor( class ConflictException @JvmOverloads constructor(
override val message: String? = "Conflict", override val message: String? = "Conflict",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(409, message, cause) ) : HttpStatusException(409, message, cause)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class EmptyJsonException @JvmOverloads constructor( class EmptyJsonException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : JsonException(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ForbiddenException @JvmOverloads constructor( class ForbiddenException @JvmOverloads constructor(
override val message: String? = "Forbidden", override val message: String? = "Forbidden",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(403, message, cause) ) : HttpStatusException(403, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class FoundException @JvmOverloads constructor( class FoundException @JvmOverloads constructor(
override val message: String? = "Found", override val message: String? = "Found",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(302, message, cause) ) : HttpStatusException(302, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class GatewayTimeoutException @JvmOverloads constructor( class GatewayTimeoutException @JvmOverloads constructor(
override val message: String? = "Gateway Timeout", override val message: String? = "Gateway Timeout",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(504, message, cause) ) : HttpStatusException(504, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class GoneException @JvmOverloads constructor( class GoneException @JvmOverloads constructor(
override val message: String? = "Gone", override val message: String? = "Gone",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(410, message, cause) ) : HttpStatusException(410, message, cause)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class HttpException @JvmOverloads constructor( open class HttpException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -30,9 +30,9 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
open class HttpStatusException @JvmOverloads constructor( open class HttpStatusException @JvmOverloads constructor(
val statusCode: Int, val statusCode: Int,
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class HttpUrlException @JvmOverloads constructor( open class HttpUrlException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class HttpVersionNotSupportedException @JvmOverloads constructor( class HttpVersionNotSupportedException @JvmOverloads constructor(
override val message: String? = "HTTP Version Not Supported", override val message: String? = "HTTP Version Not Supported",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(505, message, cause) ) : HttpStatusException(505, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class InternalServerErrorException @JvmOverloads constructor( class InternalServerErrorException @JvmOverloads constructor(
override val message: String? = "Internal Server Error", override val message: String? = "Internal Server Error",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(500, message, cause) ) : HttpStatusException(500, message, cause)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class InvalidJsonException @JvmOverloads constructor( class InvalidJsonException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : JsonException(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
@@ -31,8 +31,8 @@ package com.mingliqiye.utils.exception
* 3. 仅包含原因(Throwable)的构造函数。 * 3. 仅包含原因(Throwable)的构造函数。
*/ */
open class JsonException @JvmOverloads constructor( open class JsonException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonObjectCastException @JvmOverloads constructor( class JsonObjectCastException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : JsonException(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonParserException @JvmOverloads constructor( class JsonParserException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : JsonException(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonTypeException @JvmOverloads constructor( class JsonTypeException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : JsonException(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class LengthRequiredException @JvmOverloads constructor( class LengthRequiredException @JvmOverloads constructor(
override val message: String? = "Length Required", override val message: String? = "Length Required",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(411, message, cause) ) : HttpStatusException(411, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class MethodNotAllowedException @JvmOverloads constructor( class MethodNotAllowedException @JvmOverloads constructor(
override val message: String? = "Method Not Allowed", override val message: String? = "Method Not Allowed",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(405, message, cause) ) : HttpStatusException(405, message, cause)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class MingLiUtilsBaseException @JvmOverloads constructor( open class MingLiUtilsBaseException @JvmOverloads constructor(
message: String? = null, message: String? = null,
cause: Throwable? = null, cause: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : RuntimeException(message, cause, enableSuppression, writableStackTrace) ) : RuntimeException(message, cause, enableSuppression, writableStackTrace)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class MovedPermanentlyException @JvmOverloads constructor( class MovedPermanentlyException @JvmOverloads constructor(
override val message: String? = "Moved Permanently", override val message: String? = "Moved Permanently",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(301, message, cause) ) : HttpStatusException(301, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class MultipleChoicesException @JvmOverloads constructor( class MultipleChoicesException @JvmOverloads constructor(
override val message: String? = "Multiple Choices", override val message: String? = "Multiple Choices",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(300, message, cause) ) : HttpStatusException(300, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotAcceptableException @JvmOverloads constructor( class NotAcceptableException @JvmOverloads constructor(
override val message: String? = "Not Acceptable", override val message: String? = "Not Acceptable",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(406, message, cause) ) : HttpStatusException(406, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotFoundException @JvmOverloads constructor( class NotFoundException @JvmOverloads constructor(
override val message: String? = "Not Found", override val message: String? = "Not Found",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(404, message, cause) ) : HttpStatusException(404, message, cause)
@@ -23,8 +23,8 @@
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class NotFoundResourceException @JvmOverloads constructor( class NotFoundResourceException @JvmOverloads constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = true, writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotImplementedException @JvmOverloads constructor( class NotImplementedException @JvmOverloads constructor(
override val message: String? = "Not Implemented", override val message: String? = "Not Implemented",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(501, message, cause) ) : HttpStatusException(501, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotModifiedException @JvmOverloads constructor( class NotModifiedException @JvmOverloads constructor(
override val message: String? = "Not Modified", override val message: String? = "Not Modified",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(304, message, cause) ) : HttpStatusException(304, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class PaymentRequiredException @JvmOverloads constructor( class PaymentRequiredException @JvmOverloads constructor(
override val message: String? = "Payment Required", override val message: String? = "Payment Required",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(402, message, cause) ) : HttpStatusException(402, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class PreconditionFailedException @JvmOverloads constructor( class PreconditionFailedException @JvmOverloads constructor(
override val message: String? = "Precondition Failed", override val message: String? = "Precondition Failed",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(412, message, cause) ) : HttpStatusException(412, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ProxyAuthenticationRequiredException @JvmOverloads constructor( class ProxyAuthenticationRequiredException @JvmOverloads constructor(
override val message: String? = "Proxy Authentication Required", override val message: String? = "Proxy Authentication Required",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(407, message, cause) ) : HttpStatusException(407, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestEntityTooLargeException @JvmOverloads constructor( class RequestEntityTooLargeException @JvmOverloads constructor(
override val message: String? = "Request Entity Too Large", override val message: String? = "Request Entity Too Large",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(413, message, cause) ) : HttpStatusException(413, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestTimeoutException @JvmOverloads constructor( class RequestTimeoutException @JvmOverloads constructor(
override val message: String? = "Request Timeout", override val message: String? = "Request Timeout",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(408, message, cause) ) : HttpStatusException(408, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestUriTooLargeException @JvmOverloads constructor( class RequestUriTooLargeException @JvmOverloads constructor(
override val message: String? = "Request URI Too Large", override val message: String? = "Request URI Too Large",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(414, message, cause) ) : HttpStatusException(414, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestedRangeNotSatisfiableException @JvmOverloads constructor( class RequestedRangeNotSatisfiableException @JvmOverloads constructor(
override val message: String? = "Requested Range Not Satisfiable", override val message: String? = "Requested Range Not Satisfiable",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(416, message, cause) ) : HttpStatusException(416, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class SeeOtherException @JvmOverloads constructor( class SeeOtherException @JvmOverloads constructor(
override val message: String? = "See Other", override val message: String? = "See Other",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(303, message, cause) ) : HttpStatusException(303, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ServiceUnavailableException @JvmOverloads constructor( class ServiceUnavailableException @JvmOverloads constructor(
override val message: String? = "Service Unavailable", override val message: String? = "Service Unavailable",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(503, message, cause) ) : HttpStatusException(503, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class TemporaryRedirectException @JvmOverloads constructor( class TemporaryRedirectException @JvmOverloads constructor(
override val message: String? = "Temporary Redirect", override val message: String? = "Temporary Redirect",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(307, message, cause) ) : HttpStatusException(307, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class UnauthorizedException @JvmOverloads constructor( class UnauthorizedException @JvmOverloads constructor(
override val message: String? = "Unauthorized", override val message: String? = "Unauthorized",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(401, message, cause) ) : HttpStatusException(401, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class UnsupportedMediaTypeException @JvmOverloads constructor( class UnsupportedMediaTypeException @JvmOverloads constructor(
override val message: String? = "Unsupported Media Type", override val message: String? = "Unsupported Media Type",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(415, message, cause) ) : HttpStatusException(415, message, cause)
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class UseProxyException @JvmOverloads constructor( class UseProxyException @JvmOverloads constructor(
override val message: String? = "Use Proxy", override val message: String? = "Use Proxy",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(305, message, cause) ) : HttpStatusException(305, message, cause)
File diff suppressed because it is too large Load Diff
@@ -35,34 +35,34 @@ import com.mingliqiye.utils.functions.*
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
iterable: Iterable<T>, action: P2Function<in T, in Int> iterable: Iterable<T>, action: P2Function<in T, in Int>,
) { ) {
when (iterable) { when (iterable) {
is RandomAccess if iterable is MutableList<*> -> { is RandomAccess if iterable is MutableList<*> -> {
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能 // 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
action.call(list[i], i) action.call(list[i], i)
} }
} }
is MutableList<*> -> { is MutableList<*> -> {
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引 // 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
var index = 0 var index = 0
val it = iterable.iterator() val it = iterable.iterator()
while (it.hasNext()) { while (it.hasNext()) {
action.call(it.next(), index) action.call(it.next(), index)
index++ index++
} }
} }
else -> { else -> {
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引 // 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
for ((index, element) in iterable.withIndex()) { for ((index, element) in iterable.withIndex()) {
action.call(element, index) action.call(element, index)
} }
} }
} }
} }
/** /**
@@ -74,20 +74,20 @@ fun <T> forEach(
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
iterable: Iterable<T>, action: P1Function<in T> iterable: Iterable<T>, action: P1Function<in T>,
) { ) {
if (iterable is RandomAccess) { if (iterable is RandomAccess) {
// 如果是支持随机访问的列表,则使用索引遍历以提高性能 // 如果是支持随机访问的列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
action.call(list[i]) action.call(list[i])
} }
} else { } else {
// 否则使用增强 for 循环进行遍历 // 否则使用增强 for 循环进行遍历
for (element in iterable) { for (element in iterable) {
action.call(element) action.call(element)
} }
} }
} }
/** /**
@@ -100,36 +100,36 @@ fun <T> forEach(
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean> iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean>,
) { ) {
when (iterable) { when (iterable) {
is RandomAccess if iterable is MutableList<*> -> { is RandomAccess if iterable is MutableList<*> -> {
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能 // 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
if (action.call(list[i], i)) return if (action.call(list[i], i)) return
} }
} }
is MutableList<*> -> { is MutableList<*> -> {
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引 // 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
var index = 0 var index = 0
val it = iterable.iterator() val it = iterable.iterator()
while (it.hasNext()) { while (it.hasNext()) {
if (action.call(it.next(), index)) return if (action.call(it.next(), index)) return
index++ index++
} }
} }
else -> { else -> {
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引 // 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
var index = 0 var index = 0
for (element in iterable) { for (element in iterable) {
if (action.call(element, index)) return if (action.call(element, index)) return
index++ index++
} }
} }
} }
} }
/** /**
@@ -142,20 +142,20 @@ fun <T> forEachB(
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
iterable: Iterable<T>, action: P1RFunction<in T, out Boolean> iterable: Iterable<T>, action: P1RFunction<in T, out Boolean>,
) { ) {
if (iterable is RandomAccess) { if (iterable is RandomAccess) {
// 如果是支持随机访问的列表,则使用索引遍历以提高性能 // 如果是支持随机访问的列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
if (action.call(list[i])) return if (action.call(list[i])) return
} }
} else { } else {
// 否则使用增强 for 循环进行遍历 // 否则使用增强 for 循环进行遍历
for (element in iterable) { for (element in iterable) {
if (action.call(element)) return if (action.call(element)) return
} }
} }
} }
/** /**
@@ -166,9 +166,9 @@ fun <T> forEachB(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
array: Array<T>, action: P2Function<in T, in Int> array: Array<T>, action: P2Function<in T, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -179,9 +179,9 @@ fun <T> forEach(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
array: Array<T>, action: P1Function<in T> array: Array<T>, action: P1Function<in T>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -193,9 +193,9 @@ fun <T> forEach(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
array: Array<T>, action: P2RFunction<in T, in Int, out Boolean> array: Array<T>, action: P2RFunction<in T, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -207,9 +207,9 @@ fun <T> forEachB(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
array: Array<T>, action: P1RFunction<in T, out Boolean> array: Array<T>, action: P1RFunction<in T, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -219,9 +219,9 @@ fun <T> forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: ByteArray, action: P2Function<in Byte, in Int> array: ByteArray, action: P2Function<in Byte, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -231,9 +231,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: ByteArray, action: P1Function<in Byte> array: ByteArray, action: P1Function<in Byte>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -244,9 +244,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean> array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -257,9 +257,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ByteArray, action: P1RFunction<in Byte, out Boolean> array: ByteArray, action: P1RFunction<in Byte, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -269,9 +269,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: CharArray, action: P2Function<in Char, in Int> array: CharArray, action: P2Function<in Char, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -281,9 +281,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: CharArray, action: P1Function<in Char> array: CharArray, action: P1Function<in Char>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -294,9 +294,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: CharArray, action: P2RFunction<in Char, in Int, out Boolean> array: CharArray, action: P2RFunction<in Char, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -307,9 +307,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: CharArray, action: P1RFunction<in Char, out Boolean> array: CharArray, action: P1RFunction<in Char, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -319,9 +319,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: IntArray, action: P2Function<in Int, in Int> array: IntArray, action: P2Function<in Int, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -331,9 +331,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: IntArray, action: P1Function<in Int> array: IntArray, action: P1Function<in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -344,9 +344,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: IntArray, action: P2RFunction<in Int, in Int, out Boolean> array: IntArray, action: P2RFunction<in Int, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -357,9 +357,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: IntArray, action: P1RFunction<in Int, out Boolean> array: IntArray, action: P1RFunction<in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -369,9 +369,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: LongArray, action: P2Function<in Long, in Int> array: LongArray, action: P2Function<in Long, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -381,9 +381,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: LongArray, action: P1Function<in Long> array: LongArray, action: P1Function<in Long>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -394,9 +394,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: LongArray, action: P2RFunction<in Long, in Int, out Boolean> array: LongArray, action: P2RFunction<in Long, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -407,9 +407,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: LongArray, action: P1RFunction<in Long, out Boolean> array: LongArray, action: P1RFunction<in Long, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -419,9 +419,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: ShortArray, action: P2Function<in Short, in Int> array: ShortArray, action: P2Function<in Short, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -431,9 +431,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: ShortArray, action: P1Function<in Short> array: ShortArray, action: P1Function<in Short>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -444,9 +444,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean> array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -457,9 +457,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ShortArray, action: P1RFunction<in Short, out Boolean> array: ShortArray, action: P1RFunction<in Short, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -469,9 +469,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: FloatArray, action: P2Function<in Float, in Int> array: FloatArray, action: P2Function<in Float, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -481,9 +481,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: FloatArray, action: P1Function<in Float> array: FloatArray, action: P1Function<in Float>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -494,9 +494,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean> array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -507,9 +507,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: FloatArray, action: P1RFunction<in Float, out Boolean> array: FloatArray, action: P1RFunction<in Float, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -519,9 +519,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: DoubleArray, action: P2Function<in Double, in Int> array: DoubleArray, action: P2Function<in Double, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -531,9 +531,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: DoubleArray, action: P1Function<in Double> array: DoubleArray, action: P1Function<in Double>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -544,9 +544,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean> array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -557,9 +557,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: DoubleArray, action: P1RFunction<in Double, out Boolean> array: DoubleArray, action: P1RFunction<in Double, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -569,9 +569,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: BooleanArray, action: P2Function<in Boolean, in Int> array: BooleanArray, action: P2Function<in Boolean, in Int>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -581,9 +581,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: BooleanArray, action: P1Function<in Boolean> array: BooleanArray, action: P1Function<in Boolean>,
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -594,9 +594,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean> array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -607,9 +607,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: BooleanArray, action: P1RFunction<in Boolean, out Boolean> array: BooleanArray, action: P1RFunction<in Boolean, out Boolean>,
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -623,9 +623,9 @@ fun forEachB(
* @param <A> 集合的具体类型 * @param <A> 集合的具体类型
*/ */
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB( fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
array: A, action: P3RFunction<in K, in V, in Int, out Boolean> array: A, action: P3RFunction<in K, in V, in Int, out Boolean>,
) { ) {
forEachB(array, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) }) forEachB(array, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
} }
/** /**
@@ -639,9 +639,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
* @param <A> 映射的具体类型 * @param <A> 映射的具体类型
*/ */
fun <K, V, A : Map<K, V>> forEachB( fun <K, V, A : Map<K, V>> forEachB(
map: A, action: P3RFunction<in K, in V, in Int, out Boolean> map: A, action: P3RFunction<in K, in V, in Int, out Boolean>,
) { ) {
forEachB(map.entries, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) }) forEachB(map.entries, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
} }
/** /**
@@ -654,9 +654,9 @@ fun <K, V, A : Map<K, V>> forEachB(
* @param <A> 集合的具体类型 * @param <A> 集合的具体类型
*/ */
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap( fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
array: A, action: P2Function<in K, in V> array: A, action: P2Function<in K, in V>,
) { ) {
forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) }) forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
} }
/** /**
@@ -669,9 +669,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
* @param <A> 映射的具体类型 * @param <A> 映射的具体类型
*/ */
fun <K, V, A : Map<K, V>> forEachMap( fun <K, V, A : Map<K, V>> forEachMap(
map: A, action: P2Function<in K, in V> map: A, action: P2Function<in K, in V>,
) { ) {
forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) }) forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
} }
/** /**
@@ -685,9 +685,9 @@ fun <K, V, A : Map<K, V>> forEachMap(
* @param <A> 集合的具体类型 * @param <A> 集合的具体类型
*/ */
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB( fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
array: A, action: P2RFunction<in K, in V, out Boolean> array: A, action: P2RFunction<in K, in V, out Boolean>,
) { ) {
forEachB(array, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) }) forEachB(array, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
} }
/** /**
@@ -701,7 +701,7 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
* @param <A> 映射的具体类型 * @param <A> 映射的具体类型
*/ */
fun <K, V, A : Map<K, V>> forEachMapB( fun <K, V, A : Map<K, V>> forEachMapB(
map: A, action: P2RFunction<in K, in V, out Boolean> map: A, action: P2RFunction<in K, in V, out Boolean>,
) { ) {
forEachB(map.entries, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) }) forEachB(map.entries, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
} }
@@ -32,53 +32,53 @@ import java.util.concurrent.*
*/ */
class Debouncer(private val delay: Long, unit: TimeUnit) { class Debouncer(private val delay: Long, unit: TimeUnit) {
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor( private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor(
NamedThreadFactory { clazz, poolNumber, threadNumber -> NamedThreadFactory { clazz, poolNumber, threadNumber ->
"Debouncer-$poolNumber-$threadNumber" "Debouncer-$poolNumber-$threadNumber"
} }
) )
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap() private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
private val delayMillis: Long = unit.toMillis(delay) private val delayMillis: Long = unit.toMillis(delay)
/** /**
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时 * 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
* *
* @param key 任务的唯一标识符,用于区分不同任务 * @param key 任务的唯一标识符,用于区分不同任务
* @param task 要执行的任务 * @param task 要执行的任务
*/ */
fun debounce(key: Any, task: Runnable) { fun debounce(key: Any, task: Runnable) {
// 提交新任务并获取之前可能存在的任务 // 提交新任务并获取之前可能存在的任务
val prev = delayedMap.put( val prev = delayedMap.put(
key, key,
scheduler.schedule( scheduler.schedule(
{ {
try { try {
task.run() task.run()
} finally { } finally {
// 任务执行完成后从映射中移除 // 任务执行完成后从映射中移除
delayedMap.remove(key) delayedMap.remove(key)
} }
}, },
delayMillis, delayMillis,
TimeUnit.MILLISECONDS TimeUnit.MILLISECONDS
) )
) )
// 如果之前存在任务,则取消它 // 如果之前存在任务,则取消它
prev?.cancel(true) prev?.cancel(true)
} }
/** /**
* 关闭防抖器,取消所有待执行的任务并关闭调度器 * 关闭防抖器,取消所有待执行的任务并关闭调度器
*/ */
fun shutdown() { fun shutdown() {
// 先取消所有延迟任务 // 先取消所有延迟任务
for (future in delayedMap.values) { for (future in delayedMap.values) {
future.cancel(true) future.cancel(true)
} }
delayedMap.clear() delayedMap.clear()
// 再关闭调度器 // 再关闭调度器
scheduler.shutdownNow() scheduler.shutdownNow()
} }
} }
File diff suppressed because it is too large Load Diff
@@ -31,275 +31,275 @@ import kotlin.reflect.KClass
*/ */
class Pipeline<T>(private val value: T) { class Pipeline<T>(private val value: T) {
/** /**
* 对当前值进行转换操作,并返回新的Pipeline实例 * 对当前值进行转换操作,并返回新的Pipeline实例
* @param transformer 转换函数,接收当前值并返回转换后的结果 * @param transformer 转换函数,接收当前值并返回转换后的结果
* @return 包含转换后结果的新Pipeline实例 * @return 包含转换后结果的新Pipeline实例
*/ */
fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value)) fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value))
/** /**
* 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择 * 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择
* @param transformer 转换函数,接收当前值并返回转换后的结果 * @param transformer 转换函数,接收当前值并返回转换后的结果
* @return 包含转换后结果的新Pipeline实例 * @return 包含转换后结果的新Pipeline实例
*/ */
fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer) fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer)
/** /**
* 消费当前值但不改变流水线状态,用于执行副作用操作 * 消费当前值但不改变流水线状态,用于执行副作用操作
* @param consumer 消费函数,接收当前值进行消费操作 * @param consumer 消费函数,接收当前值进行消费操作
* @return 当前Pipeline实例,支持链式调用 * @return 当前Pipeline实例,支持链式调用
*/ */
fun consume(consumer: P1Function<T>): Pipeline<T> { fun consume(consumer: P1Function<T>): Pipeline<T> {
consumer.call(value) consumer.call(value)
return this return this
} }
/** /**
* 判断当前值是否为null * 判断当前值是否为null
* @return true表示当前值为null,false表示不为null * @return true表示当前值为null,false表示不为null
*/ */
fun isNull(): Boolean = (value == null) fun isNull(): Boolean = (value == null)
/** /**
* 判断当前值是否不为null * 判断当前值是否不为null
* @return true表示当前值不为null,false表示为null * @return true表示当前值不为null,false表示为null
*/ */
fun isNotNull(): Boolean = (value != null) fun isNotNull(): Boolean = (value != null)
/** /**
* 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null * 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null
* @param predicate 过滤条件函数,接收当前值并返回布尔值 * @param predicate 过滤条件函数,接收当前值并返回布尔值
* @return 包含过滤后结果的Pipeline实例 * @return 包含过滤后结果的Pipeline实例
*/ */
fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
if (predicate.call(value)) Pipeline(value) else Pipeline(null) if (predicate.call(value)) Pipeline(value) else Pipeline(null)
/** /**
* 获取当前流水线中的值 * 获取当前流水线中的值
* @return 当前流水线中存储的值 * @return 当前流水线中存储的值
*/ */
fun getValue(): T = value fun getValue(): T = value
/** /**
* 安全地转换当前值,允许转换结果为null * 安全地转换当前值,允许转换结果为null
* @param transformer 转换函数,可能返回null * @param transformer 转换函数,可能返回null
* @return 包含转换后结果(可能为null)的Pipeline实例 * @return 包含转换后结果(可能为null)的Pipeline实例
*/ */
fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value)) fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value))
/** /**
* 将当前值映射为另一个Pipeline实例 * 将当前值映射为另一个Pipeline实例
* @param mapper 映射函数,接收当前值并返回Pipeline实例 * @param mapper 映射函数,接收当前值并返回Pipeline实例
* @return 映射后的Pipeline实例 * @return 映射后的Pipeline实例
*/ */
fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value) fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value)
/** /**
* 将当前值映射为非null结果,如果当前值为null则直接返回null * 将当前值映射为非null结果,如果当前值为null则直接返回null
* @param mapper 映射函数,可能返回null * @param mapper 映射函数,可能返回null
* @return 包含映射后结果的Pipeline实例 * @return 包含映射后结果的Pipeline实例
*/ */
fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> = fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> =
if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null) if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null)
/** /**
* 将当前值强制转换为指定类型 * 将当前值强制转换为指定类型
* @param type 目标类型Class对象 * @param type 目标类型Class对象
* @return 包含转换后类型的Pipeline实例 * @return 包含转换后类型的Pipeline实例
* @throws ClassCastException 当类型转换失败时抛出异常 * @throws ClassCastException 当类型转换失败时抛出异常
*/ */
@Throws(ClassCastException::class) @Throws(ClassCastException::class)
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E) fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E)
/** /**
* 根据条件判断是否保留当前值,条件满足时保留,否则返回null * 根据条件判断是否保留当前值,条件满足时保留,否则返回null
* @param predicate 条件判断函数 * @param predicate 条件判断函数
* @return 包含条件判断结果的Pipeline实例 * @return 包含条件判断结果的Pipeline实例
*/ */
fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null) fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null)
/** /**
* 根据条件判断是否保留当前值,条件不满足时保留,否则返回null * 根据条件判断是否保留当前值,条件不满足时保留,否则返回null
* @param predicate 条件判断函数 * @param predicate 条件判断函数
* @return 包含条件判断结果的Pipeline实例 * @return 包含条件判断结果的Pipeline实例
*/ */
fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
Pipeline(if (!predicate.call(value)) value else null) Pipeline(if (!predicate.call(value)) value else null)
/** /**
* 在当前值上执行指定操作并返回操作结果 * 在当前值上执行指定操作并返回操作结果
* @param block 执行函数,接收当前值并返回结果 * @param block 执行函数,接收当前值并返回结果
* @return 包含执行结果的Pipeline实例 * @return 包含执行结果的Pipeline实例
*/ */
fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value)) fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value))
/** /**
* 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例 * 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例
* @param defaultValue 默认值 * @param defaultValue 默认值
* @return 当前值或默认值的Pipeline实例 * @return 当前值或默认值的Pipeline实例
*/ */
fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue) fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue)
/** /**
* 如果当前值不为null则返回自身,否则通过供应商函数获取默认值 * 如果当前值不为null则返回自身,否则通过供应商函数获取默认值
* @param supplier 默认值供应商函数 * @param supplier 默认值供应商函数
* @return 当前值或供应商提供的值的Pipeline实例 * @return 当前值或供应商提供的值的Pipeline实例
*/ */
fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call()) fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call())
/** /**
* 验证当前值是否等于指定值,如果不相等则抛出异常 * 验证当前值是否等于指定值,如果不相等则抛出异常
* @param any 比较的目标值 * @param any 比较的目标值
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java, any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java,
): Pipeline<T> { ): Pipeline<T> {
requireTrue(any == value, exception, message) requireTrue(any == value, exception, message)
return this return this
} }
/** /**
* 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常 * 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常
* @param any 比较的目标值 * @param any 比较的目标值
* @param message 错误消息 * @param message 错误消息
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
any: Any, message: String, any: Any, message: String,
): Pipeline<T> { ): Pipeline<T> {
requireTrue(any == value, message) requireTrue(any == value, message)
return this return this
} }
/** /**
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常 * 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
* @param must 验证条件函数 * @param must 验证条件函数
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
must: P1RFunction<T, Boolean>, must: P1RFunction<T, Boolean>,
message: String, message: String,
exception: Class<out Throwable> = IllegalArgumentException::class.java, exception: Class<out Throwable> = IllegalArgumentException::class.java,
): Pipeline<T> { ): Pipeline<T> {
requireTrue(must.call(value), exception, message) requireTrue(must.call(value), exception, message)
return this return this
} }
/** /**
* 验证当前值是否等于指定值,如果不相等则抛出异常 * 验证当前值是否等于指定值,如果不相等则抛出异常
* @param any 比较的目标值 * @param any 比较的目标值
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
any: Any, any: Any,
message: String, message: String,
exception: KClass<out Throwable> = IllegalArgumentException::class, exception: KClass<out Throwable> = IllegalArgumentException::class,
): Pipeline<T> { ): Pipeline<T> {
requireTrue(any == value, exception.java, message) requireTrue(any == value, exception.java, message)
return this return this
} }
/** /**
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常 * 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
* @param must 验证条件函数 * @param must 验证条件函数
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
must: (T) -> Boolean, must: (T) -> Boolean,
message: String, message: String,
exception: KClass<out Throwable> = IllegalArgumentException::class, exception: KClass<out Throwable> = IllegalArgumentException::class,
): Pipeline<T> { ): Pipeline<T> {
requireTrue(must(value), exception.java, message) requireTrue(must(value), exception.java, message)
return this return this
} }
/** /**
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常 * 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常
* @param must 验证条件函数 * @param must 验证条件函数
* @param message 错误消息 * @param message 错误消息
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
must: P1RFunction<T, Boolean>, message: String, must: P1RFunction<T, Boolean>, message: String,
): Pipeline<T> { ): Pipeline<T> {
requireTrue(must.call(value), message) requireTrue(must.call(value), message)
return this return this
} }
/** /**
* 对当前值执行指定操作但不改变流水线状态 * 对当前值执行指定操作但不改变流水线状态
* @param block 执行函数,接收当前值 * @param block 执行函数,接收当前值
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun also(block: P1Function<T>): Pipeline<T> { fun also(block: P1Function<T>): Pipeline<T> {
block.call(value) block.call(value)
return this return this
} }
/** /**
* 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常 * 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常
* @param predicate 验证条件函数 * @param predicate 验证条件函数
* @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed" * @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed"
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
predicate: P1RFunction<T, Boolean>, predicate: P1RFunction<T, Boolean>,
lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" }, lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" },
): Pipeline<T> { ): Pipeline<T> {
if (!predicate.call(value)) { if (!predicate.call(value)) {
throw IllegalArgumentException(lazyMessage.call(value).toString()) throw IllegalArgumentException(lazyMessage.call(value).toString())
} }
return this return this
} }
/** /**
* 使用比较器比较当前值与另一个值 * 使用比较器比较当前值与另一个值
* @param other 另一个比较值 * @param other 另一个比较值
* @param comparator 比较器 * @param comparator 比较器
* @return 比较结果,负数表示小于,0表示相等,正数表示大于 * @return 比较结果,负数表示小于,0表示相等,正数表示大于
*/ */
fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other) fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other)
/** /**
* 使用选择器将当前值转换为可比较类型后与另一个值比较 * 使用选择器将当前值转换为可比较类型后与另一个值比较
* @param other 另一个比较值 * @param other 另一个比较值
* @param selector 选择器函数,将当前值转换为可比较类型 * @param selector 选择器函数,将当前值转换为可比较类型
* @return 比较结果 * @return 比较结果
*/ */
fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int = fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int =
selector.call(value).compareTo(other) selector.call(value).compareTo(other)
companion object { companion object {
/** /**
* 创建包含指定值的Pipeline实例 * 创建包含指定值的Pipeline实例
* @param value 要包装的值 * @param value 要包装的值
* @return 新的Pipeline实例 * @return 新的Pipeline实例
*/ */
@JvmStatic @JvmStatic
fun <T> of(value: T): Pipeline<T> = Pipeline(value) fun <T> of(value: T): Pipeline<T> = Pipeline(value)
/** /**
* 通过供应商函数创建Pipeline实例 * 通过供应商函数创建Pipeline实例
* @param transformer 值供应商函数 * @param transformer 值供应商函数
* @return 新的Pipeline实例 * @return 新的Pipeline实例
*/ */
@JvmStatic @JvmStatic
fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call()) fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call())
} }
} }
@@ -44,24 +44,24 @@ import java.security.NoSuchAlgorithmException
*/ */
@Throws(IOException::class, NoSuchAlgorithmException::class) @Throws(IOException::class, NoSuchAlgorithmException::class)
fun calculateFileHash(file: File, algorithm: String): String { fun calculateFileHash(file: File, algorithm: String): String {
// 检查文件是否存在 // 检查文件是否存在
if (!file.exists()) { if (!file.exists()) {
throw IOException("File not found: " + file.absolutePath) throw IOException("File not found: " + file.absolutePath)
} }
val digest = MessageDigest.getInstance(algorithm) val digest = MessageDigest.getInstance(algorithm)
FileInputStream(file).use { fis -> FileInputStream(file).use { fis ->
val buffer = ByteArray(8192) val buffer = ByteArray(8192)
var bytesRead: Int var bytesRead: Int
// 分块读取文件内容并更新摘要 // 分块读取文件内容并更新摘要
while (fis.read(buffer).also { bytesRead = it } != -1) { while (fis.read(buffer).also { bytesRead = it } != -1) {
digest.update(buffer, 0, bytesRead) digest.update(buffer, 0, bytesRead)
} }
} }
return bytesToHex(digest.digest()) return bytesToHex(digest.digest())
} }
/** /**
@@ -71,7 +71,7 @@ fun calculateFileHash(file: File, algorithm: String): String {
* @return 加密后的 BCrypt 哈希字符串 * @return 加密后的 BCrypt 哈希字符串
*/ */
fun bcrypt(string: String): String { fun bcrypt(string: String): String {
return hashpw(string) return hashpw(string)
} }
/** /**
@@ -82,5 +82,5 @@ fun bcrypt(string: String): String {
* @return 如果匹配返回 true,否则返回 false * @return 如果匹配返回 true,否则返回 false
*/ */
fun checkBcrypt(string: String, bcrypted: String): Boolean { fun checkBcrypt(string: String, bcrypted: String): Boolean {
return checkpw(string, bcrypted) return checkpw(string, bcrypted)
} }
@@ -23,20 +23,20 @@
package com.mingliqiye.utils.http package com.mingliqiye.utils.http
open class BaseResponse<T>( open class BaseResponse<T>(
open val time: String, open val time: String,
open var message: String, open var message: String,
open var data: T, open var data: T,
open var statusCode: Int, open var statusCode: Int,
) { ) {
/** /**
* 返回响应对象的字符串表示 * 返回响应对象的字符串表示
* *
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。 * 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
* 显示时间、消息、数据类型和值以及状态码。 * 显示时间、消息、数据类型和值以及状态码。
* *
* @return 格式化的字符串表示 * @return 格式化的字符串表示
*/ */
override fun toString(): String = override fun toString(): String =
"${javaClass.simpleName}(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})" "${javaClass.simpleName}(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
} }
File diff suppressed because it is too large Load Diff
@@ -28,38 +28,38 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page
* 分页数据类 * 分页数据类
*/ */
data class PageData<T>( data class PageData<T>(
/** /**
* 当前页的数据列表 * 当前页的数据列表
*/ */
val records: Collection<T> = emptyList(), val records: Collection<T> = emptyList(),
/** /**
* 总条数(总记录数) * 总条数(总记录数)
*/ */
val totalCount: Long = 0, val totalCount: Long = 0,
/** /**
* 总页数 * 总页数
*/ */
val totalPages: Long = 0, val totalPages: Long = 0,
/** /**
* 每页大小 * 每页大小
*/ */
val pageSize: Long = 0, val pageSize: Long = 0,
/** /**
* 当前页码(从 1 开始) * 当前页码(从 1 开始)
*/ */
val pageIndex: Long = 0, val pageIndex: Long = 0,
) { ) {
companion object { companion object {
fun <T> of(page: Page<T>): PageData<T> = PageData( fun <T> of(page: Page<T>): PageData<T> = PageData(
records = page.records, records = page.records,
totalCount = page.total, totalCount = page.total,
totalPages = page.pages, totalPages = page.pages,
pageSize = page.size, pageSize = page.size,
pageIndex = page.current, pageIndex = page.current,
) )
} }
} }
@@ -26,191 +26,191 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page
import com.mingliqiye.utils.time.DateTime import com.mingliqiye.utils.time.DateTime
data class PagedResponse<T>( data class PagedResponse<T>(
override val time: String, // 响应时间,一旦创建不可修改 override val time: String, // 响应时间,一旦创建不可修改
override var message: String, // 响应消息,可通过setter修改 override var message: String, // 响应消息,可通过setter修改
override var data: PageData<T>, // 响应数据,可通过setter修改 override var data: PageData<T>, // 响应数据,可通过setter修改
override var statusCode: Int, // HTTP状态码,可通过setter修改 override var statusCode: Int, // HTTP状态码,可通过setter修改
) : BaseResponse<PageData<T>>( ) : BaseResponse<PageData<T>>(
time, time,
message, message,
data, data,
statusCode statusCode
) { ) {
companion object { companion object {
/** /**
* 创建一个默认的成功响应对象 * 创建一个默认的成功响应对象
* 使用默认消息"操作成功",无数据,状态码200 * 使用默认消息"操作成功",无数据,状态码200
* *
* @return Response<Nothing> 默认的成功响应对象 * @return Response<Nothing> 默认的成功响应对象
*/ */
fun ok() = ok("操作成功") fun ok() = ok("操作成功")
/** /**
* 创建一个默认的错误响应对象 * 创建一个默认的错误响应对象
* 使用默认消息"服务器错误",无数据,状态码500 * 使用默认消息"服务器错误",无数据,状态码500
* *
* @return Response<Nothing> 默认的成功响应对象 * @return Response<Nothing> 默认的成功响应对象
*/ */
fun error() = error("服务器错误") fun error() = error("服务器错误")
/** /**
* 创建一个成功的响应对象(仅包含消息) * 创建一个成功的响应对象(仅包含消息)
* *
* @param message 响应消息 * @param message 响应消息
* @return Response<Any> 成功的响应对象,数据为null * @return Response<Any> 成功的响应对象,数据为null
*/ */
@JvmStatic @JvmStatic
fun ok(message: String) = PagedResponse( fun ok(message: String) = PagedResponse(
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = 200 time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = 200
) )
/** /**
* 创建一个错误的响应对象 * 创建一个错误的响应对象
* *
* @param message 错误消息,默认为"服务器错误" * @param message 错误消息,默认为"服务器错误"
* @param statusCode HTTP状态码,默认为500 * @param statusCode HTTP状态码,默认为500
* @return Response<Any> 错误的响应对象 * @return Response<Any> 错误的响应对象
*/ */
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode) fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
/** /**
* 创建一个成功的响应对象(仅包含数据) * 创建一个成功的响应对象(仅包含数据)
* 使用默认消息"操作成功" * 使用默认消息"操作成功"
* *
* @param T 响应数据的类型 * @param T 响应数据的类型
* @param data 响应数据 * @param data 响应数据
* @return Response<T> 成功的响应对象,包含数据 * @return Response<T> 成功的响应对象,包含数据
*/ */
@JvmStatic @JvmStatic
fun <T> okData(data: PageData<T>) = PagedResponse( fun <T> okData(data: PageData<T>) = PagedResponse(
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200 time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
) )
/** /**
* 从mybatisplus的page构建 * 从mybatisplus的page构建
*/ */
@JvmOverloads @JvmOverloads
fun <T> okPgae( fun <T> okPgae(
page: Page<T>, page: Page<T>,
time: String = DateTime.now().format(), time: String = DateTime.now().format(),
message: String = "操作成功", message: String = "操作成功",
statusCode: Int = 200, statusCode: Int = 200,
): PagedResponse<T> { ): PagedResponse<T> {
return PagedResponse( return PagedResponse(
time = time, message = message, data = PageData.of(page), statusCode = statusCode time = time, message = message, data = PageData.of(page), statusCode = statusCode
) )
} }
/** /**
* 创建一个成功的响应对象(包含数据和消息) * 创建一个成功的响应对象(包含数据和消息)
* *
* @param T 响应数据的类型 * @param T 响应数据的类型
* @param data 响应数据 * @param data 响应数据
* @param message 响应消息 * @param message 响应消息
* @return Response<T> 成功的响应对象,包含数据和消息 * @return Response<T> 成功的响应对象,包含数据和消息
*/ */
@JvmStatic @JvmStatic
fun <T> okData(data: PageData<T>, message: String) = PagedResponse( fun <T> okData(data: PageData<T>, message: String) = PagedResponse(
time = DateTime.now().format(), message = message, data = data, statusCode = 200 time = DateTime.now().format(), message = message, data = data, statusCode = 200
) )
/** /**
* 创建一个指定状态码的响应对象(仅包含状态码) * 创建一个指定状态码的响应对象(仅包含状态码)
* 使用默认消息"操作成功",无数据 * 使用默认消息"操作成功",无数据
* *
* @param statusCode HTTP状态码 * @param statusCode HTTP状态码
* @return Response<Any> 指定状态码的响应对象 * @return Response<Any> 指定状态码的响应对象
*/ */
@JvmStatic @JvmStatic
fun code(statusCode: Int) = PagedResponse( fun code(statusCode: Int) = PagedResponse(
time = DateTime.now().format(), message = "操作成功", data = PageData<Nothing>(), statusCode = statusCode time = DateTime.now().format(), message = "操作成功", data = PageData<Nothing>(), statusCode = statusCode
) )
/** /**
* 创建一个指定状态码的响应对象(包含状态码和消息) * 创建一个指定状态码的响应对象(包含状态码和消息)
* 无数据 * 无数据
* *
* @param statusCode HTTP状态码 * @param statusCode HTTP状态码
* @param message 响应消息 * @param message 响应消息
* @return Response<Any> 指定状态码和消息的响应对象 * @return Response<Any> 指定状态码和消息的响应对象
*/ */
@JvmStatic @JvmStatic
fun code(statusCode: Int, message: String) = PagedResponse( fun code(statusCode: Int, message: String) = PagedResponse(
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = statusCode time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = statusCode
) )
} }
/** /**
* 默认构造函数,创建一个默认的成功响应对象 * 默认构造函数,创建一个默认的成功响应对象
* 使用当前时间、默认消息"操作成功"、状态码200、无数据 * 使用当前时间、默认消息"操作成功"、状态码200、无数据
*/ */
constructor() : this( constructor() : this(
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = PageData() time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = PageData()
) )
/** /**
* 设置响应数据 * 设置响应数据
* *
* 该方法允许修改响应数据,并返回当前对象以支持链式调用。 * 该方法允许修改响应数据,并返回当前对象以支持链式调用。
* *
* @param data 新的响应数据 * @param data 新的响应数据
* @return Response<T> 当前响应对象(支持链式调用) * @return Response<T> 当前响应对象(支持链式调用)
*/ */
fun setData(data: PageData<T>): PagedResponse<T> { fun setData(data: PageData<T>): PagedResponse<T> {
this.data = data this.data = data
return this return this
} }
/** /**
* 创建一个新的Response对象,使用指定的时间 * 创建一个新的Response对象,使用指定的时间
* *
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。 * 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
* 如果时间相同,则返回原对象避免不必要的对象创建。 * 如果时间相同,则返回原对象避免不必要的对象创建。
* *
* @param time 新的响应时间 * @param time 新的响应时间
* @return Response<T> 新的响应对象(如果时间相同则返回原对象) * @return Response<T> 新的响应对象(如果时间相同则返回原对象)
*/ */
fun withTime(time: String): PagedResponse<T> = fun withTime(time: String): PagedResponse<T> =
if (this.time == time) this else PagedResponse(time, message, data, statusCode) if (this.time == time) this else PagedResponse(time, message, data, statusCode)
/** /**
* 创建一个新的Response对象,使用指定的数据 * 创建一个新的Response对象,使用指定的数据
* *
* 该方法允许改变响应数据的类型,创建一个新的响应对象。 * 该方法允许改变响应数据的类型,创建一个新的响应对象。
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。 * 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
* *
* @param D 新的数据类型 * @param D 新的数据类型
* @param data 新的响应数据 * @param data 新的响应数据
* @return Response<D> 新的响应对象,数据类型为D * @return Response<D> 新的响应对象,数据类型为D
*/ */
fun <D> withData(data: PageData<D>): PagedResponse<D> = fun <D> withData(data: PageData<D>): PagedResponse<D> =
PagedResponse(this.time, this.message, data, this.statusCode) PagedResponse(this.time, this.message, data, this.statusCode)
/** /**
* 创建一个新的Response对象,使用指定的消息 * 创建一个新的Response对象,使用指定的消息
* *
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。 * 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
* 如果消息相同,则返回原对象避免不必要的对象创建。 * 如果消息相同,则返回原对象避免不必要的对象创建。
* *
* @param message 新的响应消息 * @param message 新的响应消息
* @return Response<T> 新的响应对象(如果消息相同则返回原对象) * @return Response<T> 新的响应对象(如果消息相同则返回原对象)
*/ */
fun withMessage(message: String): PagedResponse<T> = fun withMessage(message: String): PagedResponse<T> =
if (this.message == message) this else PagedResponse(time, message, data, statusCode) if (this.message == message) this else PagedResponse(time, message, data, statusCode)
/** /**
* 创建一个新的Response对象,使用指定的状态码 * 创建一个新的Response对象,使用指定的状态码
* *
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。 * 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
* 如果状态码相同,则返回原对象避免不必要的对象创建。 * 如果状态码相同,则返回原对象避免不必要的对象创建。
* *
* @param statusCode 新的状态码 * @param statusCode 新的状态码
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象) * @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
*/ */
fun withStatusCode(statusCode: Int): PagedResponse<T> = fun withStatusCode(statusCode: Int): PagedResponse<T> =
if (this.statusCode == statusCode) this else PagedResponse(time, message, data, statusCode) if (this.statusCode == statusCode) this else PagedResponse(time, message, data, statusCode)
} }
@@ -38,171 +38,171 @@ import com.mingliqiye.utils.time.DateTime
* @property statusCode HTTP状态码 * @property statusCode HTTP状态码
*/ */
data class Response<T>( data class Response<T>(
override val time: String, // 响应时间,一旦创建不可修改 override val time: String, // 响应时间,一旦创建不可修改
override var message: String, // 响应消息,可通过setter修改 override var message: String, // 响应消息,可通过setter修改
override var data: T?, // 响应数据,可通过setter修改 override var data: T?, // 响应数据,可通过setter修改
override var statusCode: Int, // HTTP状态码,可通过setter修改 override var statusCode: Int, // HTTP状态码,可通过setter修改
) : BaseResponse<T?>( ) : BaseResponse<T?>(
time, time,
message, message,
data, data,
statusCode, statusCode,
) { ) {
companion object { companion object {
/** /**
* 创建一个默认的成功响应对象 * 创建一个默认的成功响应对象
* 使用默认消息"操作成功",无数据,状态码200 * 使用默认消息"操作成功",无数据,状态码200
* *
* @return Response<Nothing> 默认的成功响应对象 * @return Response<Nothing> 默认的成功响应对象
*/ */
fun ok() = ok("操作成功") fun ok() = ok("操作成功")
/** /**
* 创建一个默认的错误响应对象 * 创建一个默认的错误响应对象
* 使用默认消息"服务器错误",无数据,状态码500 * 使用默认消息"服务器错误",无数据,状态码500
* *
* @return Response<Nothing> 默认的成功响应对象 * @return Response<Nothing> 默认的成功响应对象
*/ */
fun error() = error("服务器错误") fun error() = error("服务器错误")
/** /**
* 创建一个成功的响应对象(仅包含消息) * 创建一个成功的响应对象(仅包含消息)
* *
* @param message 响应消息 * @param message 响应消息
* @return Response<Any> 成功的响应对象,数据为null * @return Response<Any> 成功的响应对象,数据为null
*/ */
@JvmStatic @JvmStatic
fun ok(message: String) = Response( fun ok(message: String) = Response(
time = DateTime.now().format(), message = message, data = null, statusCode = 200 time = DateTime.now().format(), message = message, data = null, statusCode = 200
) )
/** /**
* 创建一个错误的响应对象 * 创建一个错误的响应对象
* *
* @param message 错误消息,默认为"服务器错误" * @param message 错误消息,默认为"服务器错误"
* @param statusCode HTTP状态码,默认为500 * @param statusCode HTTP状态码,默认为500
* @return Response<Any> 错误的响应对象 * @return Response<Any> 错误的响应对象
*/ */
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode) fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
/** /**
* 创建一个成功的响应对象(仅包含数据) * 创建一个成功的响应对象(仅包含数据)
* 使用默认消息"操作成功" * 使用默认消息"操作成功"
* *
* @param T 响应数据的类型 * @param T 响应数据的类型
* @param data 响应数据 * @param data 响应数据
* @return Response<T> 成功的响应对象,包含数据 * @return Response<T> 成功的响应对象,包含数据
*/ */
@JvmStatic @JvmStatic
fun <T> okData(data: T) = Response( fun <T> okData(data: T) = Response(
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200 time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
) )
/** /**
* 创建一个成功的响应对象(包含数据和消息) * 创建一个成功的响应对象(包含数据和消息)
* *
* @param T 响应数据的类型 * @param T 响应数据的类型
* @param data 响应数据 * @param data 响应数据
* @param message 响应消息 * @param message 响应消息
* @return Response<T> 成功的响应对象,包含数据和消息 * @return Response<T> 成功的响应对象,包含数据和消息
*/ */
@JvmStatic @JvmStatic
fun <T> okData(data: T, message: String) = Response( fun <T> okData(data: T, message: String) = Response(
time = DateTime.now().format(), message = message, data = data, statusCode = 200 time = DateTime.now().format(), message = message, data = data, statusCode = 200
) )
/** /**
* 创建一个指定状态码的响应对象(仅包含状态码) * 创建一个指定状态码的响应对象(仅包含状态码)
* 使用默认消息"操作成功",无数据 * 使用默认消息"操作成功",无数据
* *
* @param statusCode HTTP状态码 * @param statusCode HTTP状态码
* @return Response<Any> 指定状态码的响应对象 * @return Response<Any> 指定状态码的响应对象
*/ */
@JvmStatic @JvmStatic
fun code(statusCode: Int) = Response( fun code(statusCode: Int) = Response(
time = DateTime.now().format(), message = "操作成功", data = null, statusCode = statusCode time = DateTime.now().format(), message = "操作成功", data = null, statusCode = statusCode
) )
/** /**
* 创建一个指定状态码的响应对象(包含状态码和消息) * 创建一个指定状态码的响应对象(包含状态码和消息)
* 无数据 * 无数据
* *
* @param statusCode HTTP状态码 * @param statusCode HTTP状态码
* @param message 响应消息 * @param message 响应消息
* @return Response<Any> 指定状态码和消息的响应对象 * @return Response<Any> 指定状态码和消息的响应对象
*/ */
@JvmStatic @JvmStatic
fun code(statusCode: Int, message: String) = Response( fun code(statusCode: Int, message: String) = Response(
time = DateTime.now().format(), message = message, data = null, statusCode = statusCode time = DateTime.now().format(), message = message, data = null, statusCode = statusCode
) )
} }
/** /**
* 默认构造函数,创建一个默认的成功响应对象 * 默认构造函数,创建一个默认的成功响应对象
* 使用当前时间、默认消息"操作成功"、状态码200、无数据 * 使用当前时间、默认消息"操作成功"、状态码200、无数据
*/ */
constructor() : this( constructor() : this(
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = null time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = null
) )
/** /**
* 创建一个新的Response对象,使用指定的时间 * 创建一个新的Response对象,使用指定的时间
* *
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。 * 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
* 如果时间相同,则返回原对象避免不必要的对象创建。 * 如果时间相同,则返回原对象避免不必要的对象创建。
* *
* @param time 新的响应时间 * @param time 新的响应时间
* @return Response<T> 新的响应对象(如果时间相同则返回原对象) * @return Response<T> 新的响应对象(如果时间相同则返回原对象)
*/ */
fun withTime(time: String): Response<T> = if (this.time == time) this else Response(time, message, data, statusCode) fun withTime(time: String): Response<T> = if (this.time == time) this else Response(time, message, data, statusCode)
/** /**
* 创建一个新的Response对象,使用指定的数据 * 创建一个新的Response对象,使用指定的数据
* *
* 该方法允许改变响应数据的类型,创建一个新的响应对象。 * 该方法允许改变响应数据的类型,创建一个新的响应对象。
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。 * 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
* *
* @param D 新的数据类型 * @param D 新的数据类型
* @param data 新的响应数据 * @param data 新的响应数据
* @return Response<D> 新的响应对象,数据类型为D * @return Response<D> 新的响应对象,数据类型为D
*/ */
fun <D> withData(data: D): Response<D> = Response(this.time, this.message, data, this.statusCode) fun <D> withData(data: D): Response<D> = Response(this.time, this.message, data, this.statusCode)
/** /**
* 创建一个新的Response对象,使用指定的消息 * 创建一个新的Response对象,使用指定的消息
* *
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。 * 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
* 如果消息相同,则返回原对象避免不必要的对象创建。 * 如果消息相同,则返回原对象避免不必要的对象创建。
* *
* @param message 新的响应消息 * @param message 新的响应消息
* @return Response<T> 新的响应对象(如果消息相同则返回原对象) * @return Response<T> 新的响应对象(如果消息相同则返回原对象)
*/ */
fun withMessage(message: String): Response<T> = fun withMessage(message: String): Response<T> =
if (this.message == message) this else Response(time, message, data, statusCode) if (this.message == message) this else Response(time, message, data, statusCode)
/** /**
* 创建一个新的Response对象,使用指定的状态码 * 创建一个新的Response对象,使用指定的状态码
* *
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。 * 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
* 如果状态码相同,则返回原对象避免不必要的对象创建。 * 如果状态码相同,则返回原对象避免不必要的对象创建。
* *
* @param statusCode 新的状态码 * @param statusCode 新的状态码
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象) * @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
*/ */
fun withStatusCode(statusCode: Int): Response<T> = fun withStatusCode(statusCode: Int): Response<T> =
if (this.statusCode == statusCode) this else Response(time, message, data, statusCode) if (this.statusCode == statusCode) this else Response(time, message, data, statusCode)
/** /**
* 返回响应对象的字符串表示 * 返回响应对象的字符串表示
* *
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。 * 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
* 显示时间、消息、数据类型和值以及状态码。 * 显示时间、消息、数据类型和值以及状态码。
* *
* @return 格式化的字符串表示 * @return 格式化的字符串表示
*/ */
override fun toString(): String = override fun toString(): String =
"Response<${data?.javaClass?.simpleName ?: "Nothing"}>(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})" "Response<${data?.javaClass?.simpleName ?: "Nothing"}>(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
} }
@@ -16,45 +16,290 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile OkHttpUtils.kt * CurrentFile OkHttpUtils.kt
* LastUpdate 2026-10-22 20:20:42 * LastUpdate 2026-11-09 19:18:03
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@file:JvmName("OkHttpUtils") @file:JvmName("OkHttpUtils")
package com.mingliqiye.utils.http.okhttp package com.mingliqiye.utils.http.okhttp
import com.mingliqiye.utils.http.MediaType
import com.mingliqiye.utils.http.okhttp
import com.mingliqiye.utils.json.api.JSONA import com.mingliqiye.utils.json.api.JSONA
import com.mingliqiye.utils.json.api.base.JsonApi import com.mingliqiye.utils.json.api.base.JsonApi
import com.mingliqiye.utils.json.api.base.JsonApi.Companion.parse import com.mingliqiye.utils.json.api.base.JsonApi.Companion.parse
import okhttp3.Call import okhttp3.*
import okhttp3.OkHttpClient import okhttp3.HttpUrl.Companion.toHttpUrl
import okhttp3.Request import okhttp3.RequestBody.Companion.toRequestBody
import okhttp3.Response
/**
* 将 OkHttp 的 [Response] 响应体解析为指定泛型类型的对象。
*
* 会读取并关闭响应体。未显式传入 [jsonApi] 时使用 [JSONA.jsonApi]。
*
* @param T 目标对象类型,由调用方通过 reified 推断
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 解析后的对象实例
* @throws NullPointerException 未传入 [jsonApi] 且 [JSONA] 尚未注入实例时抛出
*/
inline fun <reified T> Response.json(jsonApi: JsonApi? = null): T = body.use { inline fun <reified T> Response.json(jsonApi: JsonApi? = null): T = body.use {
if (jsonApi != null) { (jsonApi ?: JSONA.jsonApi).parse<T>(it.bytes())
return jsonApi.parse<T>(it.bytes())
} else {
JSONA.parse<T>(it.bytes())
}
} }
fun Response.text() = body.use { /**
String(it.bytes()) * 读取 [Response] 响应体为字符串,并关闭响应体。
} *
* 按响应 `Content-Type` 的 `charset` 解码,缺省 UTF-8;读取后响应体被关闭。
*
* @return 响应体内容字符串
*/
fun Response.text() = this.body.string()
/**
* 创建一个 [Request],通过 [calld] 配置 [Request.Builder]。
*
* @param calld 在 [Request.Builder] 上执行的配置块
* @return 构建完成的 [Request]
*/
fun newRequest(calld: Request.Builder.() -> Unit): Request =
Request.Builder().apply(calld).build()
fun newRequest(calld: Request.Builder.() -> Unit): Request { /**
val request = Request.Builder() * 使用当前 [OkHttpClient] 创建一个 [Call],请求通过 [calld] 配置。
calld(request) *
return request.build() * 调用返回的 [Call] 的 `execute()` 或 `enqueue()` 才会真正发起请求。
} *
* @param calld 在 [Request.Builder] 上执行的配置块
* @return 未执行的 [Call]
*/
fun OkHttpClient.newCall(calld: Request.Builder.() -> Unit): Call { fun OkHttpClient.newCall(calld: Request.Builder.() -> Unit): Call {
return this.newCall(newRequest(calld)) return this.newCall(newRequest(calld))
} }
/**
* 使用当前 [OkHttpClient] 同步执行一次请求,请求通过 [calld] 配置。
*
* 注意:在 Android 主线程调用会抛出 `NetworkOnMainThreadException`。
*
* @param calld 在 [Request.Builder] 上执行的配置块
* @return 同步执行得到的 [Response]
* @throws java.io.IOException 网络或 I/O 失败时抛出
*/
fun OkHttpClient.newExecute(calld: Request.Builder.() -> Unit): Response { fun OkHttpClient.newExecute(calld: Request.Builder.() -> Unit): Response {
return this.newCall(newRequest(calld)).execute() return this.newCall(newRequest(calld)).execute()
} }
/**
* 在 [Request.Builder] 上设置 URL,并通过 [calld] 配置查询参数。
*
* 示例:
* ```
* Request.Builder().url("https://example.com/api") {
* addQueryParameter("page", "1")
* }
* ```
*
* @param url 基础 URL 字符串
* @param calld 可选的 [HttpUrl.Builder] 配置块(如添加查询参数);为 `null` 时直接使用 [url]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.url(
url: String,
calld: (HttpUrl.Builder.() -> Unit)? = null,
): Request.Builder {
return if (calld != null) {
this.url(url.toHttpUrl().newBuilder().apply { calld() }.build())
} else {
this.url(url.toHttpUrl())
}
}
/**
* 在 [Request.Builder] 上设置请求方法和字节数组请求体。
*
* @param method 请求方法
* @param body 请求体字节数组
* @param mediaType 可选的媒体类型;为 `null` 时不设置 Content-Type
* @param offset 起始偏移量,默认 0
* @param length 读取长度,默认从 [offset] 到 [body] 末尾
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.methodBody(
method: Method,
body: ByteArray,
mediaType: MediaType? = null,
offset: Int = 0,
length: Int = body.size - offset,
): Request.Builder {
require(offset >= 0 && length >= 0 && offset + length <= body.size) {
"offset/length 越界: offset=$offset, length=$length, size=${body.size}"
}
return method(method.name, body.toRequestBody(mediaType?.okhttp(), offset, length))
}
/**
* 在 [Request.Builder] 上设置请求方法,并将对象序列化为 JSON 作为请求体。
*
* @param method 请求方法
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.methodJsonBody(
method: Method,
body: Any,
jsonApi: JsonApi? = null,
): Request.Builder = methodBody(
method,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 GET 方法,并将对象序列化为 JSON 作为请求体。
*
* 注意:GET 请求携带请求体在 HTTP 语义中不常见,部分服务端可能忽略或拒绝。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.getJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.GET,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 POST 方法,并将对象序列化为 JSON 作为请求体。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.postJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.POST,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 PUT 方法,并将对象序列化为 JSON 作为请求体。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.putJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.PUT,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 DELETE 方法,并将对象序列化为 JSON 作为请求体。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.deleteJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.DELETE,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 HEAD 方法,并将对象序列化为 JSON 作为请求体。
*
* 注意:HEAD 请求通常不应携带请求体,部分服务端可能忽略或拒绝。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.headJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.HEAD,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 OPTIONS 方法,并将对象序列化为 JSON 作为请求体。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.optionsJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.OPTIONS,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* 在 [Request.Builder] 上设置 QUERY 方法,并将对象序列化为 JSON 作为请求体。
*
* QUERY 是 HTTP 扩展方法,需服务端支持。
*
* @param body 待序列化的对象
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
* @return 当前 [Request.Builder],便于链式调用
*/
fun Request.Builder.queryJsonBody(
body: Any,
jsonApi: JsonApi? = null,
) = methodBody(
Method.QUERY,
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
MediaType.APPLICATION_JSON,
)
/**
* HTTP 请求方法枚举,供 [Request.Builder.methodBody] 等扩展使用。
*/
enum class Method {
/** GET 方法。 */
GET,
/** POST 方法。 */
POST,
/** PUT 方法。 */
PUT,
/** DELETE 方法。 */
DELETE,
/** HEAD 方法。 */
HEAD,
/** OPTIONS 方法。 */
OPTIONS,
/** QUERY 方法(HTTP 扩展方法,需服务端支持)。 */
QUERY,
}
fun Request.Builder.post() = post(RequestBody.EMPTY)
fun Request.Builder.put() = put(RequestBody.EMPTY)
fun Request.Builder.patch() = patch(RequestBody.EMPTY)
@@ -31,8 +31,8 @@ import java.nio.charset.Charset
fun InputStream.readAllText(charset: Charset = Charsets.UTF_8) = this.readAllBytes().toString(charset) fun InputStream.readAllText(charset: Charset = Charsets.UTF_8) = this.readAllBytes().toString(charset)
fun InputStream.exportBytes(out: OutputStream) { fun InputStream.exportBytes(out: OutputStream) {
out.write(this.readAllBytes()) out.write(this.readAllBytes())
out.flush() out.flush()
} }
fun InputStream.readToList(): List<Byte> = this.readBytes().toList() fun InputStream.readToList(): List<Byte> = this.readBytes().toList()
+213 -213
View File
@@ -34,244 +34,244 @@ import java.io.PrintStream
*/ */
object SIO { object SIO {
/** /**
* 扩展函数:将字节数组以十六进制格式打印,每两个字符用空格分隔 * 扩展函数:将字节数组以十六进制格式打印,每两个字符用空格分隔
* @return 原始字节数组 * @return 原始字节数组
*/ */
@JvmStatic @JvmStatic
fun ByteArray.println(): ByteArray { fun ByteArray.println(): ByteArray {
this.toHexString().chunked(2).println() this.toHexString().chunked(2).println()
return this return this
} }
fun <T> T.ifOr(boolean: Boolean, pd: T.() -> T): T = if (boolean) { fun <T> T.ifOr(boolean: Boolean, pd: T.() -> T): T = if (boolean) {
this this
} else pd(this) } else pd(this)
fun <T> T.ifOrElse(boolean: Boolean, pd: T.() -> T): T = if (!boolean) { fun <T> T.ifOrElse(boolean: Boolean, pd: T.() -> T): T = if (!boolean) {
this this
} else pd(this) } else pd(this)
/** /**
* 扩展函数:将列表以花括号格式打印,元素间用逗号分隔 * 扩展函数:将列表以花括号格式打印,元素间用逗号分隔
* @return 原始列表 * @return 原始列表
*/ */
@JvmStatic @JvmStatic
fun <T> List<T>.println(): List<T> { fun <T> List<T>.println(): List<T> {
println("{" + ",".join(this) + "}") println("{" + ",".join(this) + "}")
return this return this
} }
/** /**
* 扩展函数:将数组以花括号格式打印,元素间用逗号分隔 * 扩展函数:将数组以花括号格式打印,元素间用逗号分隔
* @return 原始数组 * @return 原始数组
*/ */
@JvmStatic @JvmStatic
fun <T> Array<T>.println(): Array<T> { fun <T> Array<T>.println(): Array<T> {
println("{" + ",".join(this) + "}") println("{" + ",".join(this) + "}")
return this return this
} }
/** /**
* 扩展函数:打印任意对象并返回该对象 * 扩展函数:打印任意对象并返回该对象
* @return 原始对象 * @return 原始对象
*/ */
@JvmStatic @JvmStatic
fun <T> T.println(): T { fun <T> T.println(): T {
println(this) println(this)
return this return this
} }
/** /**
* 原始标准输出流的备份 * 原始标准输出流的备份
*/ */
@JvmStatic @JvmStatic
val originalOut: PrintStream = System.out val originalOut: PrintStream = System.out
/** /**
* 原始错误输出流的备份 * 原始错误输出流的备份
*/ */
@JvmStatic @JvmStatic
val originalErr: PrintStream = System.err val originalErr: PrintStream = System.err
/** /**
* 用于记录标准输出的日志记录器 * 用于记录标准输出的日志记录器
*/ */
@JvmStatic @JvmStatic
val outLog: Logger = MingLiLoggerFactory.getLogger("out") val outLog: Logger = MingLiLoggerFactory.getLogger("out")
/** /**
* 用于记录错误输出的日志记录器 * 用于记录错误输出的日志记录器
*/ */
@JvmStatic @JvmStatic
val errLog: Logger = MingLiLoggerFactory.getLogger("err") val errLog: Logger = MingLiLoggerFactory.getLogger("err")
/** /**
* 打印多个参数,使用空格分隔 * 打印多个参数,使用空格分隔
* @param args 要打印的参数数组 * @param args 要打印的参数数组
*/ */
@JvmStatic @JvmStatic
fun print(vararg args: Any?) { fun print(vararg args: Any?) {
printA(" ", *args) printA(" ", *args)
} }
/** /**
* 打印多个参数并换行,使用空格分隔 * 打印多个参数并换行,使用空格分隔
* @param args 要打印的参数数组 * @param args 要打印的参数数组
*/ */
@JvmStatic @JvmStatic
fun println(vararg args: Any?) { fun println(vararg args: Any?) {
printlnA(" ", *args) printlnA(" ", *args)
} }
/** /**
* 打印多个参数并换行,指定分隔符 * 打印多个参数并换行,指定分隔符
* @param sp 分隔符 * @param sp 分隔符
* @param args 要打印的参数数组 * @param args 要打印的参数数组
*/ */
@JvmStatic @JvmStatic
fun printlnA(sp: String, vararg args: Any?) { fun printlnA(sp: String, vararg args: Any?) {
printA(" ", *args) printA(" ", *args)
kotlin.io.println() kotlin.io.println()
} }
/** /**
* 打印多个参数,指定分隔符 * 打印多个参数,指定分隔符
* @param sp 分隔符,默认为空字符串 * @param sp 分隔符,默认为空字符串
* @param args 要打印的参数数组 * @param args 要打印的参数数组
*/ */
@JvmStatic @JvmStatic
fun printA(sp: String = "", vararg args: Any?) { fun printA(sp: String = "", vararg args: Any?) {
if (args.isEmpty()) { if (args.isEmpty()) {
kotlin.io.println() kotlin.io.println()
} }
val sb = StringBuilder() val sb = StringBuilder()
for (i in args.indices) { for (i in args.indices) {
sb.append(args[i]) sb.append(args[i])
if (i < args.size - 1) sb.append(sp) if (i < args.size - 1) sb.append(sp)
} }
kotlin.io.print(sb) kotlin.io.print(sb)
} }
/** /**
* 重定向 System.out 到 INFO 级别日志 * 重定向 System.out 到 INFO 级别日志
* 创建自定义PrintStream,将输出内容缓冲并记录到INFO级别日志中 * 创建自定义PrintStream,将输出内容缓冲并记录到INFO级别日志中
*/ */
@JvmStatic @JvmStatic
fun redirectOutToInfo() { fun redirectOutToInfo() {
val outLogger = PrintStream(object : OutputStream() { val outLogger = PrintStream(object : OutputStream() {
private val buffer = StringBuilder() private val buffer = StringBuilder()
override fun write(b: Int) { override fun write(b: Int) {
if (b == '\n'.code) { if (b == '\n'.code) {
flushBuffer() flushBuffer()
} else { } else {
buffer.append(b.toChar()) buffer.append(b.toChar())
} }
} }
override fun write(b: ByteArray, off: Int, len: Int) { override fun write(b: ByteArray, off: Int, len: Int) {
val str = String(b, off, len) val str = String(b, off, len)
if (str.contains("\n")) { if (str.contains("\n")) {
val lines = str.split("\n") val lines = str.split("\n")
lines.forEachIndexed { index, line -> lines.forEachIndexed { index, line ->
if (index == lines.size - 1 && !str.endsWith("\n")) { if (index == lines.size - 1 && !str.endsWith("\n")) {
buffer.append(line) buffer.append(line)
} else { } else {
buffer.append(line) buffer.append(line)
flushBuffer() flushBuffer()
} }
} }
} else { } else {
buffer.append(str) buffer.append(str)
} }
} }
private fun flushBuffer() { private fun flushBuffer() {
val message = buffer.toString().trim() val message = buffer.toString().trim()
if (message.isNotBlank()) { if (message.isNotBlank()) {
outLog.info(message) outLog.info(message)
} }
buffer.clear() buffer.clear()
} }
override fun flush() { override fun flush() {
flushBuffer() flushBuffer()
super.flush() super.flush()
} }
}, true) }, true)
System.setOut(outLogger) System.setOut(outLogger)
} }
/** /**
* 重定向 System.err 到 ERROR 级别 * 重定向 System.err 到 ERROR 级别
* 创建自定义PrintStream,将错误输出内容缓冲并记录到ERROR级别日志中 * 创建自定义PrintStream,将错误输出内容缓冲并记录到ERROR级别日志中
*/ */
@JvmStatic @JvmStatic
fun redirectErrToError() { fun redirectErrToError() {
val errLogger = PrintStream(object : OutputStream() { val errLogger = PrintStream(object : OutputStream() {
private val buffer = StringBuilder() private val buffer = StringBuilder()
override fun write(b: Int) { override fun write(b: Int) {
if (b == '\n'.code) { if (b == '\n'.code) {
flushBuffer() flushBuffer()
} else { } else {
buffer.append(b.toChar()) buffer.append(b.toChar())
} }
} }
override fun write(b: ByteArray, off: Int, len: Int) { override fun write(b: ByteArray, off: Int, len: Int) {
val str = String(b, off, len) val str = String(b, off, len)
if (str.contains("\n")) { if (str.contains("\n")) {
val lines = str.split("\n") val lines = str.split("\n")
lines.forEachIndexed { index, line -> lines.forEachIndexed { index, line ->
if (index == lines.size - 1 && !str.endsWith("\n")) { if (index == lines.size - 1 && !str.endsWith("\n")) {
buffer.append(line) buffer.append(line)
} else { } else {
buffer.append(line) buffer.append(line)
flushBuffer() flushBuffer()
} }
} }
} else { } else {
buffer.append(str) buffer.append(str)
} }
} }
private fun flushBuffer() { private fun flushBuffer() {
val message = buffer.toString().trim() val message = buffer.toString().trim()
if (message.isNotBlank()) { if (message.isNotBlank()) {
errLog.error(message) errLog.error(message)
} }
buffer.clear() buffer.clear()
} }
override fun flush() { override fun flush() {
flushBuffer() flushBuffer()
super.flush() super.flush()
} }
}, true) }, true)
System.setErr(errLogger) System.setErr(errLogger)
} }
/** /**
* 完全重定向(包括第三方库的输出) * 完全重定向(包括第三方库的输出)
* 同时重定向标准输出和错误输出到对应的日志级别 * 同时重定向标准输出和错误输出到对应的日志级别
*/ */
@JvmStatic @JvmStatic
fun redirectAll() { fun redirectAll() {
redirectOutToInfo() redirectOutToInfo()
redirectErrToError() redirectErrToError()
} }
/** /**
* 恢复原始输出流 * 恢复原始输出流
* 将System.out和System.err恢复到原始状态 * 将System.out和System.err恢复到原始状态
*/ */
@JvmStatic @JvmStatic
fun restore() { fun restore() {
System.setOut(originalOut) System.setOut(originalOut)
System.setErr(originalErr) System.setErr(originalErr)
} }
} }
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile FieldStructure.kt * CurrentFile FieldStructure.kt
* LastUpdate 2026-07-02 10:22:42 * LastUpdate 2026-11-04 11:53:07
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -30,31 +30,31 @@ import java.lang.reflect.Modifier
* 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段, * 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段,
* 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。 * 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。
*/ */
open class FieldStructure : Structure() { abstract class FieldStructure : Structure() {
/** /**
* 获取结构体字段顺序列表 * 获取结构体字段顺序列表
* 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段, * 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段,
* 按照字段在类中声明的顺序返回字段名列表。 * 按照字段在类中声明的顺序返回字段名列表。
* *
* @return 包含字段名的列表,按声明顺序排列 * @return 包含字段名的列表,按声明顺序排列
*/ */
override fun getFieldOrder(): MutableList<String> { override fun getFieldOrder(): MutableList<String> {
val fieldOrderList: MutableList<String> = ArrayList() val fieldOrderList: MutableList<String> = ArrayList()
var cls: Class<*> = javaClass var cls: Class<*> = javaClass
while (cls != FieldStructure::class.java) { while (cls != FieldStructure::class.java) {
val fields = cls.getDeclaredFields() val fields = cls.getDeclaredFields()
var modifiers: Int var modifiers: Int
for (field in fields) { for (field in fields) {
modifiers = field.modifiers modifiers = field.modifiers
if (Modifier.isStatic(modifiers) || if (Modifier.isStatic(modifiers) ||
!Modifier.isPublic(modifiers) !Modifier.isPublic(modifiers)
) { ) {
continue continue
} }
fieldOrderList.add(field.name) fieldOrderList.add(field.name)
} }
cls = cls.getSuperclass() cls = cls.getSuperclass()
} }
return fieldOrderList return fieldOrderList
} }
} }
File diff suppressed because it is too large Load Diff
@@ -38,211 +38,211 @@ import java.lang.reflect.Type
class Jackson3JsonApi : JsonApi { class Jackson3JsonApi : JsonApi {
var get: () -> ObjectMapper = { _prObjectMapper!! } var get: () -> ObjectMapper = { _prObjectMapper!! }
var set: (ObjectMapper) -> Unit = { _prObjectMapper = it } var set: (ObjectMapper) -> Unit = { _prObjectMapper = it }
private var _prObjectMapper: ObjectMapper? = null private var _prObjectMapper: ObjectMapper? = null
var objectMapper: ObjectMapper var objectMapper: ObjectMapper
get() = get() get() = get()
private set(value) = set(value) private set(value) = set(value)
constructor(objectMapper: ObjectMapper) { constructor(objectMapper: ObjectMapper) {
_prObjectMapper = objectMapper _prObjectMapper = objectMapper
} }
constructor( constructor(
get: () -> ObjectMapper, get: () -> ObjectMapper,
set: (ObjectMapper) -> Unit, set: (ObjectMapper) -> Unit,
) { ) {
this.get = get this.get = get
this.set = set this.set = set
} }
constructor() { constructor() {
_prObjectMapper = ObjectMapper() _prObjectMapper = ObjectMapper()
} }
override fun <T> parse(json: String, clazz: Class<T>): T { override fun <T> parse(json: String, clazz: Class<T>): T {
try { try {
return objectMapper.readValue(json, clazz) return objectMapper.readValue(json, clazz)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to parse JSON to ${clazz.simpleName}", e) throw JsonException("Failed to parse JSON to ${clazz.simpleName}", e)
} }
} }
override fun <T> parse(json: String, type: JsonTypeReference<T>): T { override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
try { try {
return objectMapper.readValue(json, object : TypeReference<T>() { return objectMapper.readValue(json, object : TypeReference<T>() {
override fun getType(): Type = type.type override fun getType(): Type = type.type
}) })
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to parse JSON to type: $type", e) throw JsonException("Failed to parse JSON to type: $type", e)
} }
} }
override fun format(obj: Any): String { override fun format(obj: Any): String {
try { try {
return objectMapper.writeValueAsString(obj) return objectMapper.writeValueAsString(obj)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to format object to JSON: ${obj.javaClass.simpleName}", e) throw JsonException("Failed to format object to JSON: ${obj.javaClass.simpleName}", e)
} }
} }
override fun formatPretty(obj: Any): String { override fun formatPretty(obj: Any): String {
try { try {
return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj) return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to format object to pretty JSON: ${obj.javaClass.simpleName}", e) throw JsonException("Failed to format object to pretty JSON: ${obj.javaClass.simpleName}", e)
} }
} }
override fun isValidJson(json: String): Boolean { override fun isValidJson(json: String): Boolean {
return try { return try {
objectMapper.readTree(json) objectMapper.readTree(json)
true true
} catch (_: Exception) { } catch (_: Exception) {
false false
} }
} }
override fun merge(vararg jsons: String): String { override fun merge(vararg jsons: String): String {
try { try {
if (jsons.isEmpty()) return "{}" if (jsons.isEmpty()) return "{}"
val resultNode = objectMapper.createObjectNode() val resultNode = objectMapper.createObjectNode()
for (json in jsons) { for (json in jsons) {
val node = objectMapper.readTree(json) val node = objectMapper.readTree(json)
if (node is ObjectNode) { if (node is ObjectNode) {
resultNode.setAll(node) resultNode.setAll(node)
} else { } else {
throw JsonException("Cannot merge non-object JSON: $json") throw JsonException("Cannot merge non-object JSON: $json")
} }
} }
return objectMapper.writeValueAsString(resultNode) return objectMapper.writeValueAsString(resultNode)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to merge JSON objects", e) throw JsonException("Failed to merge JSON objects", e)
} }
} }
override fun getNodeValue(json: String, path: String): String? { override fun getNodeValue(json: String, path: String): String? {
try { try {
val rootNode = objectMapper.readTree(json) val rootNode = objectMapper.readTree(json)
val node = rootNode.at(path) val node = rootNode.at(path)
return if (node.isMissingNode || node.isNull) { return if (node.isMissingNode || node.isNull) {
null null
} else { } else {
node.asString() node.asString()
} }
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to get node value at path: $path", e) throw JsonException("Failed to get node value at path: $path", e)
} }
} }
override fun updateNodeValue(json: String, path: String, newValue: Any): String { override fun updateNodeValue(json: String, path: String, newValue: Any): String {
try { try {
val rootNode = objectMapper.readTree(json) val rootNode = objectMapper.readTree(json)
// 处理 JSON Pointer 路径 // 处理 JSON Pointer 路径
val pathParts = path.split("/").filter { it.isNotEmpty() } val pathParts = path.split("/").filter { it.isNotEmpty() }
if (pathParts.isEmpty()) { if (pathParts.isEmpty()) {
// 替换整个根节点 // 替换整个根节点
return objectMapper.writeValueAsString(newValue) return objectMapper.writeValueAsString(newValue)
} }
when (val parentNode = findParentNode(rootNode, pathParts)) { when (val parentNode = findParentNode(rootNode, pathParts)) {
is ObjectNode -> { is ObjectNode -> {
val fieldName = pathParts.last() val fieldName = pathParts.last()
val valueNode = objectMapper.valueToTree<JsonNode>(newValue) val valueNode = objectMapper.valueToTree<JsonNode>(newValue)
parentNode.replace(fieldName, valueNode) parentNode.replace(fieldName, valueNode)
} }
else -> { else -> {
throw JsonException("Cannot update node: parent is not an object node at path: $path") throw JsonException("Cannot update node: parent is not an object node at path: $path")
} }
} }
return objectMapper.writeValueAsString(rootNode) return objectMapper.writeValueAsString(rootNode)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to update node value at path: $path", e) throw JsonException("Failed to update node value at path: $path", e)
} }
} }
override fun <D> convert(source: Any, destinationClass: Class<D>): D { override fun <D> convert(source: Any, destinationClass: Class<D>): D {
try { try {
return objectMapper.convertValue(source, destinationClass) return objectMapper.convertValue(source, destinationClass)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException( throw JsonException(
"Failed to convert from ${source.javaClass.simpleName} to ${destinationClass.simpleName}", e "Failed to convert from ${source.javaClass.simpleName} to ${destinationClass.simpleName}", e
) )
} }
} }
override fun <D> convert( override fun <D> convert(
source: Any, source: Any,
destinationType: JsonTypeReference<D>, destinationType: JsonTypeReference<D>,
): D { ): D {
try { try {
return objectMapper.convertValue(source, object : TypeReference<D>() { return objectMapper.convertValue(source, object : TypeReference<D>() {
override fun getType(): Type = destinationType.type override fun getType(): Type = destinationType.type
}) })
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to convert from ${source.javaClass.simpleName} to type: $destinationType", e) throw JsonException("Failed to convert from ${source.javaClass.simpleName} to type: $destinationType", e)
} }
} }
// 辅助方法:查找父节点 // 辅助方法:查找父节点
private fun findParentNode(root: JsonNode, pathParts: List<String>): JsonNode { private fun findParentNode(root: JsonNode, pathParts: List<String>): JsonNode {
var current: JsonNode = root var current: JsonNode = root
// 遍历到最后一个元素之前(即找到父节点) // 遍历到最后一个元素之前(即找到父节点)
for (i in 0 until pathParts.size - 1) { for (i in 0 until pathParts.size - 1) {
val part = pathParts[i] val part = pathParts[i]
current = when { current = when {
part.matches(Regex("\\d+")) -> current.get(part.toInt()) part.matches(Regex("\\d+")) -> current.get(part.toInt())
else -> current.get(part) else -> current.get(part)
} ?: throw JsonException("Path not found: ${pathParts.subList(0, i + 1).joinToString("/")}") } ?: throw JsonException("Path not found: ${pathParts.subList(0, i + 1).joinToString("/")}")
} }
return current return current
} }
override fun addJsonConverter(c: BaseJsonConverter<*, *>) { override fun addJsonConverter(c: BaseJsonConverter<*, *>) {
val mapperBuilder = Jackson3ApiJavaHelper.rebuild(objectMapper) val mapperBuilder = Jackson3ApiJavaHelper.rebuild(objectMapper)
mapperBuilder.addModule(c.getJackson3Module()) mapperBuilder.addModule(c.getJackson3Module())
this.objectMapper = mapperBuilder.build() this.objectMapper = mapperBuilder.build()
} }
override fun parseJsonItem(json: String): JsonItem { override fun parseJsonItem(json: String): JsonItem {
try { try {
return getJsonItem(objectMapper.readTree(json)) return getJsonItem(objectMapper.readTree(json))
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to parseJsonItem", e) throw JsonException("Failed to parseJsonItem", e)
} }
} }
} }
class JackSon3JsonItem : JsonItem { class JackSon3JsonItem : JsonItem {
companion object { companion object {
fun getJsonItem(node: JsonNode): JsonItem { fun getJsonItem(node: JsonNode): JsonItem {
return when (node.nodeType) { return when (node.nodeType) {
JsonNodeType.OBJECT -> JackSon3JsonObject(node) JsonNodeType.OBJECT -> JackSon3JsonObject(node)
JsonNodeType.ARRAY -> JackSon3JsonArray(node) JsonNodeType.ARRAY -> JackSon3JsonArray(node)
JsonNodeType.BOOLEAN -> JackSon3JsonBoolean(node) JsonNodeType.BOOLEAN -> JackSon3JsonBoolean(node)
JsonNodeType.NULL -> JsonNull() JsonNodeType.NULL -> JsonNull()
JsonNodeType.NUMBER -> JackSon3JsonNumber(node) JsonNodeType.NUMBER -> JackSon3JsonNumber(node)
JsonNodeType.STRING -> JackSon3JsonString(node) JsonNodeType.STRING -> JackSon3JsonString(node)
else -> throw IllegalStateException("unknown type ${node.nodeType}") else -> throw IllegalStateException("unknown type ${node.nodeType}")
} }
} }
} }
} }
class JackSon3JsonNumber(node: JsonNode) : JsonNumber(node.asString()) class JackSon3JsonNumber(node: JsonNode) : JsonNumber(node.asString())
@@ -251,47 +251,47 @@ class JackSon3JsonString(node: JsonNode) : JsonString(node.asString())
class JackSon3JsonArray(val node: JsonNode) : JsonArray() { class JackSon3JsonArray(val node: JsonNode) : JsonArray() {
override fun getIndex(index: Int): JsonItem { override fun getIndex(index: Int): JsonItem {
return JackSon3JsonItem.getJsonItem(node.get(index)) return JackSon3JsonItem.getJsonItem(node.get(index))
} }
override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> { override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> {
val iteet = node.iterator().withIndex() val iteet = node.iterator().withIndex()
return object : Iterator<IndexedValue<JsonItem>> { return object : Iterator<IndexedValue<JsonItem>> {
override fun next(): IndexedValue<JsonItem> { override fun next(): IndexedValue<JsonItem> {
val it = iteet.next() val it = iteet.next()
return IndexedValue(it.index, JackSon3JsonItem.getJsonItem(it.value)) return IndexedValue(it.index, JackSon3JsonItem.getJsonItem(it.value))
} }
override fun hasNext(): Boolean { override fun hasNext(): Boolean {
return iteet.hasNext() return iteet.hasNext()
} }
} }
} }
} }
class JackSon3JsonObject(val node: JsonNode) : JsonObject() { class JackSon3JsonObject(val node: JsonNode) : JsonObject() {
override fun getField(name: String): JsonItem { override fun getField(name: String): JsonItem {
return JackSon3JsonItem.getJsonItem(node.get(name)) return JackSon3JsonItem.getJsonItem(node.get(name))
} }
override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> { override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> {
return object : Iterator<Map.Entry<String, JsonItem>> { return object : Iterator<Map.Entry<String, JsonItem>> {
val it = node.properties().iterator() val it = node.properties().iterator()
override fun next(): Map.Entry<String, JsonItem> { override fun next(): Map.Entry<String, JsonItem> {
val utem = it.next() val utem = it.next()
return object : Map.Entry<String, JsonItem> { return object : Map.Entry<String, JsonItem> {
override val key: String override val key: String
get() = utem.key get() = utem.key
override val value: JsonItem override val value: JsonItem
get() = JackSon3JsonItem.getJsonItem(utem.value) get() = JackSon3JsonItem.getJsonItem(utem.value)
} }
} }
override fun hasNext(): Boolean { override fun hasNext(): Boolean {
return it.hasNext() return it.hasNext()
} }
} }
} }
} }
@@ -42,284 +42,284 @@ import com.mingliqiye.utils.json.objects.base.*
*/ */
class JacksonJsonApi : JsonApi { class JacksonJsonApi : JsonApi {
private val objectMapper: ObjectMapper private val objectMapper: ObjectMapper
/** /**
* 使用默认的ObjectMapper构造实例 * 使用默认的ObjectMapper构造实例
*/ */
constructor() { constructor() {
this.objectMapper = ObjectMapper() this.objectMapper = ObjectMapper()
} }
fun getObjectMapper() = objectMapper fun getObjectMapper() = objectMapper
/** /**
* 使用指定的ObjectMapper构造实例 * 使用指定的ObjectMapper构造实例
* *
* @param objectMapper 自定义的ObjectMapper实例 * @param objectMapper 自定义的ObjectMapper实例
*/ */
constructor(objectMapper: ObjectMapper) { constructor(objectMapper: ObjectMapper) {
this.objectMapper = objectMapper this.objectMapper = objectMapper
} }
/** /**
* 将JSON字符串解析为指定类型的对象 * 将JSON字符串解析为指定类型的对象
* *
* @param json 待解析的JSON字符串 * @param json 待解析的JSON字符串
* @param clazz 目标对象类型 * @param clazz 目标对象类型
* @param <T> 泛型参数,表示目标对象类型 * @param <T> 泛型参数,表示目标对象类型
* @return 解析后的对象 * @return 解析后的对象
* @throws JsonException 当解析失败时抛出异常 * @throws JsonException 当解析失败时抛出异常
*/ */
override fun <T> parse(json: String, clazz: Class<T>): T { override fun <T> parse(json: String, clazz: Class<T>): T {
return try { return try {
objectMapper.readValue(json, clazz) objectMapper.readValue(json, clazz)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to parse JSON string", e) throw JsonException("Failed to parse JSON string", e)
} }
} }
/** /**
* 将JSON字符串解析为复杂泛型结构的对象(如List、Map等) * 将JSON字符串解析为复杂泛型结构的对象(如List、Map等)
* *
* @param json JSON字符串 * @param json JSON字符串
* @param type 泛型类型引用 * @param type 泛型类型引用
* @param <T> 泛型参数,表示目标对象类型 * @param <T> 泛型参数,表示目标对象类型
* @return 解析后的对象 * @return 解析后的对象
* @throws JsonException 当解析失败时抛出异常 * @throws JsonException 当解析失败时抛出异常
*/ */
override fun <T> parse(json: String, type: JsonTypeReference<T>): T { override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
return try { return try {
val reader: ObjectReader = objectMapper.readerFor( val reader: ObjectReader = objectMapper.readerFor(
objectMapper.constructType(type.type) objectMapper.constructType(type.type)
) )
reader.readValue(json) reader.readValue(json)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to parse JSON string", e) throw JsonException("Failed to parse JSON string", e)
} }
} }
/** /**
* 将对象格式化为JSON字符串 * 将对象格式化为JSON字符串
* *
* @return 格式化后的JSON字符串 * @return 格式化后的JSON字符串
* @throws JsonException 当格式化失败时抛出异常 * @throws JsonException 当格式化失败时抛出异常
*/ */
override fun format(obj: Any): String { override fun format(obj: Any): String {
return try { return try {
objectMapper.writeValueAsString(obj) objectMapper.writeValueAsString(obj)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException( throw JsonException(
"Failed to format object to JSON string", e "Failed to format object to JSON string", e
) )
} }
} }
fun formatUnicode(obj: Any): String { fun formatUnicode(obj: Any): String {
return try { return try {
objectMapper.writer().with(JsonGenerator.Feature.ESCAPE_NON_ASCII).writeValueAsString(obj) objectMapper.writer().with(JsonGenerator.Feature.ESCAPE_NON_ASCII).writeValueAsString(obj)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException(throwable = e) throw JsonException(throwable = e)
} }
} }
/** /**
* 将对象格式化为美化(带缩进)的JSON字符串 * 将对象格式化为美化(带缩进)的JSON字符串
* *
* @return 美化后的JSON字符串 * @return 美化后的JSON字符串
* @throws JsonException 当格式化失败时抛出异常 * @throws JsonException 当格式化失败时抛出异常
*/ */
override fun formatPretty(obj: Any): String { override fun formatPretty(obj: Any): String {
return try { return try {
objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj) objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException( throw JsonException(
"Failed to format object to pretty JSON string", e "Failed to format object to pretty JSON string", e
) )
} }
} }
fun formatPrettyUnicode(obj: Any): String { fun formatPrettyUnicode(obj: Any): String {
return try { return try {
objectMapper.writerWithDefaultPrettyPrinter().with(JsonGenerator.Feature.ESCAPE_NON_ASCII) objectMapper.writerWithDefaultPrettyPrinter().with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
.writeValueAsString(obj) .writeValueAsString(obj)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException( throw JsonException(
"Failed to format object to pretty JSON string", e "Failed to format object to pretty JSON string", e
) )
} }
} }
/** /**
* 判断给定字符串是否是有效的JSON格式 * 判断给定字符串是否是有效的JSON格式
* *
* @param json 待验证的字符串 * @param json 待验证的字符串
* @return 如果是有效JSON返回true,否则返回false * @return 如果是有效JSON返回true,否则返回false
*/ */
override fun isValidJson(json: String): Boolean { override fun isValidJson(json: String): Boolean {
return try { return try {
objectMapper.readTree(json) objectMapper.readTree(json)
true true
} catch (_: Exception) { } catch (_: Exception) {
false false
} }
} }
/** /**
* 合并多个JSON字符串为一个JSON对象 * 合并多个JSON字符串为一个JSON对象
* *
* @param jsons 多个JSON字符串 * @param jsons 多个JSON字符串
* @return 合并后的JSON字符串 * @return 合并后的JSON字符串
* @throws JsonException 当合并失败时抛出异常 * @throws JsonException 当合并失败时抛出异常
*/ */
override fun merge(vararg jsons: String): String { override fun merge(vararg jsons: String): String {
val result: ObjectNode = objectMapper.createObjectNode() val result: ObjectNode = objectMapper.createObjectNode()
for (json in jsons) { for (json in jsons) {
try { try {
val node: JsonNode = objectMapper.readTree(json) val node: JsonNode = objectMapper.readTree(json)
if (node.isObject) { if (node.isObject) {
result.setAll<JsonNode>(node as ObjectNode) result.setAll<JsonNode>(node as ObjectNode)
} }
} catch (_: Exception) { } catch (_: Exception) {
} }
} }
return try { return try {
objectMapper.writeValueAsString(result) objectMapper.writeValueAsString(result)
} catch (e: JsonProcessingException) { } catch (e: JsonProcessingException) {
throw JsonException("Failed to merge JSON strings", e) throw JsonException("Failed to merge JSON strings", e)
} }
} }
/** /**
* 获取JSON字符串中指定路径的节点值 * 获取JSON字符串中指定路径的节点值
* *
* @param json JSON字符串 * @param json JSON字符串
* @param path 节点路径,使用"."分隔 * @param path 节点路径,使用"."分隔
* @return 节点值的文本表示,如果路径不存在则返回null * @return 节点值的文本表示,如果路径不存在则返回null
* @throws JsonException 当获取节点值失败时抛出异常 * @throws JsonException 当获取节点值失败时抛出异常
*/ */
override fun getNodeValue(json: String, path: String): String? { override fun getNodeValue(json: String, path: String): String? {
return try { return try {
var node: JsonNode = objectMapper.readTree(json) var node: JsonNode = objectMapper.readTree(json)
val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray() val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
for (p in paths) { for (p in paths) {
node = node.get(p) node = node.get(p)
} }
node.asText() node.asText()
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to get node value", e) throw JsonException("Failed to get node value", e)
} }
} }
/** /**
* 更新JSON字符串中指定路径的节点值 * 更新JSON字符串中指定路径的节点值
* *
* @param json JSON字符串 * @param json JSON字符串
* @param path 节点路径,使用"."分隔 * @param path 节点路径,使用"."分隔
* @param newValue 新的节点值 * @param newValue 新的节点值
* @return 更新后的JSON字符串 * @return 更新后的JSON字符串
* @throws JsonException 当更新节点值失败时抛出异常 * @throws JsonException 当更新节点值失败时抛出异常
*/ */
override fun updateNodeValue(json: String, path: String, newValue: Any): String { override fun updateNodeValue(json: String, path: String, newValue: Any): String {
return try { return try {
val node: JsonNode = objectMapper.readTree(json) val node: JsonNode = objectMapper.readTree(json)
if (node is ObjectNode) { if (node is ObjectNode) {
val objectNode: ObjectNode = node val objectNode: ObjectNode = node
val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray() val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
var current: JsonNode = objectNode var current: JsonNode = objectNode
// 导航到目标节点的父节点 // 导航到目标节点的父节点
for (i in 0 until paths.size - 1) { for (i in 0 until paths.size - 1) {
current = current.get(paths[i]) current = current.get(paths[i])
if (current !is ObjectNode) { if (current !is ObjectNode) {
return json // 路径不存在或无效 return json // 路径不存在或无效
} }
} }
// 更新值 // 更新值
if (current is ObjectNode) { if (current is ObjectNode) {
val parent: ObjectNode = current val parent: ObjectNode = current
parent.set<JsonNode>( parent.set<JsonNode>(
paths[paths.size - 1], objectMapper.valueToTree(newValue) paths[paths.size - 1], objectMapper.valueToTree(newValue)
) )
} }
objectMapper.writeValueAsString(objectNode) objectMapper.writeValueAsString(objectNode)
} }
json json
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to update node value", e) throw JsonException("Failed to update node value", e)
} }
} }
/** /**
* 在不同对象类型之间进行转换 * 在不同对象类型之间进行转换
* *
* @param source 源对象 * @param source 源对象
* @param destinationClass 目标对象类型 * @param destinationClass 目标对象类型
* @param <T> 源对象类型 * @param <T> 源对象类型
* @param <D> 目标对象类型 * @param <D> 目标对象类型
* @return 转换后的对象 * @return 转换后的对象
*/ */
override fun <D> convert(source: Any, destinationClass: Class<D>): D { override fun <D> convert(source: Any, destinationClass: Class<D>): D {
try { try {
return objectMapper.convertValue(source, destinationClass) return objectMapper.convertValue(source, destinationClass)
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to update node value", e) throw JsonException("Failed to update node value", e)
} }
} }
/** /**
* 在不同泛型对象类型之间进行转换 * 在不同泛型对象类型之间进行转换
* *
* @param source 源对象 * @param source 源对象
* @param destinationType 目标对象的泛型类型引用 * @param destinationType 目标对象的泛型类型引用
* @param <T> 源对象类型 * @param <T> 源对象类型
* @param <D> 目标对象类型 * @param <D> 目标对象类型
* @return 转换后的对象 * @return 转换后的对象
*/ */
override fun <D> convert(source: Any, destinationType: JsonTypeReference<D>): D { override fun <D> convert(source: Any, destinationType: JsonTypeReference<D>): D {
try { try {
return objectMapper.convertValue( return objectMapper.convertValue(
source, objectMapper.constructType(destinationType.type) source, objectMapper.constructType(destinationType.type)
) )
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to update node value", e) throw JsonException("Failed to update node value", e)
} }
} }
override fun addJsonConverter(c: BaseJsonConverter<*, *>) { override fun addJsonConverter(c: BaseJsonConverter<*, *>) {
try { try {
objectMapper.registerModule(c.getJacksonModule()) objectMapper.registerModule(c.getJacksonModule())
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to update node value", e) throw JsonException("Failed to update node value", e)
} }
} }
override fun parseJsonItem(json: String): JsonItem { override fun parseJsonItem(json: String): JsonItem {
try { try {
return getJsonItem(objectMapper.readTree(json)) return getJsonItem(objectMapper.readTree(json))
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException("Failed to parseJsonItem", e) throw JsonException("Failed to parseJsonItem", e)
} }
} }
} }
class JackSonJsonItem : JsonItem { class JackSonJsonItem : JsonItem {
companion object { companion object {
fun getJsonItem(node: JsonNode): JsonItem { fun getJsonItem(node: JsonNode): JsonItem {
return when (node.nodeType) { return when (node.nodeType) {
JsonNodeType.OBJECT -> JackSonJsonObject(node) JsonNodeType.OBJECT -> JackSonJsonObject(node)
JsonNodeType.ARRAY -> JackSonJsonArray(node) JsonNodeType.ARRAY -> JackSonJsonArray(node)
JsonNodeType.BOOLEAN -> JackSonJsonBoolean(node) JsonNodeType.BOOLEAN -> JackSonJsonBoolean(node)
JsonNodeType.NULL -> JsonNull() JsonNodeType.NULL -> JsonNull()
JsonNodeType.NUMBER -> JackSonJsonNumber(node) JsonNodeType.NUMBER -> JackSonJsonNumber(node)
JsonNodeType.STRING -> JackSonJsonString(node) JsonNodeType.STRING -> JackSonJsonString(node)
else -> throw IllegalStateException("unknown type ${node.nodeType}") else -> throw IllegalStateException("unknown type ${node.nodeType}")
} }
} }
} }
} }
class JackSonJsonNumber(node: JsonNode) : JsonNumber(node.asText()) class JackSonJsonNumber(node: JsonNode) : JsonNumber(node.asText())
@@ -328,47 +328,47 @@ class JackSonJsonString(node: JsonNode) : JsonString(node.asText())
class JackSonJsonArray(val node: JsonNode) : JsonArray() { class JackSonJsonArray(val node: JsonNode) : JsonArray() {
override fun getIndex(index: Int): JsonItem { override fun getIndex(index: Int): JsonItem {
return getJsonItem(node.get(index)) return getJsonItem(node.get(index))
} }
override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> { override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> {
val iteet = node.iterator().withIndex() val iteet = node.iterator().withIndex()
return object : Iterator<IndexedValue<JsonItem>> { return object : Iterator<IndexedValue<JsonItem>> {
override fun next(): IndexedValue<JsonItem> { override fun next(): IndexedValue<JsonItem> {
val it = iteet.next() val it = iteet.next()
return IndexedValue(it.index, getJsonItem(it.value)) return IndexedValue(it.index, getJsonItem(it.value))
} }
override fun hasNext(): Boolean { override fun hasNext(): Boolean {
return iteet.hasNext() return iteet.hasNext()
} }
} }
} }
} }
class JackSonJsonObject(val node: JsonNode) : JsonObject() { class JackSonJsonObject(val node: JsonNode) : JsonObject() {
override fun getField(name: String): JsonItem { override fun getField(name: String): JsonItem {
return getJsonItem(node.get(name)) return getJsonItem(node.get(name))
} }
override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> { override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> {
return object : Iterator<Map.Entry<String, JsonItem>> { return object : Iterator<Map.Entry<String, JsonItem>> {
val it = node.properties().iterator() val it = node.properties().iterator()
override fun next(): Map.Entry<String, JsonItem> { override fun next(): Map.Entry<String, JsonItem> {
val utem = it.next() val utem = it.next()
return object : Map.Entry<String, JsonItem> { return object : Map.Entry<String, JsonItem> {
override val key: String override val key: String
get() = utem.key get() = utem.key
override val value: JsonItem override val value: JsonItem
get() = getJsonItem(utem.value) get() = getJsonItem(utem.value)
} }
} }
override fun hasNext(): Boolean { override fun hasNext(): Boolean {
return it.hasNext() return it.hasNext()
} }
} }
} }
} }
File diff suppressed because it is too large Load Diff
@@ -34,148 +34,148 @@ import java.util.*
*/ */
abstract class JsonTypeReference<T> : Comparable<JsonTypeReference<T>> { abstract class JsonTypeReference<T> : Comparable<JsonTypeReference<T>> {
open var type: Type = Any::class.java open var type: Type = Any::class.java
/** /**
* 构造函数,通过反射获取泛型类型信息 * 构造函数,通过反射获取泛型类型信息
* 仅供内部匿名子类使用 * 仅供内部匿名子类使用
*/ */
protected constructor() { protected constructor() {
val superClass: Type = this.javaClass.genericSuperclass val superClass: Type = this.javaClass.genericSuperclass
// 检查是否为匿名子类,防止直接实例化导致无法获取泛型信息 // 检查是否为匿名子类,防止直接实例化导致无法获取泛型信息
if (superClass is Class<*>) { if (superClass is Class<*>) {
throw IllegalArgumentException( throw IllegalArgumentException(
"必须使用匿名子类方式创建 JsonTypeReference," + "必须使用匿名子类方式创建 JsonTypeReference," +
"例如: new JsonTypeReference<List<String>>() {}" "例如: new JsonTypeReference<List<String>>() {}"
) )
} }
this.type = (superClass as ParameterizedType).actualTypeArguments[0] this.type = (superClass as ParameterizedType).actualTypeArguments[0]
} }
/** /**
* 构造函数,直接指定类型 * 构造函数,直接指定类型
* @param type 具体的类型信息 * @param type 具体的类型信息
*/ */
protected constructor(type: Type) { protected constructor(type: Type) {
this.type = Objects.requireNonNull(type, "Type cannot be null") this.type = Objects.requireNonNull(type, "Type cannot be null")
} }
/** /**
* 创建类型引用实例 * 创建类型引用实例
* @param <T> 目标类型 * @param <T> 目标类型
* @return 类型引用实例 * @return 类型引用实例
*/ */
companion object { companion object {
inline fun <reified T> of(): JsonTypeReference<T> { inline fun <reified T> of(): JsonTypeReference<T> {
return object : JsonTypeReference<T>() {} return object : JsonTypeReference<T>() {}
} }
/** /**
* 根据 Class 创建类型引用 * 根据 Class 创建类型引用
* @param clazz 目标类 * @param clazz 目标类
* @param <T> 目标类型 * @param <T> 目标类型
* @return 类型引用实例 * @return 类型引用实例
*/ */
@JvmStatic @JvmStatic
fun <T> of(clazz: Class<T>): JsonTypeReference<T> { fun <T> of(clazz: Class<T>): JsonTypeReference<T> {
return object : JsonTypeReference<T>(clazz) {} return object : JsonTypeReference<T>(clazz) {}
} }
/** /**
* 根据 Type 创建类型引用 * 根据 Type 创建类型引用
* @param type 目标类型 * @param type 目标类型
* @param <T> 目标类型 * @param <T> 目标类型
* @return 类型引用实例 * @return 类型引用实例
*/ */
@JvmStatic @JvmStatic
fun <T> of(type: Type): JsonTypeReference<T> { fun <T> of(type: Type): JsonTypeReference<T> {
return object : JsonTypeReference<T>(type) {} return object : JsonTypeReference<T>(type) {}
} }
} }
/** /**
* 获取原始类型(去掉泛型参数的类型) * 获取原始类型(去掉泛型参数的类型)
* @return 原始类型 Class * @return 原始类型 Class
*/ */
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
fun getRawType(): Class<T> { fun getRawType(): Class<T> {
var rawType: Type = type var rawType: Type = type
// 如果是参数化类型,则提取原始类型部分 // 如果是参数化类型,则提取原始类型部分
if (type is ParameterizedType) { if (type is ParameterizedType) {
rawType = (type as ParameterizedType).rawType rawType = (type as ParameterizedType).rawType
} }
if (rawType is Class<*>) { if (rawType is Class<*>) {
return rawType as Class<T> return rawType as Class<T>
} }
throw IllegalStateException("无法获取原始类型: $type") throw IllegalStateException("无法获取原始类型: $type")
} }
/** /**
* 判断两个 JsonTypeReference 实例是否相等 * 判断两个 JsonTypeReference 实例是否相等
* @param other 另一个对象 * @param other 另一个对象
* @return 是否相等 * @return 是否相等
*/ */
override fun equals(other: Any?): Boolean { override fun equals(other: Any?): Boolean {
if (this === other) return true if (this === other) return true
if (other == null || this.javaClass != other.javaClass) return false if (other == null || this.javaClass != other.javaClass) return false
val that = other as JsonTypeReference<*> val that = other as JsonTypeReference<*>
// 对于 ParameterizedType,需要更完整的比较 // 对于 ParameterizedType,需要更完整的比较
if (this.type is ParameterizedType && that.type is ParameterizedType) { if (this.type is ParameterizedType && that.type is ParameterizedType) {
val thisParamType = this.type as ParameterizedType val thisParamType = this.type as ParameterizedType
val thatParamType = that.type as ParameterizedType val thatParamType = that.type as ParameterizedType
return ( return (
Objects.equals( Objects.equals(
thisParamType.rawType, thisParamType.rawType,
thatParamType.rawType thatParamType.rawType
) && ) &&
thisParamType.actualTypeArguments.contentEquals(thatParamType.actualTypeArguments) && thisParamType.actualTypeArguments.contentEquals(thatParamType.actualTypeArguments) &&
Objects.equals( Objects.equals(
thisParamType.ownerType, thisParamType.ownerType,
thatParamType.ownerType thatParamType.ownerType
) )
) )
} }
return Objects.equals(type, that.type) return Objects.equals(type, that.type)
} }
/** /**
* 计算当前实例的哈希码 * 计算当前实例的哈希码
* @return 哈希码值 * @return 哈希码值
*/ */
override fun hashCode(): Int { override fun hashCode(): Int {
if (type is ParameterizedType) { if (type is ParameterizedType) {
val paramType = type as ParameterizedType val paramType = type as ParameterizedType
return Objects.hash( return Objects.hash(
paramType.rawType, paramType.rawType,
paramType.actualTypeArguments.contentHashCode(), paramType.actualTypeArguments.contentHashCode(),
paramType.ownerType paramType.ownerType
) )
} }
return Objects.hash(type) return Objects.hash(type)
} }
/** /**
* 返回当前实例的字符串表示形式 * 返回当前实例的字符串表示形式
* @return 字符串描述 * @return 字符串描述
*/ */
override fun toString(): String { override fun toString(): String {
return "com.mingliqiye.utils.json.JsonTypeReference<${TypeReference.getRawString(type)}>" return "com.mingliqiye.utils.json.JsonTypeReference<${TypeReference.getRawString(type)}>"
} }
/** /**
* 比较当前实例与另一个实例的大小关系 * 比较当前实例与另一个实例的大小关系
* @param other 另一个 JsonTypeReference 实例 * @param other 另一个 JsonTypeReference 实例
* @return 比较结果 * @return 比较结果
*/ */
override fun compareTo(other: JsonTypeReference<T>): Int { override fun compareTo(other: JsonTypeReference<T>): Int {
return this.type.toString().compareTo(other.type.toString()) return this.type.toString().compareTo(other.type.toString())
} }
} }
@@ -36,11 +36,11 @@ import java.util.*
* @return 如果类型匹配则返回 true,否则返回 false * @return 如果类型匹配则返回 true,否则返回 false
*/ */
fun isTypeOf(type: Type, expectedClass: Class<*>): Boolean { fun isTypeOf(type: Type, expectedClass: Class<*>): Boolean {
return when (type) { return when (type) {
is Class<*> -> expectedClass.isAssignableFrom(type) is Class<*> -> expectedClass.isAssignableFrom(type)
is ParameterizedType -> isTypeOf(type.rawType, expectedClass) is ParameterizedType -> isTypeOf(type.rawType, expectedClass)
else -> false else -> false
} }
} }
/** /**
@@ -52,15 +52,15 @@ fun isTypeOf(type: Type, expectedClass: Class<*>): Boolean {
* @throws IllegalArgumentException 当无法获取指定索引的泛型参数时抛出异常 * @throws IllegalArgumentException 当无法获取指定索引的泛型参数时抛出异常
*/ */
fun getGenericParameter(type: Type, index: Int): Type { fun getGenericParameter(type: Type, index: Int): Type {
if (type is ParameterizedType) { if (type is ParameterizedType) {
val typeArgs = type.actualTypeArguments val typeArgs = type.actualTypeArguments
if (index >= 0 && index < typeArgs.size) { if (index >= 0 && index < typeArgs.size) {
return typeArgs[index] return typeArgs[index]
} }
} }
throw IllegalArgumentException( throw IllegalArgumentException(
"无法获取泛型参数: $type at index $index" "无法获取泛型参数: $type at index $index"
) )
} }
/** /**
@@ -70,24 +70,24 @@ fun getGenericParameter(type: Type, index: Int): Type {
* @return 类型名称字符串 * @return 类型名称字符串
*/ */
fun getTypeName(type: Type): String { fun getTypeName(type: Type): String {
return when (type) { return when (type) {
is Class<*> -> type.simpleName is Class<*> -> type.simpleName
is ParameterizedType -> { is ParameterizedType -> {
val rawType = type.rawType as Class<*> val rawType = type.rawType as Class<*>
val typeArgs = type.actualTypeArguments val typeArgs = type.actualTypeArguments
val sb = StringBuilder(rawType.simpleName) val sb = StringBuilder(rawType.simpleName)
sb.append("<") sb.append("<")
for (i in typeArgs.indices) { for (i in typeArgs.indices) {
if (i > 0) sb.append(", ") if (i > 0) sb.append(", ")
sb.append(getTypeName(typeArgs[i])) sb.append(getTypeName(typeArgs[i]))
} }
sb.append(">") sb.append(">")
sb.toString() sb.toString()
} }
else -> type.typeName else -> type.typeName
} }
} }
/** /**
@@ -98,28 +98,28 @@ fun getTypeName(type: Type): String {
* @return 表示数组类型的 JsonTypeReference 对象 * @return 表示数组类型的 JsonTypeReference 对象
*/ */
fun <T> arrayType(componentType: Class<T>): JsonTypeReference<Array<T>> { fun <T> arrayType(componentType: Class<T>): JsonTypeReference<Array<T>> {
return object : JsonTypeReference<Array<T>>() { return object : JsonTypeReference<Array<T>>() {
private val arrayType: Type = java.lang.reflect.Array.newInstance( private val arrayType: Type = java.lang.reflect.Array.newInstance(
componentType, 0 componentType, 0
).javaClass ).javaClass
override var type: Type = Any::class.java override var type: Type = Any::class.java
get() = object : ParameterizedType { get() = object : ParameterizedType {
private val actualTypeArguments = arrayOf<Type>(componentType) private val actualTypeArguments = arrayOf<Type>(componentType)
override fun getActualTypeArguments(): Array<Type> { override fun getActualTypeArguments(): Array<Type> {
return actualTypeArguments return actualTypeArguments
} }
override fun getRawType(): Type { override fun getRawType(): Type {
return arrayType return arrayType
} }
override fun getOwnerType(): Type? { override fun getOwnerType(): Type? {
return null return null
} }
} }
} }
} }
/** /**
@@ -132,22 +132,22 @@ fun <T> arrayType(componentType: Class<T>): JsonTypeReference<Array<T>> {
*/ */
fun <T> listType(componentType: Class<T>): JsonTypeReference<List<T>> { fun <T> listType(componentType: Class<T>): JsonTypeReference<List<T>> {
return object : JsonTypeReference<List<T>>() { return object : JsonTypeReference<List<T>>() {
override var type: Type = Any::class.java override var type: Type = Any::class.java
get() = object : ParameterizedType { get() = object : ParameterizedType {
override fun getActualTypeArguments(): Array<Type> { override fun getActualTypeArguments(): Array<Type> {
return arrayOf(componentType) return arrayOf(componentType)
} }
override fun getRawType(): Type { override fun getRawType(): Type {
return List::class.java return List::class.java
} }
override fun getOwnerType(): Type? { override fun getOwnerType(): Type? {
return null return null
} }
} }
} }
} }
/** /**
@@ -162,40 +162,40 @@ fun <T> listType(componentType: Class<T>): JsonTypeReference<List<T>> {
*/ */
fun <K, V> MapType(keyType: Class<K>, valueType: Class<V>): JsonTypeReference<Map<K, V>> { fun <K, V> MapType(keyType: Class<K>, valueType: Class<V>): JsonTypeReference<Map<K, V>> {
return object : JsonTypeReference<Map<K, V>>() { return object : JsonTypeReference<Map<K, V>>() {
override var type: Type = Any::class.java override var type: Type = Any::class.java
get() = object : ParameterizedType { get() = object : ParameterizedType {
override fun getActualTypeArguments(): Array<Type> { override fun getActualTypeArguments(): Array<Type> {
return arrayOf(keyType, valueType) return arrayOf(keyType, valueType)
} }
override fun getRawType(): Type { override fun getRawType(): Type {
return Map::class.java return Map::class.java
} }
override fun getOwnerType(): Type? { override fun getOwnerType(): Type? {
return null return null
} }
override fun equals(other: Any?): Boolean { override fun equals(other: Any?): Boolean {
if (this === other) return true if (this === other) return true
if (other !is ParameterizedType) return false if (other !is ParameterizedType) return false
val that = other val that = other
return (Objects.equals( return (Objects.equals(
rawType, rawType,
that.rawType that.rawType
) && actualTypeArguments.contentEquals(that.actualTypeArguments) && Objects.equals( ) && actualTypeArguments.contentEquals(that.actualTypeArguments) && Objects.equals(
ownerType, ownerType,
that.ownerType that.ownerType
)) ))
} }
override fun hashCode(): Int { override fun hashCode(): Int {
return (actualTypeArguments.contentHashCode() xor Objects.hashCode(rawType) xor Objects.hashCode( return (actualTypeArguments.contentHashCode() xor Objects.hashCode(rawType) xor Objects.hashCode(
ownerType ownerType
)) ))
} }
} }
} }
} }
@@ -28,67 +28,67 @@ import java.lang.reflect.Type
import java.lang.reflect.WildcardType import java.lang.reflect.WildcardType
class TypeReference( class TypeReference(
val rawClass: Type, val rawClass: Type,
vararg paramType: Type vararg paramType: Type,
) : ParameterizedType { ) : ParameterizedType {
private val typeArguments: Array<out Type> = paramType private val typeArguments: Array<out Type> = paramType
override fun getActualTypeArguments(): Array<out Type> = typeArguments override fun getActualTypeArguments(): Array<out Type> = typeArguments
override fun getRawType(): Type = rawClass override fun getRawType(): Type = rawClass
override fun getOwnerType(): Type? = null override fun getOwnerType(): Type? = null
override fun toString(): String = "${getRawString(rawClass)}<${ override fun toString(): String = "${getRawString(rawClass)}<${
",".join(typeArguments) { getRawString(it) } ",".join(typeArguments) { getRawString(it) }
}>" }>"
companion object { companion object {
fun getRawString(type: Type): String { fun getRawString(type: Type): String {
return when (type) { return when (type) {
is Class<*> -> type.name is Class<*> -> type.name
is WildcardType -> { is WildcardType -> {
val upperBounds = type.upperBounds val upperBounds = type.upperBounds
val lowerBounds = type.lowerBounds val lowerBounds = type.lowerBounds
when { when {
upperBounds.isNotEmpty() && upperBounds[0] != Any::class.java -> { upperBounds.isNotEmpty() && upperBounds[0] != Any::class.java -> {
"? extends ${getRawString(upperBounds[0])}" "? extends ${getRawString(upperBounds[0])}"
} }
lowerBounds.isNotEmpty() -> { lowerBounds.isNotEmpty() -> {
"? super ${getRawString(lowerBounds[0])}" "? super ${getRawString(lowerBounds[0])}"
} }
else -> "?" else -> "?"
} }
} }
is ParameterizedType -> { is ParameterizedType -> {
of(type).toString() of(type).toString()
} }
else -> type.typeName else -> type.typeName
} }
} }
inline fun <reified T> of(): TypeReference { inline fun <reified T> of(): TypeReference {
return of((object : JsonTypeReference<T>() {}).type) return of((object : JsonTypeReference<T>() {}).type)
} }
fun of(type: Type): TypeReference { fun of(type: Type): TypeReference {
return when (type) { return when (type) {
is Class<*> -> TypeReference(type) is Class<*> -> TypeReference(type)
is ParameterizedType -> TypeReference(type.rawType, *type.actualTypeArguments) is ParameterizedType -> TypeReference(type.rawType, *type.actualTypeArguments)
is WildcardType -> { is WildcardType -> {
// 处理通配符类型,返回上界类型 // 处理通配符类型,返回上界类型
val upperBound = type.upperBounds.firstOrNull() ?: Any::class.java val upperBound = type.upperBounds.firstOrNull() ?: Any::class.java
TypeReference(upperBound) TypeReference(upperBound)
} }
else -> throw IllegalStateException("无法获取类型: $type") else -> throw IllegalStateException("无法获取类型: $type")
} }
} }
} }
} }
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile DateTimeJsonConverter.kt * CurrentFile DateTimeJsonConverter.kt
* LastUpdate 2026-02-07 22:13:41 * LastUpdate 2026-11-09 14:35:06
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -40,73 +40,73 @@ import com.mingliqiye.utils.time.Formatter
class DateTimeJsonConverter private constructor() : BaseJsonStringConverter<DateTime> { class DateTimeJsonConverter private constructor() : BaseJsonStringConverter<DateTime> {
companion object { companion object {
private val dateTimeJsonConverter by lazy { private val dateTimeJsonConverter by lazy {
DateTimeJsonConverter() DateTimeJsonConverter()
} }
@JvmStatic @JvmStatic
fun getJsonConverter(): DateTimeJsonConverter = dateTimeJsonConverter fun getJsonConverter(): DateTimeJsonConverter = dateTimeJsonConverter
} }
/** /**
* 将 DateTime 对象转换为 JSON 字符串。 * 将 DateTime 对象转换为 JSON 字符串。
* *
* @param obj 需要转换的 DateTime 对象,可能为 null。 * @param obj 需要转换的 DateTime 对象,可能为 null。
* @param annotationGetter 用于获取注解信息的对象,用于决定格式化方式。 * @param annotationGetter 用于获取注解信息的对象,用于决定格式化方式。
* @return 转换后的字符串,如果输入为 null 则返回 null。 * @return 转换后的字符串,如果输入为 null 则返回 null。
* @throws Exception 如果在转换过程中发生异常。 * @throws Exception 如果在转换过程中发生异常。
*/ */
@Throws(Exception::class) @Throws(Exception::class)
override fun convert(obj: DateTime?, annotationGetter: AnnotationGetter): String? { override fun convert(obj: DateTime?, annotationGetter: AnnotationGetter): String? {
// 如果输入对象为 null,直接返回 null // 如果输入对象为 null,直接返回 null
if (obj.isNull()) return null if (obj.isNull()) return null
// 获取 DateTimeJsonFormat 注解信息 // 获取 DateTimeJsonFormat 注解信息
val dateTimeJsonFormat: DateTimeJsonFormat? = annotationGetter.get<DateTimeJsonFormat>() val dateTimeJsonFormat: DateTimeJsonFormat? = annotationGetter.get<DateTimeJsonFormat>()
// 根据注解中的格式化规则进行转换 // 根据注解中的格式化规则进行转换
return if (Formatter.NONE != dateTimeJsonFormat?.value && dateTimeJsonFormat != null) { return if (Formatter.NONE != dateTimeJsonFormat?.value && dateTimeJsonFormat != null) {
obj.format(dateTimeJsonFormat.value, dateTimeJsonFormat.repcZero) obj.format(dateTimeJsonFormat.value, dateTimeJsonFormat.repcZero)
} else if (dateTimeJsonFormat?.formatter?.isEmpty() == false) { } else if (dateTimeJsonFormat?.formatter?.isEmpty() == false) {
obj.format(dateTimeJsonFormat.formatter, dateTimeJsonFormat.repcZero) obj.format(dateTimeJsonFormat.formatter, dateTimeJsonFormat.repcZero)
} else { } else {
obj.format() obj.format()
} }
} }
/** /**
* 将 JSON 字符串转换为 DateTime 对象。 * 将 JSON 字符串转换为 DateTime 对象。
* *
* @param obj 需要转换的字符串,可能为 null 或空。 * @param obj 需要转换的字符串,可能为 null 或空。
* @param annotationGetter 用于获取注解信息的对象,用于决定解析方式。 * @param annotationGetter 用于获取注解信息的对象,用于决定解析方式。
* @return 解析后的 DateTime 对象,如果输入为 null 或空则返回 null。 * @return 解析后的 DateTime 对象,如果输入为 null 或空则返回 null。
* @throws Exception 如果在解析过程中发生异常。 * @throws Exception 如果在解析过程中发生异常。
*/ */
@Throws(Exception::class) @Throws(Exception::class)
override fun deConvert(obj: String?, annotationGetter: AnnotationGetter): DateTime? { override fun deConvert(obj: String?, annotationGetter: AnnotationGetter): DateTime? {
// 如果输入字符串为 null 或空,直接返回 null // 如果输入字符串为 null 或空,直接返回 null
if (obj.isNullish()) return null if (obj.isNullish()) return null
// 获取 DateTimeJsonFormat 注解信息 // 获取 DateTimeJsonFormat 注解信息
val dateTimeJsonFormat: DateTimeJsonFormat? = annotationGetter.get<DateTimeJsonFormat>() val dateTimeJsonFormat: DateTimeJsonFormat? = annotationGetter.get<DateTimeJsonFormat>()
// 根据注解中的解析规则进行转换 // 根据注解中的解析规则进行转换
return if (Formatter.NONE != dateTimeJsonFormat?.value && dateTimeJsonFormat != null) { return if (Formatter.NONE != dateTimeJsonFormat?.value && dateTimeJsonFormat != null) {
DateTime.parse(obj, dateTimeJsonFormat.value, dateTimeJsonFormat.repcZero) DateTime.parse(obj, dateTimeJsonFormat.value, dateTimeJsonFormat.repcZero)
} else if (dateTimeJsonFormat?.formatter?.isEmpty() == false) { } else if (dateTimeJsonFormat?.formatter?.isEmpty() == false) {
DateTime.parse(obj, dateTimeJsonFormat.formatter, dateTimeJsonFormat.repcZero) DateTime.parse(obj, dateTimeJsonFormat.formatter, dateTimeJsonFormat.repcZero)
} else { } else {
DateTime.parse(obj) DateTime.parse(obj)
} }
} }
/** /**
* 获取当前转换器支持的目标类型引用。 * 获取当前转换器支持的目标类型引用。
* *
* @return 返回 DateTime 类型的 JsonTypeReference。 * @return 返回 DateTime 类型的 JsonTypeReference。
* @throws Exception 如果在获取类型引用时发生异常。 * @throws Exception 如果在获取类型引用时发生异常。
*/ */
@Throws(Exception::class) @Throws(Exception::class)
override fun getFromType(): JsonTypeReference<DateTime> = JsonTypeReference.of<DateTime>() override fun getFromType(): JsonTypeReference<DateTime> = JsonTypeReference.of<DateTime>()
} }
@@ -0,0 +1,100 @@
/*
* 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 NetworkEndpointJsonConverter.kt
* LastUpdate 2026-11-09 14:36:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.json.converters
import com.mingliqiye.utils.json.api.type.JsonTypeReference
import com.mingliqiye.utils.json.converters.NetworkEndpointJsonConverter.Companion.getJsonConverter
import com.mingliqiye.utils.json.converters.base.AnnotationGetter
import com.mingliqiye.utils.json.converters.base.BaseJsonStringConverter
import com.mingliqiye.utils.network.NetworkEndpoint
/**
* [NetworkEndpoint] 的 JSON 字符串转换器。
*
* 继承 [BaseJsonStringConverter],负责在网络端点对象与 JSON 字符串之间进行转换:
* 序列化时输出形如 `host:port` 的字符串,反序列化时将 `host:port` 字符串还原为
* [NetworkEndpoint] 实例。
*
* 本类为单例:构造器私有,通过 [getJsonConverter] 获取全局共享实例,
* 避免在序列化框架中重复创建。
*
* @see BaseJsonStringConverter
* @see NetworkEndpoint
*/
class NetworkEndpointJsonConverter private constructor() : BaseJsonStringConverter<NetworkEndpoint> {
companion object {
private val networkEndpointJsonConverter by lazy {
NetworkEndpointJsonConverter()
}
/**
* 获取 [NetworkEndpointJsonConverter] 的全局单例。
*
* @return 共享的转换器实例。
*/
@JvmStatic
fun getJsonConverter(): NetworkEndpointJsonConverter = networkEndpointJsonConverter
}
/**
* 将 [NetworkEndpoint] 序列化为 JSON 字符串。
*
* 输出格式为 `host:port`,由 [NetworkEndpoint.toHostPortString] 生成。
*
* @param obj 待序列化的网络端点,可能为 `null`。
* @param annotationGetter 注解信息提供者,用于在需要时读取格式化相关注解;
* 当前实现不依赖注解,保留该参数以符合转换器契约。
* @return 序列化后的 `host:port` 字符串;当 [obj] 为 `null` 时返回 `null`。
* @throws Exception 若序列化过程中发生异常。
*/
@Throws(Exception::class)
override fun convert(obj: NetworkEndpoint?, annotationGetter: AnnotationGetter): String? {
return obj?.let(NetworkEndpoint::toHostPortString)
}
/**
* 将 JSON 字符串反序列化为 [NetworkEndpoint]。
*
* 期望输入为 `host:port` 形式的字符串,由 [NetworkEndpoint.Companion.of] 解析。
*
* @param obj 待反序列化的字符串,可能为 `null`。
* @param annotationGetter 注解信息提供者,用于在需要时读取解析相关注解;
* 当前实现不依赖注解,保留该参数以符合转换器契约。
* @return 解析得到的 [NetworkEndpoint];当 [obj] 为 `null` 时返回 `null`。
* @throws Exception 若字符串格式非法或解析过程中发生异常。
*/
@Throws(Exception::class)
override fun deConvert(obj: String?, annotationGetter: AnnotationGetter): NetworkEndpoint? {
return obj?.let(NetworkEndpoint.Companion::of)
}
/**
* 获取本转换器支持的目标类型引用。
*
* @return 指向 [NetworkEndpoint] 的 [JsonTypeReference]。
* @throws Exception 若获取类型引用时发生异常。
*/
@Throws(Exception::class)
override fun getFromType(): JsonTypeReference<NetworkEndpoint> = JsonTypeReference.Companion.of()
}
@@ -40,71 +40,71 @@ import com.mingliqiye.utils.uuid.UUIDFormatType
*/ */
class UUIDJsonConverter private constructor() : BaseJsonStringConverter<UUID> { class UUIDJsonConverter private constructor() : BaseJsonStringConverter<UUID> {
companion object { companion object {
private val uuidJsonConverter by lazy { private val uuidJsonConverter by lazy {
UUIDJsonConverter() UUIDJsonConverter()
} }
@JvmStatic @JvmStatic
fun getJsonConverter(): UUIDJsonConverter = uuidJsonConverter fun getJsonConverter(): UUIDJsonConverter = uuidJsonConverter
} }
/** /**
* 将 UUID 对象转换为字符串形式。 * 将 UUID 对象转换为字符串形式。
* *
* @param obj 需要转换的 UUID 对象,可能为 null。 * @param obj 需要转换的 UUID 对象,可能为 null。
* @param annotationGetter 用于获取注解信息的对象。 * @param annotationGetter 用于获取注解信息的对象。
* @return 转换后的字符串,如果输入为 null 则返回 null。 * @return 转换后的字符串,如果输入为 null 则返回 null。
*/ */
override fun convert( override fun convert(
obj: UUID?, obj: UUID?,
annotationGetter: AnnotationGetter annotationGetter: AnnotationGetter,
): String? { ): String? {
// 如果输入对象为 null,直接返回 null // 如果输入对象为 null,直接返回 null
if (obj.isNull()) return null if (obj.isNull()) return null
// 获取 UUIDJsonFormat 注解信息,若未找到则使用默认格式 // 获取 UUIDJsonFormat 注解信息,若未找到则使用默认格式
val dateTimeJsonFormat: UUIDJsonFormat = annotationGetter.get<UUIDJsonFormat>() ?: return obj.getString() val dateTimeJsonFormat: UUIDJsonFormat = annotationGetter.get<UUIDJsonFormat>() ?: return obj.getString()
// 根据注解中的 base 和 value 属性选择合适的字符串表示方式 // 根据注解中的 base 和 value 属性选择合适的字符串表示方式
return if (BaseType.BASE16 != dateTimeJsonFormat.base) { return if (BaseType.BASE16 != dateTimeJsonFormat.base) {
obj.getString(dateTimeJsonFormat.base) obj.getString(dateTimeJsonFormat.base)
} else if (UUIDFormatType.NO_UPPER_SPACE != dateTimeJsonFormat.value) { } else if (UUIDFormatType.NO_UPPER_SPACE != dateTimeJsonFormat.value) {
obj.getString(dateTimeJsonFormat.value) obj.getString(dateTimeJsonFormat.value)
} else { } else {
obj.getString() obj.getString()
} }
} }
/** /**
* 将字符串反序列化为 UUID 对象。 * 将字符串反序列化为 UUID 对象。
* *
* @param obj 需要反序列化的字符串,可能为 null 或空。 * @param obj 需要反序列化的字符串,可能为 null 或空。
* @param annotationGetter 用于获取注解信息的对象。 * @param annotationGetter 用于获取注解信息的对象。
* @return 反序列化后的 UUID 对象,如果输入无效则返回 null。 * @return 反序列化后的 UUID 对象,如果输入无效则返回 null。
*/ */
override fun deConvert( override fun deConvert(
obj: String?, obj: String?,
annotationGetter: AnnotationGetter annotationGetter: AnnotationGetter,
): UUID? { ): UUID? {
// 如果输入字符串为 null 或空,直接返回 null // 如果输入字符串为 null 或空,直接返回 null
if (obj.isNullish()) return null if (obj.isNullish()) return null
// 获取 UUIDJsonFormat 注解信息,若未找到则使用默认解析方式 // 获取 UUIDJsonFormat 注解信息,若未找到则使用默认解析方式
val dateTimeJsonFormat: UUIDJsonFormat = annotationGetter.get<UUIDJsonFormat>() ?: return UUID.of(obj) val dateTimeJsonFormat: UUIDJsonFormat = annotationGetter.get<UUIDJsonFormat>() ?: return UUID.of(obj)
// 根据注解中的 base 属性选择合适的解析方式 // 根据注解中的 base 属性选择合适的解析方式
return if (BaseType.BASE16 != dateTimeJsonFormat.base) { return if (BaseType.BASE16 != dateTimeJsonFormat.base) {
UUID.of(obj, dateTimeJsonFormat.base) UUID.of(obj, dateTimeJsonFormat.base)
} else { } else {
UUID.of(obj) UUID.of(obj)
} }
} }
/** /**
* 返回当前转换器支持的目标类型引用。 * 返回当前转换器支持的目标类型引用。
* *
* @return 表示 UUID 类型的 JsonTypeReference 对象。 * @return 表示 UUID 类型的 JsonTypeReference 对象。
*/ */
override fun getFromType() = JsonTypeReference.of<UUID>() override fun getFromType() = JsonTypeReference.of<UUID>()
} }

Some files were not shown because too many files have changed in this diff Show More