Merge pull request 'dev' (#12) from dev into master

Reviewed-on: #12

.gitignore

@@ -45,3 +45,4 @@ log
 node_modules
 *lock*
 .kotlin
+secret.gpg

.prettierrc

@@ -1,8 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/prettierrc",
-  "plugins": [
-    "prettier-plugin-java"
-  ],
-  "tabWidth": 4,
-  "useTabs": true
-}

NOTICE

@@ -0,0 +1,25 @@
+mingli-utils
+Copyright 2025 mingliqiye
+
+This product includes software developed by third parties.
+The original copyright notices and licenses are reproduced below.
+
+------------------------------------------------------------
+
+https://github.com/jeremyh/jBCrypt (org.mindrot:jbcrypt@0.4)
+
+Copyright (c) 2006 Damien Miller <djm@mindrot.org>
+
+Permission to use, copy, modify, and distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+------------------------------------------------------------

README.md

@@ -1,167 +0,0 @@
-# mingli-utils
-
-一个功能丰富的Java工具类库，提供字符串处理、时间处理、文件操作、网络工具、哈希计算等常用工具方法。
-
-## 项目概述
-
-mingli-utils 是一个 Java 工具类库，提供各种常用的工具方法，旨在简化开发流程，减少重复代码。
-
-## 技术栈
-
-- JDK 版本: Java 8
-- 构建工具: Gradle (Kotlin DSL)
-- 依赖库:
-    - Lombok 1.18.38: 用于简化 Java Bean 代码
-    - Jackson Databind 2.19.2: 用于 JSON 序列化
-    - MyBatis 3.5.19: 持久层框架
-    - Spring Boot Starter 2.7.14: Spring Boot基础依赖
-    - Bouncy Castle 1.81: 加密算法库
-    - UUID Creator 6.1.0: UUID生成工具
-    - jBCrypt 0.4: BCrypt加密实现
-    - JetBrains Annotations 24.0.0: 注解库
-
-## 主要功能模块
-
-### 字符串处理 (StringUtil)
-
-提供常用的字符串操作方法：
-
-- `toString()`: 对象转字符串
-- `format()`: 格式化字符串
-- `isEmpty()`: 判断字符串是否为空
-- `join()`: 连接字符串
-- `split()`: 分割字符串
-
-### 集合工具 (Lists)
-
-提供创建各种List实现的便捷方法：
-
-- `newArrayList()`: 创建ArrayList实例
-- `newLinkedList()`: 创建LinkedList实例
-- `newVector()`: 创建Vector实例
-
-### 时间处理 (time)
-
-提供时间相关功能：
-
-- `DateTime`: 时间处理类，封装了LocalDateTime的操作
-- `DateTimeOffset`: 时间偏移量处理
-- `Formatter`: 常用时间格式枚举
-- `DateTimeUnit`: 时间单位常量定义
-
-### 文件操作 (FileUtil)
-
-提供文件读写等操作：
-
-- `readFileToString()`: 读取文件内容为字符串
-- `writeStringToFile()`: 将字符串写入文件
-- `readLines()`: 读取文件内容为字符串列表（按行分割）
-- `writeLines()`: 将字符串列表写入文件（每行一个元素）
-- `copyFile()`: 复制文件
-- `deleteFile()`: 删除文件
-- `exists()`: 检查文件是否存在
-- `getFileSize()`: 获取文件大小
-
-### 网络工具 (network)
-
-提供网络地址处理功能：
-
-- `NetworkEndpoint`: 网络端点（IP+端口）封装
-- `NetworkAddress`: 网络地址处理（支持IPv4/IPv6）
-- `NetworkPort`: 网络端口处理
-
-### 哈希工具 (HashUtils)
-
-提供哈希计算功能：
-
-- `calculateFileHash()`: 计算文件哈希值
-- `bcrypt()`: BCrypt加密
-- `checkBcrypt()`: 验证BCrypt哈希
-
-### 系统工具 (SystemUtil)
-
-提供系统相关工具方法：
-
-- `isWindows()/isMac()/isUnix()`: 操作系统类型判断
-- `getJdkVersion()`: 获取JDK版本
-- `getLocalIps()`: 获取本地IP地址
-
-### UUID工具 (uuid)
-
-提供UUID处理功能：
-
-- `UUID`: UUID封装类，支持时间戳型UUID
-
-### 并发工具 (concurrent)
-
-提供线程安全的数据结构：
-
-- `IsChanged`: 基于CAS操作的线程安全包装类
-
-### 函数式工具 (functions)
-
-提供函数式编程支持：
-
-- `Debouncer`: 防抖器实现
-
-## 使用示例
-
-```java
-// 字符串格式化
-String message =
-        StringUtil.format("Hello {}, you are {} years old", "张三", 25);
-
-// 创建列表
-List<String> fruits = Lists.newArrayList("苹果", "香蕉", "橙子");
-
-// 连接字符串
-String result = StringUtil.join(", ", fruits);
-
-// 时间处理
-DateTime now = DateTime.now();
-String formatted = now.format(Formatter.STANDARD_DATETIME);
-
-// 文件操作
-FileUtil.
-
-writeStringToFile("example.txt","Hello World");
-
-String content = FileUtil.readFileToString("example.txt");
-
-// 网络地址处理
-NetworkEndpoint endpoint = NetworkEndpoint.of("127.0.0.1", 8080);
-InetSocketAddress address = endpoint.toInetSocketAddress();
-
-// 哈希计算
-String hash = HashUtils.bcrypt("password");
-boolean matches = HashUtils.checkBcrypt("password", hash);
-```
-
-## 构建和运行
-
-使用以下命令构建项目：
-
-```bash
-./gradlew build
-```
-
-发布到本地Maven仓库：
-
-```bash
-./gradlew publishToMavenLocal
-```
-
-## 项目配置
-
-项目在 `gradle.properties` 中定义了以下配置：
-
-```properties
-JDKVERSIONS=1.8
-GROUPSID=com.mingliqiye.utils
-ARTIFACTID=mingli-utils
-VERSIONS=1.0.4
-```
-
-## License
-
-本项目采用Apache 2.0许可证，详细信息请查看 [LICENSE](LICENSE) 文件。

build.gradle.kts

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils
  * CurrentFile build.gradle.kts
- * LastUpdate 2025-09-14 22:32:52
+ * LastUpdate 2025-09-21 15:36:59
  * UpdateUser MingLiPro
  */
 
@@ -26,12 +26,12 @@ import java.time.format.DateTimeFormatter
 plugins {
     idea
     java
-    id("java-library")
-    id("maven-publish")
+    signing
+    `java-library`
+    `maven-publish`
     kotlin("jvm") version "2.2.20"
     id("org.jetbrains.dokka") version "2.0.0"
 }
-
 val GROUPSID = project.properties["GROUPSID"] as String
 val VERSIONS = project.properties["VERSIONS"] as String
 val ARTIFACTID = project.properties["ARTIFACTID"] as String
@@ -65,23 +65,21 @@ java {
 }
 
 dependencies {
-    annotationProcessor("org.jetbrains:annotations:24.0.0")
-    annotationProcessor("org.projectlombok:lombok:1.18.38")
+
+    implementation("org.slf4j:slf4j-api:2.0.17")
+
+    implementation("com.mingliqiye.utils.jna:WinKernel32Api:1.0.1")
+    // https://github.com/jeremyh/jBCrypt
+    implementation("org.mindrot:jbcrypt:0.4")
+
     compileOnly("org.springframework.boot:spring-boot-starter:2.7.14")
     compileOnly("com.fasterxml.jackson.core:jackson-databind:2.19.2")
     compileOnly("com.google.code.gson:gson:2.13.1")
     compileOnly("org.mybatis:mybatis:3.5.19")
     compileOnly("com.alibaba.fastjson2:fastjson2:2.0.58")
-    compileOnly("org.projectlombok:lombok:1.18.38")
-    implementation("org.bouncycastle:bcprov-jdk18on:1.81")
-    implementation("com.github.f4b6a3:uuid-creator:6.1.0")
-    implementation("org.mindrot:jbcrypt:0.4")
-    implementation("org.jetbrains:annotations:24.0.0")
-    compileOnly("net.java.dev.jna:jna:5.17.0")
-    //implementation("jakarta.annotation:jakarta.annotation-api:2.1.1")
-    implementation("org.slf4j:slf4j-api:2.0.17")
-    implementation("com.mingliqiye.utils.jna:WinKernel32Api:1.0.1")
 
+    compileOnly("com.baomidou:mybatis-plus-core:3.0.1")
+    compileOnly("net.java.dev.jna:jna:5.17.0")
 }
 
 
@@ -98,10 +96,12 @@ tasks.withType<JavaExec>().configureEach {
 
 tasks.withType<org.gradle.jvm.tasks.Jar> {
     duplicatesStrategy = DuplicatesStrategy.EXCLUDE
+    from("LICENSE") { into("META-INF") }
+    from("NOTICE") { into("META-INF") }
     manifest {
         attributes(
             mapOf(
-                "Main-Class" to "com.mingliqiye.utils.Main",
+                "Main-Class" to "com.mingliqiye.utils.main.Main",
                 "Specification-Title" to ARTIFACTID,
                 "Specification-Version" to VERSIONS,
                 "Specification-Vendor" to "minglipro",
@@ -132,17 +132,16 @@ repositories {
     }
     mavenCentral()
 }
-
 tasks.register<Jar>("javaDocJar") {
     group = "build"
     archiveClassifier.set("javadoc")
-    dependsOn(tasks.dokkaJavadoc)
+    dependsOn("dokkaJavadoc")
     from(buildDir.resolve("dokka/javadoc"))
 }
 tasks.register<Jar>("kotlinDocJar") {
     group = "build"
     archiveClassifier.set("kotlindoc")
-    dependsOn(tasks.dokkaHtml)
+    dependsOn("dokkaHtml")
     from(buildDir.resolve("dokka/html"))
 }
 publishing {
@@ -151,6 +150,10 @@ publishing {
             name = "MavenRepositoryRaw"
             url = uri("C:/data/git/maven-repository-raw")
         }
+        maven {
+            name = "OSSRepository"
+            url = uri("C:/data/git/maven-repository-raw-utils")
+        }
     }
     publications {
         create<MavenPublication>("mavenJava") {
@@ -159,8 +162,34 @@ publishing {
             artifact(tasks.named("kotlinDocJar"))
             artifactId = ARTIFACTID
             java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
+            pom {
+                name = "mingli-utils"
+                url = "https://mingli-utils.mingliqiye.com"
+                description = "A Java/kotlin Utils"
+                licenses {
+                    license {
+                        name = "The Apache License, Version 2.0"
+                        url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
                     }
                 }
+                developers {
+                    developer {
+                        id = "minglipro"
+                        name = "mingli"
+                        email = "minglipro@163.com"
+                    }
+                }
+                scm {
+                    connection = "scm:git:https://git.mingliqiye.com/minglipro/mingli-utils.git"
+                    developerConnection = "scm:git:https://git.mingliqiye.com:minglipro/mingli-utils.git"
+                    url = "https://git.mingliqiye.com/minglipro/mingli-utils"
+                }
+            }
+        }
+    }
+    signing {
+        sign(publishing.publications)
+    }
 }
 
 tasks.build {
@@ -180,7 +209,6 @@ tasks.processResources {
                     DateTimeFormatter.ofPattern(
                         "yyyy-MM-dd HH:mm:ss.SSSSSSS"
                     )
-
                 )
             )
         )

gradle.properties

@@ -16,10 +16,13 @@
 # ProjectName mingli-utils
 # ModuleName mingli-utils
 # CurrentFile gradle.properties
-# LastUpdate 2025-09-15 09:25:10
+# LastUpdate 2025-09-21 15:38:52
 # UpdateUser MingLiPro
 #
 JDKVERSIONS=1.8
 GROUPSID=com.mingliqiye.utils
 ARTIFACTID=mingli-utils
-VERSIONS=4.0.0-pre
+VERSIONS=4.1.9
+signing.keyId=B22AA93B
+signing.password=
+signing.secretKeyRingFile=secret.gpg

gradle/wrapper/gradle-wrapper.properties

@@ -16,12 +16,12 @@
 # ProjectName mingli-utils
 # ModuleName mingli-utils
 # CurrentFile gradle-wrapper.properties
-# LastUpdate 2025-09-09 08:37:34
+# LastUpdate 2025-09-15 22:32:50
 # UpdateUser MingLiPro
 #
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://mirrors.aliyun.com/macports/distfiles/gradle/gradle-8.14-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.2-bin.zip
 networkTimeout=10000
 validateDistributionUrl=true
 zipStoreBase=GRADLE_USER_HOME

gradlew

@@ -18,7 +18,7 @@
 # ProjectName mingli-utils
 # ModuleName mingli-utils
 # CurrentFile gradlew
-# LastUpdate 2025-09-09 08:37:33
+# LastUpdate 2025-09-15 22:32:50
 # UpdateUser MingLiPro
 #
 

jdk8/build.gradle.kts

@@ -16,12 +16,16 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.jdk8
  * CurrentFile build.gradle.kts
- * LastUpdate 2025-09-14 18:19:04
+ * LastUpdate 2025-09-21 15:39:12
  * UpdateUser MingLiPro
  */
+
 plugins {
     id("java-library")
     id("maven-publish")
+    signing
+    kotlin("jvm") version "2.2.20"
+    id("org.jetbrains.dokka") version "2.0.0"
 }
 val GROUPSID = project.properties["GROUPSID"] as String
 val VERSIONS = project.properties["VERSIONS"] as String
@@ -39,15 +43,44 @@ publishing {
             name = "MavenRepositoryRaw"
             url = uri("C:/data/git/maven-repository-raw")
         }
+        maven {
+            name = "OSSRepository"
+            url = uri("C:/data/git/maven-repository-raw-utils")
+        }
     }
     publications {
         create<MavenPublication>("mavenJava") {
             from(components["java"])
             artifactId = "$ARTIFACTID-win-jdk8"
-            groupId = GROUPSID
-            version = VERSIONS
+            java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
+            pom {
+                name = "mingli-utils-win-jdk8"
+                url = "https://mingli-utils.mingliqiye.com"
+                description = "A Java/kotlin Utils"
+                licenses {
+                    license {
+                        name = "The Apache License, Version 2.0"
+                        url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
                     }
                 }
+                developers {
+                    developer {
+                        id = "minglipro"
+                        name = "mingli"
+                        email = "minglipro@163.com"
+                    }
+                }
+                scm {
+                    connection = "scm:git:https://git.mingliqiye.com/minglipro/mingli-utils.git"
+                    developerConnection = "scm:git:https://git.mingliqiye.com:minglipro/mingli-utils.git"
+                    url = "https://git.mingliqiye.com/minglipro/mingli-utils"
+                }
+            }
+        }
+    }
+    signing {
+        sign(publishing.publications)
+    }
 }
 
 java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))

jdk8/gradle.properties

@@ -0,0 +1,23 @@
+#
+# Copyright 2025 mingliqiye
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# ProjectName mingli-utils
+# ModuleName mingli-utils.jdk8
+# CurrentFile gradle.properties
+# LastUpdate 2025-09-16 12:14:37
+# UpdateUser MingLiPro
+#
+
+signing.secretKeyRingFile=../secret.gpg

lombok.config

@@ -1 +0,0 @@
-lombok.addLombokGeneratedAnnotation = false

package.json

@@ -1,14 +0,0 @@
-{
-	"name": "maven-repository",
-	"version": "1.0.0",
-	"scripts": {
-		"build": "gradle build-jar",
-		"buildw": "gradlew build-jar",
-		"format": "prettier --write \"**/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,json,java}\"",
-		"f": "prettier --write \"**/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,json,java}\""
-	},
-	"devDependencies": {
-		"prettier-plugin-java": "^2.7.1",
-		"prettier": "^3.6.2"
-	}
-}

settings.gradle.kts

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils
  * CurrentFile settings.gradle.kts
- * LastUpdate 2025-09-13 02:37:04
+ * LastUpdate 2025-09-16 12:32:52
  * UpdateUser MingLiPro
  */
 

src/main/java/com/mingliqiye/utils/functions/Debouncer.java

@@ -1,93 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Debouncer.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-import java.util.concurrent.*;
-
-/**
- * 防抖器类，用于实现防抖功能，防止在短时间内重复执行相同任务
- *
- * @author MingLiPro
- */
-public class Debouncer {
-
-	private final ScheduledExecutorService scheduler =
-		Executors.newSingleThreadScheduledExecutor();
-	private final ConcurrentHashMap<Object, Future<?>> delayedMap =
-		new ConcurrentHashMap<>();
-	private final long delay;
-
-	/**
-	 * 构造函数，创建一个防抖器实例
-	 *
-	 * @param delay 延迟时间
-	 * @param unit  时间单位
-	 */
-	public Debouncer(long delay, TimeUnit unit) {
-		this.delay = unit.toMillis(delay);
-	}
-
-	/**
-	 * 执行防抖操作，如果在指定延迟时间内再次调用相同key的任务，则取消之前的任务并重新计时
-	 *
-	 * @param key  任务的唯一标识符，用于区分不同任务
-	 * @param task 要执行的任务
-	 */
-	public void debounce(final Object key, final Runnable task) {
-		// 提交新任务并获取之前可能存在的任务
-		final Future<?> prev = delayedMap.put(
-			key,
-			scheduler.schedule(
-				() -> {
-					try {
-						task.run();
-					} finally {
-						// 任务执行完成后从映射中移除
-						delayedMap.remove(key);
-					}
-				},
-				delay,
-				TimeUnit.MILLISECONDS
-			)
-		);
-
-		// 如果之前存在任务，则取消它
-		if (prev != null) {
-			prev.cancel(true);
-		}
-	}
-
-	/**
-	 * 关闭防抖器，取消所有待执行的任务并关闭调度器
-	 */
-	public void shutdown() {
-		// 先取消所有延迟任务
-		for (Future<?> future : delayedMap.values()) {
-			future.cancel(true);
-		}
-		delayedMap.clear();
-
-		// 再关闭调度器
-		scheduler.shutdownNow();
-	}
-}

src/main/java/com/mingliqiye/utils/functions/P10Function.java

@@ -1,39 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P10Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P10Function<P, P1, P2, P3, P4, P5, P6, P7, P8, P9> {
-	void call(
-		P p,
-		P1 p1,
-		P2 p2,
-		P3 p3,
-		P4 p4,
-		P5 p5,
-		P6 p6,
-		P7 p7,
-		P8 p8,
-		P9 p9
-	);
-}

src/main/java/com/mingliqiye/utils/functions/P10RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P10RFunction.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P10RFunction<P, P1, P2, P3, P4, P5, P6, P7, P8, P9, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6, P7 p7, P8 p8, P9 p9);
-}

src/main/java/com/mingliqiye/utils/functions/P1Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P1Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P1Function<P> {
-	void call(P p);
-}

src/main/java/com/mingliqiye/utils/functions/P1RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P1RFunction.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P1RFunction<P, R> {
-	R call(P p);
-}

src/main/java/com/mingliqiye/utils/functions/P2Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P2Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P2Function<P, P1> {
-	void call(P p, P1 p1);
-}

src/main/java/com/mingliqiye/utils/functions/P2RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P2RFunction.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P2RFunction<P, P1, R> {
-	R call(P p, P1 p1);
-}

src/main/java/com/mingliqiye/utils/functions/P3Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P3Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P3Function<P, P1, P2> {
-	void call(P p, P1 p1, P2 p2);
-}

src/main/java/com/mingliqiye/utils/functions/P3RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P3RFunction.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P3RFunction<P, P1, P2, R> {
-	R call(P p, P1 p1, P2 p2);
-}

src/main/java/com/mingliqiye/utils/functions/P4Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P4Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P4Function<P, P1, P2, P3> {
-	void call(P p, P1 p1, P2 p2, P3 p3);
-}

src/main/java/com/mingliqiye/utils/functions/P4RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P4RFunction.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P4RFunction<P, P1, P2, P3, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3);
-}

src/main/java/com/mingliqiye/utils/functions/P5Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P5Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P5Function<P, P1, P2, P3, P4> {
-	void call(P p, P1 p1, P2 p2, P3 p3, P4 p4);
-}

src/main/java/com/mingliqiye/utils/functions/P5RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P5RFunction.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P5RFunction<P, P1, P2, P3, P4, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3, P4 p4);
-}

src/main/java/com/mingliqiye/utils/functions/P6Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P6Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P6Function<P, P1, P2, P3, P4, P5> {
-	void call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5);
-}

src/main/java/com/mingliqiye/utils/functions/P6RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P6RFunction.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P6RFunction<P, P1, P2, P3, P4, P5, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5);
-}

src/main/java/com/mingliqiye/utils/functions/P7Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P7Function.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P7Function<P, P1, P2, P3, P4, P5, P6> {
-	void call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6);
-}

src/main/java/com/mingliqiye/utils/functions/P7RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P7RFunction.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P7RFunction<P, P1, P2, P3, P4, P5, P6, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6);
-}

src/main/java/com/mingliqiye/utils/functions/P8Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P8Function.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P8Function<P, P1, P2, P3, P4, P5, P6, P7> {
-	void call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6, P7 p7);
-}

src/main/java/com/mingliqiye/utils/functions/P8RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P8RFunction.java
- * LastUpdate 2025-09-09 08:37:34
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P8RFunction<P, P1, P2, P3, P4, P5, P6, P7, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6, P7 p7);
-}

src/main/java/com/mingliqiye/utils/functions/P9Function.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P9Function.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P9Function<P, P1, P2, P3, P4, P5, P6, P7, P8> {
-	void call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6, P7 p7, P8 p8);
-}

src/main/java/com/mingliqiye/utils/functions/P9RFunction.java

@@ -1,28 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile P9RFunction.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.functions;
-
-@FunctionalInterface
-public interface P9RFunction<P, P1, P2, P3, P4, P5, P6, P7, P8, R> {
-	R call(P p, P1 p1, P2 p2, P3 p3, P4 p4, P5 p5, P6 p6, P7 p7, P8 p8);
-}

src/main/java/com/mingliqiye/utils/hash/HashUtils.java

@@ -1,114 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile HashUtils.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.hash;
-
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.IOException;
-import java.security.MessageDigest;
-import java.security.NoSuchAlgorithmException;
-import java.security.Security;
-import org.bouncycastle.jce.provider.BouncyCastleProvider;
-import org.mindrot.jbcrypt.BCrypt;
-
-/**
- * 提供常用的哈希计算工具方法，包括文件哈希值计算、BCrypt 加密等。
- *
- * @author MingLiPro
- */
-public class HashUtils {
-
-	static {
-		Security.addProvider(new BouncyCastleProvider());
-	}
-
-	/**
-	 * 计算指定文件的哈希值。
-	 *
-	 * @param file      要计算哈希值的文件对象
-	 * @param algorithm 使用的哈希算法名称（如 SHA-256、MD5 等）
-	 * @return 文件的十六进制格式哈希值字符串
-	 * @throws IOException              当文件不存在或读取过程中发生 I/O 错误时抛出
-	 * @throws NoSuchAlgorithmException 当指定的哈希算法不可用时抛出
-	 */
-	public static String calculateFileHash(File file, String algorithm)
-		throws IOException, NoSuchAlgorithmException {
-		// 检查文件是否存在
-		if (!file.exists()) {
-			throw new IOException("File not found: " + file.getAbsolutePath());
-		}
-
-		MessageDigest digest = MessageDigest.getInstance(algorithm);
-
-		try (FileInputStream fis = new FileInputStream(file)) {
-			byte[] buffer = new byte[8192];
-			int bytesRead;
-
-			// 分块读取文件内容并更新摘要
-			while ((bytesRead = fis.read(buffer)) != -1) {
-				digest.update(buffer, 0, bytesRead);
-			}
-		}
-
-		return bytesToHex(digest.digest());
-	}
-
-	/**
-	 * 将字节数组转换为十六进制字符串表示。
-	 *
-	 * @param bytes 输入的字节数组
-	 * @return 对应的十六进制字符串
-	 */
-	private static String bytesToHex(byte[] bytes) {
-		StringBuilder hexString = new StringBuilder(2 * bytes.length);
-		for (byte b : bytes) {
-			String hex = Integer.toHexString(0xff & b);
-			if (hex.length() == 1) {
-				hexString.append('0');
-			}
-			hexString.append(hex);
-		}
-		return hexString.toString();
-	}
-
-	/**
-	 * 使用 BCrypt 算法对字符串进行加密。
-	 *
-	 * @param string 需要加密的明文字符串
-	 * @return 加密后的 BCrypt 哈希字符串
-	 */
-	public static String bcrypt(String string) {
-		return BCrypt.hashpw(string, BCrypt.gensalt());
-	}
-
-	/**
-	 * 验证给定字符串与 BCrypt 哈希是否匹配。
-	 *
-	 * @param string   明文字符串
-	 * @param bcrypted 已经使用 BCrypt 加密的哈希字符串
-	 * @return 如果匹配返回 true，否则返回 false
-	 */
-	public static boolean checkBcrypt(String string, String bcrypted) {
-		return BCrypt.checkpw(string, bcrypted);
-	}
-}

src/main/java/com/mingliqiye/utils/iterator/Range.java

@@ -1,227 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Range.java
- * LastUpdate 2025-09-15 09:22:02
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.iterator;
-
-import kotlin.ranges.ClosedRange;
-import kotlin.ranges.OpenEndRange;
-import lombok.Getter;
-import lombok.val;
-import org.jetbrains.annotations.NotNull;
-
-import java.util.Iterator;
-
-/**
- * 范围 Range<br>
- * Iterable 可遍历对象<br>
- * 类似 KT的 {@code 0..10 = Range.of(0,10)} {@code 0..10 step 2 = Range.of(0,10,2)}
- * @author MingLiPro
- * @since 3.2.6
- */
-@Getter
-public class Range
-	implements Iterable<Integer>, ClosedRange<Integer>, OpenEndRange<Integer> {
-
-	private final int start;
-	private final int end;
-	private final int step;
-	private int current;
-
-	/**
-	 * 创建一个范围 <br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param start 开始 (包含)
-	 * @param end 完毕 (包含)
-	 * @see Integer
-	 */
-	public Range(int start, int end) {
-		this(start, end, 1);
-	}
-
-	/**
-	 * 创建一个范围 <br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param start 开始 (包含)
-	 * @param end 完毕 (包含)
-	 * @param step 步长
-	 * @see Integer
-	 */
-	public Range(int start, int end, int step) {
-		this.start = start;
-		this.current = start;
-		this.step = step;
-		this.end = end + 1;
-	}
-
-	/**
-	 * 创建一个范围  {@code 0 - range}<br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param range 完毕 (包含)
-	 * @see Integer
-	 */
-	public Range(int range) {
-		this(0, range);
-	}
-
-	/**
-	 * 创建一个范围  {@code 0 - range}<br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param range 完毕 (包含)
-	 * @see Integer
-	 * @return Range 对象
-	 */
-	public static Range of(int range) {
-		return new Range(range);
-	}
-
-	/**
-	 * 创建一个范围 <br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param start 开始 (包含)
-	 * @param end 完毕 (包含)
-	 * @see Integer
-	 * @return Range 对象
-	 */
-	public static Range of(int start, int end) {
-		return new Range(start, end);
-	}
-
-	/**
-	 * 创建一个范围 <br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param start 开始 (包含)
-	 * @param end 完毕 (包含)
-	 * @param step 步长
-	 * @see Integer
-	 */
-	public static Range of(int start, int end, int step) {
-		return new Range(start, end, step);
-	}
-
-	/**
-	 * 创建一个范围 <br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param start 开始 (包含)
-	 * @param end 完毕 (包含)
-	 * @param step 步长
-	 * @see Integer
-	 */
-	public static Range range(int start, int end, int step) {
-		return new Range(start, end, step);
-	}
-
-	/**
-	 * 创建一个范围  {@code 0 - range}<br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param range 完毕 (包含)
-	 * @see Integer
-	 * @return Range 对象
-	 */
-	public static Range range(int range) {
-		return new Range(range);
-	}
-
-	/**
-	 * 创建一个范围 <br>
-	 * 最大值{@code Integer.MAX_VALUE = 2147483647 } <br>
-	 * 最小值{@code Integer.MIN_VALUE = -2147483648} <br>
-	 * @param start 开始 (包含)
-	 * @param end 完毕 (包含)
-	 * @see Integer
-	 * @return Range 对象
-	 */
-	public static Range range(int start, int end) {
-		return new Range(start, end);
-	}
-
-	/**
-	 * 获取迭代器
-	 * @return 迭代器
-	 */
-	@Override
-	public @NotNull Iterator<Integer> iterator() {
-		return new Iterator<Integer>() {
-			@Override
-			public boolean hasNext() {
-				return current < end;
-			}
-
-			@Override
-			public Integer next() {
-				if (current >= end) {
-					return null;
-				}
-
-				try {
-					return current;
-				} finally {
-					current = current + step;
-				}
-			}
-		};
-	}
-
-	@Override
-	public boolean isEmpty() {
-		return current < end;
-	}
-
-	@Override
-	public @NotNull Integer getEndInclusive() {
-		val va = end - step;
-		return Math.max(va, 0);
-	}
-
-	@Override
-	public boolean contains(@NotNull Integer integer) {
-		if (step == 0) return false;
-		if (step > 0) {
-			if (integer < start || integer > end) return false;
-		} else {
-			if (integer > start || integer < end) return false;
-		}
-		return (integer - start) % step == 0;
-	}
-
-	@Override
-	public @NotNull Integer getEndExclusive() {
-		return end;
-	}
-
-	@Override
-	public @NotNull Integer getStart() {
-		return start;
-	}
-
-	@Override
-	public String toString() {
-		return String.format("Range(start=%s,end=%s,step=%s)", start, end, step);
-	}
-}

src/main/java/com/mingliqiye/utils/json/GsonJsonApi.java

@@ -1,187 +0,0 @@
-package com.mingliqiye.utils.json;
-
-import com.google.gson.*;
-
-public class GsonJsonApi implements JsonApi {
-
-	private final Gson gson;
-	private final Gson gsonUnicode;
-	private final Gson gsonPretty;
-	private final Gson gsonPrettyUnicode;
-
-	public GsonJsonApi() {
-		gson = new GsonBuilder()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-
-		gsonUnicode = new GsonBuilder()
-			.disableHtmlEscaping()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-
-		gsonPretty = new GsonBuilder()
-			.setPrettyPrinting()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-
-		gsonPrettyUnicode = new GsonBuilder()
-			.setPrettyPrinting()
-			.disableHtmlEscaping()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-	}
-
-	public GsonJsonApi(Gson gson) {
-		this.gson = gson
-			.newBuilder()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-		this.gsonUnicode = gson
-			.newBuilder()
-			.disableHtmlEscaping()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-		this.gsonPretty = gson
-			.newBuilder()
-			.setPrettyPrinting()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-		this.gsonPrettyUnicode = gson
-			.newBuilder()
-			.setPrettyPrinting()
-			.disableHtmlEscaping()
-			.setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
-			.create();
-	}
-
-	@Override
-	public <T> T parse(String json, Class<T> clazz) {
-		return gson.fromJson(json, clazz);
-	}
-
-	@Override
-	public <T> T parse(String json, JsonTypeReference<T> type) {
-		return gson.fromJson(json, type.getType());
-	}
-
-	@Override
-	public String format(Object object) {
-		return gson.toJson(object);
-	}
-
-	@Override
-	public String formatUnicode(Object object) {
-		return gsonUnicode.toJson(object);
-	}
-
-	@Override
-	public String formatPretty(Object object) {
-		return gsonPretty.toJson(object);
-	}
-
-	@Override
-	public String formatPrettyUnicode(Object object) {
-		return gsonPrettyUnicode.toJson(object);
-	}
-
-	@Override
-	public boolean isValidJson(String json) {
-		try {
-			JsonElement element = JsonParser.parseString(json);
-			return true;
-		} catch (JsonSyntaxException e) {
-			return false;
-		} catch (Exception e) {
-			return false;
-		}
-	}
-
-	@Override
-	public String merge(String... jsons) {
-		JsonObject merged = new JsonObject();
-		for (String json : jsons) {
-			if (json == null || json.isEmpty()) {
-				continue;
-			}
-			try {
-				JsonObject obj = JsonParser.parseString(json).getAsJsonObject();
-				for (String key : obj.keySet()) {
-					merged.add(key, obj.get(key));
-				}
-			} catch (Exception e) {
-				// 忽略无效的 JSON 字符串
-			}
-		}
-		return gson.toJson(merged);
-	}
-
-	@Override
-	public String getNodeValue(String json, String path) {
-		try {
-			JsonElement element = JsonParser.parseString(json);
-			String[] paths = path.split("\\.");
-			JsonElement current = element;
-
-			for (String p : paths) {
-				if (current.isJsonObject()) {
-					current = current.getAsJsonObject().get(p);
-				} else {
-					return null;
-				}
-
-				if (current == null) {
-					return null;
-				}
-			}
-
-			return current.isJsonPrimitive()
-				? current.getAsString()
-				: current.toString();
-		} catch (Exception e) {
-			return null;
-		}
-	}
-
-	@Override
-	public String updateNodeValue(String json, String path, Object newValue) {
-		try {
-			JsonObject obj = JsonParser.parseString(json).getAsJsonObject();
-			String[] paths = path.split("\\.");
-			JsonObject current = obj;
-
-			// 导航到倒数第二层
-			for (int i = 0; i < paths.length - 1; i++) {
-				String p = paths[i];
-				if (!current.has(p) || !current.get(p).isJsonObject()) {
-					current.add(p, new JsonObject());
-				}
-				current = current.getAsJsonObject(p);
-			}
-
-			// 设置最后一层的值
-			String lastPath = paths[paths.length - 1];
-			if (newValue == null) {
-				current.remove(lastPath);
-			} else {
-				JsonElement element = gson.toJsonTree(newValue);
-				current.add(lastPath, element);
-			}
-
-			return gson.toJson(obj);
-		} catch (Exception e) {
-			return json;
-		}
-	}
-
-	@Override
-	public <T, D> D convert(T source, Class<D> destinationClass) {
-		String json = gson.toJson(source);
-		return gson.fromJson(json, destinationClass);
-	}
-
-	@Override
-	public <T, D> D convert(T source, JsonTypeReference<D> destinationType) {
-		String json = gson.toJson(source);
-		return gson.fromJson(json, destinationType.getType());
-	}
-}

