no message
Gitea Actions Build / Build (push) Canceled after 0s

This commit is contained in:
2026-10-11 17:35:58 +08:00
parent 60ec0e2883
commit f7abd6c271
34 changed files with 879 additions and 209 deletions
+11 -1
View File
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils * ModuleName mingli-utils
* CurrentFile build.gradle.kts * CurrentFile build.gradle.kts
* LastUpdate 2026-06-20 21:49:36 * LastUpdate 2026-10-11 16:44:37
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -33,6 +33,7 @@ plugins {
kotlin("kapt") version "2.2.20" kotlin("kapt") version "2.2.20"
id("org.jetbrains.dokka") version "2.1.0" id("org.jetbrains.dokka") version "2.1.0"
id("org.jetbrains.dokka-javadoc") version "2.1.0" id("org.jetbrains.dokka-javadoc") version "2.1.0"
kotlin("plugin.spring") version "2.1.0"
} }
val GROUPSID = project.properties["GROUPSID"] as String val GROUPSID = project.properties["GROUPSID"] as String
val VERSIONS = project.properties["VERSIONS"] as String val VERSIONS = project.properties["VERSIONS"] as String
@@ -56,6 +57,14 @@ java {
kotlin { kotlin {
jvmToolchain(JDKVERSIONS) jvmToolchain(JDKVERSIONS)
} }
repositories {
mavenLocal()
maven {
url = uri("https://maven.mingliqiye.com/")
}
mavenCentral()
}
dependencies { dependencies {
implementation("org.slf4j:slf4j-api:2.0.17") implementation("org.slf4j:slf4j-api:2.0.17")
implementation(kotlin("reflect")) implementation(kotlin("reflect"))
@@ -85,6 +94,7 @@ dependencies {
testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0") testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0")
testImplementation("tools.jackson.core:jackson-databind:3.1.0") testImplementation("tools.jackson.core:jackson-databind:3.1.0")
testImplementation(kotlin("test"))
} }
repositories { repositories {
+2 -2
View File
@@ -16,10 +16,10 @@
# ProjectName mingli-utils # ProjectName mingli-utils
# ModuleName mingli-utils # ModuleName mingli-utils
# CurrentFile gradle.properties # CurrentFile gradle.properties
# LastUpdate 2026-06-21 10:39:07 # LastUpdate 2026-10-11 16:28:05
# UpdateUser MingLiPro # UpdateUser MingLiPro
# #
JDKVERSIONS=17 JDKVERSIONS=17
GROUPSID=com.mingliqiye.utils GROUPSID=com.mingliqiye.utils
ARTIFACTID=mingli-utils ARTIFACTID=mingli-utils
VERSIONS=5.2.6 VERSIONS=5.3.1
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile SuperStream.java * CurrentFile SuperStream.java
* LastUpdate 2026-04-14 12:00:05 * LastUpdate 2026-10-11 17:23:57
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -103,6 +103,17 @@ public class SuperStream<T> implements Stream<T> {
return of(Collections.newArrayLists(args)); return of(Collections.newArrayLists(args));
} }
/**
* 创建一个包含指定布尔元素的SuperStream
*
* @param args 可变参数的布尔数组
* @return 包含指定布尔的SuperStream实例
*/
public static SuperStream<Boolean> of(boolean... args) {
return of(Collections.newArrayLists(args));
}
/** /**
* 创建一个包含指定浮点数元素的SuperStream * 创建一个包含指定浮点数元素的SuperStream
* *
@@ -0,0 +1,133 @@
/*
* 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 SuprtStreamUtils.kt
* LastUpdate 2026-10-11 17:32:17
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.stream
import java.util.stream.Stream
/**
* [SuperStream] 的工厂工具类,提供把各类常见数据源(Java [Stream]、数组、集合、映射)
* 转换为 [SuperStream] 的扩展函数。
*
* 所有扩展函数均以 `toSuperStream` 命名,遵循 Kotlin 的 `toXxx` 转换命名惯例。
*
* 使用示例:
* ```kotlin
* intArrayOf(1, 2, 3).toSuperStream()
* listOf("a", "b").toSuperStream(parallel = true)
* mapOf(1 to "a").toSuperStream()
* ```
*/
object SuperStreamUtils {
/**
* 将 Java [Stream] 转换为 [SuperStream]。
*
* @param T 流中元素的类型,必须是不可空类型。
* @return 包装当前 [Stream] 的 [SuperStream]。
*/
fun <T : Any> Stream<T>.toSuperStream() = SuperStream.of(this)
/**
* 将 [ByteArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun ByteArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将 [ShortArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun ShortArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将 [IntArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun IntArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将 [LongArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun LongArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将 [FloatArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun FloatArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将 [DoubleArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun DoubleArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将 [BooleanArray] 转换为 [SuperStream]。
*
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun BooleanArray.toSuperStream(parallel: Boolean = false) = SuperStream.of(this.toList(), parallel)
/**
* 将对象数组 [Array] 转换为 [SuperStream]。
*
* @param T 数组元素类型,必须是不可空类型。
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前数组元素构成的 [SuperStream]。
*/
fun <T : Any> Array<T>.toSuperStream(parallel: Boolean = false) = SuperStream.of(this, parallel)
/**
* 将 [Collection] 转换为 [SuperStream]。
*
* @param T 集合元素类型,必须是不可空类型。
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前集合元素构成的 [SuperStream]。
*/
fun <T : Any> Collection<T>.toSuperStream(parallel: Boolean = false) = SuperStream.of(this, parallel)
/**
* 将 [Map] 转换为 [SuperStream],流中元素为键值对 [Map.Entry]。
*
* @param K 键的类型。
* @param V 值的类型。
* @param parallel 是否创建并行流,默认为 `false`(串行)。
* @return 由当前映射的条目构成的 [SuperStream]。
*/
fun <K, V> Map<K, V>.toSuperStream(parallel: Boolean = false) = SuperStream.of(this, parallel)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile BaseCodec.kt * CurrentFile BaseCodec.kt
* LastUpdate 2026-02-09 19:58:29 * LastUpdate 2026-10-11 16:52:16
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -43,7 +43,7 @@ interface BaseCodec {
fun catchEncode(bytes: ByteArray) = try { fun catchEncode(bytes: ByteArray) = try {
encode(bytes) encode(bytes)
} catch (e: Exception) { } catch (e: Exception) {
throw CodecException(e) throw CodecException(throwable = e)
} }
/** /**
@@ -56,7 +56,7 @@ interface BaseCodec {
fun catchDecode(string: String) = try { fun catchDecode(string: String) = try {
decode(string) decode(string)
} catch (e: Exception) { } catch (e: Exception) {
throw CodecException(e) throw CodecException(throwable = e)
} }
/** /**
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ByteBufferUtils.kt * CurrentFile ByteBufferUtils.kt
* LastUpdate 2026-03-11 08:46:40 * LastUpdate 2026-07-02 09:31:01
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -1,5 +1,5 @@
/* /*
* Copyright 2025 mingliqiye * Copyright 2026 mingliqiye
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ConfigurationProp.kt * CurrentFile ConfigurationProp.kt
* LastUpdate 2025-09-19 11:30:04 * LastUpdate 2026-07-01 12:37:05
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -156,7 +156,7 @@ open class ConfigurationProps {
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
@@ -194,7 +194,7 @@ open class ConfigurationProps {
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
@@ -248,9 +248,9 @@ open class ConfigurationProps {
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 -> 类型: ${field.type.simpleName}") help.append("$fieldName -> Type: ${field.type.simpleName}")
if (configurationProp.description.isNotEmpty()) { if (configurationProp.description.isNotEmpty()) {
help.append(" 描述: ${configurationProp.description}") help.append(" Description: ${configurationProp.description}")
} }
help.append("\n") help.append("\n")
} }
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile CodecException.kt * CurrentFile CodecException.kt
* LastUpdate 2026-02-09 19:52:21 * LastUpdate 2026-10-11 16:51:36
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class CodecException : MingLiUtilsBaseException { class CodecException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile EmptyJsonException.kt * CurrentFile EmptyJsonException.kt
* LastUpdate 2026-02-07 14:45:12 * LastUpdate 2026-10-11 16:53:26
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class EmptyJsonException : JsonException { class EmptyJsonException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpException.kt * CurrentFile HttpException.kt
* LastUpdate 2026-02-05 14:44:15 * LastUpdate 2026-10-11 16:52:48
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class HttpException : MingLiUtilsBaseException { open class HttpException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpStatusException.kt * CurrentFile HttpStatusException.kt
* LastUpdate 2026-02-10 01:12:53 * LastUpdate 2026-10-11 17:02:06
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -29,8 +29,10 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 null * @param message 异常信息,默认为 null
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
open class HttpStatusException( open class HttpStatusException @JvmOverloads constructor(
open val statusCode: Int, val statusCode: Int,
override val message: String? = null, message: String? = null,
override val cause: Throwable? = null throwable: Throwable? = null,
) : MingLiUtilsBaseException(message, cause) enableSuppression: Boolean = false,
writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpUrlException.kt * CurrentFile HttpUrlException.kt
* LastUpdate 2026-03-11 08:46:40 * LastUpdate 2026-10-11 16:53:00
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class HttpUrlException : MingLiUtilsBaseException { open class HttpUrlException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false, writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile InvalidJsonException.kt * CurrentFile InvalidJsonException.kt
* LastUpdate 2026-02-07 13:18:32 * LastUpdate 2026-10-11 16:53:31
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class InvalidJsonException : JsonException { class InvalidJsonException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonException.kt * CurrentFile JsonException.kt
* LastUpdate 2026-02-07 13:17:50 * LastUpdate 2026-10-11 16:53:07
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -30,15 +30,9 @@ package com.mingliqiye.utils.exception
* 2. 包含错误信息和原因(Throwable)的构造函数。 * 2. 包含错误信息和原因(Throwable)的构造函数。
* 3. 仅包含原因(Throwable)的构造函数。 * 3. 仅包含原因(Throwable)的构造函数。
*/ */
open class JsonException : MingLiUtilsBaseException { open class JsonException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonObjectCastException.kt * CurrentFile JsonObjectCastException.kt
* LastUpdate 2026-02-09 19:52:21 * LastUpdate 2026-10-11 16:53:36
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonObjectCastException : JsonException { class JsonObjectCastException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonParserException.kt * CurrentFile JsonParserException.kt
* LastUpdate 2026-02-07 14:45:12 * LastUpdate 2026-10-11 16:53:41
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonParserException : JsonException { class JsonParserException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonTypeException.kt * CurrentFile JsonTypeException.kt
* LastUpdate 2026-02-07 13:28:02 * LastUpdate 2026-10-11 16:53:45
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonTypeException : JsonException { class JsonTypeException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : JsonException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,22 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile MingLiUtilsBaseException.kt * CurrentFile MingLiUtilsBaseException.kt
* LastUpdate 2026-02-05 14:41:27 * LastUpdate 2026-10-11 16:39:21
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class MingLiUtilsBaseException : RuntimeException { open class MingLiUtilsBaseException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, cause: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : RuntimeException(message, cause, enableSuppression, writableStackTrace)
}
@@ -16,21 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile NotFoundResourceException.kt * CurrentFile NotFoundResourceException.kt
* LastUpdate 2026-05-22 13:20:00 * LastUpdate 2026-10-11 16:53:58
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class NotFoundResourceException : MingLiUtilsBaseException { class NotFoundResourceException @JvmOverloads constructor(
constructor()
constructor(message: String) : super(message)
constructor(throwable: Throwable) : super(throwable)
constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null, message: String? = null,
throwable: Throwable? = null, throwable: Throwable? = null,
enableSuppression: Boolean = false, enableSuppression: Boolean = false,
writableStackTrace: Boolean = false, writableStackTrace: Boolean = true,
) : super(message, throwable, enableSuppression, writableStackTrace) ) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
}
@@ -1,5 +1,5 @@
/* /*
* Copyright 2025 mingliqiye * Copyright 2026 mingliqiye
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -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 2025-09-15 22:32:50 * LastUpdate 2026-07-02 10:22:42
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -30,7 +30,7 @@ import java.lang.reflect.Modifier
* 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段, * 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段,
* 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。 * 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。
*/ */
class FieldStructure : Structure() { open class FieldStructure : Structure() {
/** /**
* 获取结构体字段顺序列表 * 获取结构体字段顺序列表
* 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段, * 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段,
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JacksonJsonApi.kt * CurrentFile JacksonJsonApi.kt
* LastUpdate 2026-06-21 10:40:58 * LastUpdate 2026-10-11 16:54:15
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -117,7 +117,7 @@ class JacksonJsonApi : JsonApi {
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(e) throw JsonException(throwable = e)
} }
} }
@@ -0,0 +1,74 @@
/*
* 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 ByteArrayCodec.kt
* LastUpdate 2026-06-27 21:43:25
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.netty
import io.netty.buffer.ByteBuf
import io.netty.channel.ChannelHandlerContext
/**
* ByteBuf 与 ByteArray 互转的编解码器
*
* 入站:将 Netty 的 ByteBuf 解码为 Kotlin 的 ByteArray
* 出站:将 Kotlin 的 ByteArray 编码为 Netty 的 ByteBuf
*
* @see NettyBaseCodec
*/
class ByteArrayCodec : NettyBaseCodec<ByteBuf, ByteArray>() {
/**
* 解码:ByteBuf → ByteArray
*
* 将 Netty 的 ByteBuf 转换为 Kotlin 的 ByteArray
*
* @param inData 输入的 ByteBuf
* @param channelHandlerContext 上下文
* @param outList 输出列表(未使用)
* @return 转换后的 ByteArray
*/
override fun decode(
inData: ByteBuf,
channelHandlerContext: ChannelHandlerContext,
outList: MutableList<Any>,
): ByteArray {
return inData.toByteArray()
}
/**
* 编码:ByteArray → ByteBuf
*
* 将 Kotlin 的 ByteArray 转换为 Netty 的 ByteBuf
*
* @param inData 输入的 ByteArray
* @param channelHandlerContext 上下文
* @param outList 输出列表(未使用)
* @return 转换后的 ByteBuf
*
*/
override fun encode(
inData: ByteArray,
channelHandlerContext: ChannelHandlerContext,
outList: MutableList<Any>,
): ByteBuf {
return inData.toByteBuf()
}
}
@@ -0,0 +1,116 @@
/*
* 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 NettyBaseCodec.kt
* LastUpdate 2026-06-27 21:50:22
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.netty
import io.netty.channel.ChannelHandlerContext
import io.netty.handler.codec.MessageToMessageCodec
/**
* 基础编解码器抽象类
*
* 同时处理入站解码(I → O)和出站编码(O → I)
* 继承自 Netty 的 MessageToMessageCodec,用于消息类型之间的转换
*
* @param I 入站消息类型(解码前的类型)
* @param O 出站消息类型(解码后的类型/编码前的类型)
*
* 使用示例:
* ```
* class StringToIntCodec : NettyBaseCodec<String, Int>() {
* override fun decode(inData: String, ctx: ChannelHandlerContext, outList: MutableList<Any>): Int {
* return inData.toInt()
* }
* override fun encode(inData: Int, ctx: ChannelHandlerContext, outList: MutableList<Any>): String {
* return inData.toString()
* }
* }
* ```
*/
abstract class NettyBaseCodec<I : Any, O : Any> : MessageToMessageCodec<I, O>() {
/**
* 解码方法(Netty 框架回调)
*
* 将入站消息 I 转换为 O,并添加到输出列表
*
* @param ctx ChannelHandler 上下文,可用于获取 Channel 等信息
* @param msg 入站消息(类型为 I)
* @param out 输出列表,解码后的消息(类型为 O)将被添加到此列表
*
* @see decode 抽象方法,由子类实现具体的解码逻辑
*/
override fun decode(ctx: ChannelHandlerContext, msg: I, out: MutableList<Any>) {
// 调用子类实现的抽象解码方法,将结果添加到输出列表
out.add(decode(msg, ctx, out))
}
/**
* 编码方法(Netty 框架回调)
*
* 将出站消息 O 转换为 I,并添加到输出列表
*
* @param ctx ChannelHandler 上下文
* @param msg 出站消息(类型为 O)
* @param out 输出列表,编码后的消息(类型为 I)将被添加到此列表
*
* @see encode 抽象方法,由子类实现具体的编码逻辑
*/
override fun encode(ctx: ChannelHandlerContext, msg: O, out: MutableList<Any>) {
// 调用子类实现的抽象编码方法,将结果添加到输出列表
out.add(encode(msg, ctx, out))
}
/**
* 抽象解码方法
*
* 子类必须实现此方法,定义具体的解码逻辑
* 将类型 I 的消息转换为类型 O
*
* @param inData 输入数据(类型 I),需要被解码
* @param channelHandlerContext ChannelHandler 上下文
* @param outList 输出列表,可用于在解码过程中添加多个消息(目前设计为单一返回值,outList 暂未使用)
* @return 解码后的数据(类型 O)
*/
abstract fun decode(
inData: I,
channelHandlerContext: ChannelHandlerContext,
outList: MutableList<Any>,
): O
/**
* 抽象编码方法
*
* 子类必须实现此方法,定义具体的编码逻辑
* 将类型 O 的消息转换为类型 I
*
* @param inData 输入数据(类型 O),需要被编码
* @param channelHandlerContext ChannelHandler 上下文
* @param outList 输出列表,可用于在编码过程中添加多个消息(目前设计为单一返回值,outList 暂未使用)
* @return 编码后的数据(类型 I)
*/
abstract fun encode(
inData: O,
channelHandlerContext: ChannelHandlerContext,
outList: MutableList<Any>,
): I
}
@@ -0,0 +1,114 @@
/*
* 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 NettyBaseDecoder.kt
* LastUpdate 2026-06-27 21:51:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.netty
import io.netty.channel.ChannelHandlerContext
import io.netty.handler.codec.MessageToMessageDecoder
/**
* Netty 基础解码器抽象类
*
* 用于将入站消息从类型 I 解码为类型 O
* 继承自 Netty 的 MessageToMessageDecoder,适用于消息类型之间的转换
*
* 适用场景:
* - 将一种业务对象转换为另一种业务对象
* - 将字符串解析为 JSON 对象
* - 将字节数组反序列化为 POJO
*
* @param I 输入消息类型(解码前的类型)
* @param O 输出消息类型(解码后的类型)
*
* 使用示例:
* ```
* class StringToIntDecoder : NettyBaseDecoder<String, Int>() {
* override fun decode(inData: String, ctx: ChannelHandlerContext, outList: MutableList<Any>): Int {
* return inData.toInt()
* }
* }
* ```
*
* @see io.netty.handler.codec.MessageToMessageDecoder
* @see io.netty.handler.codec.ByteToMessageDecoder
*/
abstract class NettyBaseDecoder<I : Any, O : Any> : MessageToMessageDecoder<I>() {
/**
* 解码方法(Netty 框架回调)
*
* 由 Netty 在收到入站消息时自动调用
* 将入站消息 I 转换为 O,并添加到输出列表
*
* @param ctx ChannelHandler 上下文
* - 可用于获取 Channel 信息
* - 可用于触发后续事件
* - 可用于获取 ChannelPipeline 引用
* @param msg 入站消息(类型为 I)
* - 由 Netty 从 Channel 中读取
* - 可能是 ByteBuf、String 或其他类型
* @param out 输出列表(类型为 MutableList<Any>)
* - 解码后的消息(类型为 O)将被添加到此列表
* - 列表中的消息会传递给下一个 InboundHandler
* - 可以添加多个消息,实现一对多的转换
*
* @see #decode 抽象方法,由子类实现具体的解码逻辑
*/
override fun decode(ctx: ChannelHandlerContext, msg: I, out: MutableList<Any>) {
// 调用子类实现的抽象解码方法,将结果添加到输出列表
// 子类通过抽象方法返回解码后的对象,然后添加到 out 中
out.add(decode(msg, ctx, out))
}
/**
* 抽象解码方法
*
* 子类必须实现此方法,定义从 I 到 O 的具体转换逻辑
*
* 实现注意事项:
* 1. 此方法会在 Netty 的 EventLoop 线程中执行,避免阻塞操作
* 2. 如果输入数据不完整,应该抛出异常或返回 null
* 3. 如果 outList 可以接收多个消息,可以多次调用 outList.add()
* 4. 注意管理 ByteBuf 的引用计数(如果 I 是 ByteBuf)
*
* @param inData 输入数据(类型 I),需要被解码
* - 由调用方(Netty 框架)传入
* - 不应为 null(泛型约束为 Any)
* @param channelHandlerContext ChannelHandler 上下文
* - 可用于获取 ChannelHandlerContext 相关信息
* - 可用于在解码过程中触发额外操作
* @param outList 输出列表
* - 可用于在解码过程中添加多个消息
* - 当前设计为单一返回值,outList 暂作为扩展预留
* - 如果需要在解码过程中输出多个消息,可以直接操作此列表并返回 null
* @return 解码后的数据(类型 O)
* - 不能返回 null(泛型约束为 Any)
* - 返回值会被自动添加到 outList 中
*
* @see #decode 包装方法,由框架调用
*/
abstract fun decode(
inData: I,
channelHandlerContext: ChannelHandlerContext,
outList: MutableList<Any>,
): O
}
@@ -0,0 +1,130 @@
/*
* 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 NettyBaseEncoder.kt
* LastUpdate 2026-06-27 21:51:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.netty
import io.netty.channel.ChannelHandlerContext
import io.netty.handler.codec.MessageToMessageEncoder
/**
* Netty 基础编码器抽象类
*
* 用于将出站消息从类型 I 编码为类型 O
* 继承自 Netty 的 MessageToMessageEncoder,适用于消息类型之间的转换
*
* 适用场景:
* - 将业务对象序列化为传输格式
* - 将 JSON 对象转换为字符串
* - 将 POJO 序列化为字节数组
*
* ⚠️ 注意:如果需要将对象编码为 ByteBuf,应使用 MessageToByteEncoder
*
* @param I 输入消息类型(编码前的类型)
* @param O 输出消息类型(编码后的类型)
*
* 使用示例:
* ```
* class IntToStringEncoder : NettyBaseEncoder<Int, String>() {
* override fun encode(inData: Int, ctx: ChannelHandlerContext, outList: MutableList<Any>): String {
* return inData.toString()
* }
* }
* ```
*
* @see io.netty.handler.codec.MessageToMessageEncoder
* @see MessageToByteEncoder
*/
abstract class NettyBaseEncoder<I : Any, O : Any> : MessageToMessageEncoder<I>() {
/**
* 编码方法(Netty 框架回调)
*
* 由 Netty 在发送出站消息时自动调用
* 将出站消息 I 编码为 O,并添加到输出列表
*
* 执行流程:
* 1. 用户调用 Channel.write(msg) 发送消息
* 2. Netty 将消息传递给 Pipeline 中的 OutboundHandler
* 3. 此方法被调用,执行编码逻辑
* 4. 编码结果添加到 out 列表
* 5. Netty 将 out 列表中的消息传递给下一个 OutboundHandler
*
* @param ctx ChannelHandler 上下文
* - 可用于获取 Channel 信息
* - 可用于触发后续写操作
* - 可用于获取 ChannelPipeline 引用
* @param msg 出站消息(类型为 I)
* - 由业务层调用 write 方法时传入
* - 可能是任意类型
* @param out 输出列表(类型为 MutableList<Any>)
* - 编码后的消息(类型为 O)将被添加到此列表
* - 列表中的消息会传递给下一个 OutboundHandler
* - 可以添加多个消息,实现一对多的转换
*
* @see #encode 抽象方法,由子类实现具体的编码逻辑
*/
override fun encode(ctx: ChannelHandlerContext, msg: I, out: MutableList<Any>) {
// 调用子类实现的抽象编码方法,将结果添加到输出列表
// 子类通过抽象方法返回编码后的对象,然后添加到 out 中
out.add(encode(msg, ctx, out))
}
/**
* 抽象编码方法
*
* 子类必须实现此方法,定义从 I 到 O 的具体转换逻辑
*
* 实现注意事项:
* 1. 此方法会在 Netty 的 EventLoop 线程中执行,避免阻塞操作
* 2. 编码后的对象应该是线程安全的(可能会被多个线程访问)
* 3. 如果 outList 可以接收多个消息,可以多次调用 outList.add()
* 4. 如果 I 是 ByteBuf,注意引用计数管理
* 5. 编码结果应该是完整的消息,不要依赖后续 handler 补充
*
* 性能建议:
* - 尽量复用对象池中的资源(如 ByteBuf)
* - 避免在编码过程中进行大量数据复制
* - 考虑使用 DirectBuffer 减少内存拷贝
*
* @param inData 输入数据(类型 I),需要被编码
* - 由调用方(业务层)传入
* - 不应为 null(泛型约束为 Any)
* @param channelHandlerContext ChannelHandler 上下文
* - 可用于获取 ChannelHandlerContext 相关信息
* - 可用于在编码过程中触发额外操作
* - 可通过 ctx.alloc() 获取 ByteBufAllocator 分配内存
* @param outList 输出列表
* - 可用于在编码过程中添加多个消息
* - 当前设计为单一返回值,outList 暂作为扩展预留
* - 如果需要在编码过程中输出多个消息,可以直接操作此列表并返回 null
* @return 编码后的数据(类型 O)
* - 不能返回 null(泛型约束为 Any)
* - 返回值会被自动添加到 outList 中
*
* @see #encode 包装方法,由框架调用
*/
abstract fun encode(
inData: I,
channelHandlerContext: ChannelHandlerContext,
outList: MutableList<Any>,
): O
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile NettyUtils.kt * CurrentFile NettyUtils.kt
* LastUpdate 2026-06-20 22:18:39 * LastUpdate 2026-06-27 21:40:00
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,12 +28,11 @@ import com.mingliqiye.utils.functions.P1Function
import io.netty.bootstrap.Bootstrap import io.netty.bootstrap.Bootstrap
import io.netty.bootstrap.ServerBootstrap import io.netty.bootstrap.ServerBootstrap
import io.netty.buffer.ByteBuf import io.netty.buffer.ByteBuf
import io.netty.buffer.ByteBufUtil
import io.netty.buffer.Unpooled import io.netty.buffer.Unpooled
import io.netty.channel.Channel import io.netty.channel.Channel
import io.netty.channel.ChannelFuture
import io.netty.channel.ChannelInitializer import io.netty.channel.ChannelInitializer
import io.netty.channel.ChannelPipeline import io.netty.channel.ChannelPipeline
import io.netty.util.concurrent.Future
import java.nio.ByteBuffer import java.nio.ByteBuffer
import java.nio.charset.Charset import java.nio.charset.Charset
@@ -71,9 +70,7 @@ fun ByteBuf.toByteBuffer(): ByteBuffer {
* @return ByteArray 转换后的字节数组,包含ByteBuf中所有可读的字节数据 * @return ByteArray 转换后的字节数组,包含ByteBuf中所有可读的字节数据
*/ */
fun ByteBuf.toByteArray(): ByteArray { fun ByteBuf.toByteArray(): ByteArray {
val array = ByteArray(this.readableBytes()) return ByteBufUtil.getBytes(this)
this.readBytes(array)
return array
} }
/** /**
@@ -331,8 +328,3 @@ fun ByteBuf.tryRelease(): Boolean {
false false
} }
} }
fun ChannelFuture.addChannelListener(
listener: (Future<Channel>) -> Unit,
) {
}
@@ -0,0 +1,144 @@
/*
* 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 ObjectPool.kt
* LastUpdate 2026-10-02 16:19:05
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.pool
import com.mingliqiye.utils.require.Require.require
import java.util.concurrent.ConcurrentLinkedQueue
import java.util.concurrent.TimeUnit
import java.util.concurrent.atomic.AtomicBoolean
import java.util.concurrent.atomic.AtomicInteger
import java.util.concurrent.locks.Condition
import java.util.concurrent.locks.ReentrantLock
import kotlin.concurrent.withLock
@Deprecated("未实现")
abstract class ObjectPool<T>(
private val maxSize: Int = Int.MAX_VALUE,
private val minSize: Int = 0,
private val initialSize: Int = 1,
) : Pool<T> {
private val initialCount = AtomicInteger(0)
private val pool = ConcurrentLinkedQueue<ObjectPoolData<T>>()
private val isClosed = AtomicBoolean(false)
private val lock = ReentrantLock()
private val notEmpty: Condition = lock.newCondition()
init {
require(maxSize >= minSize)
require(initialSize >= minSize)
require(maxSize > 0)
repeat(initialSize) {
pool.add(init(initialCount.getAndIncrement()))
}
}
override fun close() {
for (poolData in pool) {
destroy(poolData)
}
}
override fun borrow(timeoutMillis: Long): ObjectPoolData<T> {
lock.withLock {
if (isClosed.get()) {
throw IllegalStateException("Object pool closed")
}
pool.poll()?.let { return it }
if (initialCount.get() < maxSize) {
return init(initialCount.getAndIncrement())
}
// 3. 池已满且无空闲,等待归还
if (timeoutMillis <= 0) {
// 无限等待
while (pool.isEmpty()) {
notEmpty.await() // 释放锁并等待
}
return pool.poll()
}
// 有限时间等待
var remainingNanos = TimeUnit.MILLISECONDS.toNanos(timeoutMillis)
while (pool.isEmpty()) {
if (remainingNanos <= 0) {
throw IllegalStateException("Timeout waiting for object from pool")
}
remainingNanos = notEmpty.awaitNanos(remainingNanos)
}
return pool.poll()
}
}
override fun returnObject(obj: ObjectPoolData<T>) {
lock.withLock {
if (isClosed.get()) {
throw InterruptedException("Object pool closed")
}
pool.add(obj)
notEmpty.signal()
}
}
}
interface Pool<T> {
fun close()
fun borrow(timeoutMillis: Long): ObjectPoolData<T>
fun borrow(): ObjectPoolData<T> = borrow(0)
fun returnObject(obj: ObjectPoolData<T>)
fun use(funs: (ObjectPoolData<T>) -> Unit) = use(0, funs)
fun init(id: Int): ObjectPoolData<T>
fun destroy(data: ObjectPoolData<T>)
fun use(timeoutMillis: Long, funs: (ObjectPoolData<T>) -> Unit) {
val i = borrow(timeoutMillis)
funs(i)
returnObject(i)
}
}
data class ObjectPoolData<T>(
val obj: T,
val objectPool: ObjectPool<T>,
val id: Int = obj.hashCode(),
val name: String = "",
)
class TheardPool : ObjectPool<Thread>() {
override fun init(id: Int): ObjectPoolData<Thread> {
return ObjectPoolData(
Thread().apply {
name = "TheardPool $id"
},
this
)
}
override fun destroy(data: ObjectPoolData<Thread>) {
data.obj.interrupt()
}
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile RandomBytes.kt * CurrentFile RandomBytes.kt
* LastUpdate 2026-03-27 14:18:30 * LastUpdate 2026-10-11 17:11:11
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.random package com.mingliqiye.utils.random
@@ -221,7 +221,7 @@ object Random {
*/ */
@JvmStatic @JvmStatic
fun String.randomString(length: Int): String = String(CharArray(length) { fun String.randomString(length: Int): String = String(CharArray(length) {
this[nextInt(0..<this.length)] this[nextInt(indices)]
}) })
/** /**
@@ -239,63 +239,63 @@ object Random {
* @return 数组中的随机元素 * @return 数组中的随机元素
*/ */
@JvmStatic @JvmStatic
fun <T> Array<T>.randomItem(): T = this[nextInt(0..<this.size)] fun <T> Array<T>.randomItem(): T = this[nextInt(indices)]
/** /**
* ByteArray类型的扩展函数 - 从字节数组中随机选择一个元素 * ByteArray类型的扩展函数 - 从字节数组中随机选择一个元素
* @return 字节数组中的随机字节 * @return 字节数组中的随机字节
*/ */
@JvmStatic @JvmStatic
fun ByteArray.randomItem(): Byte = this[nextInt(0..<this.size)] fun ByteArray.randomItem(): Byte = this[nextInt(indices)]
/** /**
* IntArray类型的扩展函数 - 从整数数组中随机选择一个元素 * IntArray类型的扩展函数 - 从整数数组中随机选择一个元素
* @return 整数数组中的随机整数 * @return 整数数组中的随机整数
*/ */
@JvmStatic @JvmStatic
fun IntArray.randomItem(): Int = this[nextInt(0..<this.size)] fun IntArray.randomItem(): Int = this[nextInt(indices)]
/** /**
* LongArray类型的扩展函数 - 从长整数数组中随机选择一个元素 * LongArray类型的扩展函数 - 从长整数数组中随机选择一个元素
* @return 长整数数组中的随机长整数 * @return 长整数数组中的随机长整数
*/ */
@JvmStatic @JvmStatic
fun LongArray.randomItem(): Long = this[nextInt(0..<this.size)] fun LongArray.randomItem(): Long = this[nextInt(indices)]
/** /**
* FloatArray类型的扩展函数 - 从浮点数数组中随机选择一个元素 * FloatArray类型的扩展函数 - 从浮点数数组中随机选择一个元素
* @return 浮点数数组中的随机浮点数 * @return 浮点数数组中的随机浮点数
*/ */
@JvmStatic @JvmStatic
fun FloatArray.randomItem(): Float = this[nextInt(0..<this.size)] fun FloatArray.randomItem(): Float = this[nextInt(indices)]
/** /**
* DoubleArray类型的扩展函数 - 从双精度浮点数数组中随机选择一个元素 * DoubleArray类型的扩展函数 - 从双精度浮点数数组中随机选择一个元素
* @return 双精度浮点数数组中的随机双精度浮点数 * @return 双精度浮点数数组中的随机双精度浮点数
*/ */
@JvmStatic @JvmStatic
fun DoubleArray.randomItem(): Double = this[nextInt(0..<this.size)] fun DoubleArray.randomItem(): Double = this[nextInt(indices)]
/** /**
* BooleanArray类型的扩展函数 - 从布尔数组中随机选择一个元素 * BooleanArray类型的扩展函数 - 从布尔数组中随机选择一个元素
* @return 布尔数组中的随机布尔值 * @return 布尔数组中的随机布尔值
*/ */
@JvmStatic @JvmStatic
fun BooleanArray.randomItem(): Boolean = this[nextInt(0..<this.size)] fun BooleanArray.randomItem(): Boolean = this[nextInt(indices)]
/** /**
* CharArray类型的扩展函数 - 从字符数组中随机选择一个元素 * CharArray类型的扩展函数 - 从字符数组中随机选择一个元素
* @return 字符数组中的随机字符 * @return 字符数组中的随机字符
*/ */
@JvmStatic @JvmStatic
fun CharArray.randomItem(): Char = this[nextInt(0..<this.size)] fun CharArray.randomItem(): Char = this[nextInt(indices)]
/** /**
* ShortArray类型的扩展函数 - 从短整数数组中随机选择一个元素 * ShortArray类型的扩展函数 - 从短整数数组中随机选择一个元素
* @return 短整数数组中的随机短整数 * @return 短整数数组中的随机短整数
*/ */
@JvmStatic @JvmStatic
fun ShortArray.randomItem(): Short = this[nextInt(0..<this.size)] fun ShortArray.randomItem(): Short = this[nextInt(indices)]
/** /**
* Collection类型的扩展函数 - 从集合中随机选择一个元素 * Collection类型的扩展函数 - 从集合中随机选择一个元素
@@ -303,5 +303,5 @@ object Random {
* @return 集合中的随机元素 * @return 集合中的随机元素
*/ */
@JvmStatic @JvmStatic
fun <T> Collection<T>.randomItem(): T = this.elementAt(nextInt(0..<this.size)) fun <T> Collection<T>.randomItem(): T = this.elementAt(nextInt(indices))
} }
@@ -16,14 +16,13 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ReflectUtils.kt * CurrentFile ReflectUtils.kt
* LastUpdate 2026-06-21 10:40:58 * LastUpdate 2026-10-11 17:11:11
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.reflect package com.mingliqiye.utils.reflect
import com.mingliqiye.utils.io.SIO.ifOr import com.mingliqiye.utils.io.SIO.ifOr
import java.lang.reflect.AnnotatedElement
import java.lang.reflect.Method import java.lang.reflect.Method
import kotlin.reflect.KClass import kotlin.reflect.KClass
import kotlin.reflect.KFunction import kotlin.reflect.KFunction
@@ -33,13 +32,15 @@ import kotlin.reflect.jvm.javaMethod
object ReflectUtils { object ReflectUtils {
private val walker: StackWalker = StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE) private val walker: StackWalker = StackWalker.getInstance(StackWalker.Option.RETAIN_CLASS_REFERENCE)
inline fun <reified T : Annotation> AnnotatedElement.getAnnotation() = this.getAnnotation(T::class.java)
inline fun <reified T : Any> T.ktClass(): KClass<T> = T::class inline fun <reified T : Any> T.ktClass(): KClass<T> = T::class
var <T : Any> KMutableProperty<T>.value: T var <T : Any> KMutableProperty<T>.value: T
get() = this.getter.call() get() = this.getter.call()
set(t: T) = this.setter.call(t) set(t: T) = this.setter.call(t)
val <T : Any> KProperty<T>.javaGetter: Method val <T : Any> KProperty<T>.javaGetter: Method
get() = this.getter.javaMethod!! get() = this.getter.javaMethod!!
val <T : Any> KMutableProperty<T>.javaSetter: Method val <T : Any> KMutableProperty<T>.javaSetter: Method
get() = this.getter.javaMethod!! get() = this.getter.javaMethod!!
val <T : Any> KFunction<T>.java: Method val <T : Any> KFunction<T>.java: Method
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile Jackson3AutoConfiguration.kt * CurrentFile Jackson3AutoConfiguration.kt
* LastUpdate 2026-03-11 08:46:40 * LastUpdate 2026-10-02 16:11:12
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,6 +28,7 @@ import com.mingliqiye.utils.json.converters.base.getJackson3Module
import com.mingliqiye.utils.logger.MingLiLoggerFactory import com.mingliqiye.utils.logger.MingLiLoggerFactory
import org.springframework.boot.autoconfigure.AutoConfigureAfter import org.springframework.boot.autoconfigure.AutoConfigureAfter
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass import org.springframework.boot.autoconfigure.condition.ConditionalOnClass
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean
import org.springframework.boot.jackson.autoconfigure.JsonMapperBuilderCustomizer import org.springframework.boot.jackson.autoconfigure.JsonMapperBuilderCustomizer
import org.springframework.context.annotation.Bean import org.springframework.context.annotation.Bean
@@ -38,6 +39,7 @@ open class Jackson3AutoConfiguration {
private val logger = MingLiLoggerFactory.getLogger<Jackson3AutoConfiguration>() private val logger = MingLiLoggerFactory.getLogger<Jackson3AutoConfiguration>()
@Bean @Bean
@ConditionalOnMissingBean(JsonMapperBuilderCustomizer::class)
open fun myJsonMapperCustomizer(): JsonMapperBuilderCustomizer { open fun myJsonMapperCustomizer(): JsonMapperBuilderCustomizer {
return JsonMapperBuilderCustomizer { builder -> return JsonMapperBuilderCustomizer { builder ->
builder builder
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile Jackson3JsonApiAutoConfiguration.kt * CurrentFile Jackson3JsonApiAutoConfiguration.kt
* LastUpdate 2026-06-21 10:40:58 * LastUpdate 2026-10-02 16:11:02
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -39,7 +39,7 @@ open class Jackson3JsonApiAutoConfiguration {
private val logger = MingLiLoggerFactory.getLogger<Jackson3JsonApiAutoConfiguration>() private val logger = MingLiLoggerFactory.getLogger<Jackson3JsonApiAutoConfiguration>()
@Bean @Bean
@ConditionalOnMissingBean @ConditionalOnMissingBean(JsonApi::class)
open fun jsonApi(jsonMapper: JsonMapper): JsonApi { open fun jsonApi(jsonMapper: JsonMapper): JsonApi {
return Jackson3JsonApi( return Jackson3JsonApi(
get = { jsonMapper }, get = { jsonMapper },
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JacksonAutoConfiguration.kt * CurrentFile JacksonAutoConfiguration.kt
* LastUpdate 2026-03-11 08:46:40 * LastUpdate 2026-10-02 16:10:53
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -91,7 +91,7 @@ open class JacksonAutoConfiguration(objectMapper: ObjectMapper) {
*/ */
@Bean @Bean
@Primary @Primary
@ConditionalOnMissingBean @ConditionalOnMissingBean(JsonApi::class)
open fun jsonApi(objectMapper: ObjectMapper): JsonApi { open fun jsonApi(objectMapper: ObjectMapper): JsonApi {
return JacksonJsonApi(objectMapper).also { return JacksonJsonApi(objectMapper).also {
log.info("JsonApi Bean Auto Configuration Success") log.info("JsonApi Bean Auto Configuration Success")
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile Okhttp3AutoConfiguration.kt * CurrentFile Okhttp3AutoConfiguration.kt
* LastUpdate 2026-02-27 17:40:32 * LastUpdate 2026-10-02 16:10:15
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -27,6 +27,7 @@ import org.slf4j.Logger
import org.springframework.beans.factory.annotation.Autowired import org.springframework.beans.factory.annotation.Autowired
import org.springframework.boot.autoconfigure.AutoConfiguration import org.springframework.boot.autoconfigure.AutoConfiguration
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass import org.springframework.boot.autoconfigure.condition.ConditionalOnClass
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean
import org.springframework.context.annotation.Bean import org.springframework.context.annotation.Bean
import org.springframework.context.event.ContextClosedEvent import org.springframework.context.event.ContextClosedEvent
import org.springframework.context.event.EventListener import org.springframework.context.event.EventListener
@@ -43,14 +44,15 @@ open class Okhttp3AutoConfiguration {
open var userDefinedBuilder: okhttp3.OkHttpClient.Builder? = null open var userDefinedBuilder: okhttp3.OkHttpClient.Builder? = null
open fun initOkHttpClient() { open fun initOkHttpClient() {
if (userDefinedBuilder == null) { okHttpClient = if (userDefinedBuilder == null) {
okHttpClient = okhttp3.OkHttpClient() okhttp3.OkHttpClient()
} else { } else {
userDefinedBuilder!!.build() userDefinedBuilder!!.build()
} }
} }
@Bean @Bean
@ConditionalOnMissingBean
open fun okHttpClient(): okhttp3.OkHttpClient { open fun okHttpClient(): okhttp3.OkHttpClient {
if (okHttpClient == null) { if (okHttpClient == null) {
initOkHttpClient() initOkHttpClient()
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile SpringBeanUtils.kt * CurrentFile SpringBeanUtils.kt
* LastUpdate 2026-02-26 14:09:02 * LastUpdate 2026-10-02 16:18:14
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -25,6 +25,7 @@ package com.mingliqiye.utils.springboot.bean
import org.springframework.beans.BeansException import org.springframework.beans.BeansException
import org.springframework.context.ApplicationContext import org.springframework.context.ApplicationContext
import org.springframework.context.ApplicationContextAware import org.springframework.context.ApplicationContextAware
import org.springframework.context.ApplicationContextException
import org.springframework.stereotype.Component import org.springframework.stereotype.Component
/** /**
@@ -37,7 +38,12 @@ class SpringBeanUtils : ApplicationContextAware {
companion object { companion object {
@JvmStatic @JvmStatic
private var applicationContext: ApplicationContext? = null val applicationContext: ApplicationContext
get() = applicationContextBase
?: throw ApplicationContextException("applicationContext isn't ContextInitialized ?")
private var applicationContextBase: ApplicationContext? = null
@Throws(BeansException::class) @Throws(BeansException::class)
inline fun <reified T : Any> getBean() = getBean(T::class.java) inline fun <reified T : Any> getBean() = getBean(T::class.java)
@@ -53,7 +59,7 @@ class SpringBeanUtils : ApplicationContextAware {
@JvmStatic @JvmStatic
@Throws(BeansException::class) @Throws(BeansException::class)
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
fun getBean(name: String): Any = applicationContext!!.getBean(name) fun getBean(name: String): Any = applicationContext.getBean(name)
/** /**
* 根据Bean类型获取Bean实例 * 根据Bean类型获取Bean实例
@@ -65,7 +71,7 @@ class SpringBeanUtils : ApplicationContextAware {
@JvmStatic @JvmStatic
@Throws(BeansException::class) @Throws(BeansException::class)
fun <T : Any> getBean(clazz: Class<T>): T { fun <T : Any> getBean(clazz: Class<T>): T {
return applicationContext!!.getBean(clazz) return applicationContext.getBean(clazz)
} }
/** /**
@@ -79,7 +85,7 @@ class SpringBeanUtils : ApplicationContextAware {
@JvmStatic @JvmStatic
@Throws(BeansException::class) @Throws(BeansException::class)
fun <T : Any> getBean(name: String, clazz: Class<T>): T { fun <T : Any> getBean(name: String, clazz: Class<T>): T {
return applicationContext!!.getBean<T>(name, clazz) return applicationContext.getBean<T>(name, clazz)
} }
} }
@@ -92,6 +98,6 @@ class SpringBeanUtils : ApplicationContextAware {
*/ */
@Throws(BeansException::class) @Throws(BeansException::class)
override fun setApplicationContext(applicationContext: ApplicationContext) { override fun setApplicationContext(applicationContext: ApplicationContext) {
SpringBeanUtils.applicationContext = applicationContext applicationContextBase = applicationContext
} }
} }