feat(utils): 添加数组工具类和国际化支持
- 添加ByteArray.toHexString和String.toHexByteArray扩展函数 - 实现多种数组类型的copyTo和copyFrom扩展方法 - 在AutoConfiguration中集成I18N国际化功能 - 添加AutoService注解及处理器用于自动服务注册 - 新增BadGatewayException HTTP状态异常类 - 更新启动横幅格式并添加国际化文本支持
This commit is contained in:
@@ -16,12 +16,13 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile Require.kt
|
||||
* LastUpdate 2026-02-05 11:08:03
|
||||
* LastUpdate 2026-02-06 08:27:44
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.require
|
||||
|
||||
import com.mingliqiye.utils.exception.InternalServerErrorException
|
||||
import com.mingliqiye.utils.logger.MingLiLoggerFactory
|
||||
import org.slf4j.Logger
|
||||
import java.lang.reflect.Constructor
|
||||
@@ -32,19 +33,136 @@ import kotlin.contracts.contract
|
||||
* 工具对象,用于提供条件检查功能。
|
||||
* 支持抛出自定义异常、延迟消息构造以及日志记录等功能。
|
||||
*/
|
||||
object Require {
|
||||
class Require(val defaultException: Class<out Throwable>) {
|
||||
|
||||
/**
|
||||
* 日志记录器实例,用于记录错误信息。
|
||||
*/
|
||||
@JvmStatic
|
||||
var logger: Logger? = MingLiLoggerFactory.getLogger<Require>()
|
||||
companion object {
|
||||
@JvmStatic
|
||||
val RequireLayz by lazy {
|
||||
Require(IllegalArgumentException::class.java)
|
||||
}
|
||||
|
||||
/**
|
||||
* 控制是否在抛出异常时记录错误日志。
|
||||
*/
|
||||
@JvmStatic
|
||||
var isLogError = true
|
||||
@JvmStatic
|
||||
val RequireHttpLayz by lazy {
|
||||
Require(InternalServerErrorException::class.java)
|
||||
}
|
||||
|
||||
@JvmStatic
|
||||
var logger: Logger? = MingLiLoggerFactory.getLogger<Require>()
|
||||
|
||||
@JvmStatic
|
||||
var isLogError = true
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则使用延迟消息构造器生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param throwable 异常类型。
|
||||
* @param layzMessage 延迟消息构造器。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
fun require(value: Boolean, throwable: Class<out Throwable>, layzMessage: RequireLayzMessageConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
require(value, layzMessage.call(), throwable)
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则使用延迟异常构造器生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param layzThrowable 延迟异常构造器。
|
||||
*/
|
||||
@JvmStatic
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
fun require(value: Boolean, layzThrowable: RequireLayzExceptionConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(layzThrowable.call())
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则根据指定的异常类型和消息生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param message 异常消息。
|
||||
* @param throwable 异常类型。
|
||||
*/
|
||||
@JvmStatic
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
fun require(value: Boolean, message: String, throwable: Class<out Throwable>) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(getExceptionConstructor(throwable).newInstance(message))
|
||||
}
|
||||
|
||||
/**
|
||||
* 抛出指定的异常,并在启用日志记录时记录错误信息。
|
||||
*
|
||||
* @param throwable 需要抛出的异常。
|
||||
*/
|
||||
@JvmStatic
|
||||
fun throwThrowable(throwable: Throwable) {
|
||||
if (isLogError && logger != null) logger!!.error(throwable.message, throwable)
|
||||
throw throwable
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则根据指定的异常类型抛出异常。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param message 异常消息。
|
||||
* @param T 异常类型。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmName("__inline_Require")
|
||||
inline fun <reified T : Throwable> require(value: Boolean, message: String) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
require(value, message, T::class.java)
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则根据指定的异常类型和延迟消息构造器生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param layzMessage 延迟消息构造器。
|
||||
* @param T 异常类型。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmName("__inline_Require")
|
||||
inline fun <reified T : Throwable> require(value: Boolean, layzMessage: RequireLayzMessageConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(getExceptionConstructor<T>().newInstance(layzMessage.call()))
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取指定异常类型的构造函数(带字符串参数)。
|
||||
*
|
||||
* @param T 异常类型。
|
||||
* @return 异常类型的构造函数。
|
||||
*/
|
||||
@JvmName("__inline_GetExceptionConstructor")
|
||||
inline fun <reified T : Throwable> getExceptionConstructor(): Constructor<out T> =
|
||||
getExceptionConstructor(T::class.java)
|
||||
|
||||
/**
|
||||
* 获取指定异常类型的构造函数(带字符串参数)。
|
||||
*
|
||||
* @param throwable 异常类型。
|
||||
* @return 异常类型的构造函数。
|
||||
*/
|
||||
|
||||
@JvmStatic
|
||||
@JvmName("__GetExceptionConstructor")
|
||||
fun <T : Throwable> getExceptionConstructor(throwable: Class<out T>): Constructor<out T> =
|
||||
throwable.getConstructor(String::class.java)
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则抛出 [IllegalArgumentException] 异常。
|
||||
@@ -52,28 +170,25 @@ object Require {
|
||||
* @param value 需要检查的布尔值。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmStatic
|
||||
fun require(value: Boolean) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
require<IllegalArgumentException>(value, "the require conditions are not met.")
|
||||
require(value, "the require conditions are not met.")
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则根据指定的异常类型抛出异常。
|
||||
* 检查给定条件是否为真。如果为假,则使用延迟消息构造器生成 [IllegalArgumentException] 并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param message 异常消息。
|
||||
* @param T 异常类型。
|
||||
* @param layzMessage 延迟消息构造器。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmName("__inline_Require")
|
||||
inline fun <reified T : Throwable> require(value: Boolean, message: String) {
|
||||
fun requireLayzMessage(value: Boolean, layzMessage: RequireLayzMessageConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
require(value, message, T::class.java)
|
||||
require(value, defaultException, layzMessage)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -87,114 +202,6 @@ object Require {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(getExceptionConstructor<IllegalArgumentException>().newInstance(message))
|
||||
if (!value) throwThrowable(getExceptionConstructor(defaultException).newInstance(message))
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则使用延迟消息构造器生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param throwable 异常类型。
|
||||
* @param layzMessage 延迟消息构造器。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmStatic
|
||||
fun require(value: Boolean, throwable: Class<out Throwable>, layzMessage: RequireLayzMessageConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
require(value, layzMessage.call(), throwable)
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则使用延迟异常构造器生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param layzThrowable 延迟异常构造器。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmStatic
|
||||
fun require(value: Boolean, layzThrowable: RequireLayzExceptionConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(layzThrowable.call())
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则使用延迟消息构造器生成 [IllegalArgumentException] 并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param layzMessage 延迟消息构造器。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmStatic
|
||||
fun requireLayzMessage(value: Boolean, layzMessage: RequireLayzMessageConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
require<IllegalArgumentException>(value, layzMessage)
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则根据指定的异常类型和延迟消息构造器生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param layzMessage 延迟消息构造器。
|
||||
* @param T 异常类型。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmName("__inline_Require")
|
||||
inline fun <reified T : Throwable> require(value: Boolean, layzMessage: RequireLayzMessageConstructor) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(getExceptionConstructor<T>().newInstance(layzMessage.call()))
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查给定条件是否为真。如果为假,则根据指定的异常类型和消息生成异常并抛出。
|
||||
*
|
||||
* @param value 需要检查的布尔值。
|
||||
* @param message 异常消息。
|
||||
* @param throwable 异常类型。
|
||||
*/
|
||||
@OptIn(ExperimentalContracts::class)
|
||||
@JvmStatic
|
||||
fun require(value: Boolean, message: String, throwable: Class<out Throwable>) {
|
||||
contract {
|
||||
returns() implies value
|
||||
}
|
||||
if (!value) throwThrowable(getExceptionConstructor(throwable).newInstance(message))
|
||||
}
|
||||
|
||||
/**
|
||||
* 抛出指定的异常,并在启用日志记录时记录错误信息。
|
||||
*
|
||||
* @param throwable 需要抛出的异常。
|
||||
*/
|
||||
fun throwThrowable(throwable: Throwable) {
|
||||
if (isLogError && logger != null) logger!!.error(throwable.message, throwable)
|
||||
throw throwable
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取指定异常类型的构造函数(带字符串参数)。
|
||||
*
|
||||
* @param T 异常类型。
|
||||
* @return 异常类型的构造函数。
|
||||
*/
|
||||
@JvmName("__inline_GetExceptionConstructor")
|
||||
inline fun <reified T : Throwable> getExceptionConstructor(): Constructor<out T> =
|
||||
getExceptionConstructor(T::class.java)
|
||||
|
||||
/**
|
||||
* 获取指定异常类型的构造函数(带字符串参数)。
|
||||
*
|
||||
* @param throwable 异常类型。
|
||||
* @return 异常类型的构造函数。
|
||||
*/
|
||||
@JvmName("__GetExceptionConstructor")
|
||||
fun <T : Throwable> getExceptionConstructor(throwable: Class<out T>): Constructor<out T> =
|
||||
throwable.getConstructor(String::class.java)
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user