src/main/java/com/mingliqiye/utils/json/JacksonJsonApi.java

@@ -1,341 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile JacksonJsonApi.java
- * LastUpdate 2025-09-09 09:31:31
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.json;
-
-import com.fasterxml.jackson.core.JsonGenerator;
-import com.fasterxml.jackson.core.JsonProcessingException;
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.fasterxml.jackson.databind.ObjectReader;
-import com.fasterxml.jackson.databind.node.ObjectNode;
-import java.io.IOException;
-import java.util.List;
-import java.util.Map;
-
-/**
- * 基于Jackson的JSON处理实现类，提供JSON字符串解析、格式化、合并、节点操作等功能。
- */
-public class JacksonJsonApi implements JsonApi {
-
-	private final ObjectMapper objectMapper;
-
-	/**
-	 * 使用默认的ObjectMapper构造实例
-	 */
-	public JacksonJsonApi() {
-		this.objectMapper = new ObjectMapper();
-	}
-
-	/**
-	 * 使用指定的ObjectMapper构造实例
-	 *
-	 * @param objectMapper 自定义的ObjectMapper实例
-	 */
-	public JacksonJsonApi(ObjectMapper objectMapper) {
-		this.objectMapper = objectMapper.copy();
-	}
-
-	/**
-	 * 将JSON字符串解析为指定类型的对象
-	 *
-	 * @param json  待解析的JSON字符串
-	 * @param clazz 目标对象类型
-	 * @param <T>   泛型参数，表示目标对象类型
-	 * @return 解析后的对象
-	 * @throws JsonException 当解析失败时抛出异常
-	 */
-	@Override
-	public <T> T parse(String json, Class<T> clazz) {
-		try {
-			return objectMapper.readValue(json, clazz);
-		} catch (IOException e) {
-			throw new JsonException("Failed to parse JSON string", e);
-		}
-	}
-
-	/**
-	 * 将JSON字符串解析为复杂泛型结构的对象（如List、Map等）
-	 *
-	 * @param json JSON字符串
-	 * @param type 泛型类型引用
-	 * @param <T>  泛型参数，表示目标对象类型
-	 * @return 解析后的对象
-	 * @throws JsonException 当解析失败时抛出异常
-	 */
-	@Override
-	public <T> T parse(String json, JsonTypeReference<T> type) {
-		try {
-			ObjectReader reader = objectMapper.readerFor(
-				objectMapper.constructType(type.getType())
-			);
-			return reader.readValue(json);
-		} catch (IOException e) {
-			throw new JsonException("Failed to parse JSON string", e);
-		}
-	}
-
-	/**
-	 * 将对象格式化为JSON字符串
-	 *
-	 * @param object 待格式化的对象
-	 * @return 格式化后的JSON字符串
-	 * @throws JsonException 当格式化失败时抛出异常
-	 */
-	@Override
-	public String format(Object object) {
-		try {
-			return objectMapper.writeValueAsString(object);
-		} catch (JsonProcessingException e) {
-			throw new JsonException(
-				"Failed to format object to JSON string",
-				e
-			);
-		}
-	}
-
-	@Override
-	public String formatUnicode(Object object) {
-		try {
-			return objectMapper
-				.writer()
-				.with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
-				.writeValueAsString(object);
-		} catch (JsonProcessingException e) {
-			throw new JsonException(e);
-		}
-	}
-
-	/**
-	 * 将对象格式化为美化（带缩进）的JSON字符串
-	 *
-	 * @param object 待格式化的对象
-	 * @return 美化后的JSON字符串
-	 * @throws JsonException 当格式化失败时抛出异常
-	 */
-	@Override
-	public String formatPretty(Object object) {
-		try {
-			return objectMapper
-				.writerWithDefaultPrettyPrinter()
-				.writeValueAsString(object);
-		} catch (JsonProcessingException e) {
-			throw new JsonException(
-				"Failed to format object to pretty JSON string",
-				e
-			);
-		}
-	}
-
-	@Override
-	public String formatPrettyUnicode(Object object) {
-		try {
-			return objectMapper
-				.writerWithDefaultPrettyPrinter()
-				.with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
-				.writeValueAsString(object);
-		} catch (JsonProcessingException e) {
-			throw new JsonException(
-				"Failed to format object to pretty JSON string",
-				e
-			);
-		}
-	}
-
-	/**
-	 * 将JSON字符串解析为指定元素类型的List
-	 *
-	 * @param json        JSON字符串
-	 * @param elementType List中元素的类型
-	 * @param <T>         泛型参数，表示List中元素的类型
-	 * @return 解析后的List对象
-	 */
-	@Override
-	public <T> List<T> parseList(String json, Class<T> elementType) {
-		return parse(json, JsonTypeUtils.listType(elementType));
-	}
-
-	/**
-	 * 将JSON字符串解析为指定键值类型的Map
-	 *
-	 * @param json      JSON字符串
-	 * @param keyType   Map中键的类型
-	 * @param valueType Map中值的类型
-	 * @param <K>       泛型参数，表示Map中键的类型
-	 * @param <V>       泛型参数，表示Map中值的类型
-	 * @return 解析后的Map对象
-	 */
-	@Override
-	public <K, V> Map<K, V> parseMap(
-		String json,
-		Class<K> keyType,
-		Class<V> valueType
-	) {
-		return parse(json, JsonTypeUtils.MapType(keyType, valueType));
-	}
-
-	/**
-	 * 判断给定字符串是否是有效的JSON格式
-	 *
-	 * @param json 待验证的字符串
-	 * @return 如果是有效JSON返回true，否则返回false
-	 */
-	@Override
-	public boolean isValidJson(String json) {
-		try {
-			objectMapper.readTree(json);
-			return true;
-		} catch (Exception e) {
-			return false;
-		}
-	}
-
-	/**
-	 * 合并多个JSON字符串为一个JSON对象
-	 *
-	 * @param jsons 多个JSON字符串
-	 * @return 合并后的JSON字符串
-	 * @throws JsonException 当合并失败时抛出异常
-	 */
-	@Override
-	public String merge(String... jsons) {
-		ObjectNode result = objectMapper.createObjectNode();
-		for (String json : jsons) {
-			try {
-				JsonNode node = objectMapper.readTree(json);
-				if (node.isObject()) {
-					result.setAll((ObjectNode) node);
-				}
-			} catch (IOException e) {
-				// 忽略无效的JSON字符串
-			}
-		}
-		try {
-			return objectMapper.writeValueAsString(result);
-		} catch (JsonProcessingException e) {
-			throw new JsonException("Failed to merge JSON strings", e);
-		}
-	}
-
-	/**
-	 * 获取JSON字符串中指定路径的节点值
-	 *
-	 * @param json JSON字符串
-	 * @param path 节点路径，使用"."分隔
-	 * @return 节点值的文本表示，如果路径不存在则返回null
-	 * @throws JsonException 当获取节点值失败时抛出异常
-	 */
-	@Override
-	public String getNodeValue(String json, String path) {
-		try {
-			JsonNode node = objectMapper.readTree(json);
-			String[] paths = path.split("\\.");
-			for (String p : paths) {
-				node = node.get(p);
-				if (node == null) {
-					return null;
-				}
-			}
-			return node.asText();
-		} catch (IOException e) {
-			throw new JsonException("Failed to get node value", e);
-		}
-	}
-
-	/**
-	 * 更新JSON字符串中指定路径的节点值
-	 *
-	 * @param json     JSON字符串
-	 * @param path     节点路径，使用"."分隔
-	 * @param newValue 新的节点值
-	 * @return 更新后的JSON字符串
-	 * @throws JsonException 当更新节点值失败时抛出异常
-	 */
-	@Override
-	public String updateNodeValue(String json, String path, Object newValue) {
-		try {
-			JsonNode node = objectMapper.readTree(json);
-			if (node instanceof ObjectNode) {
-				ObjectNode objectNode = (ObjectNode) node;
-				String[] paths = path.split("\\.");
-				JsonNode current = objectNode;
-
-				// 导航到目标节点的父节点
-				for (int i = 0; i < paths.length - 1; i++) {
-					current = current.get(paths[i]);
-					if (current == null || !(current instanceof ObjectNode)) {
-						return json; // 路径不存在或无效
-					}
-				}
-
-				// 更新值
-				if (current instanceof ObjectNode) {
-					ObjectNode parent = (ObjectNode) current;
-					if (newValue == null) {
-						parent.remove(paths[paths.length - 1]);
-					} else {
-						parent.set(
-							paths[paths.length - 1],
-							objectMapper.valueToTree(newValue)
-						);
-					}
-				}
-
-				return objectMapper.writeValueAsString(objectNode);
-			}
-			return json;
-		} catch (IOException e) {
-			throw new JsonException("Failed to update node value", e);
-		}
-	}
-
-	/**
-	 * 在不同对象类型之间进行转换
-	 *
-	 * @param source           源对象
-	 * @param destinationClass 目标对象类型
-	 * @param <T>              源对象类型
-	 * @param <D>              目标对象类型
-	 * @return 转换后的对象
-	 */
-	@Override
-	public <T, D> D convert(T source, Class<D> destinationClass) {
-		return objectMapper.convertValue(source, destinationClass);
-	}
-
-	/**
-	 * 在不同泛型对象类型之间进行转换
-	 *
-	 * @param source          源对象
-	 * @param destinationType 目标对象的泛型类型引用
-	 * @param <T>             源对象类型
-	 * @param <D>             目标对象类型
-	 * @return 转换后的对象
-	 */
-	@Override
-	public <T, D> D convert(T source, JsonTypeReference<D> destinationType) {
-		return objectMapper.convertValue(
-			source,
-			objectMapper.constructType(destinationType.getType())
-		);
-	}
-}

src/main/java/com/mingliqiye/utils/json/JsonApi.java

@@ -1,390 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile JsonApi.java
- * LastUpdate 2025-09-09 09:22:02
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.json;
-
-import java.io.*;
-import java.nio.file.Files;
-import java.nio.file.Path;
-import java.nio.file.Paths;
-import java.util.List;
-import java.util.Map;
-
-/**
- * JSON处理接口，提供JSON字符串与Java对象之间的相互转换功能
- */
-public interface JsonApi {
-	/**
-	 * 将JSON字符串解析为指定类型的对象
-	 *
-	 * @param json  待解析的JSON字符串
-	 * @param clazz 目标对象的Class类型
-	 * @param <T>   泛型参数，表示目标对象的类型
-	 * @return 解析后的对象实例
-	 */
-	<T> T parse(String json, Class<T> clazz);
-
-	/**
-	 * 将JSON字符串解析为指定泛型类型对象
-	 *
-	 * @param json 待解析的JSON字符串
-	 * @param type 目标对象的Type类型（支持泛型）
-	 * @param <T>  泛型参数，表示目标对象的类型
-	 * @return 解析后的对象实例
-	 */
-	<T> T parse(String json, JsonTypeReference<T> type);
-
-	/**
-	 * 将对象格式化为JSON字符串
-	 *
-	 * @param object 待格式化的对象
-	 * @return 格式化后的JSON字符串
-	 */
-	String format(Object object);
-
-	String formatUnicode(Object object);
-
-	default <T> T parseFrom(String path, Class<T> clazz) throws IOException {
-		return parseFrom(Paths.get(path), clazz);
-	}
-
-	default <T> T parseFrom(Path path, Class<T> clazz) throws IOException {
-		return parseFrom(path.toFile(), clazz);
-	}
-
-	default <T> T parseFrom(File file, Class<T> clazz) throws IOException {
-		try (InputStream inputStream = Files.newInputStream(file.toPath())) {
-			return parseFrom(inputStream, clazz);
-		}
-	}
-
-	default <T> T parseFrom(InputStream inputStream, Class<T> clazz)
-		throws IOException {
-		if (inputStream == null) {
-			throw new IllegalArgumentException("inputStream cannot be null");
-		}
-		if (clazz == null) {
-			throw new IllegalArgumentException("clazz cannot be null");
-		}
-		byte[] bytes = new byte[1024];
-		try (ByteArrayOutputStream bos = new ByteArrayOutputStream()) {
-			int readlength;
-			while ((readlength = inputStream.read(bytes)) != -1) {
-				bos.write(bytes, 0, readlength);
-			}
-			return parse(bos.toByteArray(), clazz);
-		}
-	}
-
-	default <T> T parseFrom(String path, JsonTypeReference<T> type)
-		throws IOException {
-		return parseFrom(Paths.get(path), type);
-	}
-
-	default <T> T parseFrom(Path path, JsonTypeReference<T> type)
-		throws IOException {
-		return parseFrom(path.toFile(), type);
-	}
-
-	default <T> T parseFrom(File file, JsonTypeReference<T> type)
-		throws IOException {
-		try (InputStream inputStream = Files.newInputStream(file.toPath())) {
-			return parseFrom(inputStream, type);
-		}
-	}
-
-	default <T> T parseFrom(InputStream inputStream, JsonTypeReference<T> type)
-		throws IOException {
-		if (inputStream == null) {
-			throw new IllegalArgumentException("inputStream cannot be null");
-		}
-		if (type == null) {
-			throw new IllegalArgumentException("type cannot be null");
-		}
-		byte[] bytes = new byte[1024];
-		try (ByteArrayOutputStream bos = new ByteArrayOutputStream()) {
-			int readlength;
-			while ((readlength = inputStream.read(bytes)) != -1) {
-				bos.write(bytes, 0, readlength);
-			}
-			return parse(bos.toByteArray(), type);
-		}
-	}
-
-	/**
-	 * 将字节数组形式的JSON解析为指定类型的对象
-	 *
-	 * @param json  待解析的JSON字节数组
-	 * @param clazz 目标对象的Class类型
-	 * @param <T>   泛型参数，表示目标对象的类型
-	 * @return 解析后的对象实例
-	 */
-	default <T> T parse(byte[] json, Class<T> clazz) {
-		return parse(new String(json), clazz);
-	}
-
-	/**
-	 * 将字节数组形式的JSON解析为指定泛型类型对象
-	 *
-	 * @param json 待解析的JSON字节数组
-	 * @param type 目标对象的Type类型（支持泛型）
-	 * @param <T>  泛型参数，表示目标对象的类型
-	 * @return 解析后的对象实例
-	 */
-	default <T> T parse(byte[] json, JsonTypeReference<T> type) {
-		return parse(new String(json), type);
-	}
-
-	/**
-	 * 将JSON字符串解析为指定类型的对象，解析失败时返回默认值
-	 *
-	 * @param json         待解析的JSON字符串
-	 * @param clazz        目标对象的Class类型
-	 * @param defaultValue 解析失败时返回的默认值
-	 * @param <T>          泛型参数，表示目标对象的类型
-	 * @return 解析后的对象实例或默认值
-	 */
-	default <T> T parse(String json, Class<T> clazz, T defaultValue) {
-		try {
-			return parse(json, clazz);
-		} catch (Exception e) {
-			return defaultValue;
-		}
-	}
-
-	/**
-	 * 将JSON字符串解析为指定泛型类型对象，解析失败时返回默认值
-	 *
-	 * @param json         待解析的JSON字符串
-	 * @param type         目标对象的Type类型（支持泛型）
-	 * @param defaultValue 解析失败时返回的默认值
-	 * @param <T>          泛型参数，表示目标对象的类型
-	 * @return 解析后的对象实例或默认值
-	 */
-	default <T> T parse(
-		String json,
-		JsonTypeReference<T> type,
-		T defaultValue
-	) {
-		try {
-			return parse(json, type);
-		} catch (Exception e) {
-			return defaultValue;
-		}
-	}
-
-	/**
-	 * 将对象格式化为美化格式的JSON字符串（带缩进和换行）
-	 *
-	 * @param object 待格式化的对象
-	 * @return 格式化后的美化JSON字符串
-	 */
-	String formatPretty(Object object);
-
-	default byte[] formatPrettyBytes(Object object) {
-		return formatPretty(object).getBytes();
-	}
-
-	String formatPrettyUnicode(Object object);
-
-	default byte[] formatPrettyUnicodeBytes(Object object) {
-		return formatPrettyUnicode(object).getBytes();
-	}
-
-	default void formatPretty(Object object, String file) throws IOException {
-		formatPretty(object, Paths.get(file));
-	}
-
-	default void formatPretty(Object object, Path file) throws IOException {
-		formatPretty(object, file.toFile());
-	}
-
-	default void formatPretty(Object object, File file) throws IOException {
-		try (FileOutputStream fos = new FileOutputStream(file)) {
-			formatPretty(object, fos);
-		}
-	}
-
-	default void formatPretty(Object object, OutputStream stream)
-		throws IOException {
-		stream.write(formatPrettyBytes(object));
-	}
-
-	default void formatPrettyUnicode(Object object, String file)
-		throws IOException {
-		formatPrettyUnicode(object, Paths.get(file));
-	}
-
-	default void formatPrettyUnicode(Object object, Path file)
-		throws IOException {
-		formatPrettyUnicode(object, file.toFile());
-	}
-
-	default void formatPrettyUnicode(Object object, File file)
-		throws IOException {
-		try (FileOutputStream fos = new FileOutputStream(file)) {
-			formatPrettyUnicode(object, fos);
-		}
-	}
-
-	default void formatPrettyUnicode(Object object, OutputStream stream)
-		throws IOException {
-		stream.write(formatPrettyUnicodeBytes(object));
-	}
-
-	default byte[] formatBytes(Object object) {
-		return format(object).getBytes();
-	}
-
-	default byte[] formatUnicodeBytes(Object object) {
-		return formatUnicode(object).getBytes();
-	}
-
-	default void format(Object object, String file) throws IOException {
-		format(object, Paths.get(file));
-	}
-
-	default void format(Object object, Path file) throws IOException {
-		format(object, file.toFile());
-	}
-
-	default void format(Object object, File file) throws IOException {
-		try (FileOutputStream fos = new FileOutputStream(file)) {
-			format(object, fos);
-		}
-	}
-
-	default void format(Object object, OutputStream stream) throws IOException {
-		stream.write(formatPrettyBytes(object));
-	}
-
-	default void formatUnicode(Object object, String file) throws IOException {
-		formatUnicode(object, Paths.get(file));
-	}
-
-	default void formatUnicode(Object object, Path file) throws IOException {
-		formatUnicode(object, file.toFile());
-	}
-
-	default void formatUnicode(Object object, File file) throws IOException {
-		try (FileOutputStream fos = new FileOutputStream(file)) {
-			formatUnicode(object, fos);
-		}
-	}
-
-	default void formatUnicode(Object object, OutputStream stream)
-		throws IOException {
-		stream.write(formatPrettyUnicodeBytes(object));
-	}
-
-	/**
-	 * 将JSON字符串解析为指定元素类型的List集合
-	 *
-	 * @param json        待解析的JSON字符串
-	 * @param elementType List中元素的类型
-	 * @param <T>         泛型参数，表示List中元素的类型
-	 * @return 解析后的List集合
-	 */
-	default <T> List<T> parseList(String json, Class<T> elementType) {
-		return parse(json, JsonTypeUtils.listType(elementType));
-	}
-
-	/**
-	 * 将JSON字符串解析为指定键值类型的Map集合
-	 *
-	 * @param json      待解析的JSON字符串
-	 * @param keyType   Map中键的类型
-	 * @param valueType Map中值的类型
-	 * @param <K>       泛型参数，表示Map中键的类型
-	 * @param <V>       泛型参数，表示Map中值的类型
-	 * @return 解析后的Map集合
-	 */
-	default <K, V> Map<K, V> parseMap(
-		String json,
-		Class<K> keyType,
-		Class<V> valueType
-	) {
-		JsonTypeReference<Map<K, V>> mapType = new JsonTypeReference<
-			Map<K, V>
-		>() {};
-		return parse(json, mapType);
-	}
-
-	/**
-	 * 验证字符串是否为有效的JSON格式
-	 *
-	 * @param json 待验证的字符串
-	 * @return 如果是有效的JSON格式返回true，否则返回false
-	 */
-	boolean isValidJson(String json);
-
-	/**
-	 * 将对象转换为JSON字节数组
-	 *
-	 * @param object 待转换的对象
-	 * @return 转换后的JSON字节数组
-	 */
-	default byte[] toBytes(Object object) {
-		return format(object).getBytes();
-	}
-
-	/**
-	 * 将对象转换为美化格式的JSON字节数组
-	 *
-	 * @param object 待转换的对象
-	 * @return 转换后的美化格式JSON字节数组
-	 */
-	default byte[] toBytesPretty(Object object) {
-		return formatPretty(object).getBytes();
-	}
-
-	/**
-	 * 合并多个JSON字符串为一个JSON对象
-	 *
-	 * @param jsons 待合并的JSON字符串数组
-	 * @return 合并后的JSON字符串
-	 */
-	String merge(String... jsons);
-
-	/**
-	 * 获取JSON字符串中指定路径节点的值
-	 *
-	 * @param json JSON字符串
-	 * @param path 节点路径（如："user.name"）
-	 * @return 节点值的字符串表示
-	 */
-	String getNodeValue(String json, String path);
-
-	/**
-	 * 更新JSON字符串中指定路径节点的值
-	 *
-	 * @param json     原始JSON字符串
-	 * @param path     节点路径（如："user.name"）
-	 * @param newValue 新的节点值
-	 * @return 更新后的JSON字符串
-	 */
-	String updateNodeValue(String json, String path, Object newValue);
-
-	<T, D> D convert(T source, Class<D> destinationClass);
-
-	<T, D> D convert(T source, JsonTypeReference<D> destinationType);
-}

src/main/java/com/mingliqiye/utils/json/JsonTypeReference.java

@@ -1,175 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile JsonTypeReference.java
- * LastUpdate 2025-09-09 09:20:05
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.json;
-
-import java.lang.reflect.ParameterizedType;
-import java.lang.reflect.Type;
-import java.util.Arrays;
-import java.util.Objects;
-import lombok.Getter;
-
-/**
- * 通用的 JSON 类型引用类，用于在运行时保留泛型类型信息
- * 适用于所有 JSON 库（Jackson、Gson、Fastjson 等）
- *
- * @param <T> 引用的泛型类型
- */
-@Getter
-public abstract class JsonTypeReference<T>
-	implements Comparable<JsonTypeReference<T>> {
-
-	protected final Type type;
-
-	/**
-	 * 构造函数，通过反射获取泛型类型信息
-	 * 仅供内部匿名子类使用
-	 */
-	protected JsonTypeReference() {
-		Type superClass = getClass().getGenericSuperclass();
-
-		// 检查是否为匿名子类，防止直接实例化导致无法获取泛型信息
-		if (superClass instanceof Class) {
-			throw new IllegalArgumentException(
-				"必须使用匿名子类方式创建 JsonTypeReference，" +
-				"例如: new JsonTypeReference<List<String>>() {}"
-			);
-		}
-
-		this.type =
-			((ParameterizedType) superClass).getActualTypeArguments()[0];
-	}
-
-	/**
-	 * 构造函数，直接指定类型
-	 * @param type 具体的类型信息
-	 */
-	protected JsonTypeReference(Type type) {
-		this.type = Objects.requireNonNull(type, "Type cannot be null");
-	}
-
-	/**
-	 * 创建类型引用实例
-	 * @param <T> 目标类型
-	 * @return 类型引用实例
-	 */
-	public static <T> JsonTypeReference<T> of() {
-		return new JsonTypeReference<T>() {};
-	}
-
-	/**
-	 * 根据 Class 创建类型引用
-	 * @param clazz 目标类
-	 * @param <T> 目标类型
-	 * @return 类型引用实例
-	 */
-	public static <T> JsonTypeReference<T> of(Class<T> clazz) {
-		return new JsonTypeReference<T>(clazz) {};
-	}
-
-	/**
-	 * 根据 Type 创建类型引用
-	 * @param type 目标类型
-	 * @param <T> 目标类型
-	 * @return 类型引用实例
-	 */
-	public static <T> JsonTypeReference<T> of(Type type) {
-		return new JsonTypeReference<T>(type) {};
-	}
-
-	/**
-	 * 获取原始类型（去掉泛型参数的类型）
-	 * @return 原始类型 Class
-	 */
-	@SuppressWarnings("unchecked")
-	public Class<T> getRawType() {
-		Type rawType = type;
-
-		// 如果是参数化类型，则提取原始类型部分
-		if (type instanceof ParameterizedType) {
-			rawType = ((ParameterizedType) type).getRawType();
-		}
-
-		if (rawType instanceof Class) {
-			return (Class<T>) rawType;
-		}
-
-		throw new IllegalStateException("无法获取原始类型: " + type);
-	}
-
-	@Override
-	public boolean equals(Object o) {
-		if (this == o) return true;
-		if (o == null || getClass() != o.getClass()) return false;
-		JsonTypeReference<?> that = (JsonTypeReference<?>) o;
-
-		// 对于 ParameterizedType，需要更完整的比较
-		if (
-			this.type instanceof ParameterizedType &&
-			that.type instanceof ParameterizedType
-		) {
-			ParameterizedType thisParamType = (ParameterizedType) this.type;
-			ParameterizedType thatParamType = (ParameterizedType) that.type;
-
-			return (
-				Objects.equals(
-					thisParamType.getRawType(),
-					thatParamType.getRawType()
-				) &&
-				Arrays.equals(
-					thisParamType.getActualTypeArguments(),
-					thatParamType.getActualTypeArguments()
-				) &&
-				Objects.equals(
-					thisParamType.getOwnerType(),
-					thatParamType.getOwnerType()
-				)
-			);
-		}
-
-		return Objects.equals(type, that.type);
-	}
-
-	@Override
-	public int hashCode() {
-		// 针对 ParameterizedType 进行完整哈希计算
-		if (type instanceof ParameterizedType) {
-			ParameterizedType paramType = (ParameterizedType) type;
-			return Objects.hash(
-				paramType.getRawType(),
-				Arrays.hashCode(paramType.getActualTypeArguments()),
-				paramType.getOwnerType()
-			);
-		}
-		return Objects.hash(type);
-	}
-
-	@Override
-	public String toString() {
-		return "JsonTypeReference{" + type + '}';
-	}
-
-	@Override
-	public int compareTo(JsonTypeReference<T> o) {
-		return this.type.toString().compareTo(o.type.toString());
-	}
-}

src/main/java/com/mingliqiye/utils/json/JsonTypeUtils.java

@@ -1,253 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile JsonTypeUtils.java
- * LastUpdate 2025-09-09 09:18:08
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.json;
-
-import java.lang.reflect.ParameterizedType;
-import java.lang.reflect.Type;
-import java.util.Arrays;
-import java.util.List;
-import java.util.Map;
-import java.util.Objects;
-
-/**
- * JSON 类型工具类，提供类型相关的工具方法
- */
-public class JsonTypeUtils {
-
-	private JsonTypeUtils() {
-		// 工具类，防止实例化
-	}
-
-	/**
-	 * 检查给定的类型是否是指定类或其子类/实现类。
-	 *
-	 * @param type          要检查的类型
-	 * @param expectedClass 期望匹配的类
-	 * @return 如果类型匹配则返回 true，否则返回 false
-	 */
-	public static boolean isTypeOf(Type type, Class<?> expectedClass) {
-		if (type instanceof Class) {
-			return expectedClass.isAssignableFrom((Class<?>) type);
-		} else if (type instanceof ParameterizedType) {
-			return isTypeOf(
-				((ParameterizedType) type).getRawType(),
-				expectedClass
-			);
-		}
-		return false;
-	}
-
-	/**
-	 * 获取泛型类型的参数类型。
-	 *
-	 * @param type  泛型类型
-	 * @param index 参数索引（从0开始）
-	 * @return 指定位置的泛型参数类型
-	 * @throws IllegalArgumentException 当无法获取指定索引的泛型参数时抛出异常
-	 */
-	public static Type getGenericParameter(Type type, int index) {
-		if (type instanceof ParameterizedType) {
-			Type[] typeArgs =
-				((ParameterizedType) type).getActualTypeArguments();
-			if (index >= 0 && index < typeArgs.length) {
-				return typeArgs[index];
-			}
-		}
-		throw new IllegalArgumentException(
-			"无法获取泛型参数: " + type + " at index " + index
-		);
-	}
-
-	/**
-	 * 获取类型名称，支持普通类和泛型类型。
-	 *
-	 * @param type 类型对象
-	 * @return 类型名称字符串
-	 */
-	public static String getTypeName(Type type) {
-		if (type instanceof Class) {
-			return ((Class<?>) type).getSimpleName();
-		} else if (type instanceof ParameterizedType) {
-			ParameterizedType pType = (ParameterizedType) type;
-			Class<?> rawType = (Class<?>) pType.getRawType();
-			Type[] typeArgs = pType.getActualTypeArguments();
-
-			StringBuilder sb = new StringBuilder(rawType.getSimpleName());
-			sb.append("<");
-			for (int i = 0; i < typeArgs.length; i++) {
-				if (i > 0) sb.append(", ");
-				sb.append(getTypeName(typeArgs[i]));
-			}
-			sb.append(">");
-			return sb.toString();
-		}
-		return type.getTypeName();
-	}
-
-	/**
-	 * 创建一个表示数组类型的引用对象。
-	 *
-	 * @param componentType 数组元素的类型
-	 * @param <T>           元素类型
-	 * @return 表示数组类型的 JsonTypeReference 对象
-	 */
-	public static <T> JsonTypeReference<T[]> arrayType(Class<T> componentType) {
-		return new JsonTypeReference<T[]>() {
-			private final Type arrayType = java.lang.reflect.Array.newInstance(
-				componentType,
-				0
-			).getClass();
-
-			@Override
-			public Type getType() {
-				return new ParameterizedType() {
-					private final Type[] actualTypeArguments = new Type[] {
-						componentType,
-					};
-
-					@Override
-					public Type[] getActualTypeArguments() {
-						return actualTypeArguments;
-					}
-
-					@Override
-					public Type getRawType() {
-						return arrayType;
-					}
-
-					@Override
-					public Type getOwnerType() {
-						return null;
-					}
-				};
-			}
-		};
-	}
-
-	/**
-	 * 创建一个表示 List 类型的引用对象。
-	 *
-	 * @param componentType List 中元素的类型
-	 * @param <T>           元素类型
-	 * @return 表示 List 类型的 JsonTypeReference 对象
-	 * @throws IllegalArgumentException 如果 componentType 为 null，则抛出异常
-	 */
-	public static <T> JsonTypeReference<List<T>> listType(
-		Class<T> componentType
-	) {
-		if (componentType == null) {
-			throw new IllegalArgumentException("componentType cannot be null");
-		}
-
-		return new JsonTypeReference<List<T>>() {
-			@Override
-			public Type getType() {
-				return new ParameterizedType() {
-					@Override
-					public Type[] getActualTypeArguments() {
-						return new Type[] { componentType };
-					}
-
-					@Override
-					public Type getRawType() {
-						return List.class;
-					}
-
-					@Override
-					public Type getOwnerType() {
-						return null;
-					}
-				};
-			}
-		};
-	}
-
-	/**
-	 * 创建一个表示 Map 类型的引用对象。
-	 *
-	 * @param keyType   Map 键的类型
-	 * @param valueType Map 值的类型
-	 * @param <K>       键类型
-	 * @param <V>       值类型
-	 * @return 表示 Map 类型的 JsonTypeReference 对象
-	 * @throws IllegalArgumentException 如果 keyType 或 valueType 为 null，则抛出异常
-	 */
-	public static <K, V> JsonTypeReference<Map<K, V>> MapType(
-		Class<K> keyType,
-		Class<V> valueType
-	) {
-		if (keyType == null) {
-			throw new IllegalArgumentException("keyType cannot be null");
-		}
-		if (valueType == null) {
-			throw new IllegalArgumentException("valueType cannot be null");
-		}
-
-		return new JsonTypeReference<Map<K, V>>() {
-			@Override
-			public Type getType() {
-				return new ParameterizedType() {
-					@Override
-					public Type[] getActualTypeArguments() {
-						return new Type[] { keyType, valueType };
-					}
-
-					@Override
-					public Type getRawType() {
-						return Map.class;
-					}
-
-					@Override
-					public Type getOwnerType() {
-						return null;
-					}
-
-					@Override
-					public boolean equals(Object obj) {
-						if (this == obj) return true;
-						if (!(obj instanceof ParameterizedType)) return false;
-
-						ParameterizedType that = (ParameterizedType) obj;
-						return (
-							Objects.equals(getRawType(), that.getRawType()) &&
-							Arrays.equals(
-								getActualTypeArguments(),
-								that.getActualTypeArguments()
-							) &&
-							Objects.equals(getOwnerType(), that.getOwnerType())
-						);
-					}
-
-					@Override
-					public int hashCode() {
-						return (
-							Arrays.hashCode(getActualTypeArguments()) ^
-							Objects.hashCode(getRawType()) ^
-							Objects.hashCode(getOwnerType())
-						);
-					}
-				};
-			}
-		};
-	}
-}

src/main/java/com/mingliqiye/utils/json/converters/DateTimeJsonConverter.java

@@ -1,32 +0,0 @@
-package com.mingliqiye.utils.json.converters;
-
-import com.mingliqiye.utils.time.DateTime;
-import com.mingliqiye.utils.time.Formatter;
-
-public class DateTimeJsonConverter extends JsonStringConverter<DateTime> {
-
-	@Override
-	public Class<DateTime> getTClass() {
-		return DateTime.class;
-	}
-
-	@Override
-	public String convert(DateTime obj) {
-		if (obj == null) {
-			return null;
-		}
-		return obj.format(Formatter.STANDARD_DATETIME);
-	}
-
-	@Override
-	public DateTime deConvert(String string) {
-		if (string == null) {
-			return null;
-		}
-		return DateTime.parse(
-			string,
-			Formatter.STANDARD_DATETIME_MILLISECOUND7,
-			true
-		);
-	}
-}

src/main/java/com/mingliqiye/utils/json/converters/FastjsonJsonStringConverterAdapter.java

@@ -1,88 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile FastjsonJsonStringConverterAdapter.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.json.converters;
-
-import com.alibaba.fastjson2.JSONReader;
-import com.alibaba.fastjson2.JSONWriter;
-import com.alibaba.fastjson2.reader.ObjectReader;
-import com.alibaba.fastjson2.writer.ObjectWriter;
-
-import java.lang.reflect.Type;
-
-public class FastjsonJsonStringConverterAdapter<
-	T extends JsonStringConverter<TT>,
-	TT
-> {
-
-	private final JsonStringConverter<TT> jsonStringConverter;
-
-	public FastjsonJsonStringConverterAdapter(T jsonStringConverter) {
-		this.jsonStringConverter = jsonStringConverter;
-	}
-
-	public static <
-		T extends JsonStringConverter<TT>,
-		TT
-	> FastjsonJsonStringConverterAdapter<T, TT> of(T t) {
-		return new FastjsonJsonStringConverterAdapter<>(t);
-	}
-
-	/**
-	 * 获取FastJson对象写入器
-	 *
-	 * @return FastJson的ObjectWriter实例
-	 */
-	public ObjectWriter<T> getFastJsonObjectWriter() {
-		return (
-			JSONWriter writer,
-			Object object,
-			Object fieldName,
-			Type fieldType,
-			long features
-		) -> {
-			// 如果对象为null则写入null
-			if (object == null) {
-				writer.writeNull();
-				return;
-			}
-			writer.writeString(jsonStringConverter.convert((TT) object));
-		};
-	}
-
-	/**
-	 * 获取FastJson对象读取器
-	 *
-	 * @return FastJson的ObjectReader实例
-	 */
-	public ObjectReader<TT> getFastJsonObjectReader() {
-		return (
-			JSONReader reader,
-			Type fieldType,
-			Object fieldName,
-			long features
-		) -> {
-			String value = reader.readString();
-			return jsonStringConverter.deConvert(value);
-		};
-	}
-}

src/main/java/com/mingliqiye/utils/json/converters/GsonJsonStringConverterAdapter.java

@@ -1,72 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile GsonJsonStringConverterAdapter.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.json.converters;
-
-import com.google.gson.TypeAdapter;
-import com.google.gson.stream.JsonReader;
-import com.google.gson.stream.JsonWriter;
-
-import java.io.IOException;
-
-public class GsonJsonStringConverterAdapter<
-	T extends JsonStringConverter<TT>,
-	TT
-> {
-
-	private final JsonStringConverter<TT> jsonStringConverter;
-
-	public GsonJsonStringConverterAdapter(T jsonStringConverter) {
-		this.jsonStringConverter = jsonStringConverter;
-	}
-
-	public static <
-		T extends JsonStringConverter<TT>,
-		TT
-	> GsonJsonStringConverterAdapter<T, TT> of(T t) {
-		return new GsonJsonStringConverterAdapter<>(t);
-	}
-
-	/**
-	 * 获取Gson类型适配器
-	 *
-	 * @return Gson的TypeAdapter实例
-	 */
-	public TypeAdapter<TT> getGsonTypeAdapter() {
-		return new TypeAdapter<TT>() {
-			@Override
-			public void write(JsonWriter out, TT value) throws IOException {
-				if (value == null) {
-					out.nullValue();
-					return;
-				}
-				out.value(jsonStringConverter.convert(value));
-			}
-
-			@Override
-			public TT read(JsonReader in) throws IOException {
-				String value = in.nextString();
-				return jsonStringConverter.deConvert(value);
-			}
-		};
-	}
-}

src/main/java/com/mingliqiye/utils/json/converters/JacksonJsonStringConverterAdapter.java

@@ -1,91 +0,0 @@
-package com.mingliqiye.utils.json.converters;
-
-import com.fasterxml.jackson.core.JsonGenerator;
-import com.fasterxml.jackson.core.JsonParser;
-import com.fasterxml.jackson.databind.*;
-import com.fasterxml.jackson.databind.module.SimpleModule;
-import java.io.IOException;
-
-/**
- * JSON转换器的适配器
- * @param <T> JSON转换器
- * @param <TT> JSON转换器的泛型
- * @author MingLiPro
- */
-public class JacksonJsonStringConverterAdapter<
-	T extends JsonStringConverter<TT>,
-	TT
-> {
-
-	private final JsonStringConverter<TT> jsonStringConverter;
-
-	private JacksonJsonStringConverterAdapter(T jsonStringConverter) {
-		this.jsonStringConverter = jsonStringConverter;
-	}
-
-	/**
-	 *
-	 * @param t JSON转换器实例
-	 * @return JSON转换器的适配器
-	 * @param <T> JSON转换器
-	 * @param <TT> JSON转换器的泛型
-	 */
-	public static <
-		T extends JsonStringConverter<TT>,
-		TT
-	> JacksonJsonStringConverterAdapter<T, TT> of(T t) {
-		return new JacksonJsonStringConverterAdapter<>(t);
-	}
-
-	/**
-	 * 获取Jackson反序列化器
-	 *
-	 * @return Jackson的JsonDeserializer实例
-	 */
-	public JsonDeserializer<TT> getJacksonJsonDeserializer() {
-		return new JsonDeserializer<TT>() {
-			@Override
-			public TT deserialize(JsonParser p, DeserializationContext ctxt)
-				throws IOException {
-				if (p.isNaN()) return null;
-				return jsonStringConverter.deConvert(p.getValueAsString());
-			}
-		};
-	}
-
-	/**
-	 * 获取Jackson序列化器
-	 *
-	 * @return Jackson的JsonSerializer实例
-	 */
-	public JsonSerializer<TT> getJacksonJsonSerializer() {
-		return new JsonSerializer<TT>() {
-			@Override
-			public void serialize(
-				TT value,
-				JsonGenerator gen,
-				SerializerProvider serializers
-			) throws IOException {
-				if (value == null) {
-					gen.writeNull();
-					return;
-				}
-				gen.writeString(jsonStringConverter.convert(value));
-			}
-		};
-	}
-
-	/**
-	 *
-	 * 获取 Jackson 的格式化模块
-	 *
-	 * @return 格式化模块
-	 */
-	public Module getJacksonModule() {
-		Class<TT> tClass = jsonStringConverter.getTClass();
-		SimpleModule m = new SimpleModule(tClass.getSimpleName());
-		m.addSerializer(tClass, getJacksonJsonSerializer());
-		m.addDeserializer(tClass, getJacksonJsonDeserializer());
-		return m;
-	}
-}

src/main/java/com/mingliqiye/utils/json/converters/JsonStringConverter.java

@@ -1,60 +0,0 @@
-package com.mingliqiye.utils.json.converters;
-
-/**
- * JSON转换器接口，提供对象与字符串之间的相互转换功能，并支持多种JSON库
- *
- * @param <T> 需要转换的对象类型
- */
-public abstract class JsonStringConverter<T> {
-
-	public abstract Class<T> getTClass();
-
-	/**
-	 * 将对象转换为字符串
-	 *
-	 * @param obj 待转换的对象
-	 * @return 转换后的字符串
-	 */
-	abstract String convert(T obj);
-
-	/**
-	 * 将字符串转换为对象
-	 *
-	 * @param string 待转换的字符串
-	 * @return 转换后的对象
-	 */
-	abstract T deConvert(String string);
-
-	/**
-	 * 获取 Fastjson 的适配器
-	 * @return 适配器实例
-	 */
-	public FastjsonJsonStringConverterAdapter<
-		JsonStringConverter<T>,
-		T
-	> getFastjsonJsonStringConverterAdapter() {
-		return FastjsonJsonStringConverterAdapter.of(this);
-	}
-
-	/**
-	 * 获取 Gson 的适配器
-	 * @return 适配器实例
-	 */
-	public GsonJsonStringConverterAdapter<
-		JsonStringConverter<T>,
-		T
-	> getGsonJsonStringConverterAdapter() {
-		return GsonJsonStringConverterAdapter.of(this);
-	}
-
-	/**
-	 * 获取 Jackson 的适配器
-	 * @return 适配器实例
-	 */
-	public JacksonJsonStringConverterAdapter<
-		JsonStringConverter<T>,
-		T
-	> getJacksonJsonStringConverterAdapter() {
-		return JacksonJsonStringConverterAdapter.of(this);
-	}
-}

src/main/java/com/mingliqiye/utils/json/converters/UUIDJsonStringConverter.java

@@ -1,27 +0,0 @@
-package com.mingliqiye.utils.json.converters;
-
-import com.mingliqiye.utils.uuid.UUID;
-
-public class UUIDJsonStringConverter extends JsonStringConverter<UUID> {
-
-	@Override
-	public Class<UUID> getTClass() {
-		return UUID.class;
-	}
-
-	@Override
-	public String convert(UUID obj) {
-		if (obj == null) {
-			return null;
-		}
-		return obj.toUUIDString();
-	}
-
-	@Override
-	public UUID deConvert(String string) {
-		if (string == null) {
-			return null;
-		}
-		return UUID.of(string);
-	}
-}

src/main/java/com/mingliqiye/utils/minecraft/slp/Description.java

@@ -1,32 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Description.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.minecraft.slp;
-
-import lombok.Data;
-
-@Data
-public class Description {
-
-	private String text;
-	private Extra[] extra;
-}

src/main/java/com/mingliqiye/utils/minecraft/slp/MinecraftServerStatus.java

@@ -1,37 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile MinecraftServerStatus.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.minecraft.slp;
-
-import lombok.Data;
-
-@Data
-public class MinecraftServerStatus {
-
-	private Description description;
-	private Players players;
-	private Version version;
-	private String favicon;
-	private boolean enforcesSecureChat;
-	private boolean previewsChat;
-	private String jsonData;
-}

src/main/java/com/mingliqiye/utils/minecraft/slp/Players.java

@@ -1,33 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Players.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.minecraft.slp;
-
-import lombok.Data;
-
-@Data
-public class Players {
-
-	private int max;
-	private int online;
-	private PlayerSample[] sample;
-}

src/main/java/com/mingliqiye/utils/minecraft/slp/SLP.java

@@ -1,219 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile SLP.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.minecraft.slp;
-
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.mingliqiye.utils.network.NetworkEndpoint;
-import java.io.ByteArrayOutputStream;
-import java.io.DataInputStream;
-import java.io.IOException;
-import java.io.OutputStream;
-import java.net.Socket;
-import java.nio.ByteBuffer;
-import java.nio.ByteOrder;
-
-/**
- * Minecraft 服务器列表协议（Server List Ping, SLP）工具类。
- * 提供了与 Minecraft 服务器通信以获取其状态信息的功能。
- */
-public class SLP {
-
-	private static final ObjectMapper objectMapper = new ObjectMapper();
-
-	/**
-	 * 将 int32 值截断为无符号 short（2 字节）并按大端序写入字节数组。
-	 *
-	 * @param value 需要转换的整数（int32）
-	 * @return 包含两个字节的数组，表示无符号 short
-	 */
-	public static byte[] toUnsignedShort(int value) {
-		byte[] array = new byte[2];
-		ByteBuffer.wrap(array, 0, 2)
-			.order(ByteOrder.BIG_ENDIAN)
-			.putShort((short) (value & 0xFFFF));
-		return array;
-	}
-
-	/**
-	 * 构造 Minecraft 握手包数据。
-	 * 握手包用于初始化客户端与服务器之间的连接。
-	 *
-	 * @param serverIP   服务器 IP 地址或域名
-	 * @param serverPort 服务器端口号
-	 * @param type       连接类型（通常为 1 表示获取状态）
-	 * @return 握手包的完整字节数组
-	 * @throws IOException 如果构造过程中发生 IO 错误
-	 */
-	public static byte[] getHandshakePack(
-		String serverIP,
-		int serverPort,
-		int type
-	) throws IOException {
-		ByteArrayOutputStream pack = new ByteArrayOutputStream();
-		ByteArrayOutputStream byteArrayOutputStream =
-			new ByteArrayOutputStream();
-		pack.write(0x00); // 握手包标识符
-		pack.write(toVarInt(1156)); // 协议版本号（示例值）
-		byte[] sip = serverIP.getBytes();
-		pack.write(toVarInt(sip.length)); // 服务器地址长度
-		pack.write(sip); // 服务器地址
-		pack.write(toUnsignedShort(serverPort)); // 服务器端口
-		pack.write(toVarInt(type)); // 下一阶段类型（1 表示状态请求）
-		byteArrayOutputStream.write(toVarInt(pack.size())); // 包长度前缀
-		byteArrayOutputStream.write(pack.toByteArray());
-
-		return byteArrayOutputStream.toByteArray();
-	}
-
-	/**
-	 * 获取状态请求包的固定字节表示。
-	 * 此包用于向服务器请求当前状态信息。
-	 *
-	 * @return 状态请求包的字节数组
-	 */
-	public static byte[] getStatusPack() {
-		return new byte[] { 0x01, 0x00 };
-	}
-
-	/**
-	 * 从输入流中读取服务器返回的状态 JSON 数据，并解析为 MinecraftServerStatus 实体对象。
-	 *
-	 * @param inputStream 输入流，包含服务器响应的数据
-	 * @return 解析后的 MinecraftServerStatus 对象
-	 * @throws IOException 如果读取过程中发生 IO 错误
-	 */
-	public static MinecraftServerStatus getStatusJsonEntity(
-		DataInputStream inputStream
-	) throws IOException {
-		readVarInt(inputStream); // 忽略第一个 VarInt（包长度）
-		inputStream.readByte(); // 忽略包标识符
-		int lengthjson = readVarInt(inputStream); // 读取 JSON 数据长度
-		byte[] data = new byte[lengthjson];
-		inputStream.readFully(data); // 读取完整的 JSON 数据
-		MinecraftServerStatus serverStatus = objectMapper.readValue(
-			data,
-			MinecraftServerStatus.class
-		);
-		serverStatus.setJsonData(new String(data)); // 设置原始 JSON 字符串
-		return serverStatus;
-	}
-
-	/**
-	 * 从输入流中读取一个 VarInt 类型的整数（最多 5 个字节）。
-	 *
-	 * @param in 输入流
-	 * @return 解码后的整数值
-	 * @throws IOException 如果读取过程中发生 IO 错误
-	 */
-	public static int readVarInt(DataInputStream in) throws IOException {
-		int value = 0;
-		int length = 0;
-		byte currentByte;
-		do {
-			currentByte = in.readByte();
-			value |= (currentByte & 0x7F) << (length * 7);
-			length += 1;
-			if (length > 5) {
-				throw new RuntimeException("VarInt too long");
-			}
-		} while ((currentByte & 0x80) != 0);
-		return value;
-	}
-
-	/**
-	 * 将一个 int32 整数编码为 VarInt 格式的字节数组（1 到 5 个字节）。
-	 *
-	 * @param value 需要编码的整数
-	 * @return 编码后的 VarInt 字节数组
-	 */
-	public static byte[] toVarInt(int value) {
-		ByteArrayOutputStream buffer = new ByteArrayOutputStream();
-		while (true) {
-			if ((value & 0xFFFFFF80) == 0) {
-				buffer.write(value); // 最后一个字节
-				break;
-			}
-			buffer.write((value & 0x7F) | 0x80); // 写入带继续位的字节
-			value >>>= 7; // 右移 7 位继续处理
-		}
-		return buffer.toByteArray();
-	}
-
-	/**
-	 * 创建一个新的 Socket 连接到指定的网络端点，并设置超时时间。
-	 *
-	 * @param networkEndpoint 目标网络端点（包括主机和端口）
-	 * @return 已连接的 Socket 实例
-	 * @throws IOException 如果连接失败或发生 IO 错误
-	 */
-	public static Socket getNewConnect(NetworkEndpoint networkEndpoint)
-		throws IOException {
-		Socket socket = new Socket();
-		socket.setSoTimeout(5000); // 设置读取超时时间为 5 秒
-		socket.connect(networkEndpoint.toInetSocketAddress()); // 执行连接操作
-		return socket;
-	}
-
-	/**
-	 * 使用 "host:port" 格式的字符串连接到 Minecraft 服务器并获取其状态信息。
-	 *
-	 * @param s 域名或 IP 地址加端口号组成的字符串，例如 "127.0.0.1:25565"
-	 * @return 服务器状态实体对象
-	 * @throws IOException 如果连接失败或发生 IO 错误
-	 */
-	public static MinecraftServerStatus getServerStatus(String s)
-		throws IOException {
-		return getServerStatus(NetworkEndpoint.of(s));
-	}
-
-	/**
-	 * 使用指定的主机名和端口号连接到 Minecraft 服务器并获取其状态信息。
-	 *
-	 * @param s 主机名或 IP 地址
-	 * @param i 端口号
-	 * @return 服务器状态实体对象
-	 * @throws IOException 如果连接失败或发生 IO 错误
-	 */
-	public static MinecraftServerStatus getServerStatus(String s, Integer i)
-		throws IOException {
-		return getServerStatus(NetworkEndpoint.of(s, i));
-	}
-
-	/**
-	 * 使用 NetworkEndpoint 实例连接到 Minecraft 服务器并获取其状态信息。
-	 *
-	 * @param e 网络端点实例，包含主机和端口信息
-	 * @return 服务器状态实体对象
-	 * @throws IOException 如果连接失败或发生 IO 错误
-	 * @see NetworkEndpoint
-	 */
-	public static MinecraftServerStatus getServerStatus(NetworkEndpoint e)
-		throws IOException {
-		Socket socket = getNewConnect(e); // 建立 TCP 连接
-		OutputStream out = socket.getOutputStream(); // 获取输出流发送数据
-		DataInputStream in = new DataInputStream(socket.getInputStream()); // 获取输入流接收数据
-		out.write(getHandshakePack(e.getHost(), e.getPort(), 1)); // 发送握手包
-		out.write(getStatusPack()); // 发送状态请求包
-		return getStatusJsonEntity(in); // 读取并解析服务器响应
-	}
-}

src/main/java/com/mingliqiye/utils/minecraft/slp/Version.java

@@ -1,32 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Version.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.minecraft.slp;
-
-import lombok.Data;
-
-@Data
-public class Version {
-
-	private String name;
-	private int protocol;
-}

src/main/java/com/mingliqiye/utils/network/NetworkAddress.java

@@ -1,218 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile NetworkAddress.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.network;
-
-import com.mingliqiye.utils.string.StringUtils;
-import lombok.Getter;
-import org.jetbrains.annotations.NotNull;
-
-import java.io.Serializable;
-import java.net.InetAddress;
-import java.net.UnknownHostException;
-import java.util.regex.Pattern;
-
-/**
- * 网络地址类，用于表示一个网络地址（IP或域名），并提供相关操作。
- * 支持IPv4和IPv6地址的解析与验证。
- *
- * @author MingLiPro
- */
-public class NetworkAddress implements Serializable {
-
-	/**
-	 * IPv6标识
-	 */
-	public static int IPV6 = 6;
-
-	/**
-	 * IPv4标识
-	 */
-	public static int IPV4 = 4;
-
-	/**
-	 * IPv4地址正则表达式
-	 */
-	static String IPV4REG =
-		"^((2(5[0-5]|[0-4]\\d))|[0-1]?\\d{1,2})(\\.((2" +
-		"(5[0-5]|[0-4]\\d))|[0-1]?\\d{1,2})){3}$";
-
-	/**
-	 * 编译后的IPv4地址匹配模式
-	 */
-	private static final Pattern IPV4_PATTERN = Pattern.compile(IPV4REG);
-
-	/**
-	 * IPv6地址正则表达式
-	 */
-	static String IPV6REG =
-		"^([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$|" +
-		"^(::([0-9a-fA-F]{1,4}:){0,6}[0-9a-fA-F]{1,4})$" +
-		"|" +
-		"^(::)$|" +
-		"^([0-9a-fA-F]{1,4}::([0-9a-fA-F]{1,4}:){0,5}[0-9a-fA-F]{1,4})$|" +
-		"^(([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4})$|" +
-		"^(([0-9a-fA-F]{1,4}:){6}(([0-9]{1,3}\\.){3}[0-9]{1,3}))$|" +
-		"^::([fF]{4}:)?(([0-9]{1,3}\\.){3}[0-9]{1,3})$";
-
-	/**
-	 * 编译后的IPv6地址匹配模式
-	 */
-	private static final Pattern IPV6_PATTERN = Pattern.compile(IPV6REG);
-
-	/**
-	 * IP地址类型：4 表示 IPv4，6 表示 IPv6
-	 */
-	@Getter
-	private int IPv;
-
-	/**
-	 * IP地址字符串
-	 */
-	@Getter
-	private String ip;
-
-	/**
-	 * 域名（如果输入的是域名）
-	 */
-	private String domain;
-
-	/**
-	 * 标识是否是域名解析来的IP
-	 */
-	private boolean isdom;
-
-	/**
-	 * 构造方法，根据传入的字符串判断是IP地址还是域名，并进行相应处理。
-	 *
-	 * @param domip 可能是IP地址或域名的字符串
-	 */
-	NetworkAddress(String domip) {
-		try {
-			// 尝试将输入识别为IP地址
-			IPv = testIp(domip);
-			ip = domip;
-		} catch (NetworkException e) {
-			try {
-				// 如果不是有效IP，则尝试作为域名解析
-				String ips = getHostIp(domip);
-				IPv = testIp(ips);
-				ip = ips;
-				isdom = true;
-				domain = domip;
-			} catch (UnknownHostException ex) {
-				throw new NetworkException(ex);
-			}
-		}
-	}
-
-	/**
-	 * 静态工厂方法，创建 NetworkAddress 实例。
-	 *
-	 * @param domip 可能是IP地址或域名的字符串
-	 * @return 新建的 NetworkAddress 实例
-	 */
-	public static NetworkAddress of(String domip) {
-		return new NetworkAddress(domip);
-	}
-
-	/**
-	 * 静态工厂方法，通过 InetAddress 创建 NetworkAddress 实例。
-	 *
-	 * @param inetAddress InetAddress 对象
-	 * @return 新建的 NetworkAddress 实例
-	 */
-	public static NetworkAddress of(InetAddress inetAddress) {
-		return new NetworkAddress(inetAddress.getHostAddress());
-	}
-
-	/**
-	 * 从DNS服务器解析域名获取对应的IP地址。
-	 *
-	 * @param domain 域名
-	 * @return 解析出的第一个IP地址
-	 * @throws UnknownHostException 如果域名无法解析
-	 */
-	public static String getHostIp(@NotNull String domain)
-		throws UnknownHostException {
-		InetAddress[] addresses = InetAddress.getAllByName(domain.trim());
-		return addresses[0].getHostAddress();
-	}
-
-	/**
-	 * 检测给定字符串是否为有效的IPv4或IPv6地址。
-	 *
-	 * @param ip 要检测的IP地址字符串
-	 * @return 4 表示IPv4，6 表示IPv6
-	 * @throws NetworkException 如果IP格式无效
-	 */
-	public static int testIp(String ip) {
-		if (ip == null) {
-			throw new NetworkException("IP地址不能为null");
-		}
-		String trimmedIp = ip.trim();
-
-		// 判断是否匹配IPv4格式
-		if (IPV4_PATTERN.matcher(trimmedIp).matches()) {
-			return IPV4;
-		}
-
-		// 判断是否匹配IPv6格式
-		if (IPV6_PATTERN.matcher(trimmedIp).matches()) {
-			return IPV6;
-		}
-
-		// 不符合任一格式时抛出异常
-		throw new NetworkException(
-			StringUtils.format("[{}] 不是有效的IPv4或IPv6地址", ip)
-		);
-	}
-
-	/**
-	 * 将当前 NetworkAddress 转换为 InetAddress 对象。
-	 *
-	 * @return InetAddress 对象
-	 */
-	public InetAddress toInetAddress() {
-		try {
-			return InetAddress.getByName(ip != null ? ip : domain);
-		} catch (UnknownHostException e) {
-			throw new RuntimeException(e);
-		}
-	}
-
-	/**
-	 * 返回 NetworkAddress 的字符串表示形式。
-	 *
-	 * @return 字符串表示
-	 */
-	public String toString() {
-		return isdom
-			? StringUtils.format(
-				"NetworkAddress(IP='{}',type='{}'," + "domain='{}')",
-				ip,
-				IPv,
-				domain
-			)
-			: StringUtils.format("NetworkAddress(IP='{}',type='{}')", ip, IPv);
-	}
-}

src/main/java/com/mingliqiye/utils/network/NetworkEndpoint.java

@@ -1,164 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile NetworkEndpoint.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.network;
-
-import com.mingliqiye.utils.string.StringUtils;
-import lombok.Getter;
-
-import java.io.Serializable;
-import java.net.InetSocketAddress;
-
-/**
- * IP和端口聚集类，用于封装网络地址与端口信息。
- * 该类提供了与InetSocketAddress之间的相互转换功能。
- *
- * @author MingLiPro
- * @see InetSocketAddress
- */
-public class NetworkEndpoint implements Serializable {
-
-	@Getter
-	private final NetworkAddress networkAddress;
-
-	@Getter
-	private final NetworkPort networkPort;
-
-	/**
-	 * 构造函数，使用指定的网络地址和端口创建NetworkEndpoint实例。
-	 *
-	 * @param networkAddress 网络地址对象
-	 * @param networkPort    网络端口对象
-	 * @see NetworkAddress
-	 * @see NetworkPort
-	 */
-	private NetworkEndpoint(
-		NetworkAddress networkAddress,
-		NetworkPort networkPort
-	) {
-		this.networkAddress = networkAddress;
-		this.networkPort = networkPort;
-	}
-
-	/**
-	 * 根据给定的InetSocketAddress对象创建NetworkEndpoint实例。
-	 *
-	 * @param address InetSocketAddress对象
-	 * @return 新建的NetworkEndpoint实例
-	 * @see InetSocketAddress
-	 */
-	public static NetworkEndpoint of(InetSocketAddress address) {
-		return new NetworkEndpoint(
-			new NetworkAddress(address.getHostString()),
-			new NetworkPort(address.getPort())
-		);
-	}
-
-	/**
-	 * 根据主机名或IP字符串和端口号创建NetworkEndpoint实例。
-	 *
-	 * @param s 主机名或IP地址字符串
-	 * @param i 端口号
-	 * @return 新建的NetworkEndpoint实例
-	 */
-	public static NetworkEndpoint of(String s, Integer i) {
-		NetworkAddress networkAddress = new NetworkAddress(s);
-		NetworkPort networkPort = new NetworkPort(i);
-		return new NetworkEndpoint(networkAddress, networkPort);
-	}
-
-	/**
-	 * 根据"host:port"格式的字符串创建NetworkEndpoint实例。
-	 * 例如："127.0.0.1:8080"
-	 *
-	 * @param s "host:port"格式的字符串
-	 * @return 新建的NetworkEndpoint实例
-	 */
-	public static NetworkEndpoint of(String s) {
-		// 查找最后一个冒号的位置，以支持IPv6地址中的冒号
-		int lastColonIndex = s.lastIndexOf(':');
-		return of(
-			s.substring(0, lastColonIndex),
-			Integer.parseInt(s.substring(lastColonIndex + 1))
-		);
-	}
-
-	/**
-	 * 将当前NetworkEndpoint转换为InetSocketAddress对象。
-	 *
-	 * @return 对应的InetSocketAddress对象
-	 * @see InetSocketAddress
-	 */
-	public InetSocketAddress toInetSocketAddress() {
-		return new InetSocketAddress(
-			networkAddress.toInetAddress(),
-			networkPort.getPort()
-		);
-	}
-
-	/**
-	 * 将当前NetworkEndpoint转换为"host:port"格式的字符串。
-	 * 例如："127.0.0.1:25563"
-	 *
-	 * @return 格式化后的字符串
-	 */
-	public String toHostPortString() {
-		return StringUtils.format(
-			"{}:{}",
-			networkAddress.getIp(),
-			networkPort.getPort()
-		);
-	}
-
-	/**
-	 * 返回NetworkEndpoint的详细字符串表示形式。
-	 * 格式：NetworkEndpoint(IP=...,Port=...,Endpoint=...)
-	 *
-	 * @return 包含详细信息的字符串
-	 */
-	public String toString() {
-		return StringUtils.format(
-			"NetworkEndpoint(IP={},Port={},Endpoint={})",
-			networkAddress.getIp(),
-			networkPort.getPort(),
-			toHostPortString()
-		);
-	}
-
-	/**
-	 * 获取主机名或IP地址字符串。
-	 *
-	 * @return 主机名或IP地址
-	 */
-	public String getHost() {
-		return networkAddress.getIp();
-	}
-
-	/**
-	 * 获取端口号。
-	 *
-	 * @return 端口号
-	 */
-	public Integer getPort() {
-		return networkPort.getPort();
-	}
-}

src/main/java/com/mingliqiye/utils/network/NetworkPort.java

@@ -1,64 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile NetworkPort.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.network;
-
-import com.mingliqiye.utils.string.StringUtils;
-import lombok.Getter;
-
-import java.io.Serializable;
-
-/**
- * 网络端口类
- *
- * @author MingLiPro
- */
-public class NetworkPort implements Serializable {
-
-	@Getter
-	private final int port;
-
-	/**
-	 * 构造函数，创建一个网络端口对象
-	 *
-	 * @param port 端口号，必须在0-65535范围内
-	 */
-	public NetworkPort(int port) {
-		testPort(port);
-		this.port = port;
-	}
-
-	/**
-	 * 验证端口号是否合法
-	 *
-	 * @param port 待验证的端口号
-	 * @throws NetworkException 当端口号不在合法范围(0-65535)内时抛出异常
-	 */
-	public static void testPort(int port) {
-		// 验证端口号范围是否在0-65535之间
-		if (!(0 <= port && 65535 >= port)) {
-			throw new NetworkException(
-				StringUtils.format("{} 不是正确的端口号", port)
-			);
-		}
-	}
-}

src/main/java/com/mingliqiye/utils/stream/InOutSteam.java

@@ -1,279 +0,0 @@
-package com.mingliqiye.utils.stream;
-
-import java.io.*;
-import java.util.ArrayList;
-import java.util.List;
-import java.util.concurrent.locks.Lock;
-import java.util.concurrent.locks.ReentrantLock;
-import org.jetbrains.annotations.NotNull;
-
-/**
- * 自定义的输入输出流工具类，支持线程安全的数据读写操作。<br>
- * 谁闲着没事干用本地输入输出<br>
- * 实现了 AutoCloseable、Closeable 和 Flushable 接口，便于资源管理。
- *
- * @author MingLiPro
- */
-public class InOutSteam implements AutoCloseable, Closeable, Flushable {
-
-	private final Lock lock = new ReentrantLock();
-
-	List<Byte> bytes;
-
-	/**
-	 * 从内部缓冲区中读取最多 len 个字节到指定的字节数组 b 中。
-	 *
-	 * @param b   目标字节数组，用于存储读取的数据
-	 * @param off 起始偏移位置
-	 * @param len 最大读取字节数
-	 * @return 实际读取的字节数；如果已到达流末尾，则返回 -1
-	 * @throws IndexOutOfBoundsException 如果 off 或 len 参数非法
-	 */
-	public int read(byte@NotNull [] b, int off, int len) {
-		if (bytes == null) return -1;
-		if (bytes.isEmpty()) {
-			return 0;
-		}
-
-		if (off < 0 || len < 0 || off + len > b.length) {
-			throw new IndexOutOfBoundsException();
-		}
-
-		try {
-			lock.lock();
-			int bytesRead = Math.min(len, bytes.size());
-
-			for (int i = 0; i < bytesRead; i++) {
-				b[off + i] = bytes.get(i);
-			}
-			if (bytesRead > 0) {
-				bytes.subList(0, bytesRead).clear();
-			}
-
-			return bytesRead;
-		} finally {
-			lock.unlock();
-		}
-	}
-
-	/**
-	 * 读取一个字节的数据。
-	 *
-	 * @return 下一个字节数据（0~255），如果已到达流末尾则返回 -1
-	 */
-	public int read() {
-		if (bytes == null) return -1;
-		try {
-			lock.lock();
-			if (bytes.isEmpty()) {
-				return -1;
-			}
-			return bytes.remove(0);
-		} finally {
-			lock.unlock();
-		}
-	}
-
-	/**
-	 * 从内部缓冲区中读取最多 b.length 个字节到指定的字节数组 b 中。
-	 *
-	 * @param b 目标字节数组，用于存储读取的数据
-	 * @return 实际读取的字节数；如果已到达流末尾，则返回 -1
-	 */
-	public int read(byte@NotNull [] b) {
-		if (bytes == null) return -1;
-		return read(b, 0, b.length);
-	}
-
-	/**
-	 * 跳过并丢弃此输入流中数据的 n 个字节。
-	 *
-	 * @param n 要跳过的字节数
-	 * @return 实际跳过的字节数
-	 */
-	public long skip(long n) {
-		if (bytes == null) return -1;
-		if (bytes.isEmpty()) {
-			return 0;
-		}
-
-		try {
-			lock.lock();
-			if (n <= 0) {
-				return 0;
-			}
-			long bytesToSkip = Math.min(n, bytes.size());
-
-			// 移除跳过的字节
-			if (bytesToSkip > 0) {
-				bytes.subList(0, (int) bytesToSkip).clear();
-			}
-
-			return bytesToSkip;
-		} finally {
-			lock.unlock();
-		}
-	}
-
-	/**
-	 * 返回此输入流下一个方法调用可以不受阻塞地从此输入流读取（或跳过）的估计字节数。
-	 *
-	 * @return 可以无阻塞读取的字节数
-	 */
-	public int available() {
-		if (bytes == null) return -1;
-		try {
-			lock.lock();
-			return bytes.size();
-		} finally {
-			lock.unlock();
-		}
-	}
-
-	/**
-	 * 获取与当前对象关联的 InputStream 实例。
-	 *
-	 * @return InputStream 实例
-	 */
-	public InputStream getInputStream() {
-		if (inputStream == null) {
-			inputStream = inputStream();
-		}
-		return inputStream;
-	}
-
-	private InputStream inputStream;
-	private OutputStream outputStream;
-
-	/**
-	 * 获取与当前对象关联的 OutputStream 实例。
-	 *
-	 * @return OutputStream 实例
-	 */
-	public OutputStream getOutputStream() {
-		if (outputStream == null) {
-			outputStream = outputStream();
-		}
-		return outputStream;
-	}
-
-	/**
-	 * 创建并返回一个包装后的 InputStream 实例。
-	 *
-	 * @return 新创建的 InputStream 实例
-	 */
-	private InputStream inputStream() {
-		return new InputStreanWrapper(
-			new InputStream() {
-				@Override
-				public int read() {
-					return InOutSteam.this.read();
-				}
-
-				@Override
-				public int read(byte@NotNull [] b, int off, int len) {
-					return InOutSteam.this.read(b, off, len);
-				}
-
-				@Override
-				public long skip(long n) {
-					return InOutSteam.this.skip(n);
-				}
-
-				@Override
-				public int available() {
-					return InOutSteam.this.available();
-				}
-			}
-		);
-	}
-
-	/**
-	 * 创建并返回一个 OutputStream 实例。
-	 *
-	 * @return 新创建的 OutputStream 实例
-	 */
-	private OutputStream outputStream() {
-		return new OutputStream() {
-			@Override
-			public void write(int b) {
-				InOutSteam.this.write(b);
-			}
-
-			@Override
-			public void write(byte@NotNull [] b, int off, int len) {
-				InOutSteam.this.write(b, off, len);
-			}
-		};
-	}
-
-	/**
-	 * 构造函数，初始化内部字节列表。
-	 */
-	public InOutSteam() {
-		bytes = new ArrayList<>();
-	}
-
-	/**
-	 * 将指定的字节写入此输出流。
-	 *
-	 * @param b 要写入的字节
-	 */
-	public void write(int b) {
-		try {
-			lock.lock();
-			bytes.add((byte) b);
-		} finally {
-			lock.unlock();
-		}
-	}
-
-	/**
-	 * 将指定字节数组中的部分数据写入此输出流。
-	 *
-	 * @param b   数据源字节数组
-	 * @param off 起始偏移位置
-	 * @param len 写入的字节数
-	 * @throws IndexOutOfBoundsException 如果 off 或 len 参数非法
-	 */
-	public void write(byte@NotNull [] b, int off, int len) {
-		if (off < 0 || len < 0 || off + len > b.length) {
-			throw new IndexOutOfBoundsException("Invalid offset or length");
-		}
-
-		try {
-			lock.lock();
-			for (int i = off; i < off + len; i++) {
-				bytes.add(b[i]);
-			}
-		} finally {
-			lock.unlock();
-		}
-	}
-
-	/**
-	 * 将整个字节数组写入此输出流。
-	 *
-	 * @param b 要写入的字节数组
-	 */
-	public void write(byte@NotNull [] b) {
-		write(b, 0, b.length);
-	}
-
-	/**
-	 * 刷新此输出流并强制写出所有缓冲的输出字节。
-	 * 当前实现为空方法。
-	 */
-	@Override
-	public void flush() {}
-
-	/**
-	 * 关闭此流并释放与其相关的所有资源。
-	 * 清空并置空内部字节列表。
-	 */
-	@Override
-	public void close() {
-		bytes.clear();
-		bytes = null;
-	}
-}

src/main/java/com/mingliqiye/utils/stream/InputStreamUtils.java

@@ -1,123 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile InputStreamUtils.java
- * LastUpdate 2025-09-15 08:30:57
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.stream;
-
-import com.mingliqiye.utils.collection.Collections;
-import lombok.val;
-import org.jetbrains.annotations.NotNull;
-
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.util.List;
-
-/**
- * 输入流工具类，提供对InputStream的常用操作封装
- */
-public class InputStreamUtils {
-
-	/**
-	 * 默认缓冲区大小：1MB
-	 */
-	public static final int DEFAULT_BUFFER_SIZE = 1024 * 1024;
-
-	/**
-	 * 将输入流读取到字节数组中<br>
-	 * 请在外部自行关闭输入流对象 避免资源泄露
-	 *
-	 * @param inputStream 输入流对象，用于读取数据
-	 * @return 包含输入流所有数据的字节数组
-	 * @throws IOException 当读取输入流或写入输出流时发生IO异常
-	 */
-	public static byte[] readToArray(InputStream inputStream)
-		throws IOException {
-		// 使用ByteArrayOutputStream来收集输入流中的所有数据
-		try (val byteArrayOutputStream = new ByteArrayOutputStream()) {
-			val bytes = new byte[DEFAULT_BUFFER_SIZE];
-			int length;
-			// 循环读取输入流数据，直到读取完毕
-			while ((length = inputStream.read(bytes)) != -1) {
-				byteArrayOutputStream.write(bytes, 0, length);
-			}
-			return byteArrayOutputStream.toByteArray();
-		}
-	}
-
-	/**
-	 * 将输入流读取到Byte列表中<br>
-	 * 请在外部自行关闭输入流对象 避免资源泄露
-	 *
-	 * @param inputStream 输入流对象，用于读取数据
-	 * @return 包含输入流所有数据的Byte列表
-	 * @throws IOException 当读取输入流时发生IO异常
-	 */
-	public static @NotNull List<Byte> readToList(InputStream inputStream)
-		throws IOException {
-		return Collections.newArrayLists(readToArray(inputStream));
-	}
-
-	/**
-	 * 将输入流读取为字符串<br>
-	 * 请在外部自行关闭输入流对象 避免资源泄露
-	 *
-	 * @param inputStream 输入流对象，用于读取数据
-	 * @return 输入流对应的字符串内容
-	 * @throws IOException 当读取输入流时发生IO异常
-	 */
-	public static String readToString(InputStream inputStream)
-		throws IOException {
-		return new String(readToArray(inputStream));
-	}
-
-	/**
-	 * 将输入流的数据传输到输出流中<br>
-	 * 请在外部自行关闭输入流输出流对象 避免资源泄露
-	 *
-	 * @param inputStream  源输入流，用于读取数据
-	 * @param outputStream 目标输出流，用于写入数据
-	 * @return 传输的总字节数
-	 * @throws IOException 当读取或写入流时发生IO异常
-	 */
-	public static long transferTo(
-		InputStream inputStream,
-		OutputStream outputStream
-	) throws IOException {
-		if (inputStream == null) {
-			throw new IllegalArgumentException("inputStream can not be null");
-		}
-		if (outputStream == null) {
-			throw new IllegalArgumentException("outputStream can not be null");
-		}
-		val bytes = new byte[DEFAULT_BUFFER_SIZE];
-		int length;
-		long readAll = 0L;
-		// 循环读取并写入数据，直到输入流读取完毕
-		while ((length = inputStream.read(bytes)) != -1) {
-			outputStream.write(bytes, 0, length);
-			readAll += length;
-		}
-		outputStream.flush();
-		return readAll;
-	}
-}

src/main/java/com/mingliqiye/utils/stream/InputStreanWrapper.java

@@ -1,120 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile InputStreanWrapper.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.stream;
-
-import lombok.Getter;
-import org.jetbrains.annotations.NotNull;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.util.List;
-
-public class InputStreanWrapper extends InputStream implements AutoCloseable {
-
-	@Getter
-	private final InputStream inputStream;
-
-	public InputStreanWrapper(InputStream inputStream) {
-		this.inputStream = inputStream;
-	}
-
-	private static InputStreanWrapper of(InputStream inputStream) {
-		return new InputStreanWrapper(inputStream);
-	}
-
-	@Override
-	public int available() throws IOException {
-		return inputStream.available();
-	}
-
-	@Override
-	public int read() throws IOException {
-		return inputStream.read();
-	}
-
-	@Override
-	public int read(byte@NotNull [] b) throws IOException {
-		return inputStream.read(b);
-	}
-
-	@Override
-	public int read(byte@NotNull [] b, int off, int len) throws IOException {
-		return inputStream.read(b, off, len);
-	}
-
-	@Override
-	public long skip(long n) throws IOException {
-		return inputStream.skip(n);
-	}
-
-	@Override
-	public void mark(int readlimit) {
-		inputStream.mark(readlimit);
-	}
-
-	@Override
-	public void reset() throws IOException {
-		inputStream.reset();
-	}
-
-	@Override
-	public boolean markSupported() {
-		return inputStream.markSupported();
-	}
-
-	@Override
-	public void close() {
-		try {
-			inputStream.close();
-		} catch (Exception e) {
-			throw new RuntimeException(e);
-		}
-	}
-
-	/**
-	 * 输入流转换为输出流 <br>
-	 * jdk8 兼容实现 jdk9+ <br>
-	 * 请使用 InputStream.transferTo()
-	 *
-	 * @param outputStream 输出流
-	 * @return 转换的字节数
-	 * @throws IOException IO错误
-	 */
-	public long transferToOutputStream(OutputStream outputStream)
-		throws IOException {
-		return InputStreamUtils.transferTo(inputStream, outputStream);
-	}
-
-	public byte[] readToArray() throws IOException {
-		return InputStreamUtils.readToArray(inputStream);
-	}
-
-	public List<Byte> readToList() throws IOException {
-		return InputStreamUtils.readToList(inputStream);
-	}
-
-	public String readToString() throws IOException {
-		return InputStreamUtils.readToString(inputStream);
-	}
-}

src/main/java/com/mingliqiye/utils/stream/OutputStreamWrapper.java

@@ -1,81 +0,0 @@
-package com.mingliqiye.utils.stream;
-
-import java.io.ByteArrayOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
-import java.util.List;
-import lombok.Getter;
-import org.jetbrains.annotations.NotNull;
-
-public class OutputStreamWrapper extends OutputStream implements AutoCloseable {
-
-	@Getter
-	private final OutputStream outputStream;
-
-	private final ByteArrayOutputStream byteArrayOutputStream =
-		new ByteArrayOutputStream();
-
-	public OutputStreamWrapper(OutputStream outputStream) {
-		this.outputStream = outputStream;
-	}
-
-	public static OutputStreamWrapper of(OutputStream outputStream) {
-		return new OutputStreamWrapper(outputStream);
-	}
-
-	@Override
-	public void write(int b) throws IOException {
-		byteArrayOutputStream.write(b);
-	}
-
-	@Override
-	public void write(byte@NotNull [] b) throws IOException {
-		byteArrayOutputStream.write(b);
-	}
-
-	public void write(List<Byte> b) throws IOException {
-		write(b, 0, b.size());
-	}
-
-	@Override
-	public void write(byte@NotNull [] b, int off, int len) throws IOException {
-		byteArrayOutputStream.write(b, off, len);
-	}
-
-	public void write(List<Byte> b, int off, int len) throws IOException {
-		byte[] bytes = new byte[b.size()];
-		for (int i = 0; i < b.size(); i++) {
-			bytes[i] = b.get(i);
-		}
-		byteArrayOutputStream.write(bytes, off, len);
-	}
-
-	@Override
-	public void flush() throws IOException {
-		outputStream.write(byteArrayOutputStream.toByteArray());
-		byteArrayOutputStream.reset();
-	}
-
-	public int getBufferCachedSize() {
-		return byteArrayOutputStream.size();
-	}
-
-	public byte[] getBufferCachedBytes() {
-		return byteArrayOutputStream.toByteArray();
-	}
-
-	@Override
-	public void close() {
-		try {
-			outputStream.close();
-		} catch (IOException e) {
-			throw new RuntimeException(e);
-		}
-	}
-
-	public long transferFromOutputStream(InputStream inputStream)
-		throws IOException {
-		return InputStreamUtils.transferTo(inputStream, outputStream);
-	}
-}

src/main/java/com/mingliqiye/utils/stream/StreamEmptyException.java

@@ -15,18 +15,20 @@
  *
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
- * CurrentFile PlayerSample.java
- * LastUpdate 2025-09-09 08:37:33
+ * CurrentFile StreamEmptyException.java
+ * LastUpdate 2025-09-20 13:24:07
  * UpdateUser MingLiPro
  */
 
-package com.mingliqiye.utils.minecraft.slp;
+package com.mingliqiye.utils.stream;
 
-import lombok.Data;
+public class StreamEmptyException extends java.lang.RuntimeException {
 
-@Data
-public class PlayerSample {
+    public StreamEmptyException(String message) {
+        super(message);
+    }
 
-	private String name;
-	private String id;
+    public StreamEmptyException(String message, Throwable cause) {
+        super(message, cause);
+    }
 }

src/main/java/com/mingliqiye/utils/stream/interfaces/GetIdable.java

@@ -1,9 +0,0 @@
-package com.mingliqiye.utils.stream.interfaces;
-
-public interface GetIdable<T> extends Getable<T> {
-	T getId();
-
-	default T get() {
-		return getId();
-	}
-}

src/main/java/com/mingliqiye/utils/stream/interfaces/GetKeyable.java

@@ -1,9 +0,0 @@
-package com.mingliqiye.utils.stream.interfaces;
-
-public interface GetKeyable<T> {
-	T getKey();
-
-	default T get() {
-		return getKey();
-	}
-}

src/main/java/com/mingliqiye/utils/stream/interfaces/GetNameable.java

@@ -1,9 +0,0 @@
-package com.mingliqiye.utils.stream.interfaces;
-
-public interface GetNameable<T> extends Getable<T> {
-	T getName();
-
-	default T get() {
-		return getName();
-	}
-}

src/main/java/com/mingliqiye/utils/stream/interfaces/Getable.java

@@ -1,5 +0,0 @@
-package com.mingliqiye.utils.stream.interfaces;
-
-public interface Getable<T> {
-	T get();
-}

src/main/java/com/mingliqiye/utils/time/DateTime.java

@@ -1,561 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile DateTime.java
- * LastUpdate 2025-09-14 22:12:16
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.time;
-
-import com.mingliqiye.utils.jna.WinKernel32Api;
-import com.mingliqiye.utils.jna.WinKernel32ApiFactory;
-import com.mingliqiye.utils.system.SystemUtils;
-import lombok.Getter;
-import lombok.Setter;
-import lombok.val;
-import lombok.var;
-import org.jetbrains.annotations.NotNull;
-import org.slf4j.Logger;
-
-import java.io.Serializable;
-import java.time.Instant;
-import java.time.LocalDateTime;
-import java.time.ZoneId;
-import java.time.format.DateTimeFormatter;
-import java.time.temporal.ChronoUnit;
-import java.util.Date;
-
-import static com.mingliqiye.utils.jna.WinKernel32ApiFactory.FILETIME_EPOCH_OFFSET;
-import static com.mingliqiye.utils.jna.WinKernel32ApiFactory.NANOS_PER_100NS;
-import static com.mingliqiye.utils.logger.Loggers.getMingLiLoggerFactory;
-
-/**
- * 时间类，用于处理日期时间的转换、格式化等操作。
- * 提供了多种静态方法来创建 DateTime 实例，并支持与 Date、LocalDateTime 等类型的互转。
- *<br>
- * windows java 1.8 及以下 使用windows Api 获取高精度时间
- *
- * @author MingLiPro
- * @see java.time
- * @see LocalDateTime
- * @see ChronoUnit
- * @see Date
- * @see DateTimeFormatter
- * @see ZoneId
- * @see Instant
- */
-@Setter
-public final class DateTime implements Serializable {
-
-	private static final WinKernel32Api WIN_KERNEL_32_API;
-
-	static {
-		if (
-			SystemUtils.getJavaVersionAsInteger() == 8 &&
-			SystemUtils.isWindows()
-		) {
-			final Logger log = getMingLiLoggerFactory().getLogger(
-				"mingli-utils DateTime"
-			);
-			val a = WinKernel32ApiFactory.getWinKernel32Apis();
-
-			if (a.size() > 1) {
-				log.warn(
-					"Multiple Size:{} WinKernel32Api implementations found.",
-					a.size()
-				);
-				a.forEach(api ->
-					log.warn(
-						"Found WinKernel32Api: {}",
-						api.getClass().getName()
-					)
-				);
-			}
-
-			if (a.isEmpty()) {
-				WIN_KERNEL_32_API = null;
-				log.warn(
-					"No WinKernel32Api implementation found. Use Jdk1.8 LocalDateTime"
-				);
-			} else {
-				WIN_KERNEL_32_API = a.get(a.size() - 1);
-				log.info(
-					"Found and Use WinKernel32Api: {}",
-					WIN_KERNEL_32_API.getClass().getName()
-				);
-			}
-		} else {
-			WIN_KERNEL_32_API = null;
-		}
-	}
-
-	@Getter
-	private ZoneId zoneId = ZoneId.systemDefault();
-
-	@Getter
-	private LocalDateTime localDateTime;
-
-	/**
-	 * 私有构造函数，使用指定的 LocalDateTime 初始化实例。
-	 *
-	 * @param time LocalDateTime 对象
-	 */
-	private DateTime(LocalDateTime time) {
-		setLocalDateTime(time);
-	}
-
-	/**
-	 * 私有构造函数，使用当前系统时间初始化实例。
-	 */
-	private DateTime() {
-		setLocalDateTime(LocalDateTime.now());
-	}
-
-	/**
-	 * 获取当前时间的 DateTime 实例。
-	 * 如果运行在 Java 1.8 环境下，则通过 WinKernel32 获取高精度时间。
-	 *
-	 * @return 返回当前时间的 DateTime 实例
-	 */
-	public static DateTime now() {
-		if (WIN_KERNEL_32_API != null) {
-			return DateTime.of(
-				WIN_KERNEL_32_API.getTime()
-					.atZone(ZoneId.systemDefault())
-					.toLocalDateTime()
-			);
-		}
-		return new DateTime();
-	}
-
-	/**
-	 * 将 Date 对象转换为 DateTime 实例。
-	 *
-	 * @param zoneId 时区信息
-	 * @param date   Date 对象
-	 * @return 返回对应的 DateTime 实例
-	 */
-	public static DateTime of(Date date, ZoneId zoneId) {
-		return new DateTime(date.toInstant().atZone(zoneId).toLocalDateTime());
-	}
-
-	/**
-	 * 将 Date 对象转换为 DateTime 实例，使用系统默认时区。
-	 *
-	 * @param date Date 对象
-	 * @return 返回对应的 DateTime 实例
-	 */
-	public static DateTime of(Date date) {
-		return new DateTime(
-			date.toInstant().atZone(ZoneId.systemDefault()).toLocalDateTime()
-		);
-	}
-
-	/**
-	 * 根据 LocalDateTime 创建 DateTime 实例。
-	 *
-	 * @param localDateTime LocalDateTime 对象
-	 * @return 返回对应的 DateTime 实例
-	 */
-	public static DateTime of(LocalDateTime localDateTime) {
-		return new DateTime(localDateTime);
-	}
-
-	/**
-	 * 解析时间字符串并生成 DateTime 实例。
-	 *
-	 * @param timestr   时间字符串
-	 * @param formatter 格式化模板
-	 * @param fillZero  是否补零到模板长度
-	 * @return 返回解析后的 DateTime 实例
-	 */
-	public static DateTime parse(
-		String timestr,
-		String formatter,
-		boolean fillZero
-	) {
-		return new DateTime(
-			LocalDateTime.parse(
-				fillZero ? getFillZeroByLen(timestr, formatter) : timestr,
-				DateTimeFormatter.ofPattern(formatter)
-			)
-		);
-	}
-
-	/**
-	 * 使用 Formatter 枚举解析时间字符串并生成 DateTime 实例。
-	 *
-	 * @param timestr   时间字符串
-	 * @param formatter 格式化模板枚举
-	 * @param fillZero  是否补零到模板长度
-	 * @return 返回解析后的 DateTime 实例
-	 */
-	public static DateTime parse(
-		String timestr,
-		Formatter formatter,
-		boolean fillZero
-	) {
-		return parse(timestr, formatter.getValue(), fillZero);
-	}
-
-	/**
-	 * 使用 Formatter 枚举解析时间字符串并生成 DateTime 实例，默认不补零。
-	 *
-	 * @param timestr   时间字符串
-	 * @param formatter 格式化模板枚举
-	 * @return 返回解析后的 DateTime 实例
-	 */
-	public static DateTime parse(String timestr, Formatter formatter) {
-		return parse(timestr, formatter.getValue());
-	}
-
-	/**
-	 * 解析时间字符串并生成 DateTime 实例，默认不补零。
-	 *
-	 * @param timestr   时间字符串
-	 * @param formatter 格式化模板
-	 * @return 返回解析后的 DateTime 实例
-	 */
-	public static DateTime parse(String timestr, String formatter) {
-		return parse(timestr, formatter, false);
-	}
-
-	/**
-	 * 补零处理时间字符串以匹配格式化模板长度。
-	 *
-	 * @param dstr    原始时间字符串
-	 * @param formats 格式化模板
-	 * @return 补零后的时间字符串
-	 */
-	private static String getFillZeroByLen(String dstr, String formats) {
-		if (dstr.length() == formats.length()) {
-			return dstr;
-		}
-		if (formats.length() > dstr.length()) {
-			if (dstr.length() == 19) {
-				dstr += ".";
-			}
-			var sb = new StringBuilder(dstr);
-			for (int i = 0; i < formats.length() - dstr.length(); i++) {
-				sb.append("0");
-			}
-			return sb.toString();
-		}
-		throw new IllegalArgumentException(
-			String.format(
-				"Text: '%s' len %s < %s %s",
-				dstr,
-				dstr.length(),
-				formats,
-				formats.length()
-			)
-		);
-	}
-
-	/**
-	 * 根据年、月、日创建 DateTime 实例
-	 *
-	 * @param year  年份
-	 * @param month 月份 (1-12)
-	 * @param day   日期 (1-31)
-	 * @return 返回指定日期的 DateTime 实例（时间部分为 00:00:00）
-	 */
-	public static DateTime of(int year, int month, int day) {
-		return new DateTime(LocalDateTime.of(year, month, day, 0, 0));
-	}
-
-	/**
-	 * 根据年、月、日、时、分创建 DateTime 实例
-	 *
-	 * @param year   年份
-	 * @param month  月份 (1-12)
-	 * @param day    日期 (1-31)
-	 * @param hour   小时 (0-23)
-	 * @param minute 分钟 (0-59)
-	 * @return 返回指定日期时间的 DateTime 实例（秒部分为 00）
-	 */
-	public static DateTime of(
-		int year,
-		int month,
-		int day,
-		int hour,
-		int minute
-	) {
-		return new DateTime(LocalDateTime.of(year, month, day, hour, minute));
-	}
-
-	/**
-	 * 将 FILETIME 转换为 LocalDateTime。
-	 *
-	 * @param fileTime FILETIME 时间戳（100纳秒单位自1601年1月1日起）
-	 * @return 转换后的 LocalDateTime 实例
-	 */
-	public static LocalDateTime fileTimeToLocalDateTime(long fileTime) {
-		// 1. 将 FILETIME (100ns间隔 since 1601) 转换为 Unix 时间戳 (纳秒 since 1970)
-		long unixNanos = (fileTime + FILETIME_EPOCH_OFFSET) * NANOS_PER_100NS;
-
-		// 2. 从纳秒时间戳创建 Instant
-		Instant instant = Instant.ofEpochSecond(
-			unixNanos / 1_000_000_000L,
-			unixNanos % 1_000_000_000L
-		);
-
-		// 3. 转换为系统默认时区的 LocalDateTime
-		return instant.atZone(ZoneId.systemDefault()).toLocalDateTime();
-	}
-
-	/**
-	 * 根据年、月、日、时、分、秒创建 DateTime 实例
-	 *
-	 * @param year   年份
-	 * @param month  月份 (1-12)
-	 * @param day    日期 (1-31)
-	 * @param hour   小时 (0-23)
-	 * @param minute 分钟 (0-59)
-	 * @param second 秒 (0-59)
-	 * @return 返回指定日期时间的 DateTime 实例
-	 */
-	public static DateTime of(
-		int year,
-		int month,
-		int day,
-		int hour,
-		int minute,
-		int second
-	) {
-		return new DateTime(
-			LocalDateTime.of(year, month, day, hour, minute, second)
-		);
-	}
-
-	/**
-	 * 根据年、月、日、时、分、秒、纳秒创建 DateTime 实例
-	 *
-	 * @param year   年份
-	 * @param month  月份 (1-12)
-	 * @param day    日期 (1-31)
-	 * @param hour   小时 (0-23)
-	 * @param minute 分钟 (0-59)
-	 * @param second 秒 (0-59)
-	 * @param nano   纳秒 (0-999,999,999)
-	 * @return 返回指定日期时间的 DateTime 实例
-	 */
-	public static DateTime of(
-		int year,
-		int month,
-		int day,
-		int hour,
-		int minute,
-		int second,
-		int nano
-	) {
-		return new DateTime(
-			LocalDateTime.of(year, month, day, hour, minute, second, nano)
-		);
-	}
-
-	/**
-	 * 根据毫秒时间戳创建 DateTime 实例
-	 *
-	 * @param epochMilli 毫秒时间戳
-	 * @return 返回对应时间的 DateTime 实例
-	 */
-	public static DateTime of(long epochMilli) {
-		return new DateTime(
-			Instant.ofEpochMilli(epochMilli)
-				.atZone(ZoneId.systemDefault())
-				.toLocalDateTime()
-		);
-	}
-
-	/**
-	 * 根据毫秒时间戳和时区创建 DateTime 实例
-	 *
-	 * @param epochMilli 毫秒时间戳
-	 * @param zoneId     时区信息
-	 * @return 返回对应时间的 DateTime 实例
-	 */
-	public static DateTime of(long epochMilli, ZoneId zoneId) {
-		return new DateTime(
-			Instant.ofEpochMilli(epochMilli).atZone(zoneId).toLocalDateTime()
-		);
-	}
-
-	/**
-	 * 将当前 DateTime 转换为 Date 对象。
-	 *
-	 * @return 返回对应的 Date 对象
-	 */
-	public Date toDate() {
-		return Date.from(localDateTime.atZone(getZoneId()).toInstant());
-	}
-
-	/**
-	 * 获取当前 DateTime 中的 LocalDateTime 实例。
-	 *
-	 * @return 返回 LocalDateTime 对象
-	 */
-	public LocalDateTime toLocalDateTime() {
-		return localDateTime;
-	}
-
-	/**
-	 * 在当前时间基础上增加指定的时间偏移量。
-	 *
-	 * @param dateTimeOffset 时间偏移对象
-	 * @return 返回修改后的 DateTime 实例
-	 */
-	public DateTime add(DateTimeOffset dateTimeOffset) {
-		return new DateTime(
-			this.localDateTime.plus(
-				dateTimeOffset.getOffset(),
-				dateTimeOffset.getOffsetType()
-			)
-		);
-	}
-
-	/**
-	 * 在当前时间基础上减少指定的时间偏移量。
-	 *
-	 * @param dateTimeOffset 时间偏移对象
-	 * @return 返回修改后的 DateTime 实例
-	 */
-	public DateTime sub(DateTimeOffset dateTimeOffset) {
-		return new DateTime(
-			this.localDateTime.plus(
-				-dateTimeOffset.getOffset(),
-				dateTimeOffset.getOffsetType()
-			)
-		);
-	}
-
-	/**
-	 * 使用指定格式化模板将当前时间格式化为字符串。
-	 *
-	 * @param formatter 格式化模板
-	 * @return 返回格式化后的时间字符串
-	 */
-	public String format(String formatter) {
-		return format(formatter, false);
-	}
-
-	/**
-	 * 使用 Formatter 枚举将当前时间格式化为字符串。
-	 *
-	 * @param formatter 格式化模板枚举
-	 * @return 返回格式化后的时间字符串
-	 */
-	public String format(Formatter formatter) {
-		return format(formatter.getValue());
-	}
-
-	/**
-	 * 使用指定格式化模板将当前时间格式化为字符串，并可选择是否去除末尾多余的零。
-	 *
-	 * @param formatter 格式化模板
-	 * @param repcZero  是否去除末尾多余的零
-	 * @return 返回格式化后的时间字符串
-	 */
-	public String format(String formatter, boolean repcZero) {
-		var formatted = DateTimeFormatter.ofPattern(formatter).format(
-			toLocalDateTime()
-		);
-		if (repcZero) {
-			// 处理小数点后多余的0
-			formatted = formatted.replaceAll("(\\.\\d*?)0+\\b", "$1");
-			formatted = formatted.replaceAll("\\.$", "");
-		}
-		return formatted;
-	}
-
-	/**
-	 * 使用 Formatter 枚举将当前时间格式化为字符串，并可选择是否去除末尾多余的零。
-	 *
-	 * @param formatter 格式化模板枚举
-	 * @param repcZero  是否去除末尾多余的零
-	 * @return 返回格式化后的时间字符串
-	 */
-	public String format(Formatter formatter, boolean repcZero) {
-		return format(formatter.getValue(), repcZero);
-	}
-
-	/**
-	 * 返回当前时间的标准字符串表示形式。
-	 *
-	 * @return 返回标准格式的时间字符串
-	 */
-	@Override
-	public String toString() {
-		return String.format(
-			"DateTime(%s)",
-			format(Formatter.STANDARD_DATETIME_MILLISECOUND7, true)
-		);
-	}
-
-	/**
-	 * 比较当前DateTime对象与指定对象是否相等
-	 *
-	 * @param obj 要比较的对象
-	 * @return 如果对象相等则返回true，否则返回false
-	 */
-	@Override
-	public boolean equals(Object obj) {
-		// 检查对象类型是否为DateTime
-		if (obj instanceof DateTime) {
-			// 比较两个DateTime对象转换为LocalDateTime后的值
-			return toLocalDateTime().equals(((DateTime) obj).toLocalDateTime());
-		}
-		return false;
-	}
-
-	/**
-	 * 将当前 DateTime 转换为 Instant 对象。
-	 *
-	 * @return 返回 Instant 对象
-	 */
-	@NotNull
-	public Instant toInstant() {
-		return localDateTime.atZone(zoneId).toInstant();
-	}
-
-	/**
-	 * 判断当前时间是否在指定时间之后。
-	 *
-	 * @param dateTime 指定时间
-	 * @return 如果当前时间在指定时间之后则返回 true，否则返回 false
-	 */
-	public boolean isAfter(DateTime dateTime) {
-		if (dateTime == null) {
-			return false;
-		}
-		return toInstant().isAfter(dateTime.toInstant());
-	}
-
-	/**
-	 * 判断当前时间是否在指定时间之前。
-	 *
-	 * @param dateTime 指定时间
-	 * @return 如果当前时间在指定时间之前则返回 true，否则返回 false
-	 */
-	public boolean isBefore(DateTime dateTime) {
-		if (dateTime == null) {
-			return false;
-		}
-		return toInstant().isBefore(dateTime.toInstant());
-	}
-}

src/main/java/com/mingliqiye/utils/time/DateTimeOffset.java

@@ -1,65 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile DateTimeOffset.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.time;
-
-import java.time.temporal.ChronoUnit;
-import lombok.Getter;
-
-/**
- * 时间位移 类
- *
- * @author MingLiPro
- */
-@Getter
-public class DateTimeOffset {
-
-	private final ChronoUnit offsetType;
-	private final Long offset;
-
-	private DateTimeOffset(ChronoUnit offsetType, Long offset) {
-		this.offsetType = offsetType;
-		this.offset = offset;
-	}
-
-	/**
-	 * 创建一个新的DateTimeOffset实例
-	 *
-	 * @param offsetType 偏移量的单位类型，指定偏移量的计算单位
-	 * @param offset     偏移量的数值，可以为正数、负数或零
-	 * @return 返回一个新的DateTimeOffset对象，包含指定的偏移量信息
-	 */
-	public static DateTimeOffset of(ChronoUnit offsetType, Long offset) {
-		return new DateTimeOffset(offsetType, offset);
-	}
-
-	/**
-	 * 创建一个 DateTimeOffset 实例
-	 *
-	 * @param offset     偏移量数值
-	 * @param offsetType 偏移量的时间单位类型
-	 * @return 返回一个新的 DateTimeOffset 实例
-	 */
-	public static DateTimeOffset of(Long offset, ChronoUnit offsetType) {
-		return new DateTimeOffset(offsetType, offset);
-	}
-}

src/main/java/com/mingliqiye/utils/time/DateTimeUnit.java

@@ -1,65 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile DateTimeUnit.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.time;
-
-/**
- * 时间单位常量定义
- *
- * @author MingLiPro
- */
-public interface DateTimeUnit {
-	// 时间单位常量
-	String YEAR = "year";
-	String MONTH = "month";
-	String WEEK = "week";
-	String DAY = "day";
-	String HOUR = "hour";
-	String MINUTE = "minute";
-	String SECOND = "second";
-	String MILLISECOND = "millisecond";
-	String MICROSECOND = "microsecond";
-	String NANOSECOND = "nanosecond";
-
-	// 时间单位缩写
-	String YEAR_ABBR = "y";
-	String MONTH_ABBR = "M";
-	String WEEK_ABBR = "w";
-	String DAY_ABBR = "d";
-	String HOUR_ABBR = "h";
-	String MINUTE_ABBR = "m";
-	String SECOND_ABBR = "s";
-	String MILLISECOND_ABBR = "ms";
-	String MICROSECOND_ABBR = "μs";
-	String NANOSECOND_ABBR = "ns";
-
-	// 时间单位转换系数（毫秒为基准）
-	long MILLIS_PER_SECOND = 1000L;
-	long MILLIS_PER_MINUTE = 60 * MILLIS_PER_SECOND;
-	long MILLIS_PER_HOUR = 60 * MILLIS_PER_MINUTE;
-	long MILLIS_PER_DAY = 24 * MILLIS_PER_HOUR;
-	long MILLIS_PER_WEEK = 7 * MILLIS_PER_DAY;
-
-	// 月份和年的毫秒数仅为近似值
-	long MILLIS_PER_MONTH = 30 * MILLIS_PER_DAY; // 近似值
-	long MILLIS_PER_YEAR = 365 * MILLIS_PER_DAY; // 近似值
-}

src/main/java/com/mingliqiye/utils/time/Formatter.java

@@ -1,115 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Formatter.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.time;
-
-import lombok.Getter;
-
-/**
- * 时间格式化枚举类
- * <p>
- * 定义了常用的时间格式化模式，用于日期时间的解析和格式化操作
- * 每个枚举常量包含对应的格式化字符串和字符串长度
- * </p>
- */
-public enum Formatter {
-	/**
-	 * 标准日期时间格式：yyyy-MM-dd HH:mm:ss
-	 */
-	STANDARD_DATETIME("yyyy-MM-dd HH:mm:ss"),
-
-	/**
-	 * 标准日期时间格式(7位毫秒)：yyyy-MM-dd HH:mm:ss.SSSSSSS
-	 */
-	STANDARD_DATETIME_MILLISECOUND7("yyyy-MM-dd HH:mm:ss.SSSSSSS"),
-
-	/**
-	 * 标准日期时间格式(6位毫秒)：yyyy-MM-dd HH:mm:ss.SSSSSS
-	 */
-	STANDARD_DATETIME_MILLISECOUND6("yyyy-MM-dd HH:mm:ss.SSSSSS"),
-
-	/**
-	 * 标准日期时间格式(5位毫秒)：yyyy-MM-dd HH:mm:ss.SSSSS
-	 */
-	STANDARD_DATETIME_MILLISECOUND5("yyyy-MM-dd HH:mm:ss.SSSSS"),
-
-	/**
-	 * 标准日期时间格式(4位毫秒)：yyyy-MM-dd HH:mm:ss.SSSS
-	 */
-	STANDARD_DATETIME_MILLISECOUND4("yyyy-MM-dd HH:mm:ss.SSSS"),
-
-	/**
-	 * 标准日期时间格式(3位毫秒)：yyyy-MM-dd HH:mm:ss.SSS
-	 */
-	STANDARD_DATETIME_MILLISECOUND3("yyyy-MM-dd HH:mm:ss.SSS"),
-
-	/**
-	 * 标准日期时间格式(2位毫秒)：yyyy-MM-dd HH:mm:ss.SS
-	 */
-	STANDARD_DATETIME_MILLISECOUND2("yyyy-MM-dd HH:mm:ss.SS"),
-
-	/**
-	 * 标准日期时间格式(1位毫秒)：yyyy-MM-dd HH:mm:ss.S
-	 */
-	STANDARD_DATETIME_MILLISECOUND1("yyyy-MM-dd HH:mm:ss.S"),
-
-	/**
-	 * 标准ISO格式：yyyy-MM-dd'T'HH:mm:ss.SSS'Z'
-	 */
-	STANDARD_ISO("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'"),
-
-	/**
-	 * 标准日期时间秒格式：yyyy-MM-dd HH:mm:ss
-	 */
-	STANDARD_DATETIME_SECOUND("yyyy-MM-dd HH:mm:ss"),
-
-	/**
-	 * 标准日期格式：yyyy-MM-dd
-	 */
-	STANDARD_DATE("yyyy-MM-dd"),
-
-	/**
-	 * ISO8601格式：yyyy-MM-dd'T'HH:mm:ss.SSS'000'
-	 */
-	ISO8601("yyyy-MM-dd'T'HH:mm:ss.SSS'000'"),
-
-	/**
-	 * 紧凑型日期时间格式：yyyyMMddHHmmss
-	 */
-	COMPACT_DATETIME("yyyyMMddHHmmss");
-
-	@Getter
-	private final String value;
-
-	@Getter
-	private final int len;
-
-	/**
-	 * 构造函数
-	 *
-	 * @param value 格式化模式字符串
-	 */
-	Formatter(String value) {
-		this.value = value;
-		this.len = value.length();
-	}
-}

src/main/java/com/mingliqiye/utils/time/typehandlers/DateTimeTypeHandler.java

@@ -1,128 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile DateTimeTypeHandler.java
- * LastUpdate 2025-09-09 08:37:33
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.time.typehandlers;
-
-import com.mingliqiye.utils.time.DateTime;
-import com.mingliqiye.utils.time.Formatter;
-import java.sql.*;
-import org.apache.ibatis.type.BaseTypeHandler;
-import org.apache.ibatis.type.JdbcType;
-import org.apache.ibatis.type.MappedJdbcTypes;
-import org.apache.ibatis.type.MappedTypes;
-
-/**
- * DateTime类型处理器类
- * 用于在MyBatis中处理DateTime类型与数据库VARCHAR类型之间的转换
- */
-@MappedTypes({ DateTime.class })
-@MappedJdbcTypes(JdbcType.VARCHAR)
-public class DateTimeTypeHandler extends BaseTypeHandler<DateTime> {
-
-	/**
-	 * 设置非空参数值
-	 * 将DateTime对象转换为Timestamp并设置到PreparedStatement中
-	 *
-	 * @param ps        PreparedStatement对象
-	 * @param i         参数索引位置
-	 * @param parameter DateTime参数值
-	 * @param jdbcType  JDBC类型
-	 * @throws SQLException SQL异常
-	 */
-	@Override
-	public void setNonNullParameter(
-		PreparedStatement ps,
-		int i,
-		DateTime parameter,
-		JdbcType jdbcType
-	) throws SQLException {
-		ps.setTimestamp(i, Timestamp.valueOf(parameter.getLocalDateTime()));
-	}
-
-	/**
-	 * 从ResultSet中获取可为空的结果值
-	 * 根据列名获取字符串值并解析为DateTime对象
-	 *
-	 * @param rs         ResultSet对象
-	 * @param columnName 列名
-	 * @return DateTime对象，如果值为null则返回null
-	 * @throws SQLException SQL异常
-	 */
-	@Override
-	public DateTime getNullableResult(ResultSet rs, String columnName)
-		throws SQLException {
-		return parse(rs.getString(columnName));
-	}
-
-	/**
-	 * 从ResultSet中获取可为空的结果值
-	 * 根据列索引获取字符串值并解析为DateTime对象
-	 *
-	 * @param rs          ResultSet对象
-	 * @param columnIndex 列索引
-	 * @return DateTime对象，如果值为null则返回null
-	 * @throws SQLException SQL异常
-	 */
-	@Override
-	public DateTime getNullableResult(ResultSet rs, int columnIndex)
-		throws SQLException {
-		return parse(rs.getString(columnIndex));
-	}
-
-	/**
-	 * 从CallableStatement中获取可为空的结果值
-	 * 根据列索引获取字符串值并解析为DateTime对象
-	 *
-	 * @param cs          CallableStatement对象
-	 * @param columnIndex 列索引
-	 * @return DateTime对象，如果值为null则返回null
-	 * @throws SQLException SQL异常
-	 */
-	@Override
-	public DateTime getNullableResult(CallableStatement cs, int columnIndex)
-		throws SQLException {
-		return parse(cs.getString(columnIndex));
-	}
-
-	/**
-	 * 解析字符串为DateTime对象
-	 *
-	 * @param s 待解析的字符串
-	 * @return DateTime对象，如果字符串为null则返回null
-	 */
-	public DateTime parse(String s) {
-		if (s == null) {
-			return null;
-		}
-		return DateTime.parse(s, Formatter.STANDARD_DATETIME_MILLISECOUND7);
-	}
-
-	/**
-	 * 格式化DateTime对象为字符串
-	 *
-	 * @param t DateTime对象
-	 * @return 格式化后的字符串
-	 */
-	public String format(DateTime t) {
-		return t.format(Formatter.STANDARD_DATETIME_MILLISECOUND7);
-	}
-}

src/main/kotlin/com/mingliqiye/utils/aes/AesUtils.kt

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
  * CurrentFile AesUtils.kt
- * LastUpdate 2025-09-14 18:43:04
+ * LastUpdate 2025-09-19 21:35:53
  * UpdateUser MingLiPro
  */
 
@@ -25,8 +25,7 @@
 
 package com.mingliqiye.utils.aes
 
-import com.mingliqiye.utils.base64.decode
-import com.mingliqiye.utils.base64.encode
+import com.mingliqiye.utils.base.BASE64
 import java.nio.charset.StandardCharsets
 import java.security.GeneralSecurityException
 import java.security.MessageDigest
@@ -72,8 +71,8 @@ fun encrypt(sSrc: String, sKey: String?): String? {
     val encrypted = cipher.doFinal(
         sSrc.toByteArray(StandardCharsets.UTF_8)
     )
-    return encode(
-        "${encode(iv)}:${encode(encrypted)}".toByteArray()
+    return BASE64.encode(
+        "${BASE64.encode(iv)}:${BASE64.encode(encrypted)}".toByteArray()
     )
 }
 
@@ -86,13 +85,13 @@ fun encrypt(sSrc: String, sKey: String?): String? {
 fun decrypt(sSrc: String, sKey: String): String? {
     try {
         // 分割IV和加密数据
-        val sSrcs = String(decode(sSrc))
+        val sSrcs = String(BASE64.decode(sSrc))
         val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
         if (parts.size != 2) {
             return null
         }
-        val iv = decode(parts[0]!!)
-        val encryptedData = decode(parts[1]!!)
+        val iv = BASE64.decode(parts[0]!!)
+        val encryptedData = BASE64.decode(parts[1]!!)
         if (iv.size != GCM_IV_LENGTH) {
             return null
         }
@@ -122,3 +121,4 @@ private fun createSecretKey(sKey: String): SecretKeySpec {
     val digest = md.digest(key)
     return SecretKeySpec(digest, ALGORITHM)
 }
+

src/main/kotlin/com/mingliqiye/utils/base/Base16.kt

@@ -0,0 +1,54 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile Base16.kt
+ * LastUpdate 2025-09-17 10:56:07
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.base
+
+/**
+ * Base16编解码器实现类
+ * 提供字节数组与十六进制字符串之间的相互转换功能
+ */
+class Base16 : BaseCodec {
+    /**
+     * 将字节数组编码为十六进制字符串
+     * @param bytes 待编码的字节数组
+     * @return 编码后的十六进制字符串，每个字节对应两位十六进制字符
+     */
+    override fun encode(bytes: ByteArray): String {
+        // 将每个字节转换为两位十六进制字符串并拼接
+        return bytes.joinToString("") {
+            it.toInt().and(0xff).toString(16).padStart(2, '0')
+        }
+    }
+
+    /**
+     * 将十六进制字符串解码为字节数组
+     * @param string 待解码的十六进制字符串
+     * @return 解码后的字节数组
+     */
+    override fun decode(string: String): ByteArray {
+        // 按每两个字符分组，转换为字节
+        return string.chunked(2).map {
+            it.toInt(16).toByte()
+        }.toByteArray()
+    }
+
+}

src/main/kotlin/com/mingliqiye/utils/base/Base256.kt

@@ -0,0 +1,313 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile Base256.kt
+ * LastUpdate 2025-09-20 14:01:29
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.base
+
+/**
+ * Base256 字符集 256个
+ *
+ * 256个字符 要字符集的下面复制
+ *
+ * !#$%&()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}~§±×÷←↑→↓⇒⇔∀∃∅∆∇∈∉∋∌∏∑−∓∕∗∘∙√∛∜∞∟∠∣∥∧∨∩∪∫∬∭∮∯∰∱∲∳∴∵∶∷≈≠≡≤≥≦≧≪≫≺≻⊂⊃⊆⊇⊈⊉⊊⊋⊕⊖⊗⊘⊙⊚⊛⊜⊝⊞⊟⊠⊡⊢⊣⊤⊥⊦⊧⊨⊩⊪⊫⊬⊭⊮⊯⋀⋁⋂⋃⋄⋅⋆⋇⋈⋉⋊⋋⋌⋍⋎⋏⋐⋑⋒⋓⋔⋕⋖⋗⋘⋙⋚⋛⋜⋝⋞⋟⋠⋡⋢⋣⋤⋥⋦⋧⋨⋩▁▂▃▄▅▆▇█▉▊▋▌▍▎▏▐░▒▓▔▕▖▗▘▙
+ *
+ */
+class Base256 : BaseCodec {
+
+    companion object {
+        val code = arrayOf(
+            '!',
+            '#',
+            '$',
+            '%',
+            '&',
+            '(',
+            ')',
+            '*',
+            '+',
+            ',',
+            '-',
+            '.',
+            '/',
+            '0',
+            '1',
+            '2',
+            '3',
+            '4',
+            '5',
+            '6',
+            '7',
+            '8',
+            '9',
+            ':',
+            ';',
+            '<',
+            '=',
+            '>',
+            '?',
+            '@',
+            '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',
+            '[',
+            ']',
+            '^',
+            '_',
+            '`',
+            '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',
+            '{',
+            '|',
+            '}',
+            '~',
+            '§',
+            '±',
+            '×',
+            '÷',
+            '←',
+            '↑',
+            '→',
+            '↓',
+            '⇒',
+            '⇔',
+            '∀',
+            '∃',
+            '∅',
+            '∆',
+            '∇',
+            '∈',
+            '∉',
+            '∋',
+            '∌',
+            '∏',
+            '∑',
+            '−',
+            '∓',
+            '∕',
+            '∗',
+            '∘',
+            '∙',
+            '√',
+            '∛',
+            '∜',
+            '∞',
+            '∟',
+            '∠',
+            '∣',
+            '∥',
+            '∧',
+            '∨',
+            '∩',
+            '∪',
+            '∫',
+            '∬',
+            '∭',
+            '∮',
+            '∯',
+            '∰',
+            '∱',
+            '∲',
+            '∳',
+            '∴',
+            '∵',
+            '∶',
+            '∷',
+            '≈',
+            '≠',
+            '≡',
+            '≤',
+            '≥',
+            '≦',
+            '≧',
+            '≪',
+            '≫',
+            '≺',
+            '≻',
+            '⊂',
+            '⊃',
+            '⊆',
+            '⊇',
+            '⊈',
+            '⊉',
+            '⊊',
+            '⊋',
+            '⊕',
+            '⊖',
+            '⊗',
+            '⊘',
+            '⊙',
+            '⊚',
+            '⊛',
+            '⊜',
+            '⊝',
+            '⊞',
+            '⊟',
+            '⊠',
+            '⊡',
+            '⊢',
+            '⊣',
+            '⊤',
+            '⊥',
+            '⊦',
+            '⊧',
+            '⊨',
+            '⊩',
+            '⊪',
+            '⊫',
+            '⊬',
+            '⊭',
+            '⊮',
+            '⊯',
+            '⋀',
+            '⋁',
+            '⋂',
+            '⋃',
+            '⋄',
+            '⋅',
+            '⋆',
+            '⋇',
+            '⋈',
+            '⋉',
+            '⋊',
+            '⋋',
+            '⋌',
+            '⋍',
+            '⋎',
+            '⋏',
+            '⋐',
+            '⋑',
+            '⋒',
+            '⋓',
+            '⋔',
+            '⋕',
+            '⋖',
+            '⋗',
+            '⋘',
+            '⋙',
+            '⋚',
+            '⋛',
+            '⋜',
+            '⋝',
+            '⋞',
+            '⋟',
+            '⋠',
+            '⋡',
+            '⋢',
+            '⋣',
+            '⋤',
+            '⋥',
+            '⋦',
+            '⋧',
+            '⋨',
+            '⋩',
+            '▁',
+            '▂',
+            '▃',
+            '▄',
+            '▅',
+            '▆',
+            '▇',
+            '█',
+            '▉',
+            '▊',
+            '▋',
+            '▌',
+            '▍',
+            '▎',
+            '▏',
+            '▐',
+            '░',
+            '▒',
+            '▓',
+            '▔',
+            '▕',
+            '▖',
+            '▗',
+            '▘',
+            '▙'
+        )
+        val codeMap = code.mapIndexed { index, c -> c to index }.toMap()
+    }
+
+    override fun encode(bytes: ByteArray): String {
+        val result = CharArray(bytes.size)
+        for (i in bytes.indices) {
+            val unsignedByte = bytes[i].toInt() and 0xFF
+            result[i] = code[unsignedByte]
+        }
+        return String(result)
+    }
+
+    override fun decode(string: String): ByteArray {
+        val result = ByteArray(string.length)
+        for (i in string.indices) {
+            result[i] = codeMap[string[i]]!!.toByte()
+        }
+        return result
+    }
+}

src/main/kotlin/com/mingliqiye/utils/base/Base64.kt

@@ -0,0 +1,62 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile Base64.kt
+ * LastUpdate 2025-09-17 10:56:32
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.base
+
+/*
+ * Base64编解码工具类
+ * 提供Base64编码和解码功能的实现
+ */
+class Base64 : BaseCodec {
+
+    /*
+     * Base64编码器实例
+     * 用于执行字节数组到Base64字符串的编码操作
+     */
+    val BASE_64_ENCODER: java.util.Base64.Encoder = java.util.Base64.getEncoder()
+
+    /*
+     * Base64解码器实例
+     * 用于执行Base64字符串到字节数组的解码操作
+     */
+    val BASE_64_DECODER: java.util.Base64.Decoder = java.util.Base64.getDecoder()
+
+    /*
+     * 将字节数组编码为Base64字符串
+     *
+     * @param bytes 待编码的字节数组
+     * @return 编码后的Base64字符串
+     */
+    override fun encode(bytes: ByteArray): String {
+        return BASE_64_ENCODER.encodeToString(bytes)
+    }
+
+    /*
+     * 将Base64字符串解码为字节数组
+     *
+     * @param string 待解码的Base64字符串
+     * @return 解码后的字节数组
+     */
+    override fun decode(string: String): ByteArray {
+        return BASE_64_DECODER.decode(string)
+    }
+}

src/main/kotlin/com/mingliqiye/utils/base/Base91.kt

@@ -0,0 +1,404 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile Base91.kt
+ * LastUpdate 2025-09-19 20:08:46
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.base
+
+/**
+ * Base91 编解码工具类，用于将字节数组编码为 Base91 字符串，或将 Base91 字符串解码为原始字节数组。
+ *
+ * Base91 是一种高效的二进制到文本的编码方式，相较于 Base64，它使用更少的字符来表示相同的数据。
+ */
+class Base91 : BaseCodec {
+
+    companion object {
+        /**
+         * Base91 编码表，共 91 个可打印 ASCII 字符。
+         */
+        val ENCODING_TABLE: CharArray = charArrayOf(
+            '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',
+            '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',
+            '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '!', '#', '$',
+            '%', '&', '(', ')', '*', '+', ',', '.', '/', ':', ';', '<', '=',
+            '>', '?', '@', '[', ']', '^', '_', '`', '{', '|', '}', '~', '"'
+        )
+
+        /**
+         * Base91 解码表，大小为 256，用于快速查找字符对应的数值。
+         * 初始化时将所有元素设为 -1，表示无效字符；然后根据 ENCODING_TABLE 填充有效字符的索引。
+         */
+        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,
+            62,
+            90,
+            63,
+            64,
+            65,
+            66,
+            -1,
+            67,
+            68,
+            69,
+            70,
+            71,
+            -1,
+            72,
+            73,
+            52,
+            53,
+            54,
+            55,
+            56,
+            57,
+            58,
+            59,
+            60,
+            61,
+            74,
+            75,
+            76,
+            77,
+            78,
+            79,
+            80,
+            0,
+            1,
+            2,
+            3,
+            4,
+            5,
+            6,
+            7,
+            8,
+            9,
+            10,
+            11,
+            12,
+            13,
+            14,
+            15,
+            16,
+            17,
+            18,
+            19,
+            20,
+            21,
+            22,
+            23,
+            24,
+            25,
+            81,
+            -1,
+            82,
+            83,
+            84,
+            85,
+            26,
+            27,
+            28,
+            29,
+            30,
+            31,
+            32,
+            33,
+            34,
+            35,
+            36,
+            37,
+            38,
+            39,
+            40,
+            41,
+            42,
+            43,
+            44,
+            45,
+            46,
+            47,
+            48,
+            49,
+            50,
+            51,
+            86,
+            87,
+            88,
+            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
+        )
+    }
+
+    /**
+     * 将字节数组编码为 Base91 字符串。
+     *
+     * @param bytes 待编码的字节数组
+     * @return 编码后的 Base91 字符串
+     */
+    override fun encode(bytes: ByteArray): String {
+        if (bytes.isEmpty()) return ""
+        val sb = StringBuilder()
+        var ebq = 0       // 编码缓冲区，用于暂存待处理的位数据
+        var en = 0        // 当前缓冲区中的有效位数
+
+        for (b in bytes) {
+            // 将当前字节加入缓冲区
+            ebq = ebq or ((b.toInt() and 0xFF) shl en)
+            en += 8
+
+            // 每当缓冲区中有超过 13 位的数据时，尝试进行编码
+            if (en > 13) {
+                var ev = ebq and 0x1FFF  // 取出低 13 位作为候选值
+                if (ev > 88) {
+                    // 如果候选值大于 88，则使用 13 位编码
+                    ebq = ebq shr 13
+                    en -= 13
+                } else {
+                    // 否则使用 14 位编码
+                    ev = ebq and 0x3FFF
+                    ebq = ebq shr 14
+                    en -= 14
+                }
+                // 将两个字符追加到结果中
+                sb.append(ENCODING_TABLE[ev % 91])
+                sb.append(ENCODING_TABLE[ev / 91])
+            }
+        }
+
+        // 处理剩余未编码的数据
+        if (en > 0) {
+            sb.append(ENCODING_TABLE[ebq % 91])
+            if (en > 7 || ebq > 90) {
+                sb.append(ENCODING_TABLE[ebq / 91])
+            }
+        }
+
+        return sb.toString()
+    }
+
+    /**
+     * 将 Base91 字符串解码为原始字节数组。
+     *
+     * @param string 待解码的 Base91 字符串
+     * @return 解码后的字节数组
+     */
+    override fun decode(string: String): ByteArray {
+        if (string.isEmpty()) return ByteArray(0)
+        var dbq = 0       // 解码缓冲区，用于暂存待处理的位数据
+        var dn = 0        // 当前缓冲区中的有效位数
+        var dv = -1       // 当前读取到的 Base91 值
+        val buffer = ByteArray(string.length * 13 / 8)  // 预分配输出缓冲区
+        var index = 0     // 输出缓冲区写入位置
+
+        for (c in string.toCharArray()) {
+            // 忽略不在编码表中的字符
+            if (DECODING_TABLE[c.code] == -1) continue
+
+            if (dv == -1) {
+                // 第一次读取字符，保存为 dv
+                dv = DECODING_TABLE[c.code]
+            } else {
+                // 第二次读取字符，组合成完整的 Base91 值
+                dv += DECODING_TABLE[c.code] * 91
+                dbq = dbq or (dv shl dn)
+                // 根据值大小判断是 13 位还是 14 位编码
+                dn += if ((dv and 0x1FFF) > 88) 13 else 14
+
+                // 将缓冲区中完整的字节写入输出数组
+                do {
+                    buffer[index++] = (dbq and 0xFF).toByte()
+                    dbq = dbq shr 8
+                    dn -= 8
+                } while (dn > 7)
+
+                dv = -1  // 重置 dv，准备下一轮读取
+            }
+        }
+
+        // 处理最后剩余的一个字符（如果存在）
+        if (dv != -1) {
+            buffer[index++] = ((dbq or (dv shl dn)) and 0xFF).toByte()
+        }
+
+        // 返回实际使用的部分
+        return buffer.copyOf(index)
+    }
+}

src/main/kotlin/com/mingliqiye/utils/base/BaseCodec.kt

@@ -0,0 +1,173 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile BaseCodec.kt
+ * LastUpdate 2025-09-18 14:07:35
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.base
+
+import java.io.File
+import java.io.IOException
+import java.nio.file.Path
+
+interface BaseCodec {
+    /**
+     * 将字节数组编码为Base64字符串
+     *
+     * @param bytes 需要编码的字节数组
+     * @return 编码后的Base64字符串
+     */
+    fun encode(bytes: ByteArray): String
+
+    /**
+     * 将Base64字符串解码为字节数组
+     *
+     * @param string 需要解码的Base64字符串
+     * @return 解码后的字节数组
+     */
+    fun decode(string: String): ByteArray
+
+    /**
+     * 将文件内容编码为Base64字符串
+     *
+     * @param file 需要编码的文件
+     * @return 文件内容的Base64编码字符串
+     * @throws IOException 当文件读取失败时抛出
+     */
+    @Throws(IOException::class)
+    fun encode(file: File): String {
+        return encode(file.readBytes())
+    }
+
+    /**
+     * 将Base64字符串解码并写入文件
+     *
+     * @param file 目标文件
+     * @param string 需要解码的Base64字符串
+     * @throws IOException 当文件写入失败时抛出
+     */
+    @Throws(IOException::class)
+    fun decode(file: File, string: String) {
+        file.writeBytes(decode(string))
+    }
+
+    /**
+     * 安全地将文件内容编码为Base64字符串，出现异常时返回null
+     *
+     * @param file 需要编码的文件
+     * @return 文件内容的Base64编码字符串，失败时返回null
+     */
+    fun encodeSafe(file: File): String? {
+        return try {
+            encode(file)
+        } catch (_: Exception) {
+            null
+        }
+    }
+
+    /**
+     * 安全地将Base64字符串解码并写入文件，返回操作是否成功
+     *
+     * @param file 目标文件
+     * @param string 需要解码的Base64字符串
+     * @return 操作成功返回true，失败返回false
+     */
+    fun decodeSafe(file: File, string: String): Boolean {
+        return try {
+            decode(file, string)
+            true
+        } catch (_: Exception) {
+            false
+        }
+    }
+
+    /**
+     * 将路径对应的文件内容编码为Base64字符串
+     *
+     * @param path 需要编码的文件路径
+     * @return 文件内容的Base64编码字符串
+     * @throws IOException 当文件读取失败时抛出
+     */
+    @Throws(IOException::class)
+    fun encode(path: Path): String {
+        return encode(path.toFile().readBytes())
+    }
+
+    /**
+     * 将Base64字符串解码并写入路径指定的文件
+     *
+     * @param path 目标文件路径
+     * @param string 需要解码的Base64字符串
+     * @throws IOException 当文件写入失败时抛出
+     */
+    @Throws(IOException::class)
+    fun decode(path: Path, string: String) {
+        path.toFile().writeBytes(decode(string))
+    }
+
+    /**
+     * 安全地将路径对应的文件内容编码为Base64字符串，出现异常时返回null
+     *
+     * @param path 需要编码的文件路径
+     * @return 文件内容的Base64编码字符串，失败时返回null
+     */
+    fun encodeSafe(path: Path): String? {
+        return try {
+            encode(path)
+        } catch (_: Exception) {
+            null
+        }
+    }
+
+    /**
+     * 安全地将Base64字符串解码并写入路径指定的文件，返回操作是否成功
+     *
+     * @param path 目标文件路径
+     * @param string 需要解码的Base64字符串
+     * @return 操作成功返回true，失败返回false
+     */
+    fun decodeSafe(path: Path, string: String): Boolean {
+        return try {
+            decode(path, string)
+            true
+        } catch (_: Exception) {
+            false
+        }
+    }
+
+    /**
+     * 将字符串编码为Base64字符串
+     *
+     * @param string 需要编码的字符串
+     * @return 编码后的Base64字符串
+     */
+    fun encode(string: String): String {
+        return encode(string.toByteArray())
+    }
+
+    /**
+     * 将Base64字符串解码为字符串
+     *
+     * @param string 需要解码的Base64字符串
+     * @return 解码后的字符串
+     */
+    fun decodetoString(string: String): String {
+        return decode(string).toString(Charsets.UTF_8)
+    }
+}

src/main/kotlin/com/mingliqiye/utils/base/BaseUtils.kt

@@ -0,0 +1,63 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile BaseUtils.kt
+ * LastUpdate 2025-09-19 20:18:09
+ * UpdateUser MingLiPro
+ */
+
+@file:JvmName("BaseUtils")
+
+package com.mingliqiye.utils.base
+
+/**
+ * Base64编解码器实例
+ * 使用懒加载方式初始化Base64编解码器对象
+ * 保证线程安全且只在首次访问时创建实例
+ */
+val BASE64: BaseCodec by lazy {
+    Base64()
+}
+
+/**
+ * Base91编解码器实例
+ * 使用懒加载方式初始化Base91编解码器对象
+ * 保证线程安全且只在首次访问时创建实例
+ */
+val BASE91: BaseCodec by lazy {
+    Base91()
+}
+
+/**
+ * Base91编解码器实例
+ * 使用懒加载方式初始化Base91编解码器对象
+ * 保证线程安全且只在首次访问时创建实例
+ */
+val BASE16: BaseCodec by lazy {
+    Base16()
+}
+
+/**
+ * Base256编解码器实例
+ * 使用懒加载方式初始化Base256编解码器对象
+ * 保证线程安全且只在首次访问时创建实例
+ */
+val BASE256: BaseCodec by lazy {
+    Base256()
+}
+
+

src/main/kotlin/com/mingliqiye/utils/base64/Base64Utils.kt

@@ -1,160 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Base64Utils.kt
- * LastUpdate 2025-09-14 18:44:22
- * UpdateUser MingLiPro
- */
-@file:JvmName("Base64Utils")
-
-package com.mingliqiye.utils.base64
-
-import java.io.File
-import java.io.IOException
-import java.nio.file.Path
-import java.util.*
-
-val BASE_64_ENCODER: Base64.Encoder = Base64.getEncoder()
-val BASE_64_DECODER: Base64.Decoder = Base64.getDecoder()
-
-/**
- * 将字节数组编码为Base64字符串
- *
- * @param bytes 需要编码的字节数组
- * @return 编码后的Base64字符串
- */
-fun encode(bytes: ByteArray): String {
-    return BASE_64_ENCODER.encodeToString(bytes)
-}
-
-/**
- * 将Base64字符串解码为字节数组
- *
- * @param string 需要解码的Base64字符串
- * @return 解码后的字节数组
- */
-fun decode(string: String): ByteArray {
-    return BASE_64_DECODER.decode(string)
-}
-
-/**
- * 将文件内容编码为Base64字符串
- *
- * @param file 需要编码的文件
- * @return 文件内容的Base64编码字符串
- * @throws IOException 当文件读取失败时抛出
- */
-@Throws(IOException::class)
-fun encode(file: File): String {
-    return encode(file.readBytes())
-}
-
-/**
- * 将Base64字符串解码并写入文件
- *
- * @param file 目标文件
- * @param string 需要解码的Base64字符串
- * @throws IOException 当文件写入失败时抛出
- */
-@Throws(IOException::class)
-fun decode(file: File, string: String) {
-    file.writeBytes(decode(string))
-}
-
-/**
- * 安全地将文件内容编码为Base64字符串，出现异常时返回null
- *
- * @param file 需要编码的文件
- * @return 文件内容的Base64编码字符串，失败时返回null
- */
-fun encodeSafe(file: File): String? {
-    return try {
-        encode(file)
-    } catch (_: Exception) {
-        null
-    }
-}
-
-/**
- * 安全地将Base64字符串解码并写入文件，返回操作是否成功
- *
- * @param file 目标文件
- * @param string 需要解码的Base64字符串
- * @return 操作成功返回true，失败返回false
- */
-fun decodeSafe(file: File, string: String): Boolean {
-    return try {
-        decode(file, string)
-        true
-    } catch (_: Exception) {
-        false
-    }
-}
-
-/**
- * 将路径对应的文件内容编码为Base64字符串
- *
- * @param path 需要编码的文件路径
- * @return 文件内容的Base64编码字符串
- * @throws IOException 当文件读取失败时抛出
- */
-@Throws(IOException::class)
-fun encode(path: Path): String {
-    return encode(path.toFile().readBytes())
-}
-
-/**
- * 将Base64字符串解码并写入路径指定的文件
- *
- * @param path 目标文件路径
- * @param string 需要解码的Base64字符串
- * @throws IOException 当文件写入失败时抛出
- */
-@Throws(IOException::class)
-fun decode(path: Path, string: String) {
-    path.toFile().writeBytes(decode(string))
-}
-
-/**
- * 安全地将路径对应的文件内容编码为Base64字符串，出现异常时返回null
- *
- * @param path 需要编码的文件路径
- * @return 文件内容的Base64编码字符串，失败时返回null
- */
-fun encodeSafe(path: Path): String? {
-    return try {
-        encode(path)
-    } catch (_: Exception) {
-        null
-    }
-}
-
-/**
- * 安全地将Base64字符串解码并写入路径指定的文件，返回操作是否成功
- *
- * @param path 目标文件路径
- * @param string 需要解码的Base64字符串
- * @return 操作成功返回true，失败返回false
- */
-fun decodeSafe(path: Path, string: String): Boolean {
-    return try {
-        decode(path, string)
-        true
-    } catch (_: Exception) {
-        false
-    }
-}

src/main/kotlin/com/mingliqiye/utils/bcrypt/BCrypt.kt

@@ -0,0 +1,59 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile BCrypt.kt
+ * LastUpdate 2025-09-19 20:17:41
+ * UpdateUser MingLiPro
+ */
+
+@file:JvmName("BCrypt")
+
+package com.mingliqiye.utils.bcrypt
+
+
+import java.security.SecureRandom
+import org.mindrot.jbcrypt.BCrypt as JBCrypt
+
+
+fun hashpw(string: String): String {
+    return hashpw(string, gensalt())
+}
+
+
+fun hashpw(string: String, salt: String = gensalt()): String {
+    return JBCrypt.hashpw(string, salt)
+}
+
+
+fun checkpw(string: String, bcrypted: String): Boolean {
+    return JBCrypt.checkpw(string, bcrypted)
+}
+
+
+fun gensalt(): String {
+    return JBCrypt.gensalt()
+}
+
+
+fun gensalt(long: Int): String {
+    return JBCrypt.gensalt(long)
+}
+
+
+fun gensalt(long: Int, secureRandom: SecureRandom): String {
+    return JBCrypt.gensalt(long, secureRandom)
+}

src/main/kotlin/com/mingliqiye/utils/bean/Factory.kt

@@ -1,241 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile Factory.kt
- * LastUpdate 2025-09-14 19:09:28
- * UpdateUser MingLiPro
- */
-@file:JvmName("Factory")
-
-package com.mingliqiye.utils.bean
-
-import com.mingliqiye.utils.bean.annotation.ComponentBean
-import com.mingliqiye.utils.bean.annotation.InjectBean
-import java.io.File
-import java.net.URL
-import java.util.*
-import java.util.concurrent.ConcurrentHashMap
-import kotlin.reflect.KClass
-
-/**
- * 存储所有已注册的Bean实例，键为Bean名称，值为Bean实例
- */
-private val BEANS: ConcurrentHashMap<String, Any> = ConcurrentHashMap()
-
-/**
- * 存储按类型查找的Bean实例，键为Bean的Class对象，值为Bean实例
- */
-private val TYPE_BEANS: ConcurrentHashMap<KClass<*>, Any> = ConcurrentHashMap()
-
-/**
- * 自动扫描指定类所在包下的所有类并注册为Bean
- *
- * @param c 指定的类，用于获取其所在的包
- * @throws IllegalArgumentException 如果传入的类为null或位于默认包中
- */
-fun autoScan(c: Class<*>?) {
-    if (c == null) {
-        throw IllegalArgumentException("Class cannot be null")
-    }
-    val pkg = c.`package`
-    if (pkg == null) {
-        throw IllegalArgumentException("Class is in the default package")
-    }
-    scan(pkg.name)
-}
-
-/**
- * 扫描指定包路径下的所有类文件，并注册其中带有@ComponentBean注解的类为Bean
- *
- * @param basePackage 要扫描的基础包名
- * @throws RuntimeException 如果在扫描过程中发生异常
- */
-fun scan(basePackage: String) {
-    try {
-        val path = basePackage.replace('.', '/')
-        val classLoader = Thread.currentThread().contextClassLoader
-        val resources: Enumeration<URL> = classLoader.getResources(path)
-        while (resources.hasMoreElements()) {
-            val resource = resources.nextElement()
-            val file = File(resource.toURI())
-            scanDirectory(file, basePackage)
-        }
-        injectDependencies()
-    } catch (e: Exception) {
-        throw RuntimeException(e)
-    }
-}
-
-/**
- * 递归扫描目录中的所有类文件，并注册符合条件的类为Bean
- *
- * @param directory   当前要扫描的目录
- * @param packageName 当前目录对应的包名
- * @throws Exception 如果在扫描或类加载过程中发生异常
- */
-private fun scanDirectory(directory: File, packageName: String) {
-    val files = directory.listFiles() ?: return
-
-    for (file in files) {
-        if (file.isDirectory) {
-            scanDirectory(file, "$packageName.${file.name}")
-        } else if (file.name.endsWith(".class")) {
-            val className = packageName + '.' + file.name.replace(".class", "")
-            registerComponent(Class.forName(className))
-        }
-    }
-}
-
-/**
- * 注册一个带有@ComponentBean注解的类为Bean实例
- *
- * @param clazz 要注册的类
- * @throws Exception 如果在实例化类或处理注解时发生异常
- */
-private fun registerComponent(clazz: Class<*>) {
-    if (clazz.isAnnotationPresent(ComponentBean::class.java)) {
-        val component = clazz.getAnnotation(ComponentBean::class.java)
-        val name = component.value.ifEmpty { clazz.name }
-        val instance = clazz.getDeclaredConstructor().newInstance()
-        BEANS[name] = instance
-        val kClass = clazz.kotlin
-        TYPE_BEANS[kClass] = instance
-
-        for (interfaceClass in clazz.interfaces) {
-            TYPE_BEANS.putIfAbsent(interfaceClass.kotlin, instance)
-        }
-    }
-}
-
-/**
- * 对所有已注册的Bean进行依赖注入处理
- *
- * @throws Exception 如果在注入过程中发生异常
- */
-private fun injectDependencies() {
-    for (bean in BEANS.values) {
-        for (field in bean.javaClass.declaredFields) {
-            if (field.isAnnotationPresent(InjectBean::class.java)) {
-                val inject = field.getAnnotation(InjectBean::class.java)
-                val dependency = findDependency(field.type, inject.value)
-                if (dependency == null) {
-                    throw IllegalStateException(
-                        "No suitable dependency found for field " + field.name + " in class " + bean.javaClass.name
-                    )
-                }
-                field.isAccessible = true
-                field.set(bean, dependency)
-            }
-        }
-    }
-}
-
-/**
- * 根据类型和名称查找对应的依赖实例
- *
- * @param type 依赖的类型
- * @param name 依赖的名称（可为空）
- * @return 找到的依赖实例，未找到则返回null
- */
-private fun findDependency(type: Class<*>, name: String): Any? {
-    if (name.isNotEmpty()) {
-        return BEANS[name]
-    }
-
-    val dependency = TYPE_BEANS[type.kotlin]
-    if (dependency != null) {
-        return dependency
-    }
-
-    for (interfaceType in TYPE_BEANS.keys) {
-        if (type.isAssignableFrom(interfaceType.java)) {
-            return TYPE_BEANS[interfaceType]
-        }
-    }
-
-    return null
-}
-
-/**
- * 将一个对象添加到Bean容器中，使用其类名作为键
- *
- * @param obj 要添加的对象
- * @throws RuntimeException 如果在注入依赖时发生异常
- */
-fun add(obj: Any) {
-    val clazz = obj.javaClass
-    val name = clazz.name
-    BEANS[name] = obj
-    TYPE_BEANS[clazz.kotlin] = obj
-    try {
-        injectDependencies()
-    } catch (e: Exception) {
-        throw RuntimeException(e)
-    }
-}
-
-/**
- * 将一个对象以指定名称添加到Bean容器中
- *
- * @param name   Bean的名称
- * @param obj 要添加的对象
- * @throws RuntimeException 如果在注入依赖时发生异常
- */
-fun add(name: String, obj: Any) {
-    BEANS[name] = obj
-    TYPE_BEANS[obj.javaClass.kotlin] = obj
-    try {
-        injectDependencies()
-    } catch (e: Exception) {
-        throw RuntimeException(e)
-    }
-}
-
-/**
- * 根据类型获取对应的Bean实例
- *
- * @param objclass Bean的类型
- * @param T      Bean的泛型类型
- * @return 对应类型的Bean实例，未找到则返回null
- */
-@Suppress("UNCHECKED_CAST")
-fun <T : Any> get(objclass: KClass<T>): T? {
-    return TYPE_BEANS[objclass] as? T
-}
-
-/**
- * 根据名称和类型获取对应的Bean实例
- *
- * @param name     Bean的名称
- * @param objclass Bean的类型
- * @param T      Bean的泛型类型
- * @return 对应名称和类型的Bean实例，未找到则返回null
- */
-@Suppress("UNCHECKED_CAST")
-fun <T : Any> get(name: String, objclass: KClass<T>): T? {
-    return BEANS[name] as? T
-}
-
-/**
- * 根据名称获取对应的Bean实例
- *
- * @param name Bean的名称
- * @return 对应名称的Bean实例，未找到则返回null
- */
-fun get(name: String): Any? {
-    return BEANS[name]
-}

src/main/kotlin/com/mingliqiye/utils/bean/annotation/ComponentBean.kt

@@ -1,43 +0,0 @@
-/*
- * Copyright 2025 mingliqiye
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- *
- * ProjectName mingli-utils
- * ModuleName mingli-utils.main
- * CurrentFile ComponentBean.kt
- * LastUpdate 2025-09-14 18:48:59
- * UpdateUser MingLiPro
- */
-
-package com.mingliqiye.utils.bean.annotation
-
-import kotlin.annotation.AnnotationRetention.RUNTIME
-import kotlin.annotation.AnnotationTarget.CLASS
-import kotlin.annotation.AnnotationTarget.FIELD
-
-/**
- * 组件bean注解
- * @author MingLiPro
- */
-@Retention(RUNTIME)
-@Target(CLASS)
-annotation class ComponentBean(val value: String = "")
-
-/**
- * 注入bean注解
- * @author MingLiPro
- */
-@Retention(RUNTIME)
-@Target(FIELD)
-annotation class InjectBean(val value: String = "")

src/main/kotlin/com/mingliqiye/utils/bytes/ByteUtils.kt

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
  * CurrentFile ByteUtils.kt
- * LastUpdate 2025-09-15 00:07:22
+ * LastUpdate 2025-09-20 11:49:05
  * UpdateUser MingLiPro
  */
 @file:JvmName("ByteUtils")
@@ -41,8 +41,20 @@ const val ESC_RESERVED: Byte = 0x06
  * @return 包含每个字节对应十六进制字符串的列表
  */
 fun ByteArray.getByteArrayString(): MutableList<String> {
-    return this.toList().stream()
-        .map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
-        .collect(SuperStream.Collectors.toList())
+    return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
+        .collect(SuperStream.toList()) as MutableList<String>
 }
 
+
+fun Char.hexDigitToValue(): Int {
+    return when (this) {
+        in '0'..'9' -> this - '0'
+        in 'A'..'F' -> this - 'A' + 10
+        in 'a'..'f' -> this - 'a' + 10
+        else -> throw NumberFormatException("Invalid hex character: $this")
+    }
+}
+
+private fun hexStringToByteArray(string: String): ByteArray {
+    return string.hexToByteArray()
+}

src/main/kotlin/com/mingliqiye/utils/clone/CloneUtils.kt

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
  * CurrentFile CloneUtils.kt
- * LastUpdate 2025-09-15 09:30:37
+ * LastUpdate 2025-09-20 14:01:29
  * UpdateUser MingLiPro
  */
 @file:JvmName("CloneUtils")
@@ -38,8 +38,7 @@ inline fun <reified T> T.deepJsonClone(jsonApi: JsonApi): T {
 
     } catch (e: Exception) {
         throw JsonException(
-            "Failed to deep clone object using JSON",
-            e
+            "Failed to deep clone object using JSON", e
         )
     }
 }

src/main/kotlin/com/mingliqiye/utils/collection/Collection.kt

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
  * CurrentFile Collection.kt
- * LastUpdate 2025-09-15 09:30:37
+ * LastUpdate 2025-09-21 14:36:57
  * UpdateUser MingLiPro
  */
 
@@ -26,33 +26,72 @@ package com.mingliqiye.utils.collection
 
 import com.mingliqiye.utils.stream.SuperStream
 import java.util.*
+import java.util.stream.Collectors
 
 
+/**
+ * 将当前集合转换为数组。
+ *
+ * @param T 集合元素类型
+ * @return 转换后的数组
+ */
 inline fun <reified T> Collection<T>.toArray(): Array<T> {
     return arrayOf(*this.toTypedArray())
 }
 
+/**
+ * 将当前集合转换为 Map，其中键为集合元素本身，值由给定函数生成。
+ *
+ * @param T 集合元素类型
+ * @param V 映射值的类型
+ * @param v 用于生成映射值的函数
+ * @return 转换后的 Map
+ */
+@Suppress("UNCHECKED_CAST")
 inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
     return this.stream().collect(
-        SuperStream.Collectors.toMap(
-            SuperStream.Collectors::getThis, v
-        )
+        SuperStream.toMap(
+            v
         )
+    ) as Map<T, V>
 }
 
+/**
+ * 将当前集合转换为 Map，其中键和值分别由给定函数生成。
+ *
+ * @param T 集合元素类型
+ * @param V 映射值的类型
+ * @param K 映射键的类型
+ * @param k 用于生成映射键的函数
+ * @param v 用于生成映射值的函数
+ * @return 转换后的 Map
+ */
 inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> {
     return this.stream().collect(
-        SuperStream.Collectors.toMap(
+        Collectors.toMap(
             k, v
         )
     )
 }
 
+/**
+ * 将数组转换为 Set。
+ *
+ * @param T 数组元素类型
+ * @param array 输入数组
+ * @return 转换后的 Set
+ */
 fun <T> toSet(array: Array<T>): Set<T> {
     return array.toSet()
 }
 
 
+/**
+ * 获取集合中的第一个元素，如果集合为空则返回 null。
+ *
+ * @param T 集合元素类型
+ * @return 第一个元素或 null
+ */
 inline fun <reified T> Collection<T>.getFirst(): T? {
     if (this.isEmpty()) {
         return null
@@ -63,6 +102,12 @@ inline fun <reified T> Collection<T>.getFirst(): T? {
     return this.iterator().next()
 }
 
+/**
+ * 获取数组中的第一个元素，如果数组为空则返回 null。
+ *
+ * @param T 数组元素类型
+ * @return 第一个元素或 null
+ */
 inline fun <reified T> Array<T>.getFirst(): T? {
     if (this.isEmpty()) {
         return null
@@ -70,6 +115,12 @@ inline fun <reified T> Array<T>.getFirst(): T? {
     return this.first()
 }
 
+/**
+ * 获取集合中的最后一个元素，如果集合为空则返回 null。
+ *
+ * @param T 集合元素类型
+ * @return 最后一个元素或 null
+ */
 inline fun <reified T> Collection<T>.getLast(): T? {
     if (this.isEmpty()) {
         return null
@@ -84,6 +135,12 @@ inline fun <reified T> Collection<T>.getLast(): T? {
     return lastElement
 }
 
+/**
+ * 获取数组中的最后一个元素，如果数组为空则返回 null。
+ *
+ * @param T 数组元素类型
+ * @return 最后一个元素或 null
+ */
 inline fun <reified T> Array<T>.getLast(): T? {
     if (this.isEmpty()) {
         return null
@@ -92,6 +149,14 @@ inline fun <reified T> Array<T>.getLast(): T? {
 }
 
 
+/**
+ * 根据索引获取集合中的元素，若索引越界则返回默认值。
+ *
+ * @param T 集合元素类型
+ * @param index 索引位置
+ * @param defaultValue 默认返回值
+ * @return 指定索引处的元素或默认值
+ */
 inline fun <reified T> Collection<T>.getOrDefault(
     index: Int, defaultValue: T
 ): T {
@@ -111,54 +176,135 @@ inline fun <reified T> Collection<T>.getOrDefault(
     return defaultValue
 }
 
+/**
+ * 创建一个新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayList(): ArrayList<T> {
     return ArrayList()
 }
 
+/**
+ * 创建一个指定初始容量的新 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param size 初始容量大小
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayList(size: Int): ArrayList<T> {
     return ArrayList()
 }
 
+/**
+ * 使用可变参数创建一个新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayList(vararg elements: T): ArrayList<T> {
     return newArrayList(elements.asList())
 }
 
+/**
+ * 将当前集合转换为新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 ArrayList
+ */
 fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
     return newArrayList(this)
 }
 
+/**
+ * 将数组转换为新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入数组
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
     return newArrayList(elements.asList())
 }
 
+/**
+ * 将集合转换为新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将 Iterable 转换为新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Iterable
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
     return newArrayList(elements.toList())
 }
 
+/**
+ * 将 Sequence 转换为新的 ArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Sequence
+ * @return 新创建的 ArrayList
+ */
 fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
     return newArrayList(elements.toList())
 }
 
+/**
+ * 创建一个新的 LinkedList 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 LinkedList
+ */
 fun <T> newLinkedList(): LinkedList<T> {
     return LinkedList()
 }
 
+/**
+ * 使用可变参数创建一个新的 LinkedList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 LinkedList
+ */
 fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
     val list = newLinkedList<T>()
     list.addAll(elements.asList())
     return list
 }
 
+/**
+ * 将集合转换为新的 LinkedList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 LinkedList
+ */
 fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
     val list = newLinkedList<T>()
     list.addAll(elements)
     return list
 }
 
+/**
+ * 将 Iterable 转换为新的 LinkedList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Iterable
+ * @return 新创建的 LinkedList
+ */
 fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
     val list = newLinkedList<T>()
     for (element in elements) {
@@ -167,26 +313,60 @@ fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
     return list
 }
 
+/**
+ * 将 Sequence 转换为新的 LinkedList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Sequence
+ * @return 新创建的 LinkedList
+ */
 fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
     return newLinkedList(elements.toList())
 }
 
+/**
+ * 创建一个新的 Vector 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 Vector
+ */
 fun <T> newVector(): Vector<T> {
     return Vector()
 }
 
+/**
+ * 使用可变参数创建一个新的 Vector 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 Vector
+ */
 fun <T> newVector(vararg elements: T): Vector<T> {
     val vector = newVector<T>()
     vector.addAll(elements.asList())
     return vector
 }
 
+/**
+ * 将集合转换为新的 Vector 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 Vector
+ */
 fun <T> newVector(elements: Collection<T>): Vector<T> {
     val vector = newVector<T>()
     vector.addAll(elements)
     return vector
 }
 
+/**
+ * 将 Iterable 转换为新的 Vector 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Iterable
+ * @return 新创建的 Vector
+ */
 fun <T> newVector(elements: Iterable<T>): Vector<T> {
     val vector = newVector<T>()
     for (element in elements) {
@@ -195,31 +375,72 @@ fun <T> newVector(elements: Iterable<T>): Vector<T> {
     return vector
 }
 
+/**
+ * 将 Sequence 转换为新的 Vector 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Sequence
+ * @return 新创建的 Vector
+ */
 fun <T> newVector(elements: Sequence<T>): Vector<T> {
     return newVector(elements.toList())
 }
 
 
+/**
+ * 创建一个新的 HashSet 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 HashSet
+ */
 fun <T> newHashSet(): HashSet<T> {
     return HashSet()
 }
 
+/**
+ * 创建一个指定初始容量的新 HashSet 实例。
+ *
+ * @param T 元素类型
+ * @param size 初始容量大小
+ * @return 新创建的 HashSet
+ */
 fun <T> newHashSet(size: Int): HashSet<T> {
     return HashSet(size)
 }
 
+/**
+ * 使用可变参数创建一个新的 HashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 HashSet
+ */
 fun <T> newHashSet(vararg elements: T): HashSet<T> {
     val set = newHashSet<T>()
     set.addAll(elements.asList())
     return set
 }
 
+/**
+ * 将集合转换为新的 HashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 HashSet
+ */
 fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
     val set = newHashSet<T>()
     set.addAll(elements)
     return set
 }
 
+/**
+ * 将 Iterable 转换为新的 HashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Iterable
+ * @return 新创建的 HashSet
+ */
 fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
     val set = newHashSet<T>()
     for (element in elements) {
@@ -228,30 +449,71 @@ fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
     return set
 }
 
+/**
+ * 将 Sequence 转换为新的 HashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Sequence
+ * @return 新创建的 HashSet
+ */
 fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
     return newHashSet(elements.toSet())
 }
 
+/**
+ * 创建一个新的 LinkedHashSet 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 LinkedHashSet
+ */
 fun <T> newLinkedHashSet(): LinkedHashSet<T> {
     return LinkedHashSet()
 }
 
+/**
+ * 创建一个指定初始容量的新 LinkedHashSet 实例。
+ *
+ * @param T 元素类型
+ * @param size 初始容量大小
+ * @return 新创建的 LinkedHashSet
+ */
 fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
     return LinkedHashSet(size)
 }
 
+/**
+ * 使用可变参数创建一个新的 LinkedHashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 LinkedHashSet
+ */
 fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
     val set = newLinkedHashSet<T>()
     set.addAll(elements.asList())
     return set
 }
 
+/**
+ * 将集合转换为新的 LinkedHashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 LinkedHashSet
+ */
 fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
     val set = newLinkedHashSet<T>()
     set.addAll(elements)
     return set
 }
 
+/**
+ * 将 Iterable 转换为新的 LinkedHashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Iterable
+ * @return 新创建的 LinkedHashSet
+ */
 fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
     val set = newLinkedHashSet<T>()
     for (element in elements) {
@@ -260,26 +522,60 @@ fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
     return set
 }
 
+/**
+ * 将 Sequence 转换为新的 LinkedHashSet 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入 Sequence
+ * @return 新创建的 LinkedHashSet
+ */
 fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
     return newLinkedHashSet(elements.toSet())
 }
 
+/**
+ * 创建一个新的 TreeSet 实例。
+ *
+ * @param T 元素类型，必须实现 Comparable 接口
+ * @return 新创建的 TreeSet
+ */
 fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
     return TreeSet()
 }
 
+/**
+ * 使用可变参数创建一个新的 TreeSet 实例。
+ *
+ * @param T 元素类型，必须实现 Comparable 接口
+ * @param elements 可变参数列表
+ * @return 新创建的 TreeSet
+ */
 fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
     val set = newTreeSet<T>()
     set.addAll(elements.asList())
     return set
 }
 
+/**
+ * 将集合转换为新的 TreeSet 实例。
+ *
+ * @param T 元素类型，必须实现 Comparable 接口
+ * @param elements 输入集合
+ * @return 新创建的 TreeSet
+ */
 fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
     val set = newTreeSet<T>()
     set.addAll(elements)
     return set
 }
 
+/**
+ * 将 Iterable 转换为新的 TreeSet 实例。
+ *
+ * @param T 元素类型，必须实现 Comparable 接口
+ * @param elements 输入 Iterable
+ * @return 新创建的 TreeSet
+ */
 fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
     val set = newTreeSet<T>()
     for (element in elements) {
@@ -288,65 +584,160 @@ fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
     return set
 }
 
+/**
+ * 将 Sequence 转换为新的 TreeSet 实例。
+ *
+ * @param T 元素类型，必须实现 Comparable 接口
+ * @param elements 输入 Sequence
+ * @return 新创建的 TreeSet
+ */
 fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
     return newTreeSet(elements.toSet())
 }
 
 
+/**
+ * 将字节数组转换为 ArrayList。
+ *
+ * @param elements 输入字节数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将短整型数组转换为 ArrayList。
+ *
+ * @param elements 输入短整型数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: ShortArray): ArrayList<Short> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将整型数组转换为 ArrayList。
+ *
+ * @param elements 输入整型数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: IntArray): ArrayList<Int> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将长整型数组转换为 ArrayList。
+ *
+ * @param elements 输入长整型数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: LongArray): ArrayList<Long> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将浮点数组转换为 ArrayList。
+ *
+ * @param elements 输入浮点数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: FloatArray): ArrayList<Float> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将双精度浮点数组转换为 ArrayList。
+ *
+ * @param elements 输入双精度浮点数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将布尔数组转换为 ArrayList。
+ *
+ * @param elements 输入布尔数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 将字符数组转换为 ArrayList。
+ *
+ * @param elements 输入字符数组
+ * @return 转换后的 ArrayList
+ */
 fun newArrayLists(elements: CharArray): ArrayList<Char> {
     return ArrayList(elements.toList())
 }
 
+/**
+ * 创建一个新的 CopyOnWriteArrayList 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 CopyOnWriteArrayList
+ */
 fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> {
     return java.util.concurrent.CopyOnWriteArrayList()
 }
 
+/**
+ * 使用可变参数创建一个新的 CopyOnWriteArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 CopyOnWriteArrayList
+ */
 fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> {
     return java.util.concurrent.CopyOnWriteArrayList(elements.asList())
 }
 
+/**
+ * 将集合转换为新的 CopyOnWriteArrayList 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 CopyOnWriteArrayList
+ */
 fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> {
     return java.util.concurrent.CopyOnWriteArrayList(elements)
 }
 
+/**
+ * 创建一个新的 Stack 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 Stack
+ */
 fun <T> newStack(): Stack<T> {
     return Stack()
 }
 
+/**
+ * 使用可变参数创建一个新的 Stack 实例。
+ *
+ * @param T 元素类型
+ * @param elements 可变参数列表
+ * @return 新创建的 Stack
+ */
 fun <T> newStack(vararg elements: T): Stack<T> {
     val stack = newStack<T>()
     stack.addAll(elements.asList())
     return stack
 }
 
+/**
+ * 将集合转换为新的 Stack 实例。
+ *
+ * @param T 元素类型
+ * @param elements 输入集合
+ * @return 新创建的 Stack
+ */
 fun <T> newStack(elements: Collection<T>): Stack<T> {
     val stack = newStack<T>()
     stack.addAll(elements)
@@ -354,22 +745,53 @@ fun <T> newStack(elements: Collection<T>): Stack<T> {
 
 }
 
+/**
+ * 创建一个新的 TreeSet 实例，并指定比较器。
+ *
+ * @param T 元素类型
+ * @param comparator 用于排序的比较器
+ * @return 新创建的 TreeSet
+ */
 fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
     return TreeSet(comparator)
 }
 
+/**
+ * 使用可变参数创建一个新的 TreeSet 实例，并指定比较器。
+ *
+ * @param T 元素类型
+ * @param comparator 用于排序的比较器
+ * @param elements 可变参数列表
+ * @return 新创建的 TreeSet
+ */
 fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
     val set = newTreeSet(comparator)
     set.addAll(elements.asList())
     return set
 }
 
+/**
+ * 将集合转换为新的 TreeSet 实例，并指定比较器。
+ *
+ * @param T 元素类型
+ * @param comparator 用于排序的比较器
+ * @param elements 输入集合
+ * @return 新创建的 TreeSet
+ */
 fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> {
     val set = newTreeSet(comparator)
     set.addAll(elements)
     return set
 }
 
+/**
+ * 将 Iterable 转换为新的 TreeSet 实例，并指定比较器。
+ *
+ * @param T 元素类型
+ * @param comparator 用于排序的比较器
+ * @param elements 输入 Iterable
+ * @return 新创建的 TreeSet
+ */
 fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> {
     val set = newTreeSet(comparator)
     for (element in elements) {
@@ -378,32 +800,71 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T>
     return set
 }
 
+/**
+ * 将 Sequence 转换为新的 TreeSet 实例，并指定比较器。
+ *
+ * @param T 元素类型
+ * @param comparator 用于排序的比较器
+ * @param elements 输入 Sequence
+ * @return 新创建的 TreeSet
+ */
 fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> {
     return newTreeSet(comparator, elements.toSet())
 }
 
+/**
+ * 将当前集合转换为新的 CopyOnWriteArrayList 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 CopyOnWriteArrayList
+ */
 fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> {
     return java.util.concurrent.CopyOnWriteArrayList(this)
 }
 
+/**
+ * 将当前集合转换为新的 Stack 实例。
+ *
+ * @param T 元素类型
+ * @return 新创建的 Stack
+ */
 fun <T> Collection<T>.newStacks(): Stack<T> {
     val stack = Stack<T>()
     stack.addAll(this)
     return stack
 }
 
+/**
+ * 将当前集合转换为新的 TreeSet 实例。
+ *
+ * @param T 元素类型，必须实现 Comparable 接口
+ * @return 新创建的 TreeSet
+ */
 fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
     val set = TreeSet<T>()
     set.addAll(this)
     return set
 }
 
+/**
+ * 将当前集合转换为新的 TreeSet 实例，并指定比较器。
+ *
+ * @param T 元素类型
+ * @param comparator 用于排序的比较器
+ * @return 新创建的 TreeSet
+ */
 fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
     val set = TreeSet(comparator)
     set.addAll(this)
     return set
 }
 
+/**
+ * 将 Byte 类型的 List 转换为字节数组。
+ *
+ * @param list 输入的 Byte 列表
+ * @return 转换后的字节数组
+ */
 fun toArray(list: List<Byte>): ByteArray {
     val arr = ByteArray(list.size)
     for (i in list.indices) {
@@ -413,6 +874,12 @@ fun toArray(list: List<Byte>): ByteArray {
 }
 
 
+/**
+ * 将 Short 类型的 List 转换为短整型数组。
+ *
+ * @param list 输入的 Short 列表
+ * @return 转换后的短整型数组
+ */
 fun toArray(list: List<Short>): ShortArray {
     val arr = ShortArray(list.size)
     for (i in list.indices) {
@@ -421,6 +888,12 @@ fun toArray(list: List<Short>): ShortArray {
     return arr
 }
 
+/**
+ * 将 Int 类型的 List 转换为整型数组。
+ *
+ * @param list 输入的 Int 列表
+ * @return 转换后的整型数组
+ */
 fun toArray(list: List<Int>): IntArray {
     val arr = IntArray(list.size)
     for (i in list.indices) {
@@ -429,6 +902,12 @@ fun toArray(list: List<Int>): IntArray {
     return arr
 }
 
+/**
+ * 将 Long 类型的 List 转换为长整型数组。
+ *
+ * @param list 输入的 Long 列表
+ * @return 转换后的长整型数组
+ */
 fun toArray(list: List<Long>): LongArray {
     val arr = LongArray(list.size)
     for (i in list.indices) {
@@ -437,6 +916,12 @@ fun toArray(list: List<Long>): LongArray {
     return arr
 }
 
+/**
+ * 将 Float 类型的 List 转换为浮点数组。
+ *
+ * @param list 输入的 Float 列表
+ * @return 转换后的浮点数组
+ */
 fun toArray(list: List<Float>): FloatArray {
     val arr = FloatArray(list.size)
     for (i in list.indices) {
@@ -445,6 +930,12 @@ fun toArray(list: List<Float>): FloatArray {
     return arr
 }
 
+/**
+ * 将 Double 类型的 List 转换为双精度浮点数组。
+ *
+ * @param list 输入的 Double 列表
+ * @return 转换后的双精度浮点数组
+ */
 fun toArray(list: List<Double>): DoubleArray {
     val arr = DoubleArray(list.size)
     for (i in list.indices) {
@@ -453,6 +944,12 @@ fun toArray(list: List<Double>): DoubleArray {
     return arr
 }
 
+/**
+ * 将 Boolean 类型的 List 转换为布尔数组。
+ *
+ * @param list 输入的 Boolean 列表
+ * @return 转换后的布尔数组
+ */
 fun toArray(list: List<Boolean>): BooleanArray {
     val arr = BooleanArray(list.size)
     for (i in list.indices) {
@@ -461,6 +958,12 @@ fun toArray(list: List<Boolean>): BooleanArray {
     return arr
 }
 
+/**
+ * 将 Char 类型的 List 转换为字符数组。
+ *
+ * @param list 输入的 Char 列表
+ * @return 转换后的字符数组
+ */
 fun toArray(list: List<Char>): CharArray {
     val arr = CharArray(list.size)
     for (i in list.indices) {
@@ -468,3 +971,23 @@ fun toArray(list: List<Char>): CharArray {
     }
     return arr
 }
+
+
+/**
+ * 将任意类型的 List 转换为数组。
+ *
+ * @param T 元素类型
+ * @param list 输入的 List
+ * @return 转换后的数组
+ */
+inline fun <reified T> toArray(list: List<T>): Array<T> {
+    if (list.isEmpty())
+        return arrayOf<T>()
+    return SuperStream.of<T>(list)
+        .toArray(T::class.java)
+}
+
+fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> {
+    return SuperStream.of<T>(list)
+        .toArray(clazz)
+}

src/main/kotlin/com/mingliqiye/utils/concurrent/IsChanged.kt

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
  * CurrentFile IsChanged.kt
- * LastUpdate 2025-09-15 09:30:37
+ * LastUpdate 2025-09-19 20:17:07
  * UpdateUser MingLiPro
  */
 

src/main/kotlin/com/mingliqiye/utils/configuration/ConfigurationProp.kt

@@ -0,0 +1,273 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile ConfigurationProp.kt
+ * LastUpdate 2025-09-19 11:30:04
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.configuration
+
+/**
+ * 配置属性注解，用于标记配置类中的字段，支持通过命令行参数进行初始化。
+ *
+ * @param name 配置项的名称，默认为空字符串，表示使用字段名作为配置项名称。
+ * @param description 配置项的描述信息，默认为空字符串。
+ * @param showHelper 是否显示帮助信息，默认为 true。
+ */
+@Retention(AnnotationRetention.RUNTIME)
+@Target(
+    AnnotationTarget.TYPE_PARAMETER,
+    AnnotationTarget.VALUE_PARAMETER,
+    AnnotationTarget.FIELD,      // 添加字段支持
+    AnnotationTarget.PROPERTY    // 添加属性支持
+)
+annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true)
+
+/**
+ * 根据字段名生成对应的 setter 方法名。
+ *
+ * @param fieldName 字段名。
+ * @return 对应的 setter 方法名。
+ */
+private fun getSetterName(fieldName: String): String {
+    return "set" + fieldName.take(1).uppercase() + fieldName.substring(1)
+}
+
+/**
+ * 根据字段名生成对应的 getter 方法名。
+ *
+ * @param fieldName 字段名。
+ * @return 对应的 getter 方法名。
+ */
+private fun getGetterName(fieldName: String): String {
+    return "get" + fieldName.take(1).uppercase() + fieldName.substring(1)
+}
+
+/**
+ * 配置初始化器，用于解析命令行参数并填充配置对象。
+ */
+open class ConfigurationProps {
+
+    companion object {
+        /**
+         * 初始化配置类实例，并根据命令行参数填充其字段。
+         *
+         * @param clazz 配置类的 Class 对象。
+         * @param args 命令行参数数组。
+         * @return 初始化后的配置类实例。
+         */
+        @JvmStatic
+        fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
+            val mapsArgs = parseArguments(args)
+            val instance = clazz.getDeclaredConstructor().newInstance()
+
+            processFields(clazz, instance, mapsArgs)
+
+            return instance
+        }
+
+        /**
+         * 解析命令行参数，将其转换为键值对映射。
+         *
+         * 支持以下格式：
+         * - `--key=value` 或 `-k=value`：键值对形式。
+         * - `--key value` 或 `-k value`：键和值分开的形式。
+         * - `--flag` 或 `-f`：布尔标志形式，默认值为 "true"。
+         *
+         * @param args 命令行参数数组。
+         * @return 解析后的键值对映射。
+         */
+        private fun parseArguments(args: Array<String>): Map<String, List<String>> {
+            val mapsArgs = mutableMapOf<String, MutableList<String>>()
+
+            var i = 0
+            while (i < args.size) {
+                val arg = args[i]
+
+                when {
+                    arg.startsWith("--") -> {
+                        // 处理 --key=value 格式
+                        if (arg.contains("=")) {
+                            val (key, value) = arg.substring(2).split("=", limit = 2)
+                            mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
+                        }
+                        // 处理 --key value 格式
+                        else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
+                            val key = arg.substring(2)
+                            val value = args[i + 1]
+                            mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
+                            i++ // 跳过下一个参数
+                        }
+                        // 处理 --flag 格式的布尔标志
+                        else {
+                            val key = arg.substring(2)
+                            mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
+                        }
+                    }
+
+                    arg.startsWith("-") -> {
+                        // 处理 -k=value 格式
+                        if (arg.contains("=")) {
+                            val (key, value) = arg.substring(1).split("=", limit = 2)
+                            mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
+                        }
+                        // 处理 -k value 格式
+                        else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
+                            val key = arg.substring(1)
+                            val value = args[i + 1]
+                            mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
+                            i++
+                        }
+                        // 处理 -f 格式的布尔标志
+                        else {
+                            val key = arg.substring(1)
+                            mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
+                        }
+                    }
+                }
+                i++
+            }
+
+            return mapsArgs
+        }
+
+        /**
+         * 处理配置类中的字段，根据解析出的参数设置字段值。
+         *
+         * @param clazz 配置类的 Class 对象。
+         * @param instance 配置类的实例。
+         * @param mapsArgs 解析后的命令行参数映射。
+         */
+        private fun <T : ConfigurationProps> processFields(
+            clazz: Class<T>,
+            instance: T,
+            mapsArgs: Map<String, List<String>>
+        ) {
+            val fields = clazz.declaredFields
+
+            for (field in fields) {
+                val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
+                if (configurationProp != null) {
+                    val fieldName = configurationProp.name.ifEmpty { field.name }
+                    val values = mapsArgs[fieldName]
+
+                    if (values != null) {
+                        try {
+                            val setter = clazz.getDeclaredMethod(
+                                getSetterName(field.name),
+                                field.type
+                            )
+
+                            val value = convertValue(field.type, values, configurationProp)
+                            setter.invoke(instance, value)
+                        } catch (e: Exception) {
+                            println("Warning: Failed to set field ${field.name}: ${e.message}")
+                        }
+                    }
+                }
+            }
+        }
+
+        /**
+         * 将字符串值转换为目标类型。
+         *
+         * @param type 目标类型。
+         * @param values 字符串值列表。
+         * @param annotation 配置属性注解。
+         * @return 转换后的值。
+         */
+        private fun convertValue(
+            type: Class<*>,
+            values: List<String>,
+            annotation: ConfigurationProp
+        ): Any? {
+            val lastValue = values.lastOrNull() ?: return null
+
+            return when (type) {
+                String::class.java -> lastValue
+
+                Integer::class.java, Int::class.java -> try {
+                    lastValue.toInt()
+                } catch (e: NumberFormatException) {
+                    println("Warning: Invalid integer value '$lastValue'")
+                    null
+                }
+
+                Long::class.java, java.lang.Long::class.java -> try {
+                    lastValue.toLong()
+                } catch (e: NumberFormatException) {
+                    println("Warning: Invalid long value '$lastValue'")
+                    null
+                }
+
+                Double::class.java, java.lang.Double::class.java -> try {
+                    lastValue.toDouble()
+                } catch (e: NumberFormatException) {
+                    println("Warning: Invalid double value '$lastValue'")
+                    null
+                }
+
+                Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
+                    "true", "1", "yes", "on" -> true
+                    "false", "0", "no", "off" -> false
+                    else -> {
+                        println("Warning: Invalid boolean value '$lastValue'")
+                        null
+                    }
+                }
+
+                List::class.java -> values
+
+                else -> {
+                    println("Warning: Unsupported type ${type.simpleName}")
+                    null
+                }
+            }
+        }
+    }
+
+    fun printHelp() {
+        val fields = this::class.java.declaredFields
+        val help = StringBuilder()
+        for (field in fields) {
+            val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
+            if (configurationProp != null && configurationProp.showHelper) {
+                val fieldName = configurationProp.name.ifEmpty { field.name }
+                help.append("$fieldName -> 类型: ${field.type.simpleName}")
+                if (configurationProp.description.isNotEmpty()) {
+                    help.append(" 描述: ${configurationProp.description}")
+                }
+                help.append("\n")
+            }
+        }
+        println(help)
+    }
+
+    val fields: Map<String, Any?>
+        get() {
+            val fields = this::class.java.declaredFields
+            val fieldValues = mutableMapOf<String, Any?>()
+            for (field in fields) {
+                field.isAccessible = true
+                val fieldName = field.name
+                val fieldValue = field.get(this)
+                fieldValues[fieldName] = fieldValue
+            }
+            return fieldValues
+        }
+}

src/main/kotlin/com/mingliqiye/utils/dto/DtoUtils.kt

@@ -0,0 +1,146 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile DtoUtils.kt
+ * LastUpdate 2025-09-19 13:38:56
+ * UpdateUser MingLiPro
+ */
+
+@file:JvmName("DtoUtils")
+
+package com.mingliqiye.utils.dto
+
+import java.lang.reflect.Field
+
+
+/**
+ * 克隆一个对象，通过反射创建新实例并复制所有非静态字段值。
+ *
+ * @param obj 要克隆的对象，必须是非空的任意类型实例。
+ * @return 返回一个新的对象实例，其字段值与原对象一致。
+ */
+fun <T : Any> clone(obj: T): T {
+    val clazz = obj.javaClass
+    val constructor = clazz.getDeclaredConstructor().apply {
+        isAccessible = true
+    }
+    val instance = constructor.newInstance()
+
+    // 遍历类及其父类的所有字段进行赋值
+    var currentClass: Class<*>? = clazz
+    while (currentClass != null) {
+        currentClass.declaredFields.forEach { field ->
+            if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
+                field.isAccessible = true
+                field.set(instance, field.get(obj))
+            }
+        }
+        currentClass = currentClass.superclass
+    }
+
+    return instance
+}
+
+/**
+ * 定义 DTO 拷贝行为的枚举类型。
+ */
+enum class DotCopyType {
+    /**
+     * 表示使用点拷贝（.copy）方式处理字段。
+     */
+    DOT_COPY,
+
+    /**
+     * 表示普通拷贝方式处理字段。
+     */
+    COPY
+}
+
+/**
+ * 标注用于控制 DTO 字段拷贝行为的注解。
+ *
+ * @param type 指定拷贝类型，默认为 COPY。
+ */
+@Retention(AnnotationRetention.RUNTIME)
+@Target(
+    AnnotationTarget.TYPE_PARAMETER,
+    AnnotationTarget.VALUE_PARAMETER,
+    AnnotationTarget.FIELD,
+    AnnotationTarget.PROPERTY
+)
+annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
+
+/**
+ * 将源对象转换为目标 DTO 类型的实例，并根据字段名匹配拷贝字段值。
+ *
+ * @param obj 源对象，包含需要被拷贝的数据。
+ * @param dtoClass 目标 DTO 的 Class 对象。
+ * @return 返回一个新的目标 DTO 实例，字段值已从源对象拷贝。
+ */
+fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
+    val instance = dtoClass.getDeclaredConstructor().apply {
+        isAccessible = true
+    }.newInstance()
+
+    val sourceFields = getAllFields(obj.javaClass)
+
+    for (sourceField in sourceFields) {
+        sourceField.isAccessible = true
+        val fieldName = sourceField.name
+        val fieldValue = sourceField.get(obj)
+
+        try {
+            val targetField = dtoClass.getDeclaredField(fieldName).apply {
+                isAccessible = true
+            }
+            if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
+                continue
+            }
+            val ta = targetField.getAnnotation(DtoCopy::class.java)
+            if (ta != null) {
+                if (ta.type == DotCopyType.DOT_COPY) {
+                    continue
+                }
+            }
+            targetField.set(instance, fieldValue)
+
+        } catch (e: NoSuchFieldException) {
+            continue
+        } catch (e: IllegalArgumentException) {
+            continue
+        }
+    }
+
+    return instance
+}
+
+/**
+ * 获取指定类及其所有父类中声明的所有字段。
+ *
+ * @param clazz 起始类对象。
+ * @return 包含所有字段的列表。
+ */
+private fun getAllFields(clazz: Class<*>): List<Field> {
+    val fields = mutableListOf<Field>()
+    var currentClass: Class<*>? = clazz
+    while (currentClass != null && currentClass != Any::class.java) {
+        fields.addAll(currentClass.declaredFields)
+        currentClass = currentClass.superclass
+    }
+    return fields
+}
+

src/main/kotlin/com/mingliqiye/utils/foreach/ForEach.kt

@@ -0,0 +1,709 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile ForEach.kt
+ * LastUpdate 2025-09-15 12:44:46
+ * UpdateUser MingLiPro
+ */
+@file:JvmName("ForEach")
+
+package com.mingliqiye.utils.foreach
+
+import com.mingliqiye.utils.functions.*
+
+
+/**
+ * 对给定的可迭代对象执行指定的操作，同时处理元素值和索引。
+ * 根据可迭代对象是否实现 RandomAccess 接口选择最优的遍历方式。
+ *
+ * @param iterable 要遍历的可迭代对象
+ * @param action   要对每个元素执行的操作，接收元素值和索引作为参数
+ * @param <T>      可迭代对象中元素的类型
+ */
+fun <T> forEach(
+    iterable: Iterable<T>, action: P2Function<in T, in Int>
+) {
+    when (iterable) {
+        is RandomAccess if iterable is MutableList<*> -> {
+            // 如果是支持随机访问的可变列表，则使用索引遍历以提高性能
+            val list = iterable as MutableList<T>
+            for (i in list.indices) {
+                action.call(list[i], i)
+            }
+        }
+
+        is MutableList<*> -> {
+            // 对于普通可变列表，使用迭代器进行遍历，并手动维护索引
+            var index = 0
+            val it = iterable.iterator()
+            while (it.hasNext()) {
+                action.call(it.next(), index)
+                index++
+            }
+        }
+
+        else -> {
+            // 对于其他类型的可迭代对象，使用增强 for 循环并手动维护索引
+            var index = 0
+            for (element in iterable) {
+                action.call(element, index)
+                index++
+            }
+        }
+    }
+}
+
+/**
+ * 对给定的可迭代对象执行指定的操作，仅处理元素值。
+ * 根据可迭代对象是否实现 RandomAccess 接口选择最优的遍历方式。
+ *
+ * @param iterable 要遍历的可迭代对象
+ * @param action   要对每个元素执行的操作，只接收元素值作为参数
+ * @param <T>      可迭代对象中元素的类型
+ */
+fun <T> forEach(
+    iterable: Iterable<T>, action: P1Function<in T>
+) {
+    if (iterable is RandomAccess) {
+        // 如果是支持随机访问的列表，则使用索引遍历以提高性能
+        val list = iterable as MutableList<T>
+        for (i in list.indices) {
+            action.call(list[i])
+        }
+    } else {
+        // 否则使用增强 for 循环进行遍历
+        for (element in iterable) {
+            action.call(element)
+        }
+    }
+}
+
+/**
+ * 对给定的可迭代对象执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ * 根据可迭代对象是否实现 RandomAccess 接口选择最优的遍历方式。
+ *
+ * @param iterable 要遍历的可迭代对象
+ * @param action   要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ * @param <T>      可迭代对象中元素的类型
+ */
+fun <T> forEachB(
+    iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean>
+) {
+    when (iterable) {
+        is RandomAccess if iterable is MutableList<*> -> {
+            // 如果是支持随机访问的可变列表，则使用索引遍历以提高性能
+            val list = iterable as MutableList<T>
+            for (i in list.indices) {
+                if (action.call(list[i], i)) return
+            }
+        }
+
+        is MutableList<*> -> {
+            // 对于普通可变列表，使用迭代器进行遍历，并手动维护索引
+            var index = 0
+            val it = iterable.iterator()
+            while (it.hasNext()) {
+                if (action.call(it.next(), index)) return
+                index++
+            }
+        }
+
+        else -> {
+            // 对于其他类型的可迭代对象，使用增强 for 循环并手动维护索引
+            var index = 0
+            for (element in iterable) {
+                if (action.call(element, index)) return
+                index++
+            }
+        }
+    }
+}
+
+/**
+ * 对给定的可迭代对象执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ * 根据可迭代对象是否实现 RandomAccess 接口选择最优的遍历方式。
+ *
+ * @param iterable 要遍历的可迭代对象
+ * @param action   要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ * @param <T>      可迭代对象中元素的类型
+ */
+fun <T> forEachB(
+    iterable: Iterable<T>, action: P1RFunction<in T, out Boolean>
+) {
+    if (iterable is RandomAccess) {
+        // 如果是支持随机访问的列表，则使用索引遍历以提高性能
+        val list = iterable as MutableList<T>
+        for (i in list.indices) {
+            if (action.call(list[i])) return
+        }
+    } else {
+        // 否则使用增强 for 循环进行遍历
+        for (element in iterable) {
+            if (action.call(element)) return
+        }
+    }
+}
+
+/**
+ * 对给定的数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ * @param <T>    数组中元素的类型
+ */
+fun <T> forEach(
+    array: Array<T>, action: P2Function<in T, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ * @param <T>    数组中元素的类型
+ */
+fun <T> forEach(
+    array: Array<T>, action: P1Function<in T>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ * @param <T>    数组中元素的类型
+ */
+fun <T> forEachB(
+    array: Array<T>, action: P2RFunction<in T, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ * @param <T>    数组中元素的类型
+ */
+fun <T> forEachB(
+    array: Array<T>, action: P1RFunction<in T, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的字节数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的字节数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: ByteArray, action: P2Function<in Byte, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的字节数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的字节数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: ByteArray, action: P1Function<in Byte>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的字节数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的字节数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的字节数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的字节数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: ByteArray, action: P1RFunction<in Byte, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的字符数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的字符数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: CharArray, action: P2Function<in Char, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的字符数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的字符数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: CharArray, action: P1Function<in Char>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的字符数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的字符数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: CharArray, action: P2RFunction<in Char, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的字符数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的字符数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: CharArray, action: P1RFunction<in Char, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的整型数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的整型数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: IntArray, action: P2Function<in Int, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的整型数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的整型数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: IntArray, action: P1Function<in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的整型数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的整型数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: IntArray, action: P2RFunction<in Int, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的整型数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的整型数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: IntArray, action: P1RFunction<in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的长整型数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的长整型数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: LongArray, action: P2Function<in Long, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的长整型数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的长整型数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: LongArray, action: P1Function<in Long>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的长整型数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的长整型数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: LongArray, action: P2RFunction<in Long, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的长整型数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的长整型数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: LongArray, action: P1RFunction<in Long, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的短整型数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的短整型数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: ShortArray, action: P2Function<in Short, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的短整型数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的短整型数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: ShortArray, action: P1Function<in Short>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的短整型数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的短整型数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的短整型数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的短整型数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: ShortArray, action: P1RFunction<in Short, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的浮点数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的浮点数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: FloatArray, action: P2Function<in Float, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的浮点数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的浮点数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: FloatArray, action: P1Function<in Float>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的浮点数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的浮点数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的浮点数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的浮点数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: FloatArray, action: P1RFunction<in Float, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的双精度浮点数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的双精度浮点数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: DoubleArray, action: P2Function<in Double, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的双精度浮点数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的双精度浮点数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: DoubleArray, action: P1Function<in Double>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的双精度浮点数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的双精度浮点数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的双精度浮点数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的双精度浮点数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: DoubleArray, action: P1RFunction<in Double, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的布尔数组执行指定的操作，同时处理元素值和索引。
+ *
+ * @param array  要遍历的布尔数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数
+ */
+fun forEach(
+    array: BooleanArray, action: P2Function<in Boolean, in Int>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的布尔数组执行指定的操作，仅处理元素值。
+ *
+ * @param array  要遍历的布尔数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数
+ */
+fun forEach(
+    array: BooleanArray, action: P1Function<in Boolean>
+) {
+    forEach(array.toList(), action)
+}
+
+/**
+ * 对给定的布尔数组执行指定的操作，同时处理元素值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的布尔数组
+ * @param action 要对每个元素执行的操作，接收元素值和索引作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的布尔数组执行指定的操作，仅处理元素值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的布尔数组
+ * @param action 要对每个元素执行的操作，只接收元素值作为参数，返回 Boolean 表示是否提前终止
+ */
+fun forEachB(
+    array: BooleanArray, action: P1RFunction<in Boolean, out Boolean>
+) {
+    forEachB(array.toList(), action)
+}
+
+/**
+ * 对给定的键值对集合执行指定的操作，同时处理键、值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的键值对集合
+ * @param action 要对每个键值对执行的操作，接收键、值和索引作为参数，返回 Boolean 表示是否提前终止
+ * @param <K>    键的类型
+ * @param <V>    值的类型
+ * @param <A>    集合的具体类型
+ */
+fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
+    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) })
+}
+
+/**
+ * 对给定的映射执行指定的操作，同时处理键、值和索引。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param map    要遍历的映射
+ * @param action 要对每个键值对执行的操作，接收键、值和索引作为参数，返回 Boolean 表示是否提前终止
+ * @param <K>    键的类型
+ * @param <V>    值的类型
+ * @param <A>    映射的具体类型
+ */
+fun <K, V, A : Map<K, V>> forEachB(
+    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) })
+}
+
+/**
+ * 对给定的键值对集合执行指定的操作，仅处理键和值。
+ *
+ * @param array  要遍历的键值对集合
+ * @param action 要对每个键值对执行的操作，接收键和值作为参数
+ * @param <K>    键的类型
+ * @param <V>    值的类型
+ * @param <A>    集合的具体类型
+ */
+fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
+    array: A, action: P2Function<in K, in V>
+) {
+    forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
+}
+
+/**
+ * 对给定的映射执行指定的操作，仅处理键和值。
+ *
+ * @param map    要遍历的映射
+ * @param action 要对每个键值对执行的操作，接收键和值作为参数
+ * @param <K>    键的类型
+ * @param <V>    值的类型
+ * @param <A>    映射的具体类型
+ */
+fun <K, V, A : Map<K, V>> forEachMap(
+    map: A, action: P2Function<in K, in V>
+) {
+    forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
+}
+
+/**
+ * 对给定的键值对集合执行指定的操作，仅处理键和值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param array  要遍历的键值对集合
+ * @param action 要对每个键值对执行的操作，接收键和值作为参数，返回 Boolean 表示是否提前终止
+ * @param <K>    键的类型
+ * @param <V>    值的类型
+ * @param <A>    集合的具体类型
+ */
+fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
+    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) })
+}
+
+/**
+ * 对给定的映射执行指定的操作，仅处理键和值。
+ * 如果操作返回 true，则提前终止遍历。
+ *
+ * @param map    要遍历的映射
+ * @param action 要对每个键值对执行的操作，接收键和值作为参数，返回 Boolean 表示是否提前终止
+ * @param <K>    键的类型
+ * @param <V>    值的类型
+ * @param <A>    映射的具体类型
+ */
+fun <K, V, A : Map<K, V>> forEachMapB(
+    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) })
+}

src/main/kotlin/com/mingliqiye/utils/functions/Functions.kt

@@ -0,0 +1,181 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile Functions.kt
+ * LastUpdate 2025-09-15 09:56:54
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.functions
+
+import java.util.concurrent.*
+
+/**
+ * 防抖器类，用于实现防抖功能，防止在短时间内重复执行相同任务
+ *
+ * @author MingLiPro
+ */
+class Debouncer(private val delay: Long, unit: TimeUnit) {
+
+    private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor()
+    private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
+    private val delayMillis: Long = unit.toMillis(delay)
+
+    /**
+     * 执行防抖操作，如果在指定延迟时间内再次调用相同key的任务，则取消之前的任务并重新计时
+     *
+     * @param key  任务的唯一标识符，用于区分不同任务
+     * @param task 要执行的任务
+     */
+    fun debounce(key: Any, task: Runnable) {
+        // 提交新任务并获取之前可能存在的任务
+        val prev = delayedMap.put(
+            key,
+            scheduler.schedule(
+                {
+                    try {
+                        task.run()
+                    } finally {
+                        // 任务执行完成后从映射中移除
+                        delayedMap.remove(key)
+                    }
+                },
+                delayMillis,
+                TimeUnit.MILLISECONDS
+            )
+        )
+
+        // 如果之前存在任务，则取消它
+        if (prev != null) {
+            prev.cancel(true)
+        }
+    }
+
+    /**
+     * 关闭防抖器，取消所有待执行的任务并关闭调度器
+     */
+    fun shutdown() {
+        // 先取消所有延迟任务
+        for (future in delayedMap.values) {
+            future.cancel(true)
+        }
+        delayedMap.clear()
+
+        // 再关闭调度器
+        scheduler.shutdownNow()
+    }
+}
+
+@FunctionalInterface
+fun interface P1Function<P> {
+    fun call(p: P)
+}
+
+@FunctionalInterface
+fun interface P1RFunction<P, R> {
+    fun call(p: P): R
+}
+
+@FunctionalInterface
+fun interface P2Function<P, P1> {
+    fun call(p: P, p1: P1)
+}
+
+@FunctionalInterface
+fun interface P2RFunction<P, P1, R> {
+    fun call(p: P, p1: P1): R
+}
+
+@FunctionalInterface
+fun interface P3Function<P, P1, P2> {
+    fun call(p: P, p1: P1, p2: P2)
+}
+
+@FunctionalInterface
+fun interface P3RFunction<P, P1, P2, R> {
+    fun call(p: P, p1: P1, p2: P2): R
+}
+
+@FunctionalInterface
+fun interface P4Function<P, P1, P2, P3> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3)
+}
+
+@FunctionalInterface
+fun interface P4RFunction<P, P1, P2, P3, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3): R
+}
+
+@FunctionalInterface
+fun interface P5Function<P, P1, P2, P3, P4> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4)
+}
+
+@FunctionalInterface
+fun interface P5RFunction<P, P1, P2, P3, P4, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4): R
+}
+
+@FunctionalInterface
+fun interface P6Function<P, P1, P2, P3, P4, P5> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5)
+}
+
+@FunctionalInterface
+fun interface P6RFunction<P, P1, P2, P3, P4, P5, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5): R
+}
+
+@FunctionalInterface
+fun interface P7Function<P, P1, P2, P3, P4, P5, P6> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6)
+}
+
+@FunctionalInterface
+fun interface P7RFunction<P, P1, P2, P3, P4, P5, P6, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6): R
+}
+
+@FunctionalInterface
+fun interface P8Function<P, P1, P2, P3, P4, P5, P6, P7> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6, p7: P7)
+}
+
+@FunctionalInterface
+fun interface P8RFunction<P, P1, P2, P3, P4, P5, P6, P7, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6, p7: P7): R
+}
+
+@FunctionalInterface
+fun interface P9Function<P, P1, P2, P3, P4, P5, P6, P7, P8> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6, p7: P7, p8: P8)
+}
+
+@FunctionalInterface
+fun interface P9RFunction<P, P1, P2, P3, P4, P5, P6, P7, P8, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6, p7: P7, p8: P8): R
+}
+
+@FunctionalInterface
+fun interface P10Function<P, P1, P2, P3, P4, P5, P6, P7, P8, P9> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6, p7: P7, p8: P8, p9: P9)
+}
+
+@FunctionalInterface
+fun interface P10RFunction<P, P1, P2, P3, P4, P5, P6, P7, P8, P9, R> {
+    fun call(p: P, p1: P1, p2: P2, p3: P3, p4: P4, p5: P5, p6: P6, p7: P7, p8: P8, p9: P9): R
+}

src/main/kotlin/com/mingliqiye/utils/hash/HashUtils.kt

@@ -0,0 +1,96 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile HashUtils.kt
+ * LastUpdate 2025-09-19 20:24:33
+ * UpdateUser MingLiPro
+ */
+@file:JvmName("HashUtils")
+
+package com.mingliqiye.utils.hash
+
+
+import com.mingliqiye.utils.base.BASE16
+import com.mingliqiye.utils.bcrypt.checkpw
+import com.mingliqiye.utils.bcrypt.hashpw
+import java.io.File
+import java.io.FileInputStream
+import java.io.IOException
+import java.security.MessageDigest
+import java.security.NoSuchAlgorithmException
+
+/**
+ * 计算指定文件的哈希值。
+ *
+ * @param file      要计算哈希值的文件对象
+ * @param algorithm 使用的哈希算法名称（如 SHA-256、MD5 等）
+ * @return 文件的十六进制格式哈希值字符串
+ * @throws IOException              当文件不存在或读取过程中发生 I/O 错误时抛出
+ * @throws NoSuchAlgorithmException 当指定的哈希算法不可用时抛出
+ */
+@Throws(IOException::class, NoSuchAlgorithmException::class)
+fun calculateFileHash(file: File, algorithm: String): String {
+    // 检查文件是否存在
+    if (!file.exists()) {
+        throw IOException("File not found: " + file.absolutePath)
+    }
+
+    val digest = MessageDigest.getInstance(algorithm)
+
+    FileInputStream(file).use { fis ->
+        val buffer = ByteArray(8192)
+        var bytesRead: Int
+
+        // 分块读取文件内容并更新摘要
+        while (fis.read(buffer).also { bytesRead = it } != -1) {
+            digest.update(buffer, 0, bytesRead)
+        }
+    }
+
+    return bytesToHex(digest.digest())
+}
+
+/**
+ * 将字节数组转换为十六进制字符串表示。
+ *
+ * @param bytes 输入的字节数组
+ * @return 对应的十六进制字符串
+ */
+private fun bytesToHex(bytes: ByteArray): String {
+    return BASE16.encode(bytes)
+}
+
+/**
+ * 使用 BCrypt 算法对字符串进行加密。
+ *
+ * @param string 需要加密的明文字符串
+ * @return 加密后的 BCrypt 哈希字符串
+ */
+fun bcrypt(string: String): String {
+    return hashpw(string)
+}
+
+/**
+ * 验证给定字符串与 BCrypt 哈希是否匹配。
+ *
+ * @param string   明文字符串
+ * @param bcrypted 已经使用 BCrypt 加密的哈希字符串
+ * @return 如果匹配返回 true，否则返回 false
+ */
+fun checkBcrypt(string: String, bcrypted: String): Boolean {
+    return checkpw(string, bcrypted)
+}

src/main/kotlin/com/mingliqiye/utils/io/IO.kt

@@ -0,0 +1,63 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile IO.kt
+ * LastUpdate 2025-09-20 16:03:14
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.io
+
+
+fun Any?.println() {
+    IO.println(this)
+}
+
+
+class IO {
+    companion object {
+
+        @JvmStatic
+        fun print(vararg args: Any?) {
+            printA(" ", *args)
+        }
+
+        @JvmStatic
+        fun println(vararg args: Any?) {
+            printlnA(" ", *args)
+        }
+
+        @JvmStatic
+        fun printlnA(sp: String, vararg args: Any?) {
+            printA(" ", *args)
+            kotlin.io.println()
+        }
+
+        @JvmStatic
+        fun printA(sp: String = "", vararg args: Any?) {
+            if (args.isEmpty()) {
+                kotlin.io.println()
+            }
+            val sb = StringBuilder()
+            for (i in args.indices) {
+                sb.append(args[i])
+                if (i < args.size - 1) sb.append(sp)
+            }
+            kotlin.io.print(sb)
+        }
+    }
+}

src/main/kotlin/com/mingliqiye/utils/io/InputStreamUtils.kt

@@ -15,24 +15,36 @@
  *
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
- * CurrentFile JsonException.java
- * LastUpdate 2025-09-09 09:25:08
+ * CurrentFile InputStreamUtils.kt
+ * LastUpdate 2025-09-15 17:26:34
  * UpdateUser MingLiPro
  */
+@file:JvmName("InputStreamUtils")
 
-package com.mingliqiye.utils.json;
+package com.mingliqiye.utils.io
 
-public class JsonException extends RuntimeException {
+import java.io.InputStream
+import java.io.OutputStream
+import java.nio.charset.Charset
 
-	public JsonException(String message) {
-		super(message);
-	}
 
-	public JsonException(String message, Throwable cause) {
-		super(message, cause);
-	}
-
-	public JsonException(Throwable cause) {
-		this(cause.getMessage(), cause);
-	}
+fun InputStream.readAllText(charset: Charset = Charsets.UTF_8): String {
+    return this.readAllBytes().toString(charset)
 }
+
+fun InputStream.readAllBytes(): ByteArray {
+    return this.readBytes()
+}
+
+fun InputStream.exportBytes(out: OutputStream) {
+    out.write(this.readAllBytes())
+    out.flush()
+}
+
+fun InputStream.readToList(): List<Byte> {
+    return this.readBytes().toList()
+}
+
+
+
+

src/main/kotlin/com/mingliqiye/utils/jna/FieldStructure.kt

@@ -16,7 +16,7 @@
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
  * CurrentFile FieldStructure.kt
- * LastUpdate 2025-09-14 18:19:29
+ * LastUpdate 2025-09-15 22:32:50
  * UpdateUser MingLiPro
  */
 

src/main/kotlin/com/mingliqiye/utils/json/GsonJsonApi.kt

@@ -0,0 +1,231 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile GsonJsonApi.kt
+ * LastUpdate 2025-09-15 22:07:43
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.json
+
+import com.google.gson.*
+import com.mingliqiye.utils.json.converters.JsonConverter
+import com.mingliqiye.utils.json.converters.JsonStringConverter
+
+class GsonJsonApi : JsonApi {
+
+    private var gsonUnicode: Gson
+    private var gsonPretty: Gson
+    private var gsonPrettyUnicode: Gson
+    private var gson: Gson
+
+    constructor() {
+        gson = GsonBuilder()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+
+        gsonUnicode = GsonBuilder()
+            .disableHtmlEscaping()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+
+        gsonPretty = GsonBuilder()
+            .setPrettyPrinting()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+
+        gsonPrettyUnicode = GsonBuilder()
+            .setPrettyPrinting()
+            .disableHtmlEscaping()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+    }
+
+    constructor(gson: Gson) {
+        this.gson = gson
+            .newBuilder()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+        this.gsonUnicode = gson
+            .newBuilder()
+            .disableHtmlEscaping()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+        this.gsonPretty = gson
+            .newBuilder()
+            .setPrettyPrinting()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+        this.gsonPrettyUnicode = gson
+            .newBuilder()
+            .setPrettyPrinting()
+            .disableHtmlEscaping()
+            .setObjectToNumberStrategy(ToNumberPolicy.LONG_OR_DOUBLE)
+            .create()
+    }
+
+    override fun <T> parse(json: String, clazz: Class<T>): T {
+        return gson.fromJson(json, clazz)
+    }
+
+    override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
+        return gson.fromJson(json, type.type)
+    }
+
+    override fun format(obj: Any): String {
+        return gson.toJson(obj)
+    }
+
+    override fun formatUnicode(obj: Any): String {
+        return gsonUnicode.toJson(obj)
+    }
+
+    override fun formatPretty(obj: Any): String {
+        return gsonPretty.toJson(obj)
+    }
+
+    override fun formatPrettyUnicode(obj: Any): String {
+        return gsonPrettyUnicode.toJson(obj)
+    }
+
+    override fun isValidJson(json: String): Boolean {
+        return try {
+            JsonParser.parseString(json)
+            true
+        } catch (e: JsonSyntaxException) {
+            false
+        } catch (e: Exception) {
+            false
+        }
+    }
+
+    override fun merge(vararg jsons: String): String {
+        val merged = JsonObject()
+        for (json in jsons) {
+            if (json.isNullOrEmpty()) {
+                continue
+            }
+            try {
+                val obj = JsonParser.parseString(json).asJsonObject
+                for (key in obj.keySet()) {
+                    merged.add(key, obj.get(key))
+                }
+            } catch (e: Exception) {
+                // 忽略无效的 JSON 字符串
+            }
+        }
+        return gson.toJson(merged)
+    }
+
+    override fun getNodeValue(json: String, path: String): String? {
+        return try {
+            var element = JsonParser.parseString(json)
+            val paths = path.split("\\.".toRegex()).toTypedArray()
+            var current = element
+
+            for (p in paths) {
+                if (current.isJsonObject) {
+                    current = current.asJsonObject.get(p)
+                } else {
+                    return null
+                }
+
+                if (current == null) {
+                    return null
+                }
+            }
+
+            if (current.isJsonPrimitive) current.asString else current.toString()
+        } catch (e: Exception) {
+            null
+        }
+    }
+
+    override fun updateNodeValue(json: String, path: String, newValue: Any): String {
+        return try {
+            val obj = JsonParser.parseString(json).asJsonObject
+            val paths = path.split("\\.".toRegex()).toTypedArray()
+            var current = obj
+
+            // 导航到倒数第二层
+            for (i in 0 until paths.size - 1) {
+                val p = paths[i]
+                if (!current.has(p) || !current.get(p).isJsonObject) {
+                    current.add(p, JsonObject())
+                }
+                current = current.getAsJsonObject(p)
+            }
+
+            // 设置最后一层的值
+            val lastPath = paths[paths.size - 1]
+            val element = gson.toJsonTree(newValue)
+            current.add(lastPath, element)
+
+            gson.toJson(obj)
+        } catch (e: Exception) {
+            json
+        }
+    }
+
+    override fun <T, D> convert(source: T, destinationClass: Class<D>): D {
+        val json = gson.toJson(source)
+        return gson.fromJson(json, destinationClass)
+    }
+
+    override fun <T, D> convert(source: T, destinationType: JsonTypeReference<D>): D {
+        val json = gson.toJson(source)
+        return gson.fromJson(json, destinationType.type)
+    }
+
+    override fun addJsonConverter(c: JsonConverter<*, *>) {
+        c.getStringConverter()?.let {
+            gson = gson
+                .newBuilder()
+                .registerTypeAdapter(
+                    it.tClass,
+                    it.gsonJsonStringConverterAdapter
+                )
+                .create()
+            gsonUnicode = gsonUnicode
+                .newBuilder()
+                .registerTypeAdapter(
+                    it.tClass,
+                    it.gsonJsonStringConverterAdapter
+                )
+                .create()
+            gsonPretty = gsonPretty
+                .newBuilder()
+                .registerTypeAdapter(
+                    it.tClass,
+                    it.gsonJsonStringConverterAdapter
+                )
+                .create()
+            gsonPrettyUnicode = gsonPrettyUnicode
+                .newBuilder()
+                .registerTypeAdapter(
+                    it.tClass,
+                    it.gsonJsonStringConverterAdapter
+                )
+                .create()
+        }
+
+    }
+
+    override fun addJsonStringConverter(c: JsonStringConverter<*>) {
+        addJsonConverter(c)
+    }
+}

src/main/kotlin/com/mingliqiye/utils/json/JacksonJsonApi.kt

@@ -0,0 +1,301 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile JacksonJsonApi.kt
+ * LastUpdate 2025-09-15 22:07:43
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.json
+
+import com.fasterxml.jackson.core.JsonGenerator
+import com.fasterxml.jackson.core.JsonProcessingException
+import com.fasterxml.jackson.databind.JsonNode
+import com.fasterxml.jackson.databind.ObjectMapper
+import com.fasterxml.jackson.databind.ObjectReader
+import com.fasterxml.jackson.databind.node.ObjectNode
+import com.mingliqiye.utils.json.converters.JsonConverter
+import com.mingliqiye.utils.json.converters.JsonStringConverter
+import java.io.IOException
+
+/**
+ * 基于Jackson的JSON处理实现类，提供JSON字符串解析、格式化、合并、节点操作等功能。
+ */
+class JacksonJsonApi : JsonApi {
+
+    private val objectMapper: ObjectMapper
+
+    /**
+     * 使用默认的ObjectMapper构造实例
+     */
+    constructor() {
+        this.objectMapper = ObjectMapper()
+    }
+
+    /**
+     * 使用指定的ObjectMapper构造实例
+     *
+     * @param objectMapper 自定义的ObjectMapper实例
+     */
+    constructor(objectMapper: ObjectMapper) {
+        this.objectMapper = objectMapper.copy()
+    }
+
+    /**
+     * 将JSON字符串解析为指定类型的对象
+     *
+     * @param json  待解析的JSON字符串
+     * @param clazz 目标对象类型
+     * @param <T>   泛型参数，表示目标对象类型
+     * @return 解析后的对象
+     * @throws JsonException 当解析失败时抛出异常
+     */
+    override fun <T> parse(json: String, clazz: Class<T>): T {
+        return try {
+            objectMapper.readValue(json, clazz)
+        } catch (e: IOException) {
+            throw JsonException("Failed to parse JSON string", e)
+        }
+    }
+
+    /**
+     * 将JSON字符串解析为复杂泛型结构的对象（如List、Map等）
+     *
+     * @param json JSON字符串
+     * @param type 泛型类型引用
+     * @param <T>  泛型参数，表示目标对象类型
+     * @return 解析后的对象
+     * @throws JsonException 当解析失败时抛出异常
+     */
+    override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
+        return try {
+            val reader: ObjectReader = objectMapper.readerFor(
+                objectMapper.constructType(type.type)
+            )
+            reader.readValue(json)
+        } catch (e: IOException) {
+            throw JsonException("Failed to parse JSON string", e)
+        }
+    }
+
+    /**
+     * 将对象格式化为JSON字符串
+     *
+     * @param `object` 待格式化的对象
+     * @return 格式化后的JSON字符串
+     * @throws JsonException 当格式化失败时抛出异常
+     */
+    override fun format(obj: Any): String {
+        return try {
+            objectMapper.writeValueAsString(obj)
+        } catch (e: JsonProcessingException) {
+            throw JsonException(
+                "Failed to format object to JSON string",
+                e
+            )
+        }
+    }
+
+    override fun formatUnicode(obj: Any): String {
+        return try {
+            objectMapper
+                .writer()
+                .with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
+                .writeValueAsString(obj)
+        } catch (e: JsonProcessingException) {
+            throw JsonException(e)
+        }
+    }
+
+    /**
+     * 将对象格式化为美化（带缩进）的JSON字符串
+     *
+     * @param `object` 待格式化的对象
+     * @return 美化后的JSON字符串
+     * @throws JsonException 当格式化失败时抛出异常
+     */
+    override fun formatPretty(obj: Any): String {
+        return try {
+            objectMapper
+                .writerWithDefaultPrettyPrinter()
+                .writeValueAsString(obj)
+        } catch (e: JsonProcessingException) {
+            throw JsonException(
+                "Failed to format object to pretty JSON string",
+                e
+            )
+        }
+    }
+
+    override fun formatPrettyUnicode(obj: Any): String {
+        return try {
+            objectMapper
+                .writerWithDefaultPrettyPrinter()
+                .with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
+                .writeValueAsString(obj)
+        } catch (e: JsonProcessingException) {
+            throw JsonException(
+                "Failed to format object to pretty JSON string",
+                e
+            )
+        }
+    }
+
+
+    /**
+     * 判断给定字符串是否是有效的JSON格式
+     *
+     * @param json 待验证的字符串
+     * @return 如果是有效JSON返回true，否则返回false
+     */
+    override fun isValidJson(json: String): Boolean {
+        return try {
+            objectMapper.readTree(json)
+            true
+        } catch (e: Exception) {
+            false
+        }
+    }
+
+    /**
+     * 合并多个JSON字符串为一个JSON对象
+     *
+     * @param jsons 多个JSON字符串
+     * @return 合并后的JSON字符串
+     * @throws JsonException 当合并失败时抛出异常
+     */
+    override fun merge(vararg jsons: String): String {
+        val result: ObjectNode = objectMapper.createObjectNode()
+        for (json in jsons) {
+            try {
+                val node: JsonNode = objectMapper.readTree(json)
+                if (node.isObject) {
+                    result.setAll<JsonNode>(node as ObjectNode)
+                }
+            } catch (e: IOException) {
+                // 忽略无效的JSON字符串
+            }
+        }
+        return try {
+            objectMapper.writeValueAsString(result)
+        } catch (e: JsonProcessingException) {
+            throw JsonException("Failed to merge JSON strings", e)
+        }
+    }
+
+    /**
+     * 获取JSON字符串中指定路径的节点值
+     *
+     * @param json JSON字符串
+     * @param path 节点路径，使用"."分隔
+     * @return 节点值的文本表示，如果路径不存在则返回null
+     * @throws JsonException 当获取节点值失败时抛出异常
+     */
+    override fun getNodeValue(json: String, path: String): String? {
+        return try {
+            var node: JsonNode = objectMapper.readTree(json)
+            val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
+            for (p in paths) {
+                node = node.get(p)
+            }
+            node.asText()
+        } catch (e: IOException) {
+            throw JsonException("Failed to get node value", e)
+        }
+    }
+
+    /**
+     * 更新JSON字符串中指定路径的节点值
+     *
+     * @param json     JSON字符串
+     * @param path     节点路径，使用"."分隔
+     * @param newValue 新的节点值
+     * @return 更新后的JSON字符串
+     * @throws JsonException 当更新节点值失败时抛出异常
+     */
+    override fun updateNodeValue(json: String, path: String, newValue: Any): String {
+        return try {
+            val node: JsonNode = objectMapper.readTree(json)
+            if (node is ObjectNode) {
+                val objectNode: ObjectNode = node
+                val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
+                var current: JsonNode = objectNode
+
+                // 导航到目标节点的父节点
+                for (i in 0 until paths.size - 1) {
+                    current = current.get(paths[i])
+                    if (current !is ObjectNode) {
+                        return json // 路径不存在或无效
+                    }
+                }
+
+                // 更新值
+                if (current is ObjectNode) {
+                    val parent: ObjectNode = current
+                    parent.set<JsonNode>(
+                        paths[paths.size - 1],
+                        objectMapper.valueToTree(newValue)
+                    )
+                }
+
+                objectMapper.writeValueAsString(objectNode)
+            }
+            json
+        } catch (e: IOException) {
+            throw JsonException("Failed to update node value", e)
+        }
+    }
+
+    /**
+     * 在不同对象类型之间进行转换
+     *
+     * @param source           源对象
+     * @param destinationClass 目标对象类型
+     * @param <T>              源对象类型
+     * @param <D>              目标对象类型
+     * @return 转换后的对象
+     */
+    override fun <T, D> convert(source: T, destinationClass: Class<D>): D {
+        return objectMapper.convertValue(source, destinationClass)
+    }
+
+    /**
+     * 在不同泛型对象类型之间进行转换
+     *
+     * @param source          源对象
+     * @param destinationType 目标对象的泛型类型引用
+     * @param <T>             源对象类型
+     * @param <D>             目标对象类型
+     * @return 转换后的对象
+     */
+    override fun <T, D> convert(source: T, destinationType: JsonTypeReference<D>): D {
+        return objectMapper.convertValue(
+            source,
+            objectMapper.constructType(destinationType.type)
+        )
+    }
+
+    override fun addJsonConverter(c: JsonConverter<*, *>) {
+        c.getStringConverter()?.let {
+            objectMapper.registerModule(it.jacksonJsonStringConverterAdapter.jacksonModule)
+        }
+    }
+
+    override fun addJsonStringConverter(c: JsonStringConverter<*>) {
+        addJsonConverter(c)
+    }
+}

src/main/kotlin/com/mingliqiye/utils/json/JsonApi.kt

@@ -0,0 +1,393 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile JsonApi.kt
+ * LastUpdate 2025-09-15 22:32:50
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.json
+
+import com.mingliqiye.utils.json.converters.JsonConverter
+import com.mingliqiye.utils.json.converters.JsonStringConverter
+import java.io.*
+import java.nio.file.Files
+import java.nio.file.Path
+import java.nio.file.Paths
+
+
+/**
+ * JSON处理接口，提供JSON字符串与Java对象之间的相互转换功能
+ */
+interface JsonApi {
+    /**
+     * 将JSON字符串解析为指定类型的对象
+     *
+     * @param json  待解析的JSON字符串
+     * @param clazz 目标对象的Class类型
+     * @param <T>   泛型参数，表示目标对象的类型
+     * @return 解析后的对象实例
+    </T> */
+    fun <T> parse(json: String, clazz: Class<T>): T
+
+    /**
+     * 将JSON字符串解析为指定泛型类型对象
+     *
+     * @param json 待解析的JSON字符串
+     * @param type 目标对象的Type类型（支持泛型）
+     * @param <T>  泛型参数，表示目标对象的类型
+     * @return 解析后的对象实例
+    </T> */
+    fun <T> parse(json: String, type: JsonTypeReference<T>): T
+
+    /**
+     * 将对象格式化为JSON字符串
+     *
+     * @param obj 待格式化的对象
+     * @return 格式化后的JSON字符串
+     */
+    fun format(obj: Any): String
+
+    fun formatUnicode(obj: Any): String
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(path: String, clazz: Class<T>): T {
+        return parseFrom(Paths.get(path), clazz)
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(path: Path, clazz: Class<T>): T {
+        return parseFrom(path.toFile(), clazz)
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(file: File, clazz: Class<T>): T {
+        Files.newInputStream(file.toPath()).use { inputStream ->
+            return parseFrom(inputStream, clazz)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(inputStream: InputStream, clazz: Class<T>): T {
+        val bytes = ByteArray(1024)
+        ByteArrayOutputStream().use { bos ->
+            var readlength: Int
+            while ((inputStream.read(bytes).also { readlength = it }) != -1) {
+                bos.write(bytes, 0, readlength)
+            }
+            return parse(bos.toByteArray(), clazz)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(path: String, type: JsonTypeReference<T>): T {
+        return parseFrom(Paths.get(path), type)
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(path: Path, type: JsonTypeReference<T>): T {
+        return parseFrom(path.toFile(), type)
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(file: File, type: JsonTypeReference<T>): T {
+        Files.newInputStream(file.toPath()).use { inputStream ->
+            return parseFrom<T>(inputStream, type)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun <T> parseFrom(inputStream: InputStream, type: JsonTypeReference<T>): T {
+        val bytes = ByteArray(1024)
+        ByteArrayOutputStream().use { bos ->
+            var readlength: Int
+            while ((inputStream.read(bytes).also { readlength = it }) != -1) {
+                bos.write(bytes, 0, readlength)
+            }
+            return parse(bos.toByteArray(), type)
+        }
+    }
+
+    /**
+     * 将字节数组形式的JSON解析为指定类型的对象
+     *
+     * @param json  待解析的JSON字节数组
+     * @param clazz 目标对象的Class类型
+     * @param <T>   泛型参数，表示目标对象的类型
+     * @return 解析后的对象实例
+    </T> */
+    fun <T> parse(json: ByteArray, clazz: Class<T>): T {
+        return parse(String(json), clazz)
+    }
+
+    /**
+     * 将字节数组形式的JSON解析为指定泛型类型对象
+     *
+     * @param json 待解析的JSON字节数组
+     * @param type 目标对象的Type类型（支持泛型）
+     * @param <T>  泛型参数，表示目标对象的类型
+     * @return 解析后的对象实例
+    </T> */
+    fun <T> parse(json: ByteArray, type: JsonTypeReference<T>): T {
+        return parse(String(json), type)
+    }
+
+    /**
+     * 将JSON字符串解析为指定类型的对象，解析失败时返回默认值
+     *
+     * @param json         待解析的JSON字符串
+     * @param clazz        目标对象的Class类型
+     * @param defaultValue 解析失败时返回的默认值
+     * @param <T>          泛型参数，表示目标对象的类型
+     * @return 解析后的对象实例或默认值
+    </T> */
+    fun <T> parse(json: String, clazz: Class<T>, defaultValue: T): T {
+        try {
+            return parse(json, clazz)
+        } catch (e: Exception) {
+            return defaultValue
+        }
+    }
+
+    /**
+     * 将JSON字符串解析为指定泛型类型对象，解析失败时返回默认值
+     *
+     * @param json         待解析的JSON字符串
+     * @param type         目标对象的Type类型（支持泛型）
+     * @param defaultValue 解析失败时返回的默认值
+     * @param <T>          泛型参数，表示目标对象的类型
+     * @return 解析后的对象实例或默认值
+     **/
+    fun <T> parse(
+        json: String,
+        type: JsonTypeReference<T>,
+        defaultValue: T
+    ): T {
+        try {
+            return parse<T>(json, type)
+        } catch (e: Exception) {
+            return defaultValue
+        }
+    }
+
+    /**
+     * 将对象格式化为美化格式的JSON字符串（带缩进和换行）
+     *
+     * @param object 待格式化的对象
+     * @return 格式化后的美化JSON字符串
+     */
+    fun formatPretty(obj: Any): String
+
+    fun formatPrettyBytes(obj: Any): ByteArray {
+        return formatPretty(obj)!!.toByteArray()
+    }
+
+    fun formatPrettyUnicode(obj: Any): String
+
+    fun formatPrettyUnicodeBytes(obj: Any): ByteArray {
+        return formatPrettyUnicode(obj)!!.toByteArray()
+    }
+
+    @Throws(IOException::class)
+    fun formatPretty(obj: Any, file: String) {
+        formatPretty(obj, Paths.get(file))
+    }
+
+    @Throws(IOException::class)
+    fun formatPretty(obj: Any, file: Path) {
+        formatPretty(obj, file.toFile())
+    }
+
+    @Throws(IOException::class)
+    fun formatPretty(obj: Any, file: File) {
+        FileOutputStream(file).use { fos ->
+            formatPretty(obj, fos)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun formatPretty(obj: Any, stream: OutputStream) {
+        stream.write(formatPrettyBytes(obj))
+    }
+
+    @Throws(IOException::class)
+    fun formatPrettyUnicode(obj: Any, file: String) {
+        formatPrettyUnicode(obj, Paths.get(file))
+    }
+
+    @Throws(IOException::class)
+    fun formatPrettyUnicode(obj: Any, file: Path) {
+        formatPrettyUnicode(obj, file.toFile())
+    }
+
+    @Throws(IOException::class)
+    fun formatPrettyUnicode(obj: Any, file: File) {
+        FileOutputStream(file).use { fos ->
+            formatPrettyUnicode(obj, fos)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun formatPrettyUnicode(obj: Any, stream: OutputStream) {
+        stream.write(formatPrettyUnicodeBytes(obj))
+    }
+
+    fun formatBytes(obj: Any): ByteArray {
+        return format(obj)!!.toByteArray()
+    }
+
+    fun formatUnicodeBytes(obj: Any): ByteArray {
+        return formatUnicode(obj)!!.toByteArray()
+    }
+
+    @Throws(IOException::class)
+    fun format(obj: Any, file: String) {
+        format(obj, Paths.get(file))
+    }
+
+    @Throws(IOException::class)
+    fun format(obj: Any, file: Path) {
+        format(obj, file.toFile())
+    }
+
+    @Throws(IOException::class)
+    fun format(obj: Any, file: File) {
+        FileOutputStream(file).use { fos ->
+            format(obj, fos)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun format(obj: Any, stream: OutputStream) {
+        stream.write(formatPrettyBytes(obj))
+    }
+
+    @Throws(IOException::class)
+    fun formatUnicode(obj: Any, file: String) {
+        formatUnicode(obj, Paths.get(file))
+    }
+
+    @Throws(IOException::class)
+    fun formatUnicode(obj: Any, file: Path) {
+        formatUnicode(obj, file.toFile())
+    }
+
+    @Throws(IOException::class)
+    fun formatUnicode(obj: Any, file: File) {
+        FileOutputStream(file).use { fos ->
+            formatUnicode(obj, fos)
+        }
+    }
+
+    @Throws(IOException::class)
+    fun formatUnicode(obj: Any, stream: OutputStream) {
+        stream.write(formatPrettyUnicodeBytes(obj))
+    }
+
+    /**
+     * 将JSON字符串解析为指定元素类型的List集合
+     *
+     * @param json        待解析的JSON字符串
+     * @param elementType List中元素的类型
+     * @param <T>         泛型参数，表示List中元素的类型
+     * @return 解析后的List集合
+    </T> */
+    fun <T> parseList(json: String, elementType: Class<T>): List<T> {
+        return parse(json, type = listType(elementType))
+    }
+
+    /**
+     * 将JSON字符串解析为指定键值类型的Map集合
+     *
+     * @param json      待解析的JSON字符串
+     * @param keyType   Map中键的类型
+     * @param valueType Map中值的类型
+     * @param <K>       泛型参数，表示Map中键的类型
+     * @param <V>       泛型参数，表示Map中值的类型
+     * @return 解析后的Map集合
+    </V></K> */
+    fun <K, V> parseMap(
+        json: String,
+        keyType: Class<K>,
+        valueType: Class<V>
+    ): MutableMap<K, V> {
+        val mapType: JsonTypeReference<MutableMap<K, V>> = object : JsonTypeReference<MutableMap<K, V>>() {}
+        return parse<MutableMap<K, V>>(json, mapType)
+    }
+
+    /**
+     * 验证字符串是否为有效的JSON格式
+     *
+     * @param json 待验证的字符串
+     * @return 如果是有效的JSON格式返回true，否则返回false
+     */
+    fun isValidJson(json: String): Boolean
+
+    /**
+     * 将对象转换为JSON字节数组
+     *
+     * @param object 待转换的对象
+     * @return 转换后的JSON字节数组
+     */
+    fun toBytes(obj: Any): ByteArray {
+        return format(obj)!!.toByteArray()
+    }
+
+    /**
+     * 将对象转换为美化格式的JSON字节数组
+     *
+     * @param object 待转换的对象
+     * @return 转换后的美化格式JSON字节数组
+     */
+    fun toBytesPretty(obj: Any): ByteArray {
+        return formatPretty(obj)!!.toByteArray()
+    }
+
+    /**
+     * 合并多个JSON字符串为一个JSON对象
+     *
+     * @param jsons 待合并的JSON字符串数组
+     * @return 合并后的JSON字符串
+     */
+    fun merge(vararg jsons: String): String
+
+    /**
+     * 获取JSON字符串中指定路径节点的值
+     *
+     * @param json JSON字符串
+     * @param path 节点路径（如："user.name"）
+     * @return 节点值的字符串表示
+     */
+    fun getNodeValue(json: String, path: String): String?
+
+    /**
+     * 更新JSON字符串中指定路径节点的值
+     *
+     * @param json     原始JSON字符串
+     * @param path     节点路径（如："user.name"）
+     * @param newValue 新的节点值
+     * @return 更新后的JSON字符串
+     */
+    fun updateNodeValue(json: String, path: String, newValue: Any): String
+
+    fun <T, D> convert(source: T, destinationClass: Class<D>): D
+
+    fun <T, D> convert(source: T, destinationType: JsonTypeReference<D>): D
+
+    fun addJsonConverter(c: JsonConverter<*, *>)
+    fun addJsonStringConverter(c: JsonStringConverter<*>)
+}

src/main/kotlin/com/mingliqiye/utils/json/JsonException.kt

@@ -15,20 +15,18 @@
  *
  * ProjectName mingli-utils
  * ModuleName mingli-utils.main
- * CurrentFile Extra.java
- * LastUpdate 2025-09-09 08:37:34
+ * CurrentFile JsonException.kt
+ * LastUpdate 2025-09-15 22:32:50
  * UpdateUser MingLiPro
  */
 
-package com.mingliqiye.utils.minecraft.slp;
+package com.mingliqiye.utils.json
 
-import lombok.Data;
+class JsonException : RuntimeException {
 
-@Data
-public class Extra {
+    constructor(message: String) : super(message)
 
-	private String text;
-	private String color;
-	private Boolean bold;
-	private Boolean italic;
+    constructor(message: String, cause: Throwable) : super(message, cause)
+
+    constructor(cause: Throwable) : this(cause.message ?: "", cause)
 }

src/main/kotlin/com/mingliqiye/utils/json/JsonTypeReference.kt

@@ -0,0 +1,164 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile JsonTypeReference.kt
+ * LastUpdate 2025-09-15 22:32:50
+ * UpdateUser MingLiPro
+ */
+
+package com.mingliqiye.utils.json
+
+import java.lang.reflect.ParameterizedType
+import java.lang.reflect.Type
+import java.util.*
+
+/**
+ * 通用的 JSON 类型引用类，用于在运行时保留泛型类型信息
+ * 适用于所有 JSON 库（Jackson、Gson、Fastjson 等）
+ *
+ * @param <T> 引用的泛型类型
+ */
+abstract class JsonTypeReference<T> : Comparable<JsonTypeReference<T>> {
+
+    open var type: Type = Any::class.java
+
+    /**
+     * 构造函数，通过反射获取泛型类型信息
+     * 仅供内部匿名子类使用
+     */
+    protected constructor() {
+        val superClass: Type = this.javaClass.genericSuperclass
+
+        // 检查是否为匿名子类，防止直接实例化导致无法获取泛型信息
+        if (superClass is Class<*>) {
+            throw IllegalArgumentException(
+                "必须使用匿名子类方式创建 JsonTypeReference，" +
+                        "例如: new JsonTypeReference<List<String>>() {}"
+            )
+        }
+
+        this.type = (superClass as ParameterizedType).actualTypeArguments[0]
+    }
+
+    /**
+     * 构造函数，直接指定类型
+     * @param type 具体的类型信息
+     */
+    protected constructor(type: Type) {
+        this.type = Objects.requireNonNull(type, "Type cannot be null")
+    }
+
+    /**
+     * 创建类型引用实例
+     * @param <T> 目标类型
+     * @return 类型引用实例
+     */
+    companion object {
+        @JvmStatic
+        fun <T> of(): JsonTypeReference<T> {
+            return object : JsonTypeReference<T>() {}
+        }
+
+        /**
+         * 根据 Class 创建类型引用
+         * @param clazz 目标类
+         * @param <T> 目标类型
+         * @return 类型引用实例
+         */
+        @JvmStatic
+        fun <T> of(clazz: Class<T>): JsonTypeReference<T> {
+            return object : JsonTypeReference<T>(clazz) {}
+        }
+
+        /**
+         * 根据 Type 创建类型引用
+         * @param type 目标类型
+         * @param <T> 目标类型
+         * @return 类型引用实例
+         */
+        @JvmStatic
+        fun <T> of(type: Type): JsonTypeReference<T> {
+            return object : JsonTypeReference<T>(type) {}
+        }
+    }
+
+    /**
+     * 获取原始类型（去掉泛型参数的类型）
+     * @return 原始类型 Class
+     */
+    @Suppress("UNCHECKED_CAST")
+    fun getRawType(): Class<T> {
+        var rawType: Type = type
+
+        // 如果是参数化类型，则提取原始类型部分
+        if (type is ParameterizedType) {
+            rawType = (type as ParameterizedType).rawType
+        }
+
+        if (rawType is Class<*>) {
+            return rawType as Class<T>
+        }
+
+        throw IllegalStateException("无法获取原始类型: $type")
+    }
+
+    override fun equals(other: Any?): Boolean {
+        if (this === other) return true
+        if (other == null || this.javaClass != other.javaClass) return false
+        val that = other as JsonTypeReference<*>
+
+        // 对于 ParameterizedType，需要更完整的比较
+        if (this.type is ParameterizedType && that.type is ParameterizedType) {
+            val thisParamType = this.type as ParameterizedType
+            val thatParamType = that.type as ParameterizedType
+
+            return (
+                    Objects.equals(
+                        thisParamType.rawType,
+                        thatParamType.rawType
+                    ) &&
+                            thisParamType.actualTypeArguments.contentEquals(thatParamType.actualTypeArguments) &&
+                            Objects.equals(
+                                thisParamType.ownerType,
+                                thatParamType.ownerType
+                            )
+                    )
+        }
+
+        return Objects.equals(type, that.type)
+    }
+
+    override fun hashCode(): Int {
+        if (type is ParameterizedType) {
+            val paramType = type as ParameterizedType
+            return Objects.hash(
+                paramType.rawType,
+                paramType.actualTypeArguments.contentHashCode(),
+                paramType.ownerType
+            )
+        }
+        return Objects.hash(type)
+    }
+
+    override fun toString(): String {
+        return "JsonTypeReference{$type}"
+    }
+
+    override fun compareTo(other: JsonTypeReference<T>): Int {
+        return this.type.toString().compareTo(other.type.toString())
+    }
+}

src/main/kotlin/com/mingliqiye/utils/json/JsonTypeUtils.kt

@@ -0,0 +1,201 @@
+/*
+ * Copyright 2025 mingliqiye
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * ProjectName mingli-utils
+ * ModuleName mingli-utils.main
+ * CurrentFile JsonTypeUtils.kt
+ * LastUpdate 2025-09-17 11:12:06
+ * UpdateUser MingLiPro
+ */
+@file:JvmName("JsonTypeUtils")
+
+package com.mingliqiye.utils.json
+
+import java.lang.reflect.ParameterizedType
+import java.lang.reflect.Type
+import java.util.*
+
+
+/**
+ * 检查给定的类型是否是指定类或其子类/实现类。
+ *
+ * @param type          要检查的类型
+ * @param expectedClass 期望匹配的类
+ * @return 如果类型匹配则返回 true，否则返回 false
+ */
+fun isTypeOf(type: Type, expectedClass: Class<*>): Boolean {
+    return when (type) {
+        is Class<*> -> expectedClass.isAssignableFrom(type)
+        is ParameterizedType -> isTypeOf(type.rawType, expectedClass)
+        else -> false
+    }
+}
+
+/**
+ * 获取泛型类型的参数类型。
+ *
+ * @param type  泛型类型
+ * @param index 参数索引（从0开始）
+ * @return 指定位置的泛型参数类型
+ * @throws IllegalArgumentException 当无法获取指定索引的泛型参数时抛出异常
+ */
+fun getGenericParameter(type: Type, index: Int): Type {
+    if (type is ParameterizedType) {
+        val typeArgs = type.actualTypeArguments
+        if (index >= 0 && index < typeArgs.size) {
+            return typeArgs[index]
+        }
+    }
+    throw IllegalArgumentException(
+        "无法获取泛型参数: $type at index $index"
+    )
+}
+
+/**
+ * 获取类型名称，支持普通类和泛型类型。
+ *
+ * @param type 类型对象
+ * @return 类型名称字符串
+ */
+fun getTypeName(type: Type): String {
+    return when (type) {
+        is Class<*> -> type.simpleName
+        is ParameterizedType -> {
+            val rawType = type.rawType as Class<*>
+            val typeArgs = type.actualTypeArguments
+
+            val sb = StringBuilder(rawType.simpleName)
+            sb.append("<")
+            for (i in typeArgs.indices) {
+                if (i > 0) sb.append(", ")
+                sb.append(getTypeName(typeArgs[i]))
+            }
+            sb.append(">")
+            sb.toString()
+        }
+
+        else -> type.typeName
+    }
+}
+
+/**
+ * 创建一个表示数组类型的引用对象。
+ *
+ * @param componentType 数组元素的类型
+ * @param <T>           元素类型
+ * @return 表示数组类型的 JsonTypeReference 对象
+ */
+fun <T> arrayType(componentType: Class<T>): JsonTypeReference<Array<T>> {
+    return object : JsonTypeReference<Array<T>>() {
+        private val arrayType: Type = java.lang.reflect.Array.newInstance(
+            componentType, 0
+        ).javaClass
+
+        override var type: Type = Any::class.java
+            get() = object : ParameterizedType {
+                private val actualTypeArguments = arrayOf<Type>(componentType)
+
+                override fun getActualTypeArguments(): Array<Type> {
+                    return actualTypeArguments
+                }
+
+                override fun getRawType(): Type {
+                    return arrayType
+                }
+
+                override fun getOwnerType(): Type? {
+                    return null
+                }
+            }
+    }
+}
+
+/**
+ * 创建一个表示 List 类型的引用对象。
+ *
+ * @param componentType List 中元素的类型
+ * @param <T>           元素类型
+ * @return 表示 List 类型的 JsonTypeReference 对象
+ * @throws IllegalArgumentException 如果 componentType 为 null，则抛出异常
+ */
+fun <T> listType(componentType: Class<T>): JsonTypeReference<List<T>> {
+
+    return object : JsonTypeReference<List<T>>() {
+        override var type: Type = Any::class.java
+            get() = object : ParameterizedType {
+                override fun getActualTypeArguments(): Array<Type> {
+                    return arrayOf(componentType)
+                }
+
+                override fun getRawType(): Type {
+                    return List::class.java
+                }
+
+                override fun getOwnerType(): Type? {
+                    return null
+                }
+            }
+    }
+}
+
+/**
+ * 创建一个表示 Map 类型的引用对象。
+ *
+ * @param keyType   Map 键的类型
+ * @param valueType Map 值的类型
+ * @param <K>       键类型
+ * @param <V>       值类型
+ * @return 表示 Map 类型的 JsonTypeReference 对象
+ * @throws IllegalArgumentException 如果 keyType 或 valueType 为 null，则抛出异常
+ */
+fun <K, V> MapType(keyType: Class<K>, valueType: Class<V>): JsonTypeReference<Map<K, V>> {
+
+    return object : JsonTypeReference<Map<K, V>>() {
+        override var type: Type = Any::class.java
+            get() = object : ParameterizedType {
+                override fun getActualTypeArguments(): Array<Type> {
+                    return arrayOf(keyType, valueType)
+                }
+
+                override fun getRawType(): Type {
+                    return Map::class.java
+                }
+
+                override fun getOwnerType(): Type? {
+                    return null
+                }
+
+                override fun equals(other: Any?): Boolean {
+                    if (this === other) return true
+                    if (other !is ParameterizedType) return false
+
+                    val that = other
+                    return (Objects.equals(
+                        rawType,
+                        that.rawType
+                    ) && actualTypeArguments.contentEquals(that.actualTypeArguments) && Objects.equals(
+                        ownerType,
+                        that.ownerType
+                    ))
+                }
+
+                override fun hashCode(): Int {
+                    return (actualTypeArguments.contentHashCode() xor Objects.hashCode(rawType) xor Objects.hashCode(
+                        ownerType
+                    ))
+                }
+            }
+    }
+}