Compare commits

..
2 Commits
Author SHA1 Message Date
minglipro c98977116b Merge pull request 'master' (#15) from master into dev
Reviewed-on: #15
2026-02-08 03:19:11 +08:00
minglipro f5d90a95de Merge pull request 'master' (#14) from master into dev
Reviewed-on: #14
2026-01-14 13:03:54 +08:00
243 changed files with 12628 additions and 44388 deletions
+75 -83
View File
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils * ModuleName mingli-utils
* CurrentFile build.gradle.kts * CurrentFile build.gradle.kts
* LastUpdate 2026-10-28 21:50:32 * LastUpdate 2026-02-08 03:14:06
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -30,16 +30,12 @@ plugins {
`java-library` `java-library`
`maven-publish` `maven-publish`
kotlin("jvm") version "2.2.20" kotlin("jvm") version "2.2.20"
id("org.jetbrains.dokka") version "2.0.0"
kotlin("kapt") version "2.2.20" kotlin("kapt") version "2.2.20"
id("org.jetbrains.dokka") version "2.1.0"
id("org.jetbrains.dokka-javadoc") version "2.1.0"
kotlin("plugin.spring") version "2.1.0"
} }
val GROUPSID = project.properties["GROUPSID"] as String val GROUPSID = project.properties["GROUPSID"] as String
val VERSIONS = project.properties["VERSIONS"] as String val VERSIONS = project.properties["VERSIONS"] as String
val ARTIFACTID = project.properties["ARTIFACTID"] as String val ARTIFACTID = project.properties["ARTIFACTID"] as String
val JDKVERSIONS = (project.properties["JDKVERSIONS"] as String).toInt()
group = GROUPSID group = GROUPSID
version = VERSIONS version = VERSIONS
@@ -50,71 +46,64 @@ base {
val buildDir: java.nio.file.Path = File("build").toPath() val buildDir: java.nio.file.Path = File("build").toPath()
java { sourceSets {
toolchain.languageVersion.set(JavaLanguageVersion.of(JDKVERSIONS)) main {
withSourcesJar() java {
} srcDirs("src/main/java")
kotlin { }
jvmToolchain(JDKVERSIONS) kotlin {
} srcDirs("src/main/kotlin")
}
repositories { resources {
mavenLocal() srcDirs("src/main/resources")
maven { }
url = uri("https://maven.mingliqiye.com/")
} }
mavenCentral()
}
dependencies {
implementation("org.slf4j:slf4j-api:2.0.17")
implementation(kotlin("reflect"))
api("com.mingliqiye.utils.aliasfor:alias-for:1.0.1")
compileOnly("org.mindrot:jbcrypt:0.4")
compileOnly("com.squareup.okhttp3:okhttp:5.3.2")
compileOnly("com.fasterxml.jackson.core:jackson-databind:2.21.0")
compileOnly("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
compileOnly("org.springframework:spring-context:5.3.0")
compileOnly("org.springframework.boot:spring-boot-autoconfigure:2.7.16")
compileOnly("tools.jackson.core:jackson-databind:3.1.0")
compileOnly(fileTree("libs"))
compileOnly("com.google.code.gson:gson:2.13.2")
compileOnly("org.mybatis:mybatis:3.5.19")
compileOnly("io.netty:netty-all:4.2.15.Final")
compileOnly("com.baomidou:mybatis-plus-core:3.5.15")
compileOnly("net.java.dev.jna:jna:5.17.0")
compileOnly("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8")
compileOnly("com.baomidou:mybatis-plus-extension:3.5.15")
compileOnly("com.baomidou:mybatis-plus-jsqlparser:3.5.15")
compileOnly("com.baomidou:mybatis-plus-spring:3.5.9")
testImplementation("org.junit.jupiter:junit-jupiter:5.7.1")
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.9")
testImplementation("com.google.code.gson:gson:2.13.2")
testImplementation("com.fasterxml.jackson.core:jackson-databind:2.21.0")
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0")
testImplementation("tools.jackson.core:jackson-databind:3.1.0")
testImplementation(kotlin("test"))
} }
repositories { tasks.test {
mavenLocal()
}
tasks.withType<JavaCompile>().configureEach {
options.encoding = "UTF-8"
}
tasks.named<Test>("test") {
useJUnitPlatform() useJUnitPlatform()
} }
java {
withSourcesJar()
toolchain.languageVersion.set(JavaLanguageVersion.of(8))
}
tasks.withType<JavaExec> { dependencies {
jvmArgs(
implementation("org.slf4j:slf4j-api:2.0.17")
implementation("com.mingliqiye.utils.jna:WinKernel32Api:1.0.1")
implementation(kotlin("reflect"))
compileOnly("org.mindrot:jbcrypt:0.4")
compileOnly("com.squareup.okhttp3:okhttp:5.3.2")
compileOnly("com.fasterxml.jackson.core:jackson-databind:2.21.0")
compileOnly("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
compileOnly("org.springframework.boot:spring-boot-starter-web:2.7.18")
compileOnly("com.google.code.gson:gson:2.13.2")
compileOnly("org.mybatis:mybatis:3.5.19")
compileOnly("io.netty:netty-all:4.1.130.Final")
compileOnly("com.baomidou:mybatis-plus-core:3.5.15")
compileOnly("net.java.dev.jna:jna:5.17.0")
compileOnly("com.baomidou:mybatis-plus-extension:3.5.15")
testImplementation("org.junit.jupiter:junit-jupiter-api:5.8.1")
testRuntimeOnly("org.junit.jupiter:junit-jupiter-engine:5.8.1")
// testImplementation("com.squareup.okhttp3:okhttp:5.3.2")
testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.5")
testImplementation("com.google.code.gson:gson:2.13.2")
testImplementation("com.fasterxml.jackson.core:jackson-databind:2.21.0")
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
}
tasks.withType<JavaCompile> {
options.encoding = "UTF-8"
}
tasks.withType<JavaExec>().configureEach {
jvmArgs = listOf(
"-Dfile.encoding=UTF-8", "-Dsun.stdout.encoding=UTF-8", "-Dsun.stderr.encoding=UTF-8" "-Dfile.encoding=UTF-8", "-Dsun.stdout.encoding=UTF-8", "-Dsun.stderr.encoding=UTF-8"
) )
} }
@@ -160,34 +149,44 @@ tasks.withType<org.gradle.jvm.tasks.Jar> {
} }
val isJdk8Build = project.findProperty("buildForJdk8") == "true" val isJdk8Build = project.findProperty("buildForJdk8") == "true"
repositories {
maven {
url = uri("https://maven.aliyun.com/repository/public/")
}
mavenCentral()
}
tasks.register<Jar>("javaDocJar") { tasks.register<Jar>("javaDocJar") {
group = "build" group = "build"
archiveClassifier.set("javadoc-dec") archiveClassifier.set("javadoc")
dependsOn("dokkaGeneratePublicationJavadoc") dependsOn("dokkaJavadoc")
from(buildDir.resolve("dokka/javadoc")) from(buildDir.resolve("dokka/javadoc"))
} }
tasks.register<Jar>("kotlinDocJar") { tasks.register<Jar>("kotlinDocJar") {
group = "build" group = "build"
archiveClassifier.set("javadoc") archiveClassifier.set("kotlindoc")
dependsOn("dokkaGeneratePublicationHtml") dependsOn("dokkaHtml")
from(buildDir.resolve("dokka/html")) from(buildDir.resolve("dokka/html"))
} }
publishing { publishing {
repositories { repositories {
maven { maven {
name = "mingliqiye" name = "MavenRepositoryRaw"
url = uri("https://repository.mingliqiye.com/repository/maven") url = uri("C:/data/git/maven-repository-raw")
credentials { }
username = System.getenv("mingliqiye.username") maven {
password = System.getenv("mingliqiye.password") name = "OSSRepository"
} url = uri("C:/data/git/maven-repository-raw-utils")
} }
} }
publications { publications {
create<MavenPublication>("mavenJava") { create<MavenPublication>("mavenJava") {
from(components["java"]) from(components["java"])
artifact(tasks.named("javaDocJar"))
artifact(tasks.named("kotlinDocJar")) artifact(tasks.named("kotlinDocJar"))
artifactId = ARTIFACTID artifactId = ARTIFACTID
java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
pom { pom {
name = "mingli-utils" name = "mingli-utils"
url = "https://mingli-utils.mingliqiye.com" url = "https://mingli-utils.mingliqiye.com"
@@ -223,6 +222,8 @@ tasks.build {
} }
tasks.processResources { tasks.processResources {
duplicatesStrategy = DuplicatesStrategy.EXCLUDE duplicatesStrategy = DuplicatesStrategy.EXCLUDE
outputs.upToDateWhen { false } outputs.upToDateWhen { false }
@@ -238,12 +239,3 @@ tasks.processResources {
) )
} }
} }
signing {
val secretKeyRingFile = System.getenv("SIGNING_SECRET_KEY_RING_FILE")
val keyId = System.getenv("SIGNING_KEY_ID")
useGpgCmd()
project.ext.set("signing.secretKeyRingFile", secretKeyRingFile)
project.ext.set("signing.keyId", keyId)
project.ext.set("signing.password", "")
}
+6 -3
View File
@@ -16,10 +16,13 @@
# ProjectName mingli-utils # ProjectName mingli-utils
# ModuleName mingli-utils # ModuleName mingli-utils
# CurrentFile gradle.properties # CurrentFile gradle.properties
# LastUpdate 2026-11-09 19:49:52 # LastUpdate 2026-02-08 03:15:06
# UpdateUser MingLiPro # UpdateUser MingLiPro
# #
JDKVERSIONS=17 JDKVERSIONS=1.8
GROUPSID=com.mingliqiye.utils GROUPSID=com.mingliqiye.utils
ARTIFACTID=mingli-utils ARTIFACTID=mingli-utils
VERSIONS=5.4.3 VERSIONS=4.6.4
signing.keyId=B22AA93B
signing.password=
signing.secretKeyRingFile=secret.gpg
+89
View File
@@ -0,0 +1,89 @@
/*
* 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 build.gradle.kts
* LastUpdate 2025-09-21 15:39:12
* UpdateUser MingLiPro
*/
plugins {
id("java-library")
id("maven-publish")
signing
}
val GROUPSID = project.properties["GROUPSID"] as String
val VERSIONS = project.properties["VERSIONS"] as String
val ARTIFACTID = project.properties["ARTIFACTID"] as String
version = VERSIONS
group = GROUPSID
base.archivesName.set(ARTIFACTID)
publishing {
repositories {
maven {
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"
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))
dependencies {
api(rootProject)
implementation("com.mingliqiye.utils.jna:WinKernel32Platform:1.0.1")
}
+23
View File
@@ -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
Binary file not shown.
Binary file not shown.
+2 -13
View File
@@ -16,21 +16,10 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils * ModuleName mingli-utils
* CurrentFile settings.gradle.kts * CurrentFile settings.gradle.kts
* LastUpdate 2026-02-26 10:52:01 * LastUpdate 2026-02-07 17:00:59
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
plugins { include("jdk8")
id("com.gradleup.nmcp.settings").version("1.4.4")
}
val ARTIFACTID: String by settings.extra val ARTIFACTID: String by settings.extra
rootProject.name = ARTIFACTID rootProject.name = ARTIFACTID
nmcpSettings {
centralPortal {
username = System.getenv("sonatype.username")
password = System.getenv("sonatype.password")
publishingType = "AUTOMATIC"
}
}
@@ -1,34 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Jackson3ApiJavaHelper.java
* LastUpdate 2026-03-18 08:32:31
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.json.api;
import tools.jackson.databind.ObjectMapper;
import tools.jackson.databind.cfg.MapperBuilder;
public class Jackson3ApiJavaHelper {
@SuppressWarnings("rawtypes")
static MapperBuilder rebuild(ObjectMapper objectMapper) {
return objectMapper.rebuild();
}
}
@@ -1,120 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Main.java
* LastUpdate 2026-02-26 15:04:49
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.main;
import java.io.IOException;
import java.io.InputStream;
import java.lang.management.ManagementFactory;
import java.net.InetAddress;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
public class Main {
public final static String BANNER =
"| $$\\ $$\\ $$\\ $$\\ $$\\ $$$$$$$$\\ $$$$$$\\ \n" +
"| $$$\\ $$$ |$$ | $$ | $$ |\\__$$ __|$$ __$$\\ \n" +
"| $$$$\\ $$$$ |$$ | $$ | $$ | $$ | $$ / \\__| \n" +
"| $$\\$$\\$$ $$ |$$ | $$ | $$ | $$ | \\$$$$$$\\ \n" +
"| $$ \\$$$ $$ |$$ | $$ | $$ | $$ | \\____$$\\ \n" +
"| $$ |\\$ /$$ |$$ | $$ | $$ | $$ | $$\\ $$ | \n" +
"| $$ | \\_/ $$ |$$$$$$$$\\\\$$$$$$ | $$ | \\$$$$$$ \n" +
"| \\__| \\__|\\________|\\______/ \\__| \\______/ \n|\n";
public static void main(String[] args) {
try {
printb();
} catch (IOException ignored) {
}
}
public static String getPid() {
try {
var name = ManagementFactory.getRuntimeMXBean().getName();
var index = name.indexOf('@');
if (index > 0) {
return name.substring(0, index);
} else {
return "-1";
}
} catch (Exception e) {
return "-1";
}
}
public static String getComputerName() {
try {
var name = System.getenv("COMPUTERNAME");
if (name == null || name.isEmpty()) {
name = System.getenv("HOSTNAME");
}
if (name == null || name.isEmpty()) {
name = InetAddress.getLocalHost().getHostName();
}
return name != null ? name : "unknown";
} catch (Exception e) {
return "unknown";
}
}
public static String getUserName() {
try {
String user = System.getenv("USERNAME");
if (user == null || user.isEmpty()) {
user = System.getenv("USER");
}
if (user == null || user.isEmpty()) {
user = System.getenv("user.name");
}
if (user == null || user.isEmpty()) {
user = "unknown";
}
return user;
} catch (Exception e) {
return "unknown";
}
}
public static void printb() throws IOException {
InputStream inputStream = Main.class.getResourceAsStream("/META-INF/meta-data");
if (inputStream == null) return;
String data = new String(inputStream.readAllBytes());
inputStream.close();
StringBuilder sb = new StringBuilder(BANNER);
for (String sz : data.split("\n")) {
var d = sz.split("=");
sb.append("| -> ").append(d[0]).append(": ").append(d[1]).append("\n");
}
sb.append("| -> jdkVersion: ").append(System.getProperty("java.specification.version")).append("\n");
sb.append("| -> pid: ").append(getPid()).append("\n");
sb.append("| -> computerName: ").append(getComputerName()).append("\n");
sb.append("| -> userName: ").append(getUserName()).append("\n");
sb.append("| -> time: ")
.append(LocalDateTime.now()
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")))
.append("\n");
System.out.println();
System.out.println(sb);
}
}
@@ -13,10 +13,10 @@
* See the License for the specific language governing permissions and * See the License for the specific language governing permissions and
* limitations under the License. * limitations under the License.
* *
* ProjectName FastBaseMapper.kt * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile SuperStream.java * CurrentFile SuperStream.java
* LastUpdate 2026-10-26 23:22:18 * LastUpdate 2026-01-20 13:27:09
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -103,17 +103,6 @@ public class SuperStream<T> implements Stream<T> {
return of(Collections.newArrayLists(args)); return of(Collections.newArrayLists(args));
} }
/**
* 创建一个包含指定布尔元素的SuperStream
*
* @param args 可变参数的布尔数组
* @return 包含指定布尔的SuperStream实例
*/
public static SuperStream<Boolean> of(boolean... args) {
return of(Collections.newArrayLists(args));
}
/** /**
* 创建一个包含指定浮点数元素的SuperStream * 创建一个包含指定浮点数元素的SuperStream
* *
@@ -707,7 +696,7 @@ public class SuperStream<T> implements Stream<T> {
* @param <T> 输入元素的类型 * @param <T> 输入元素的类型
* @return 产生List的收集器 * @return 产生List的收集器
*/ */
public static <T> Collector<T, ?, List<T>> toListCollector() { public static <T> Collector<T, ?, List<T>> toList() {
return Collectors.toList(); return Collectors.toList();
} }
@@ -1230,7 +1219,7 @@ public class SuperStream<T> implements Stream<T> {
* @return 包含流中所有元素的List * @return 包含流中所有元素的List
*/ */
public List<T> toAList() { public List<T> toAList() {
return collect(toListCollector()); return collect(toList());
} }
} }
@@ -1,5 +1,5 @@
/* /*
* Copyright 2026 mingliqiye * Copyright 2025 mingliqiye
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile AesUtils.kt * CurrentFile AesUtils.kt
* LastUpdate 2026-03-12 10:34:36 * LastUpdate 2025-09-19 21:35:53
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -25,7 +25,7 @@
package com.mingliqiye.utils.aes package com.mingliqiye.utils.aes
import com.mingliqiye.utils.base.BaseType import com.mingliqiye.utils.base.BASE64
import java.nio.charset.StandardCharsets import java.nio.charset.StandardCharsets
import java.security.GeneralSecurityException import java.security.GeneralSecurityException
import java.security.MessageDigest import java.security.MessageDigest
@@ -50,30 +50,30 @@ val SECURE_RANDOM = SecureRandom()
*/ */
@Throws(GeneralSecurityException::class) @Throws(GeneralSecurityException::class)
fun encrypt(sSrc: String, sKey: String?): String? { fun encrypt(sSrc: String, sKey: String?): String? {
if (sKey == null) { if (sKey == null) {
return null return null
} }
// 生成密钥 // 生成密钥
val secretKeySpec = createSecretKey(sKey) val secretKeySpec = createSecretKey(sKey)
// 生成安全随机IV // 生成安全随机IV
val iv = ByteArray(GCM_IV_LENGTH) val iv = ByteArray(GCM_IV_LENGTH)
SECURE_RANDOM.nextBytes(iv) SECURE_RANDOM.nextBytes(iv)
// 初始化加密器 // 初始化加密器
val cipher = Cipher.getInstance(TRANSFORMATION) val cipher = Cipher.getInstance(TRANSFORMATION)
val gcmParameterSpec = GCMParameterSpec( val gcmParameterSpec = GCMParameterSpec(
GCM_TAG_LENGTH * 8, iv GCM_TAG_LENGTH * 8, iv
) )
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec) cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
val encrypted = cipher.doFinal( val encrypted = cipher.doFinal(
sSrc.toByteArray(StandardCharsets.UTF_8) sSrc.toByteArray(StandardCharsets.UTF_8)
) )
return BaseType.BASE64.encode( return BASE64.encode(
"${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray() "${BASE64.encode(iv)}:${BASE64.encode(encrypted)}".toByteArray()
) )
} }
/** /**
@@ -83,29 +83,29 @@ fun encrypt(sSrc: String, sKey: String?): String? {
* @return 解密后的原始字符串 * @return 解密后的原始字符串
*/ */
fun decrypt(sSrc: String, sKey: String): String? { fun decrypt(sSrc: String, sKey: String): String? {
try { try {
// 分割IV和加密数据 // 分割IV和加密数据
val sSrcs = String(BaseType.BASE64.decode(sSrc)) val sSrcs = String(BASE64.decode(sSrc))
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray() val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
if (parts.size != 2) { if (parts.size != 2) {
return null return null
} }
val iv = BaseType.BASE64.decode(parts[0]!!) val iv = BASE64.decode(parts[0]!!)
val encryptedData = BaseType.BASE64.decode(parts[1]!!) val encryptedData = BASE64.decode(parts[1]!!)
if (iv.size != GCM_IV_LENGTH) { if (iv.size != GCM_IV_LENGTH) {
return null return null
} }
val secretKeySpec = createSecretKey(sKey) val secretKeySpec = createSecretKey(sKey)
val cipher = Cipher.getInstance(TRANSFORMATION) val cipher = Cipher.getInstance(TRANSFORMATION)
val gcmParameterSpec = GCMParameterSpec( val gcmParameterSpec = GCMParameterSpec(
GCM_TAG_LENGTH * 8, iv GCM_TAG_LENGTH * 8, iv
) )
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec) cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
val original = cipher.doFinal(encryptedData) val original = cipher.doFinal(encryptedData)
return String(original, StandardCharsets.UTF_8) return String(original, StandardCharsets.UTF_8)
} catch (e: Exception) { } catch (e: Exception) {
return null return null
} }
} }
/** /**
@@ -116,8 +116,9 @@ fun decrypt(sSrc: String, sKey: String): String? {
*/ */
@Throws(Exception::class) @Throws(Exception::class)
private fun createSecretKey(sKey: String): SecretKeySpec { private fun createSecretKey(sKey: String): SecretKeySpec {
val key = sKey.toByteArray(StandardCharsets.UTF_8) val key = sKey.toByteArray(StandardCharsets.UTF_8)
val md = MessageDigest.getInstance("MD5") val md = MessageDigest.getInstance("MD5")
val digest = md.digest(key) val digest = md.digest(key)
return SecretKeySpec(digest, ALGORITHM) return SecretKeySpec(digest, ALGORITHM)
} }
@@ -37,5 +37,5 @@ import kotlin.reflect.KClass
@Target(AnnotationTarget.CLASS) @Target(AnnotationTarget.CLASS)
@Retention(AnnotationRetention.SOURCE) @Retention(AnnotationRetention.SOURCE)
annotation class AutoService( annotation class AutoService(
val value: Array<KClass<*>> = [], val value: Array<KClass<*>> = []
) )
@@ -33,7 +33,7 @@ import com.mingliqiye.utils.time.Formatter
*/ */
@Target(AnnotationTarget.FIELD) @Target(AnnotationTarget.FIELD)
annotation class DateTimeJsonFormat( annotation class DateTimeJsonFormat(
val value: Formatter = Formatter.NONE, val value: Formatter = Formatter.NONE,
val formatter: String = "", val formatter: String = "",
val repcZero: Boolean = true, val repcZero: Boolean = true,
) )
@@ -15,15 +15,17 @@
* *
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile MediaTypeUtils.kt * CurrentFile TestAnnotation.kt
* LastUpdate 2026-02-27 22:15:03 * LastUpdate 2026-02-07 08:44:25
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@file:JvmName("MediaTypeUtils")
package com.mingliqiye.utils.http package com.mingliqiye.utils.annotation
import okhttp3.MediaType.Companion.toMediaType @Target(AnnotationTarget.CLASS, AnnotationTarget.FUNCTION, AnnotationTarget.PROPERTY)
@Retention(AnnotationRetention.SOURCE)
annotation class TestAnnotation(val value: String = "test")
@Target(AnnotationTarget.FIELD)
fun MediaType.okhttp(): okhttp3.MediaType = this.value.toMediaType() @Retention(AnnotationRetention.SOURCE)
annotation class TestFieldAnnotation(val required: Boolean = true)
@@ -33,6 +33,6 @@ import com.mingliqiye.utils.uuid.UUIDFormatType
*/ */
@Target(AnnotationTarget.FIELD) @Target(AnnotationTarget.FIELD)
annotation class UUIDJsonFormat( annotation class UUIDJsonFormat(
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE, val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
val base: BaseType = BaseType.BASE16, val base: BaseType = BaseType.BASE16
) )
@@ -16,13 +16,14 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile AutoServiceProcessor.kt * CurrentFile AutoServiceProcessor.kt
* LastUpdate 2026-03-11 08:46:40 * LastUpdate 2026-02-08 01:24:16
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.annotation.processor package com.mingliqiye.utils.annotation.processor
import com.mingliqiye.utils.annotation.AutoService import com.mingliqiye.utils.annotation.AutoService
import com.mingliqiye.utils.io.IO.println
import javax.annotation.processing.AbstractProcessor import javax.annotation.processing.AbstractProcessor
import javax.annotation.processing.ProcessingEnvironment import javax.annotation.processing.ProcessingEnvironment
import javax.annotation.processing.RoundEnvironment import javax.annotation.processing.RoundEnvironment
@@ -35,70 +36,70 @@ import javax.tools.StandardLocation
@SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService") @SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService")
class AutoServiceProcessor : AbstractProcessor() { class AutoServiceProcessor : AbstractProcessor() {
override fun init(processingEnv: ProcessingEnvironment) { override fun init(processingEnv: ProcessingEnvironment) {
super.init(processingEnv) super.init(processingEnv)
} }
override fun process( override fun process(
annotations: Set<TypeElement>, annotations: Set<TypeElement>,
roundEnv: RoundEnvironment, roundEnv: RoundEnvironment
): Boolean { ): Boolean {
val service = mutableMapOf<String, MutableList<String>>() val service = mutableMapOf<String, MutableList<String>>()
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java) val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
if (elements.isEmpty()) return false if (elements.isEmpty()) return false
for (element in elements) { for (element in elements) {
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java) val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
var asd = (try { var asd = (try {
autoServiceAnnotation!!.value.map { it.java.name } autoServiceAnnotation!!.value.map { it.java.name }
} catch (e: MirroredTypesException) { } catch (e: MirroredTypesException) {
e.typeMirrors.map(TypeMirror::toString) e.typeMirrors.map(TypeMirror::toString)
}) })
if (asd.isEmpty()) { if (asd.isEmpty()) {
if (element is TypeElement) { if (element is TypeElement) {
asd = element.interfaces.map { it.toString() } asd = element.interfaces.map { it.toString() }
} }
} }
for (data in asd) { for (data in asd) {
var ldata: MutableList<String>? = service[data] var ldata: MutableList<String>? = service[data]
if (ldata == null) { if (ldata == null) {
ldata = mutableListOf() ldata = mutableListOf()
service[data] = ldata service[data] = ldata
} }
ldata.add(element.toString()) ldata.add(element.toString())
} }
} }
processClassAnnotation(service) processClassAnnotation(service)
return true return true
} }
fun processClassAnnotation(map: Map<String, MutableList<String>>) { fun processClassAnnotation(map: Map<String, MutableList<String>>) {
map.forEach { (interfaceName, implementations) -> map.forEach { (interfaceName, implementations) ->
if (implementations.isEmpty()) { if (implementations.isEmpty()) {
println("警告: $interfaceName 的实现列表为空!") println("警告: $interfaceName 的实现列表为空!")
return@forEach return@forEach
} }
try { try {
val serviceFile = processingEnv.filer.createResource( val serviceFile = processingEnv.filer.createResource(
StandardLocation.CLASS_OUTPUT, StandardLocation.CLASS_OUTPUT,
"", "",
"META-INF/services/$interfaceName" "META-INF/services/$interfaceName"
) )
val content = StringBuilder() val content = StringBuilder()
serviceFile.openWriter().use { writer -> serviceFile.openWriter().use { writer ->
implementations.forEach { impl -> implementations.forEach { impl ->
val line = "$impl\n" val line = "$impl\n"
content.append(line) content.append(line)
writer.write(line) writer.write(line)
} }
writer.flush() writer.flush()
} }
} catch (e: Exception) { } catch (e: Exception) {
println("文件创建失败: ${e.javaClass.name} - ${e.message}") println("文件创建失败: ${e.javaClass.name} - ${e.message}")
e.printStackTrace() e.printStackTrace()
} }
} }
} }
} }
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ArrayUtils.kt * CurrentFile ArrayUtils.kt
* LastUpdate 2026-03-12 10:08:42 * LastUpdate 2026-02-06 14:01:56
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -25,7 +25,7 @@
package com.mingliqiye.utils.array package com.mingliqiye.utils.array
import com.mingliqiye.utils.base.BaseType import com.mingliqiye.utils.base.BASE16
/** /**
@@ -35,7 +35,7 @@ import com.mingliqiye.utils.base.BaseType
* @since 4.6.0 * @since 4.6.0
* @see toHexByteArray * @see toHexByteArray
*/ */
fun ByteArray.toHexString(): String = BaseType.BASE16.encode(this).uppercase() fun ByteArray.toHexString(): String = BASE16.encode(this).uppercase()
/** /**
* 将十六进制字符串转换为字节数组 * 将十六进制字符串转换为字节数组
@@ -45,7 +45,9 @@ fun ByteArray.toHexString(): String = BaseType.BASE16.encode(this).uppercase()
* @since 4.6.0 * @since 4.6.0
* @see toHexString * @see toHexString
*/ */
fun String.toHexByteArray(): ByteArray = BaseType.BASE16.decode(this.lowercase()) fun String.toHexByteArray(): ByteArray = BASE16.decode(this.lowercase())
/* ==================== 数组复制扩展函数 ==================== */
/** /**
* 将当前数组的指定范围复制到目标数组 * 将当前数组的指定范围复制到目标数组
@@ -61,7 +63,7 @@ fun String.toHexByteArray(): ByteArray = BaseType.BASE16.decode(this.lowercase()
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also { fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -76,12 +78,12 @@ fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Ar
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> = fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also { java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
System.arraycopy(this, srcPos, it, distPos, len) System.arraycopy(this, srcPos, it, distPos, len)
}.let { }.let {
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
it as Array<T> it as Array<T>
} }
/** /**
* 将源数组的指定范围复制到当前数组 * 将源数组的指定范围复制到当前数组
@@ -96,7 +98,7 @@ fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also { fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== BooleanArray 扩展 ==================== */ /* ==================== BooleanArray 扩展 ==================== */
@@ -107,7 +109,7 @@ fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): A
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also { fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -116,9 +118,9 @@ fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int)
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray = fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
BooleanArray(len).also { newArray -> BooleanArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -126,7 +128,7 @@ fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also { fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== ByteArray 扩展 ==================== */ /* ==================== ByteArray 扩展 ==================== */
@@ -137,7 +139,7 @@ fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also { fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -146,9 +148,9 @@ fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): Byte
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray = fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
ByteArray(len).also { newArray -> ByteArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -156,7 +158,7 @@ fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also { fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== CharArray 扩展 ==================== */ /* ==================== CharArray 扩展 ==================== */
@@ -167,7 +169,7 @@ fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): Byt
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also { fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -176,9 +178,9 @@ fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): Char
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray = fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
CharArray(len).also { newArray -> CharArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -186,7 +188,7 @@ fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also { fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== DoubleArray 扩展 ==================== */ /* ==================== DoubleArray 扩展 ==================== */
@@ -197,7 +199,7 @@ fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): Cha
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also { fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -206,9 +208,9 @@ fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int):
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray = fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
DoubleArray(len).also { newArray -> DoubleArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -216,7 +218,7 @@ fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also { fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== FloatArray 扩展 ==================== */ /* ==================== FloatArray 扩展 ==================== */
@@ -227,7 +229,7 @@ fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int):
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also { fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -236,9 +238,9 @@ fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): Fl
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray = fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
FloatArray(len).also { newArray -> FloatArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -246,7 +248,7 @@ fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also { fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== IntArray 扩展 ==================== */ /* ==================== IntArray 扩展 ==================== */
@@ -257,7 +259,7 @@ fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): F
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also { fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -266,9 +268,9 @@ fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArr
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray = fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
IntArray(len).also { newArray -> IntArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -276,7 +278,7 @@ fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also { fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== LongArray 扩展 ==================== */ /* ==================== LongArray 扩展 ==================== */
@@ -287,7 +289,7 @@ fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntAr
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also { fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -296,9 +298,9 @@ fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): Long
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray = fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
LongArray(len).also { newArray -> LongArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -306,7 +308,7 @@ fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also { fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
/* ==================== ShortArray 扩展 ==================== */ /* ==================== ShortArray 扩展 ==================== */
@@ -317,7 +319,7 @@ fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): Lon
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also { fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
System.arraycopy(this, srcPos, dest, distPos, len) System.arraycopy(this, srcPos, dest, distPos, len)
} }
/** /**
@@ -326,9 +328,9 @@ fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): Sh
*/ */
@JvmName("arrayCopy") @JvmName("arrayCopy")
fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray = fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
ShortArray(len).also { newArray -> ShortArray(len).also { newArray ->
System.arraycopy(this, srcPos, newArray, distPos, len) System.arraycopy(this, srcPos, newArray, distPos, len)
} }
/** /**
* @see Array.copyFrom * @see Array.copyFrom
@@ -336,5 +338,5 @@ fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
*/ */
@JvmName("arrayCopyFrom") @JvmName("arrayCopyFrom")
fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also { fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
System.arraycopy(src, srcPos, this, distPos, len) System.arraycopy(src, srcPos, this, distPos, len)
} }
@@ -0,0 +1,68 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base10.kt
* LastUpdate 2026-02-08 03:08:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
import java.math.BigInteger
internal class Base10 : BaseCodec {
/**
* 将字节数组编码为Base10字符串(十进制)
*
* @param bytes 需要编码的字节数组
* @return 编码后的Base10字符串(十进制数字)
*/
override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return "0"
// 将字节数组转换为正的大整数
val bigInt = BigInteger(1, bytes) // 参数1表示正数
return bigInt.toString(10) // 转换为10进制字符串
}
/**
* 将Base10字符串解码为字节数组
*
* @param string 需要解码的Base10字符串(十进制数字)
* @return 解码后的字节数组
*/
override fun decode(string: String): ByteArray {
// 验证输入是否为有效的十进制数字
if (!string.matches(Regex("\\d+"))) {
throw IllegalArgumentException("Base10字符串只能包含数字0-9")
}
val bigInt = BigInteger(string, 10) // 从10进制解析
// 转换为字节数组,并确保保留前导零
var byteArray = bigInt.toByteArray()
// BigInteger.toByteArray() 可能会添加一个符号字节
// 对于正数,如果第一个字节是0,需要移除它
if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) {
byteArray = byteArray.copyOfRange(1, byteArray.size)
}
return byteArray
}
}
@@ -1,68 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base10Codec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
import java.math.BigInteger
internal class Base10Codec : BaseCodec {
/**
* 将字节数组编码为Base10字符串(十进制)
*
* @param bytes 需要编码的字节数组
* @return 编码后的Base10字符串(十进制数字)
*/
override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return "0"
// 将字节数组转换为正的大整数
val bigInt = BigInteger(1, bytes) // 参数1表示正数
return bigInt.toString(10) // 转换为10进制字符串
}
/**
* 将Base10字符串解码为字节数组
*
* @param string 需要解码的Base10字符串(十进制数字)
* @return 解码后的字节数组
*/
override fun decode(string: String): ByteArray {
// 验证输入是否为有效的十进制数字
if (!string.matches(Regex("\\d+"))) {
throw IllegalArgumentException("Base10字符串只能包含数字0-9")
}
val bigInt = BigInteger(string, 10) // 从10进制解析
// 转换为字节数组,并确保保留前导零
var byteArray = bigInt.toByteArray()
// BigInteger.toByteArray() 可能会添加一个符号字节
// 对于正数,如果第一个字节是0,需要移除它
if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) {
byteArray = byteArray.copyOfRange(1, byteArray.size)
}
return byteArray
}
}
@@ -0,0 +1,54 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base16.kt
* LastUpdate 2026-02-08 03:08:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/**
* Base16编解码器实现类
* 提供字节数组与十六进制字符串之间的相互转换功能
*/
internal 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()
}
}
@@ -1,54 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base16Codec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/**
* Base16编解码器实现类
* 提供字节数组与十六进制字符串之间的相互转换功能
*/
internal class Base16Codec : 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()
}
}
@@ -0,0 +1,59 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base2.kt
* LastUpdate 2026-02-08 03:06:23
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
internal class Base2 : BaseCodec {
override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return ""
val result = StringBuilder()
for ((index, byte) in bytes.withIndex()) {
val unsignedByte = byte.toInt() and 0xFF
val binary = unsignedByte.toString(2).padStart(8, '0')
result.append(binary)
}
return result.toString()
}
override fun decode(string: String): ByteArray {
if (string.length % 8 != 0) {
throw IllegalArgumentException(
"BASE1字符串长度必须是8的倍数,当前长度: ${string.length}"
)
}
if (!string.matches(Regex("[01]+"))) {
throw IllegalArgumentException(
"BASE1字符串只能包含字符'0'和'1'"
)
}
val byteCount = string.length / 8
val result = ByteArray(byteCount)
for (i in 0 until byteCount) {
val startIndex = i * 8
val endIndex = startIndex + 8
val binaryStr = string.substring(startIndex, endIndex)
val byteValue = binaryStr.toInt(2)
result[i] = byteValue.toByte()
}
return result
}
}
@@ -0,0 +1,313 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base256.kt
* LastUpdate 2026-02-08 03:08:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/**
* Base256 字符集 256个
*
* 256个字符 要字符集的下面复制
*
* !#$%&()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}~§±×÷←↑→↓⇒⇔∀∃∅∆∇∈∉∋∌∏∑−∓∕∗∘∙√∛∜∞∟∠∣∥∧∨∩∪∫∬∭∮∯∰∱∲∳∴∵∶∷≈≠≡≤≥≦≧≪≫≺≻⊂⊃⊆⊇⊈⊉⊊⊋⊕⊖⊗⊘⊙⊚⊛⊜⊝⊞⊟⊠⊡⊢⊣⊤⊥⊦⊧⊨⊩⊪⊫⊬⊭⊮⊯⋀⋁⋂⋃⋄⋅⋆⋇⋈⋉⋊⋋⋌⋍⋎⋏⋐⋑⋒⋓⋔⋕⋖⋗⋘⋙⋚⋛⋜⋝⋞⋟⋠⋡⋢⋣⋤⋥⋦⋧⋨⋩▁▂▃▄▅▆▇█▉▊▋▌▍▎▏▐░▒▓▔▕▖▗▘▙
*
*/
internal 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
}
}
@@ -1,313 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base256Codec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/**
* Base256 字符集 256个
*
* 256个字符 要字符集的下面复制
*
* !#$%&()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}~§±×÷←↑→↓⇒⇔∀∃∅∆∇∈∉∋∌∏∑−∓∕∗∘∙√∛∜∞∟∠∣∥∧∨∩∪∫∬∭∮∯∰∱∲∳∴∵∶∷≈≠≡≤≥≦≧≪≫≺≻⊂⊃⊆⊇⊈⊉⊊⊋⊕⊖⊗⊘⊙⊚⊛⊜⊝⊞⊟⊠⊡⊢⊣⊤⊥⊦⊧⊨⊩⊪⊫⊬⊭⊮⊯⋀⋁⋂⋃⋄⋅⋆⋇⋈⋉⋊⋋⋌⋍⋎⋏⋐⋑⋒⋓⋔⋕⋖⋗⋘⋙⋚⋛⋜⋝⋞⋟⋠⋡⋢⋣⋤⋥⋦⋧⋨⋩▁▂▃▄▅▆▇█▉▊▋▌▍▎▏▐░▒▓▔▕▖▗▘▙
*
*/
internal class Base256Codec : 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
}
}
@@ -1,59 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base2Codec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
internal class Base2Codec : BaseCodec {
override fun encode(bytes: ByteArray): String {
if (bytes.isEmpty()) return ""
val result = StringBuilder()
for ((index, byte) in bytes.withIndex()) {
val unsignedByte = byte.toInt() and 0xFF
val binary = unsignedByte.toString(2).padStart(8, '0')
result.append(binary)
}
return result.toString()
}
override fun decode(string: String): ByteArray {
if (string.length % 8 != 0) {
throw IllegalArgumentException(
"BASE1字符串长度必须是8的倍数,当前长度: ${string.length}"
)
}
if (!string.matches(Regex("[01]+"))) {
throw IllegalArgumentException(
"BASE1字符串只能包含字符'0'和'1'"
)
}
val byteCount = string.length / 8
val result = ByteArray(byteCount)
for (i in 0 until byteCount) {
val startIndex = i * 8
val endIndex = startIndex + 8
val binaryStr = string.substring(startIndex, endIndex)
val byteValue = binaryStr.toInt(2)
result[i] = byteValue.toByte()
}
return result
}
}
@@ -0,0 +1,62 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base64.kt
* LastUpdate 2026-02-08 03:08:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/*
* Base64编解码工具类
* 提供Base64编码和解码功能的实现
*/
internal 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)
}
}
@@ -1,64 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base64Codec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
import java.util.*
/*
* Base64编解码工具类
* 提供Base64编码和解码功能的实现
*/
internal class Base64Codec : BaseCodec {
/*
* Base64编码器实例
* 用于执行字节数组到Base64字符串的编码操作
*/
val encoder: Base64.Encoder = Base64.getEncoder()
/*
* Base64解码器实例
* 用于执行Base64字符串到字节数组的解码操作
*/
val decoder: Base64.Decoder = Base64.getDecoder()
/*
* 将字节数组编码为Base64字符串
*
* @param bytes 待编码的字节数组
* @return 编码后的Base64字符串
*/
override fun encode(bytes: ByteArray): String {
return encoder.encodeToString(bytes)
}
/*
* 将Base64字符串解码为字节数组
*
* @param string 待解码的Base64字符串
* @return 解码后的字节数组
*/
override fun decode(string: String): ByteArray {
return decoder.decode(string)
}
}
@@ -1,60 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base64UrlCodec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
import java.util.*
internal class Base64UrlCodec : BaseCodec {
/*
* Base64编码器实例
* 用于执行字节数组到Base64字符串的编码操作
*/
val encoder: Base64.Encoder = Base64.getUrlEncoder()
/*
* Base64解码器实例
* 用于执行Base64字符串到字节数组的解码操作
*/
val decoder: Base64.Decoder = Base64.getUrlDecoder()
/*
* 将字节数组编码为Base64字符串
*
* @param bytes 待编码的字节数组
* @return 编码后的Base64字符串
*/
override fun encode(bytes: ByteArray): String {
return encoder.encodeToString(bytes)
}
/*
* 将Base64字符串解码为字节数组
*
* @param string 待解码的Base64字符串
* @return 解码后的字节数组
*/
override fun decode(string: String): ByteArray {
return decoder.decode(string)
}
}
@@ -0,0 +1,404 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base91.kt
* LastUpdate 2026-02-08 03:08:10
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/**
* Base91 编解码工具类,用于将字节数组编码为 Base91 字符串,或将 Base91 字符串解码为原始字节数组。
*
* Base91 是一种高效的二进制到文本的编码方式,相较于 Base64,它使用更少的字符来表示相同的数据。
*/
internal 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)
}
}
@@ -1,404 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile Base91Codec.kt
* LastUpdate 2026-03-12 10:34:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.base
/**
* Base91 编解码工具类,用于将字节数组编码为 Base91 字符串,或将 Base91 字符串解码为原始字节数组。
*
* Base91 是一种高效的二进制到文本的编码方式,相较于 Base64,它使用更少的字符来表示相同的数据。
*/
internal class Base91Codec : 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)
}
}
@@ -1,5 +1,5 @@
/* /*
* Copyright 2026 mingliqiye * Copyright 2025 mingliqiye
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -16,163 +16,158 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile BaseCodec.kt * CurrentFile BaseCodec.kt
* LastUpdate 2026-10-11 16:52:16 * LastUpdate 2025-09-18 14:07:35
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.base package com.mingliqiye.utils.base
import com.mingliqiye.utils.exception.CodecException
import java.io.File import java.io.File
import java.io.IOException
import java.nio.file.Path import java.nio.file.Path
/**
* BaseCodec 接口定义了一组用于编码和解码数据的基本方法。
* 提供了对字节数组、字符串、文件和路径的编码与解码功能,
* 并支持安全操作(在发生异常时返回默认值或布尔状态)。
*/
interface BaseCodec { interface BaseCodec {
/**
* 将字节数组编码为Base64字符串
*
* @param bytes 需要编码的字节数组
* @return 编码后的Base64字符串
*/
fun encode(bytes: ByteArray): String
/** /**
* 对字节数组进行编码,并捕获可能发生的异常。 * 将Base64字符串解码为字节数组
* *
* @param bytes 需要编码的字节数组 * @param string 需要解码的Base64字符串
* @return 编码后的字符串结果 * @return 解码后的字节数组
* @throws CodecException 如果编码过程中发生异常 */
*/ fun decode(string: String): ByteArray
fun catchEncode(bytes: ByteArray) = try {
encode(bytes)
} catch (e: Exception) {
throw CodecException(throwable = e)
}
/** /**
* 对字符串进行解码,并捕获可能发生的异常。 * 将文件内容编码为Base64字符串
* *
* @param string 需要解码的字符串 * @param file 需要编码的文件
* @return 解码后的字节数组结果 * @return 文件内容的Base64编码字符串
* @throws CodecException 如果解码过程中发生异常 * @throws IOException 当文件读取失败时抛出
*/ */
fun catchDecode(string: String) = try { @Throws(IOException::class)
decode(string) fun encode(file: File): String {
} catch (e: Exception) { return encode(file.readBytes())
throw CodecException(throwable = e) }
}
/** /**
* 将字节数组编码为字符串。 * 将Base64字符串解码并写入文件
* *
* @param bytes 需要编码的字节数组 * @param file 目标文件
* @return 编码后的字符串结果 * @param string 需要解码的Base64字符串
*/ * @throws IOException 当文件写入失败时抛出
fun encode(bytes: ByteArray): String */
@Throws(IOException::class)
fun decode(file: File, string: String) {
file.writeBytes(decode(string))
}
/** /**
* 将字符串解码为字节数组。 * 安全地将文件内容编码为Base64字符串,出现异常时返回null
* *
* @param string 需要解码的字符串 * @param file 需要编码的文件
* @return 解码后的字节数组结果 * @return 文件内容的Base64编码字符串,失败时返回null
*/ */
fun decode(string: String): ByteArray fun encodeSafe(file: File): String? {
return try {
encode(file)
} catch (_: Exception) {
null
}
}
/** /**
* 对文件内容进行编码。 * 安全地将Base64字符串解码并写入文件,返回操作是否成功
* *
* @param file 需要编码的文件对象 * @param file 目标文件
* @return 文件内容编码后的字符串结果 * @param string 需要解码的Base64字符串
*/ * @return 操作成功返回true,失败返回false
fun encode(file: File) = catchEncode(file.readBytes()) */
fun decodeSafe(file: File, string: String): Boolean {
return try {
decode(file, string)
true
} catch (_: Exception) {
false
}
}
/** /**
* 将字符串解码后写入指定文件。 * 将路径对应的文件内容编码为Base64字符串
* *
* @param file 目标文件对象 * @param path 需要编码的文件路径
* @param string 需要解码的字符串 * @return 文件内容的Base64编码字符串
*/ * @throws IOException 当文件读取失败时抛出
fun decode(file: File, string: String) = */
file.writeBytes(catchDecode(string)) @Throws(IOException::class)
fun encode(path: Path): String {
return encode(path.toFile().readBytes())
}
/** /**
* 安全地对文件内容进行编码,如果发生异常则返回 null。 * 将Base64字符串解码并写入路径指定的文件
* *
* @param file 需要编码的文件对象 * @param path 目标文件路径
* @return 文件内容编码后的字符串结果,若失败则返回 null * @param string 需要解码的Base64字符串
*/ * @throws IOException 当文件写入失败时抛出
fun encodeSafe(file: File) = try { */
encode(file) @Throws(IOException::class)
} catch (_: Exception) { fun decode(path: Path, string: String) {
null path.toFile().writeBytes(decode(string))
} }
/** /**
* 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。 * 安全地将路径对应的文件内容编码为Base64字符串,出现异常时返回null
* *
* @param file 目标文件对象 * @param path 需要编码的文件路径
* @param string 需要解码的字符串 * @return 文件内容的Base64编码字符串,失败时返回null
* @return 操作是否成功的布尔值 */
*/ fun encodeSafe(path: Path): String? {
fun decodeSafe(file: File, string: String) = try { return try {
decode(file, string) encode(path)
true } catch (_: Exception) {
} catch (_: Exception) { null
false }
} }
/** /**
* 对路径指向的文件内容进行编码。 * 安全地将Base64字符串解码并写入路径指定的文件,返回操作是否成功
* *
* @param path 需要编码的文件路径 * @param path 目标文件路径
* @return 文件内容编码后的字符串结果 * @param string 需要解码的Base64字符串
*/ * @return 操作成功返回true,失败返回false
fun encode(path: Path) = catchEncode(path.toFile().readBytes()) */
fun decodeSafe(path: Path, string: String): Boolean {
return try {
decode(path, string)
true
} catch (_: Exception) {
false
}
}
/** /**
* 将字符串解码后写入指定路径的文件。 * 将字符串编码为Base64字符串
* *
* @param path 目标文件路径 * @param string 需要编码的字符串
* @param string 需要解码的字符串 * @return 编码后的Base64字符串
*/ */
fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string)) fun encode(string: String): String {
return encode(string.toByteArray())
}
/** /**
* 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。 * 将Base64字符串解码为字符串
* *
* @param path 需要编码的文件路径 * @param string 需要解码的Base64字符串
* @return 文件内容编码后的字符串结果,若失败则返回 null * @return 解码后的字符串
*/ */
fun encodeSafe(path: Path) = try { fun decodetoString(string: String): String {
encode(path) return decode(string).toString(Charsets.UTF_8)
} catch (_: Exception) { }
null
}
/**
* 安全地将字符串解码并写入指定路径的文件,如果成功则返回 true,否则返回 false。
*
* @param path 目标文件路径
* @param string 需要解码的字符串
* @return 操作是否成功的布尔值
*/
fun decodeSafe(path: Path, string: String) = try {
decode(path, string)
true
} catch (_: Exception) {
false
}
/**
* 对字符串进行编码。
*
* @param string 需要编码的字符串
* @return 编码后的字符串结果
*/
fun encode(string: String) = catchEncode(string.toByteArray())
/**
* 将字符串解码为 UTF-8 格式的字符串。
*
* @param string 需要解码的字符串
* @return 解码后的 UTF-8 字符串结果
*/
fun decodetoString(string: String) = catchDecode(string).toString(Charsets.UTF_8)
} }
@@ -16,23 +16,15 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile BaseType.kt * CurrentFile BaseType.kt
* LastUpdate 2026-03-12 10:08:42 * LastUpdate 2026-02-04 21:54:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.base package com.mingliqiye.utils.base
enum class BaseType(val baseCodec: BaseCodec) : BaseCodec { enum class BaseType(val baseCodec: BaseCodec) {
BASE16(com.mingliqiye.utils.base.BASE16),
BASE2(com.mingliqiye.utils.base.code.BASE2), BASE64(com.mingliqiye.utils.base.BASE64),
BASE10(com.mingliqiye.utils.base.code.BASE10), BASE91(com.mingliqiye.utils.base.BASE91),
BASE16(com.mingliqiye.utils.base.code.BASE16), BASE256(com.mingliqiye.utils.base.BASE256),
BASE64(com.mingliqiye.utils.base.code.BASE64),
BASE64URL(com.mingliqiye.utils.base.code.BASE64URL),
BASE91(com.mingliqiye.utils.base.code.BASE91),
BASE256(com.mingliqiye.utils.base.code.BASE256);
override fun encode(bytes: ByteArray) = baseCodec.encode(bytes)
override fun decode(string: String) = baseCodec.decode(string)
} }
@@ -0,0 +1,72 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile BaseUtils.kt
* LastUpdate 2026-02-08 03:00:37
* UpdateUser MingLiPro
*/
@file:JvmName("BaseUtils")
package com.mingliqiye.utils.base
import com.mingliqiye.utils.base.code.Base10
import com.mingliqiye.utils.base.code.Base16
import com.mingliqiye.utils.base.code.Base256
import com.mingliqiye.utils.base.code.Base64
import com.mingliqiye.utils.base.code.Base91
@Deprecated(
"重命名", replaceWith = ReplaceWith(
expression = "Base10", imports = ["com.mingliqiye.utils.base.code"]
)
)
val BASE10: BaseCodec
get() = Base10
@Deprecated(
"重命名", replaceWith = ReplaceWith(
expression = "Base16", imports = ["com.mingliqiye.utils.base.code"]
)
)
val BASE16: BaseCodec
get() = Base16
@Deprecated(
"重命名", replaceWith = ReplaceWith(
expression = "Base64", imports = ["com.mingliqiye.utils.base.code"]
)
)
val BASE64: BaseCodec
get() = Base64
@Deprecated(
"重命名", replaceWith = ReplaceWith(
expression = "Base91", imports = ["com.mingliqiye.utils.base.code"]
)
)
val BASE91: BaseCodec
get() = Base91
@Deprecated(
"重命名", replaceWith = ReplaceWith(
expression = "Base256", imports = ["com.mingliqiye.utils.base.code"]
)
)
val BASE256: BaseCodec
get() = Base256
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile BaseCodes.kt * CurrentFile BaseCodes.kt
* LastUpdate 2026-03-12 10:03:32 * LastUpdate 2026-02-08 03:10:03
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -30,57 +30,52 @@ import com.mingliqiye.utils.base.*
* 提供Base2编码器的懒加载实例。 * 提供Base2编码器的懒加载实例。
* 该编码器用于将数据编码为二进制格式。 * 该编码器用于将数据编码为二进制格式。
*/ */
@get:JvmName("base2") @get:JvmName("Base2")
val BASE2: BaseCodec by lazy { val Base2: BaseCodec by lazy {
Base2Codec() Base2()
} }
/** /**
* 提供Base10编码器的懒加载实例。 * 提供Base10编码器的懒加载实例。
* 该编码器用于将数据编码为十进制格式。 * 该编码器用于将数据编码为十进制格式。
*/ */
@get:JvmName("base10") @get:JvmName("Base10")
val BASE10: BaseCodec by lazy { val Base10: BaseCodec by lazy {
Base10Codec() Base10()
} }
/** /**
* 提供Base16编码器的懒加载实例。 * 提供Base16编码器的懒加载实例。
* 该编码器用于将数据编码为十六进制格式。 * 该编码器用于将数据编码为十六进制格式。
*/ */
@get:JvmName("base16") @get:JvmName("Base16")
val BASE16: BaseCodec by lazy { val Base16: BaseCodec by lazy {
Base16Codec() Base16()
} }
/** /**
* 提供Base64编码器的懒加载实例。 * 提供Base64编码器的懒加载实例。
* 该编码器用于将数据编码为Base64格式,常用于URL安全传输或存储。 * 该编码器用于将数据编码为Base64格式,常用于URL安全传输或存储。
*/ */
@get:JvmName("base64") @get:JvmName("Base64")
val BASE64: BaseCodec by lazy { val Base64: BaseCodec by lazy {
Base64Codec() Base64()
}
@get:JvmName("base64Url")
val BASE64URL: BaseCodec by lazy {
Base64UrlCodec()
} }
/** /**
* 提供Base91编码器的懒加载实例。 * 提供Base91编码器的懒加载实例。
* 该编码器用于将数据编码为Base91格式,具有较高的压缩效率。 * 该编码器用于将数据编码为Base91格式,具有较高的压缩效率。
*/ */
@get:JvmName("base91") @get:JvmName("Base91")
val BASE91: BaseCodec by lazy { val Base91: BaseCodec by lazy {
Base91Codec() Base91()
} }
/** /**
* 提供Base256编码器的懒加载实例。 * 提供Base256编码器的懒加载实例。
* 该编码器用于将数据编码为Base256格式,适用于字节级数据处理。 * 该编码器用于将数据编码为Base256格式,适用于字节级数据处理。
*/ */
@get:JvmName("base256") @get:JvmName("Base256")
val BASE256: BaseCodec by lazy { val Base256: BaseCodec by lazy {
Base256Codec() Base256()
} }
@@ -30,30 +30,30 @@ import org.mindrot.jbcrypt.BCrypt as JBCrypt
fun hashpw(string: String): String { fun hashpw(string: String): String {
return hashpw(string, gensalt()) return hashpw(string, gensalt())
} }
fun hashpw(string: String, salt: String = gensalt()): String { fun hashpw(string: String, salt: String = gensalt()): String {
return JBCrypt.hashpw(string, salt) return JBCrypt.hashpw(string, salt)
} }
fun checkpw(string: String, bcrypted: String): Boolean { fun checkpw(string: String, bcrypted: String): Boolean {
return JBCrypt.checkpw(string, bcrypted) return JBCrypt.checkpw(string, bcrypted)
} }
fun gensalt(): String { fun gensalt(): String {
return JBCrypt.gensalt() return JBCrypt.gensalt()
} }
fun gensalt(long: Int): String { fun gensalt(long: Int): String {
return JBCrypt.gensalt(long) return JBCrypt.gensalt(long)
} }
fun gensalt(long: Int, secureRandom: SecureRandom): String { fun gensalt(long: Int, secureRandom: SecureRandom): String {
return JBCrypt.gensalt(long, secureRandom) return JBCrypt.gensalt(long, secureRandom)
} }
File diff suppressed because it is too large Load Diff
@@ -1,276 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile ByteBufferWrapperConvertor.kt
* LastUpdate 2026-03-15 11:05:48
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.buffer.convertor
import com.mingliqiye.utils.buffer.ByteBufferWrapper
import com.mingliqiye.utils.bytes.ByteFlags
import com.mingliqiye.utils.time.DateTime
import com.mingliqiye.utils.uuid.UUID
import java.math.BigDecimal
import java.math.BigInteger
import java.time.LocalDateTime
import java.util.*
import java.util.concurrent.ConcurrentHashMap
import java.util.UUID as JUUID
interface ByteBufferWrapperConvertorInterface<T : Any> {
fun write(obj: T, byteBufferWrapper: ByteBufferWrapper)
fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T
fun getType(): Class<T>
}
abstract class ByteBufferWrapperConvertor<T : Any> : ByteBufferWrapperConvertorInterface<T> {
override fun toString(): String {
return "ByteBufferWrapperConvertor(type=${getType()})"
}
companion object {
private val _instantiations =
ConcurrentHashMap<Class<ByteBufferWrapperConvertor<*>>, ByteBufferWrapperConvertor<*>>()
@JvmStatic
fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> {
return _instantiations.getOrPut(clazz) {
clazz.getConstructor().newInstance()
}
}
@JvmStatic
@Suppress("UNCHECKED_CAST")
inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> {
return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>)
}
fun defaultConvertorInstall() {
ByteBufferWrapper.addConvertor<BigDecimalBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BigIntegerBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BooleanBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BytedBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ByteFlagsBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<CharBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DateBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DateTimeFlagsBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DoubleBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<FloatBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<IntBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<JUUIDBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<LocalDateTimeBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<LongBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ShortBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<StringBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<UUIDBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ByteArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<CharArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<ShortArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<IntArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<LongArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<FloatArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<DoubleArrayBufferWrapperConvertor>()
ByteBufferWrapper.addConvertor<BooleanArrayBufferWrapperConvertor>()
}
}
}
abstract class ObjectBufferWrapperConvertor<T : Any>(
val write: ByteBufferWrapper.(obj: T) -> Unit,
val read: ByteBufferWrapper.() -> T,
val typer: Class<T>,
) : ByteBufferWrapperConvertor<T>() {
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T =
read.invoke(byteBufferWrapper)
override fun getType(): Class<T> = typer
}
class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>(
ByteBufferWrapper::putByte,
ByteBufferWrapper::getByte,
Byte::class.java,
)
class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>(
ByteBufferWrapper::putChar,
ByteBufferWrapper::getChar,
Char::class.java,
)
class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>(
ByteBufferWrapper::putShort,
ByteBufferWrapper::getShort,
Short::class.java,
)
class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>(
ByteBufferWrapper::putInt,
ByteBufferWrapper::getInt,
Int::class.java,
)
class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>(
ByteBufferWrapper::putLong,
ByteBufferWrapper::getLong,
Long::class.java,
)
class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>(
ByteBufferWrapper::putDouble,
ByteBufferWrapper::getDouble,
Double::class.java,
)
class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>(
ByteBufferWrapper::putFloat,
ByteBufferWrapper::getFloat,
Float::class.java,
)
class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>(
ByteBufferWrapper::putBigInteger,
ByteBufferWrapper::getBigInteger,
BigInteger::class.java,
)
class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>(
ByteBufferWrapper::putBigDecimal,
ByteBufferWrapper::getBigDecimal,
BigDecimal::class.java,
)
class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>(
ByteBufferWrapper::putBoolean,
ByteBufferWrapper::getBoolean,
Boolean::class.java,
)
class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>(
ByteBufferWrapper::putString,
ByteBufferWrapper::getString,
String::class.java,
)
class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>(
ByteBufferWrapper::putFlag,
ByteBufferWrapper::getFlag,
ByteFlags::class.java,
)
class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>(
ByteBufferWrapper::putUUID,
ByteBufferWrapper::getJUUID,
JUUID::class.java,
)
class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>(
ByteBufferWrapper::putUUID,
ByteBufferWrapper::getUUID,
UUID::class.java,
)
class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>(
ByteBufferWrapper::putDateTime,
ByteBufferWrapper::getDateTime,
DateTime::class.java,
)
class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>(
ByteBufferWrapper::putLocalDateTime,
ByteBufferWrapper::getLocalDateTime,
LocalDateTime::class.java,
)
class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>(
ByteBufferWrapper::putDate,
ByteBufferWrapper::getDate,
Date::class.java,
)
abstract class ArrayBufferWrapperConvertor<T : Any>(
val write: ByteBufferWrapper.(obj: T) -> Unit,
val read: ByteBufferWrapper.(size: Int) -> T,
val typer: Class<T>,
) : ByteBufferWrapperConvertor<T>() {
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T {
if (parameters.isEmpty()) {
throw IllegalArgumentException("parameters cannot be empty, must has a Int")
}
val size = parameters[0]
if (size !is Int)
throw IllegalArgumentException("parameters[0] cannot be Int, must has a Int")
return read.invoke(byteBufferWrapper, size)
}
override fun getType(): Class<T> = typer
}
class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>(
ByteBufferWrapper::putByteArray,
ByteBufferWrapper::getByteArray,
ByteArray::class.java,
)
class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>(
ByteBufferWrapper::putCharArray,
ByteBufferWrapper::getCharArray,
CharArray::class.java,
)
class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>(
ByteBufferWrapper::putShortArray,
ByteBufferWrapper::getShortArray,
ShortArray::class.java,
)
class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>(
ByteBufferWrapper::putIntArray,
ByteBufferWrapper::getIntArray,
IntArray::class.java,
)
class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>(
ByteBufferWrapper::putLongArray,
ByteBufferWrapper::getLongArray,
LongArray::class.java,
)
class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>(
ByteBufferWrapper::putFloatArray,
ByteBufferWrapper::getFloatArray,
FloatArray::class.java,
)
class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>(
ByteBufferWrapper::putDoubleArray,
ByteBufferWrapper::getDoubleArray,
DoubleArray::class.java,
)
class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>(
ByteBufferWrapper::putBooleanArray,
ByteBufferWrapper::getBooleanArray,
BooleanArray::class.java,
)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ByteBufferUtils.kt * CurrentFile ByteBufferUtils.kt
* LastUpdate 2026-07-02 09:31:01 * LastUpdate 2026-01-11 09:44:19
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -26,7 +26,6 @@ package com.mingliqiye.utils.bytes
import java.io.IOException import java.io.IOException
import java.io.OutputStream import java.io.OutputStream
import java.nio.BufferUnderflowException
import java.nio.ByteBuffer import java.nio.ByteBuffer
import java.nio.charset.Charset import java.nio.charset.Charset
@@ -40,7 +39,7 @@ import java.nio.charset.Charset
* @return 当前 [ByteBuffer] 实例(支持链式调用) * @return 当前 [ByteBuffer] 实例(支持链式调用)
*/ */
fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer = fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer =
this.put(string.toByteArray(charset)).put(0x00) this.put(string.toByteArray(charset)).put(0x00)
/** /**
* 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。 * 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。
@@ -53,15 +52,15 @@ fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): Byt
* @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符) * @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符)
*/ */
fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String { fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
val data = ArrayList<Byte>() val data = ArrayList<Byte>()
while (true) { while (true) {
val byte = this.get() val byte = this.get()
if (byte == 0x00.toByte()) { if (byte == 0x00.toByte()) {
break break
} }
data.add(byte) data.add(byte)
} }
return String(data.toByteArray(), charset) return String(data.toByteArray(), charset)
} }
/** /**
@@ -72,9 +71,9 @@ fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
* @return 包含剩余字节的新字节数组 * @return 包含剩余字节的新字节数组
*/ */
fun ByteBuffer.toByteArray(): ByteArray { fun ByteBuffer.toByteArray(): ByteArray {
val ba = ByteArray(this.remaining()) val ba = ByteArray(this.remaining())
this.get(ba) this.get(ba)
return ba return ba
} }
/** /**
@@ -87,18 +86,18 @@ fun ByteBuffer.toByteArray(): ByteArray {
* @throws IndexOutOfBoundsException 如果列表长度不足 8 * @throws IndexOutOfBoundsException 如果列表长度不足 8
*/ */
fun ByteBuffer.putByteFlags( fun ByteBuffer.putByteFlags(
bit: List<Boolean> = List(8) { false }, bit: List<Boolean> = List(8) { false },
): ByteBuffer = this.putByteFlags( ): ByteBuffer = this.putByteFlags(
ByteFlags( ByteFlags(
bit[0], bit[0],
bit[1], bit[1],
bit[2], bit[2],
bit[3], bit[3],
bit[4], bit[4],
bit[5], bit[5],
bit[6], bit[6],
bit[7], bit[7],
) )
) )
/** /**
@@ -111,18 +110,18 @@ fun ByteBuffer.putByteFlags(
* @throws IndexOutOfBoundsException 如果数组长度不足 8 * @throws IndexOutOfBoundsException 如果数组长度不足 8
*/ */
fun ByteBuffer.putByteFlags( fun ByteBuffer.putByteFlags(
bit: BooleanArray = BooleanArray(8), bit: BooleanArray = BooleanArray(8),
): ByteBuffer = this.putByteFlags( ): ByteBuffer = this.putByteFlags(
ByteFlags( ByteFlags(
bit[0], bit[0],
bit[1], bit[1],
bit[2], bit[2],
bit[3], bit[3],
bit[4], bit[4],
bit[5], bit[5],
bit[6], bit[6],
bit[7], bit[7],
) )
) )
/** /**
@@ -149,25 +148,25 @@ fun ByteBuffer.putByteFlags(byteFlags: ByteFlags): ByteBuffer = this.put(byteFla
* @return 当前 [ByteBuffer] 实例(支持链式调用) * @return 当前 [ByteBuffer] 实例(支持链式调用)
*/ */
fun ByteBuffer.putByteFlags( fun ByteBuffer.putByteFlags(
bit0: Boolean = false, bit0: Boolean = false,
bit1: Boolean = false, bit1: Boolean = false,
bit2: Boolean = false, bit2: Boolean = false,
bit3: Boolean = false, bit3: Boolean = false,
bit4: Boolean = false, bit4: Boolean = false,
bit5: Boolean = false, bit5: Boolean = false,
bit6: Boolean = false, bit6: Boolean = false,
bit7: Boolean = false, bit7: Boolean = false,
): ByteBuffer = this.putByteFlags( ): ByteBuffer = this.putByteFlags(
ByteFlags( ByteFlags(
bit0, bit0,
bit1, bit1,
bit2, bit2,
bit3, bit3,
bit4, bit4,
bit5, bit5,
bit6, bit6,
bit7, bit7,
) )
) )
/** /**
@@ -204,7 +203,7 @@ fun ByteBuffer.putBoolean(boolean: Boolean): ByteBuffer = this.put(if (boolean)
* @return 包装后的 [ByteBuffer] 实例 * @return 包装后的 [ByteBuffer] 实例
*/ */
fun ByteArray.toByteBuffer(): ByteBuffer { fun ByteArray.toByteBuffer(): ByteBuffer {
return ByteBuffer.wrap(this) return ByteBuffer.wrap(this)
} }
/** /**
@@ -219,19 +218,19 @@ fun ByteArray.toByteBuffer(): ByteBuffer {
* @throws IOException 当读取过程中发生IO异常时抛出。 * @throws IOException 当读取过程中发生IO异常时抛出。
*/ */
fun ByteBuffer.getVarLong(size: Int = 8): Long { fun ByteBuffer.getVarLong(size: Int = 8): Long {
var numRead = 0 var numRead = 0
var result: Long = 0 var result: Long = 0
var read: Byte var read: Byte
do { do {
read = this.get() read = this.get()
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算 // 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
result = result or ((read.toLong() and 127) shl (7 * numRead)) result = result or ((read.toLong() and 127) shl (7 * numRead))
numRead++ numRead++
if (numRead > size) { if (numRead > size) {
throw IOException("VarNumber is too big") throw IOException("VarNumber is too big")
} }
} while ((read.toLong() and 128) != 0L) } while ((read.toLong() and 128) != 0L)
return result return result
} }
/** /**
@@ -269,13 +268,13 @@ fun ByteBuffer.getVarLong(): Long = this.getVarLong(8)
* @return 当前ByteBuffer实例(支持链式调用) * @return 当前ByteBuffer实例(支持链式调用)
*/ */
fun ByteBuffer.putVarLong(value: Long): ByteBuffer { fun ByteBuffer.putVarLong(value: Long): ByteBuffer {
var v = value var v = value
while (v >= 0x80) { while (v >= 0x80) {
this.put((v and 0x7F or 0x80).toByte()) this.put((v and 0x7F or 0x80).toByte())
v = v shr 7 v = v shr 7
} }
this.put(v.toByte()) this.put(v.toByte())
return this return this
} }
/** /**
@@ -1,50 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile ByteConvertible.kt
* LastUpdate 2026-02-08 10:25:22
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.bytes
import java.io.OutputStream
import java.io.Serializable
import java.nio.ByteBuffer
interface ByteConvertible : Serializable {
fun toBytes(): ByteArray
fun writeToStream(outputStream: OutputStream) {
outputStream.write(toBytes())
}
fun putToByteBuffer(byteBuffer: ByteBuffer) {
byteBuffer.put(toBytes())
}
companion object {
fun OutputStream.write(byteConvertible: ByteConvertible) {
byteConvertible.writeToStream(this)
}
fun ByteBuffer.put(byteConvertible: ByteConvertible) {
byteConvertible.putToByteBuffer(this)
}
}
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ByteFlags.kt * CurrentFile ByteFlags.kt
* LastUpdate 2026-06-21 10:40:58 * LastUpdate 2026-01-07 09:37:09
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -32,429 +32,429 @@ package com.mingliqiye.utils.bytes
* 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。 * 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。
*/ */
data class ByteFlags( data class ByteFlags(
/** 第 0 位(最低位,0x01) */ /** 第 0 位(最低位,0x01) */
var b0: Boolean = false, var b0: Boolean = false,
/** 第 1 位(0x02) */ /** 第 1 位(0x02) */
var b1: Boolean = false, var b1: Boolean = false,
/** 第 2 位(0x04) */ /** 第 2 位(0x04) */
var b2: Boolean = false, var b2: Boolean = false,
/** 第 3 位(0x08) */ /** 第 3 位(0x08) */
var b3: Boolean = false, var b3: Boolean = false,
/** 第 4 位(0x10) */ /** 第 4 位(0x10) */
var b4: Boolean = false, var b4: Boolean = false,
/** 第 5 位(0x20) */ /** 第 5 位(0x20) */
var b5: Boolean = false, var b5: Boolean = false,
/** 第 6 位(0x40) */ /** 第 6 位(0x40) */
var b6: Boolean = false, var b6: Boolean = false,
/** 第 7 位(最高位,0x80) */ /** 第 7 位(最高位,0x80) */
var b7: Boolean = false, var b7: Boolean = false
) { ) {
/** /**
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。 * 通过一个 [Byte] 值构造 [ByteFlags] 实例。
* *
* @param byte 用于初始化的字节值(仅使用低 8 位) * @param byte 用于初始化的字节值(仅使用低 8 位)
*/ */
constructor(byte: Byte) : this() { constructor(byte: Byte) : this() {
fromByte(byte) fromByte(byte)
} }
/** /**
* 从给定的 [Byte] 值解析并设置各个位标志。 * 从给定的 [Byte] 值解析并设置各个位标志。
* *
* @param byte 要解析的字节 * @param byte 要解析的字节
*/ */
fun fromByte(byte: Byte) { fun fromByte(byte: Byte) {
val value = byte.toInt() and 0xFF val value = byte.toInt() and 0xFF
b0 = (value and 0x01) != 0 b0 = (value and 0x01) != 0
b1 = (value and 0x02) != 0 b1 = (value and 0x02) != 0
b2 = (value and 0x04) != 0 b2 = (value and 0x04) != 0
b3 = (value and 0x08) != 0 b3 = (value and 0x08) != 0
b4 = (value and 0x10) != 0 b4 = (value and 0x10) != 0
b5 = (value and 0x20) != 0 b5 = (value and 0x20) != 0
b6 = (value and 0x40) != 0 b6 = (value and 0x40) != 0
b7 = (value and 0x80) != 0 b7 = (value and 0x80) != 0
} }
/** /**
* 将当前标志状态转换为一个 [Byte] 值。 * 将当前标志状态转换为一个 [Byte] 值。
* *
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回) * @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
*/ */
fun toByte(): Byte { fun toByte(): Byte {
var result = 0 var result = 0
if (b0) result = result or 0x01 if (b0) result = result or 0x01
if (b1) result = result or 0x02 if (b1) result = result or 0x02
if (b2) result = result or 0x04 if (b2) result = result or 0x04
if (b3) result = result or 0x08 if (b3) result = result or 0x08
if (b4) result = result or 0x10 if (b4) result = result or 0x10
if (b5) result = result or 0x20 if (b5) result = result or 0x20
if (b6) result = result or 0x40 if (b6) result = result or 0x40
if (b7) result = result or 0x80 if (b7) result = result or 0x80
return result.toByte() return result.toByte()
} }
/** /**
* 通过索引(0~7)获取对应位的布尔值。 * 通过索引(0~7)获取对应位的布尔值。
* *
* @param index 位索引(0 = LSB, 7 = MSB) * @param index 位索引(0 = LSB, 7 = MSB)
* @return 该位是否为 true * @return 该位是否为 true
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内 * @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
*/ */
operator fun get(index: Int): Boolean { operator fun get(index: Int): Boolean {
return when (index) { return when (index) {
0 -> b0 0 -> b0
1 -> b1 1 -> b1
2 -> b2 2 -> b2
3 -> b3 3 -> b3
4 -> b4 4 -> b4
5 -> b5 5 -> b5
6 -> b6 6 -> b6
7 -> b7 7 -> b7
else -> throw IndexOutOfBoundsException("索引必须在0-7之间") else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
} }
} }
/** /**
* 通过索引(0~7)设置对应位的布尔值。 * 通过索引(0~7)设置对应位的布尔值。
* *
* @param index 位索引(0 = LSB, 7 = MSB) * @param index 位索引(0 = LSB, 7 = MSB)
* @param value 要设置的布尔值 * @param value 要设置的布尔值
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内 * @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
*/ */
operator fun set(index: Int, value: Boolean) { operator fun set(index: Int, value: Boolean) {
when (index) { when (index) {
0 -> b0 = value 0 -> b0 = value
1 -> b1 = value 1 -> b1 = value
2 -> b2 = value 2 -> b2 = value
3 -> b3 = value 3 -> b3 = value
4 -> b4 = value 4 -> b4 = value
5 -> b5 = value 5 -> b5 = value
6 -> b6 = value 6 -> b6 = value
7 -> b7 = value 7 -> b7 = value
else -> throw IndexOutOfBoundsException("索引必须在0-7之间") else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
} }
} }
/** /**
* 将所有 8 个位设置为 `true`。 * 将所有 8 个位设置为 `true`。
*/ */
fun setAll() { fun setAll() {
b0 = true b0 = true
b1 = true b1 = true
b2 = true b2 = true
b3 = true b3 = true
b4 = true b4 = true
b5 = true b5 = true
b6 = true b6 = true
b7 = true b7 = true
} }
/** /**
* 将所有 8 个位设置为 `false`。 * 将所有 8 个位设置为 `false`。
*/ */
fun clearAll() { fun clearAll() {
b0 = false b0 = false
b1 = false b1 = false
b2 = false b2 = false
b3 = false b3 = false
b4 = false b4 = false
b5 = false b5 = false
b6 = false b6 = false
b7 = false b7 = false
} }
/** /**
* 对所有位执行逻辑取反(true ↔ false)。 * 对所有位执行逻辑取反(true ↔ false)。
*/ */
fun toggleAll() { fun toggleAll() {
b0 = !b0 b0 = !b0
b1 = !b1 b1 = !b1
b2 = !b2 b2 = !b2
b3 = !b3 b3 = !b3
b4 = !b4 b4 = !b4
b5 = !b5 b5 = !b5
b6 = !b6 b6 = !b6
b7 = !b7 b7 = !b7
} }
/** /**
* 切换指定索引位的状态(true 变 false,反之亦然)。 * 切换指定索引位的状态(true 变 false,反之亦然)。
* *
* @param index 要切换的位索引(0~7) * @param index 要切换的位索引(0~7)
* @throws IndexOutOfBoundsException 如果索引无效 * @throws IndexOutOfBoundsException 如果索引无效
*/ */
fun toggle(index: Int) { fun toggle(index: Int) {
this[index] = !this[index] this[index] = !this[index]
} }
/** /**
* 检查是否所有位都为 `true`。 * 检查是否所有位都为 `true`。
* *
* @return 若全部为 true 则返回 true,否则 false * @return 若全部为 true 则返回 true,否则 false
*/ */
fun allTrue(): Boolean { fun allTrue(): Boolean {
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7 return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
} }
/** /**
* 检查是否所有位都为 `false`。 * 检查是否所有位都为 `false`。
* *
* @return 若全部为 false 则返回 true,否则 false * @return 若全部为 false 则返回 true,否则 false
*/ */
fun allFalse(): Boolean { fun allFalse(): Boolean {
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7 return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
} }
/** /**
* 统计值为 `true` 的位数量。 * 统计值为 `true` 的位数量。
* *
* @return true 位的个数(0~8) * @return true 位的个数(0~8)
*/ */
fun countTrue(): Int { fun countTrue(): Int {
var count = 0 var count = 0
if (b0) count++ if (b0) count++
if (b1) count++ if (b1) count++
if (b2) count++ if (b2) count++
if (b3) count++ if (b3) count++
if (b4) count++ if (b4) count++
if (b5) count++ if (b5) count++
if (b6) count++ if (b6) count++
if (b7) count++ if (b7) count++
return count return count
} }
/** /**
* 统计值为 `false` 的位数量。 * 统计值为 `false` 的位数量。
* *
* @return false 位的个数(0~8) * @return false 位的个数(0~8)
*/ */
fun countFalse(): Int = 8 - countTrue() fun countFalse(): Int = 8 - countTrue()
/** /**
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。 * 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
* *
* 支持别名:`bN` 或 `bitN`(不区分大小写)。 * 支持别名:`bN` 或 `bitN`(不区分大小写)。
* *
* @param name 位的名称(例如 "b0", "BIT5") * @param name 位的名称(例如 "b0", "BIT5")
* @return 对应位的布尔值 * @return 对应位的布尔值
* @throws IllegalArgumentException 如果名称无效 * @throws IllegalArgumentException 如果名称无效
*/ */
fun getByName(name: String): Boolean { fun getByName(name: String): Boolean {
return when (name.lowercase()) { return when (name.lowercase()) {
"b0", "bit0" -> b0 "b0", "bit0" -> b0
"b1", "bit1" -> b1 "b1", "bit1" -> b1
"b2", "bit2" -> b2 "b2", "bit2" -> b2
"b3", "bit3" -> b3 "b3", "bit3" -> b3
"b4", "bit4" -> b4 "b4", "bit4" -> b4
"b5", "bit5" -> b5 "b5", "bit5" -> b5
"b6", "bit6" -> b6 "b6", "bit6" -> b6
"b7", "bit7" -> b7 "b7", "bit7" -> b7
else -> throw IllegalArgumentException("未知的位名称: $name") else -> throw IllegalArgumentException("未知的位名称: $name")
} }
} }
/** /**
* 将当前状态转换为标准二进制字符串(MSB 在前)。 * 将当前状态转换为标准二进制字符串(MSB 在前)。
* *
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001" * 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
* *
* @return 8 位二进制字符串(高位在左) * @return 8 位二进制字符串(高位在左)
*/ */
fun toBinaryString(): String { fun toBinaryString(): String {
return buildString { return buildString {
if (b7) append('1') else append('0') if (b7) append('1') else append('0')
if (b6) append('1') else append('0') if (b6) append('1') else append('0')
if (b5) append('1') else append('0') if (b5) append('1') else append('0')
if (b4) append('1') else append('0') if (b4) append('1') else append('0')
if (b3) append('1') else append('0') if (b3) append('1') else append('0')
if (b2) append('1') else append('0') if (b2) append('1') else append('0')
if (b1) append('1') else append('0') if (b1) append('1') else append('0')
if (b0) append('1') else append('0') if (b0) append('1') else append('0')
} }
} }
/** /**
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。 * 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
* *
* 例如:若值为 10,则返回 "0x0A" * 例如:若值为 10,则返回 "0x0A"
* *
* @return 格式如 "0xXX" 的十六进制字符串 * @return 格式如 "0xXX" 的十六进制字符串
*/ */
fun toHexString(): String { fun toHexString(): String {
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase() return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
} }
/** /**
* 将当前位状态转换为布尔数组。 * 将当前位状态转换为布尔数组。
* *
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。 * 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
* *
* @return 长度为 8 的布尔数组 * @return 长度为 8 的布尔数组
*/ */
fun toBooleanArray(): BooleanArray { fun toBooleanArray(): BooleanArray {
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7) return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
} }
/** /**
* 从布尔数组初始化位状态。 * 从布尔数组初始化位状态。
* *
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。 * 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
* *
* @param array 布尔数组(长度至少为 8) * @param array 布尔数组(长度至少为 8)
* @throws IllegalArgumentException 如果数组长度不足 8 * @throws IllegalArgumentException 如果数组长度不足 8
*/ */
fun fromBooleanArray(array: BooleanArray) { fun fromBooleanArray(array: BooleanArray) {
require(array.size >= 8) { "数组长度至少为8" } require(array.size >= 8) { "数组长度至少为8" }
b0 = array[0] b0 = array[0]
b1 = array[1] b1 = array[1]
b2 = array[2] b2 = array[2]
b3 = array[3] b3 = array[3]
b4 = array[4] b4 = array[4]
b5 = array[5] b5 = array[5]
b6 = array[6] b6 = array[6]
b7 = array[7] b7 = array[7]
} }
/** /**
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。 * 对两个 [ByteFlags] 执行按位“与”操作(AND)。
* *
* 结果的每一位 = this位 && other位 * 结果的每一位 = this位 && other位
* *
* @param other 另一个 ByteFlags 实例 * @param other 另一个 ByteFlags 实例
* @return 新的 ByteFlags 实例,表示 AND 结果 * @return 新的 ByteFlags 实例,表示 AND 结果
*/ */
infix fun and(other: ByteFlags): ByteFlags { infix fun and(other: ByteFlags): ByteFlags {
return ByteFlags( return ByteFlags(
this.b0 && other.b0, this.b0 && other.b0,
this.b1 && other.b1, this.b1 && other.b1,
this.b2 && other.b2, this.b2 && other.b2,
this.b3 && other.b3, this.b3 && other.b3,
this.b4 && other.b4, this.b4 && other.b4,
this.b5 && other.b5, this.b5 && other.b5,
this.b6 && other.b6, this.b6 && other.b6,
this.b7 && other.b7 this.b7 && other.b7
) )
} }
/** /**
* 对两个 [ByteFlags] 执行按位“或”操作(OR)。 * 对两个 [ByteFlags] 执行按位“或”操作(OR)。
* *
* 结果的每一位 = this位 || other位 * 结果的每一位 = this位 || other位
* *
* @param other 另一个 ByteFlags 实例 * @param other 另一个 ByteFlags 实例
* @return 新的 ByteFlags 实例,表示 OR 结果 * @return 新的 ByteFlags 实例,表示 OR 结果
*/ */
infix fun or(other: ByteFlags): ByteFlags { infix fun or(other: ByteFlags): ByteFlags {
return ByteFlags( return ByteFlags(
this.b0 || other.b0, this.b0 || other.b0,
this.b1 || other.b1, this.b1 || other.b1,
this.b2 || other.b2, this.b2 || other.b2,
this.b3 || other.b3, this.b3 || other.b3,
this.b4 || other.b4, this.b4 || other.b4,
this.b5 || other.b5, this.b5 || other.b5,
this.b6 || other.b6, this.b6 || other.b6,
this.b7 || other.b7 this.b7 || other.b7
) )
} }
/** /**
* 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。 * 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。
* *
* 结果的每一位 = this位 != other位 * 结果的每一位 = this位 != other位
* *
* @param other 另一个 ByteFlags 实例 * @param other 另一个 ByteFlags 实例
* @return 新的 ByteFlags 实例,表示 XOR 结果 * @return 新的 ByteFlags 实例,表示 XOR 结果
*/ */
infix fun xor(other: ByteFlags): ByteFlags { infix fun xor(other: ByteFlags): ByteFlags {
return ByteFlags( return ByteFlags(
this.b0 != other.b0, this.b0 != other.b0,
this.b1 != other.b1, this.b1 != other.b1,
this.b2 != other.b2, this.b2 != other.b2,
this.b3 != other.b3, this.b3 != other.b3,
this.b4 != other.b4, this.b4 != other.b4,
this.b5 != other.b5, this.b5 != other.b5,
this.b6 != other.b6, this.b6 != other.b6,
this.b7 != other.b7 this.b7 != other.b7
) )
} }
/** /**
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。 * 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
* *
* 每一位取反。 * 每一位取反。
* *
* @return 新的 ByteFlags 实例,所有位取反 * @return 新的 ByteFlags 实例,所有位取反
*/ */
operator fun not(): ByteFlags { operator fun not(): ByteFlags {
return ByteFlags( return ByteFlags(
!b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7 !b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7
) )
} }
/** /**
* 返回可读的字符串表示,包含二进制和十六进制形式。 * 返回可读的字符串表示,包含二进制和十六进制形式。
* *
* 示例:`ByteFlags(10100001 = 0xA1)` * 示例:`ByteFlags(10100001 = 0xA1)`
* *
* @return 字符串描述 * @return 字符串描述
*/ */
override fun toString(): String { override fun toString(): String {
return "ByteFlags(${toBinaryString()} = ${toHexString()})" return "ByteFlags(${toBinaryString()} = ${toHexString()})"
} }
companion object { companion object {
/** /**
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。 * 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
* *
* @return 全 1 的 ByteFlags(值为 0xFF) * @return 全 1 的 ByteFlags(值为 0xFF)
*/ */
fun allTrue(): ByteFlags { fun allTrue(): ByteFlags {
return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true) return ByteFlags(true, true, true, true, true, true, true, true)
} }
/** /**
* 创建一个所有位均为 `false` 的 [ByteFlags] 实例。 * 创建一个所有位均为 `false` 的 [ByteFlags] 实例。
* *
* @return 全 0 的 ByteFlags(值为 0x00) * @return 全 0 的 ByteFlags(值为 0x00)
*/ */
fun allFalse(): ByteFlags { fun allFalse(): ByteFlags {
return ByteFlags() return ByteFlags()
} }
/** /**
* 从 8 位二进制字符串创建 [ByteFlags] 实例。 * 从 8 位二进制字符串创建 [ByteFlags] 实例。
* *
* 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。 * 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。
* *
* @param binary 8 位二进制字符串(仅含 '0' 和 '1') * @param binary 8 位二进制字符串(仅含 '0' 和 '1')
* @return 对应的 ByteFlags 实例 * @return 对应的 ByteFlags 实例
* @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符 * @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符
*/ */
fun fromBinaryString(binary: String): ByteFlags { fun fromBinaryString(binary: String): ByteFlags {
require(binary.length == 8) { "二进制字符串长度必须为8" } require(binary.length == 8) { "二进制字符串长度必须为8" }
require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" } require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" }
return ByteFlags( return ByteFlags(
binary[7] == '1', // b0 是最低位(对应字符串最后一位) binary[7] == '1', // b0 是最低位(对应字符串最后一位)
binary[6] == '1', binary[6] == '1',
binary[5] == '1', binary[5] == '1',
binary[4] == '1', binary[4] == '1',
binary[3] == '1', binary[3] == '1',
binary[2] == '1', binary[2] == '1',
binary[1] == '1', binary[1] == '1',
binary[0] == '1' // b7 是最高位(对应字符串第一位) binary[0] == '1' // b7 是最高位(对应字符串第一位)
) )
} }
/** /**
* 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。 * 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。
* *
* @param value 输入整数 * @param value 输入整数
* @return 对应的 ByteFlags 实例 * @return 对应的 ByteFlags 实例
*/ */
fun fromInt(value: Int): ByteFlags { fun fromInt(value: Int): ByteFlags {
return ByteFlags((value and 0xFF).toByte()) return ByteFlags((value and 0xFF).toByte())
} }
} }
} }
@@ -16,14 +16,14 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ByteUtils.kt * CurrentFile ByteUtils.kt
* LastUpdate 2026-05-22 13:26:55 * LastUpdate 2026-01-14 13:01:44
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@file:JvmName("ByteUtils") @file:JvmName("ByteUtils")
package com.mingliqiye.utils.bytes package com.mingliqiye.utils.bytes
import com.mingliqiye.utils.base.BaseType import com.mingliqiye.utils.base.BASE16
import com.mingliqiye.utils.stream.SuperStream import com.mingliqiye.utils.stream.SuperStream
/** /**
@@ -87,8 +87,8 @@ const val ESC_RESERVED: Byte = 0x06
* @return 包含每个字节对应十六进制字符串的列表 * @return 包含每个字节对应十六进制字符串的列表
*/ */
fun ByteArray.getByteArrayString(): MutableList<String> { fun ByteArray.getByteArrayString(): MutableList<String> {
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) } return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
.collect(SuperStream.toListCollector()) as MutableList<String> .collect(SuperStream.toList()) as MutableList<String>
} }
@@ -99,12 +99,12 @@ fun ByteArray.getByteArrayString(): MutableList<String> {
* @throws NumberFormatException 当字符不是有效的十六进制字符时抛出 * @throws NumberFormatException 当字符不是有效的十六进制字符时抛出
*/ */
fun Char.hexDigitToValue(): Int { fun Char.hexDigitToValue(): Int {
return when (this) { return when (this) {
in '0'..'9' -> this - '0' in '0'..'9' -> this - '0'
in 'A'..'F' -> this - 'A' + 10 in 'A'..'F' -> this - 'A' + 10
in 'a'..'f' -> this - 'a' + 10 in 'a'..'f' -> this - 'a' + 10
else -> throw NumberFormatException("Invalid hex character: $this") else -> throw NumberFormatException("Invalid hex character: $this")
} }
} }
/** /**
@@ -114,7 +114,7 @@ fun Char.hexDigitToValue(): Int {
* @return 转换后的字节数组 * @return 转换后的字节数组
*/ */
fun hexStringToByteArray(string: String): ByteArray { fun hexStringToByteArray(string: String): ByteArray {
return string.hexToByteArray() return string.hexToByteArray()
} }
@@ -125,5 +125,5 @@ fun hexStringToByteArray(string: String): ByteArray {
* @return 对应的十六进制字符串 * @return 对应的十六进制字符串
*/ */
fun bytesToHex(bytes: ByteArray): String { fun bytesToHex(bytes: ByteArray): String {
return BaseType.BASE16.encode(bytes) return BASE16.encode(bytes)
} }
@@ -41,23 +41,23 @@ import java.io.OutputStream
*/ */
@Throws(IOException::class) @Throws(IOException::class)
fun InputStream.readVarNumber(size: Int = 8): Long { fun InputStream.readVarNumber(size: Int = 8): Long {
var numRead = 0 var numRead = 0
var result: Long = 0 var result: Long = 0
var read: Byte var read: Byte
do { do {
read = this.read().let { read = this.read().let {
if (it == -1) { if (it == -1) {
throw IOException("Reached end of stream") throw IOException("Reached end of stream")
} }
it.toByte() it.toByte()
} }
result = result or ((read.toLong() and 127) shl (7 * numRead)) result = result or ((read.toLong() and 127) shl (7 * numRead))
numRead++ numRead++
if (numRead > size) { if (numRead > size) {
throw IOException("VarNumber is too big") throw IOException("VarNumber is too big")
} }
} while ((read.toLong() and 128) != 0L) } while ((read.toLong() and 128) != 0L)
return result return result
} }
/** /**
@@ -102,20 +102,20 @@ fun InputStream.readVarLong(): Long = this.readVarNumber()
*/ */
@Throws(IOException::class) @Throws(IOException::class)
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) { fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
var v = value var v = value
var numWritten = 0 var numWritten = 0
while (v >= 0x80 && numWritten < size - 1) { while (v >= 0x80 && numWritten < size - 1) {
this.write((v and 0x7F or 0x80).toInt()) this.write((v and 0x7F or 0x80).toInt())
v = v ushr 7 v = v ushr 7
numWritten++ numWritten++
} }
if (numWritten >= size) { if (numWritten >= size) {
throw IOException("VarNumber is too big") throw IOException("VarNumber is too big")
} }
this.write(v.toInt()) this.write(v.toInt())
} }
/** /**
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile CloneUtils.kt * CurrentFile CloneUtils.kt
* LastUpdate 2026-02-08 10:36:51 * LastUpdate 2026-02-05 14:41:27
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@file:JvmName("CloneUtils") @file:JvmName("CloneUtils")
@@ -24,39 +24,38 @@
package com.mingliqiye.utils.clone package com.mingliqiye.utils.clone
import com.mingliqiye.utils.exception.JsonException import com.mingliqiye.utils.exception.JsonException
import com.mingliqiye.utils.json.api.JSONA import com.mingliqiye.utils.json.api.base.JsonApi
import java.io.* import java.io.*
@JvmName("_inline_deepClone") inline fun <reified T> Serializable.deepClone(): T {
inline fun <reified T : Serializable> T.deepClone(): T { return deepClone(this) as T
return deepClone(this)
} }
inline fun <reified T> T.deepJsonClone(): T { inline fun <reified T> T.deepJsonClone(jsonApi: JsonApi): T {
try { try {
return JSONA.convert(this as Any, this!!.javaClass) as T return jsonApi.convert(this as Any, this!!.javaClass) as T
} catch (e: Exception) { } catch (e: Exception) {
throw JsonException( throw JsonException(
"Failed to deep clone object using JSON", e "Failed to deep clone object using JSON", e
) )
} }
} }
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
fun <T : Serializable?> deepClone(obj: T): T { fun <T : Serializable?> deepClone(obj: T): T {
try { try {
val bao = ByteArrayOutputStream() val bao = ByteArrayOutputStream()
val oos = ObjectOutputStream(bao) val oos = ObjectOutputStream(bao)
oos.writeObject(obj) oos.writeObject(obj)
val bis = ByteArrayInputStream( val bis = ByteArrayInputStream(
bao.toByteArray() bao.toByteArray()
) )
val ois = ObjectInputStream(bis) val ois = ObjectInputStream(bis)
return ois.readObject() as T return ois.readObject() as T
} catch (e: IOException) { } catch (e: IOException) {
throw RuntimeException(e) throw RuntimeException(e)
} catch (e: ClassNotFoundException) { } catch (e: ClassNotFoundException) {
throw RuntimeException(e) throw RuntimeException(e)
} }
} }
@@ -36,7 +36,7 @@ import java.util.stream.Collectors
* @return 转换后的数组 * @return 转换后的数组
*/ */
inline fun <reified T> Collection<T>.toArray(): Array<T> { inline fun <reified T> Collection<T>.toArray(): Array<T> {
return arrayOf(*this.toTypedArray()) return arrayOf(*this.toTypedArray())
} }
/** /**
@@ -49,11 +49,11 @@ inline fun <reified T> Collection<T>.toArray(): Array<T> {
*/ */
@Suppress("UNCHECKED_CAST") @Suppress("UNCHECKED_CAST")
inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> { inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
return this.stream().collect( return this.stream().collect(
SuperStream.toMap( SuperStream.toMap(
v v
) )
) as Map<T, V> ) as Map<T, V>
} }
/** /**
@@ -67,11 +67,11 @@ inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
* @return 转换后的 Map * @return 转换后的 Map
*/ */
inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> { inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> {
return this.stream().collect( return this.stream().collect(
Collectors.toMap( Collectors.toMap(
k, v k, v
) )
) )
} }
/** /**
@@ -82,7 +82,7 @@ inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline
* @return 转换后的 Set * @return 转换后的 Set
*/ */
fun <T> toSet(array: Array<T>): Set<T> { fun <T> toSet(array: Array<T>): Set<T> {
return array.toSet() return array.toSet()
} }
@@ -93,13 +93,13 @@ fun <T> toSet(array: Array<T>): Set<T> {
* @return 第一个元素或 null * @return 第一个元素或 null
*/ */
inline fun <reified T> Collection<T>.getFirst(): T? { inline fun <reified T> Collection<T>.getFirst(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
if (this is MutableList<T>) { if (this is MutableList<T>) {
return this.first() return this.first()
} }
return this.iterator().next() return this.iterator().next()
} }
/** /**
@@ -109,10 +109,10 @@ inline fun <reified T> Collection<T>.getFirst(): T? {
* @return 第一个元素或 null * @return 第一个元素或 null
*/ */
inline fun <reified T> Array<T>.getFirst(): T? { inline fun <reified T> Array<T>.getFirst(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
return this.first() return this.first()
} }
/** /**
@@ -122,17 +122,17 @@ inline fun <reified T> Array<T>.getFirst(): T? {
* @return 最后一个元素或 null * @return 最后一个元素或 null
*/ */
inline fun <reified T> Collection<T>.getLast(): T? { inline fun <reified T> Collection<T>.getLast(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
if (this is MutableList<T>) { if (this is MutableList<T>) {
return this.last() return this.last()
} }
var lastElement: T? = null var lastElement: T? = null
for (element in this) { for (element in this) {
lastElement = element lastElement = element
} }
return lastElement return lastElement
} }
/** /**
@@ -142,10 +142,10 @@ inline fun <reified T> Collection<T>.getLast(): T? {
* @return 最后一个元素或 null * @return 最后一个元素或 null
*/ */
inline fun <reified T> Array<T>.getLast(): T? { inline fun <reified T> Array<T>.getLast(): T? {
if (this.isEmpty()) { if (this.isEmpty()) {
return null return null
} }
return this.last() return this.last()
} }
@@ -158,22 +158,22 @@ inline fun <reified T> Array<T>.getLast(): T? {
* @return 指定索引处的元素或默认值 * @return 指定索引处的元素或默认值
*/ */
inline fun <reified T> Collection<T>.getOrDefault( inline fun <reified T> Collection<T>.getOrDefault(
index: Int, defaultValue: T, index: Int, defaultValue: T
): T { ): T {
if (!(!this.isEmpty() && index < this.size)) { if (!(!this.isEmpty() && index < this.size)) {
return defaultValue return defaultValue
} }
if (this is List<T>) { if (this is List<T>) {
return this[index] return this[index]
} }
var i = 0 var i = 0
for (element in this) { for (element in this) {
if (i == index) { if (i == index) {
return element return element
} }
i++ i++
} }
return defaultValue return defaultValue
} }
/** /**
@@ -183,7 +183,7 @@ inline fun <reified T> Collection<T>.getOrDefault(
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(): ArrayList<T> { fun <T> newArrayList(): ArrayList<T> {
return ArrayList() return ArrayList()
} }
/** /**
@@ -194,7 +194,7 @@ fun <T> newArrayList(): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(size: Int): ArrayList<T> { fun <T> newArrayList(size: Int): ArrayList<T> {
return ArrayList() return ArrayList()
} }
/** /**
@@ -205,7 +205,7 @@ fun <T> newArrayList(size: Int): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(vararg elements: T): ArrayList<T> { fun <T> newArrayList(vararg elements: T): ArrayList<T> {
return newArrayList(elements.asList()) return newArrayList(elements.asList())
} }
/** /**
@@ -215,7 +215,7 @@ fun <T> newArrayList(vararg elements: T): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> Collection<T>.newArrayLists(): ArrayList<T> { fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
return newArrayList(this) return newArrayList(this)
} }
/** /**
@@ -226,7 +226,7 @@ fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayLists(elements: Array<T>): ArrayList<T> { fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
return newArrayList(elements.asList()) return newArrayList(elements.asList())
} }
/** /**
@@ -237,7 +237,7 @@ fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(elements: Collection<T>): ArrayList<T> { fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -248,7 +248,7 @@ fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> { fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
return newArrayList(elements.toList()) return newArrayList(elements.toList())
} }
/** /**
@@ -259,7 +259,7 @@ fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
* @return 新创建的 ArrayList * @return 新创建的 ArrayList
*/ */
fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> { fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
return newArrayList(elements.toList()) return newArrayList(elements.toList())
} }
/** /**
@@ -269,7 +269,7 @@ fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(): LinkedList<T> { fun <T> newLinkedList(): LinkedList<T> {
return LinkedList() return LinkedList()
} }
/** /**
@@ -280,9 +280,9 @@ fun <T> newLinkedList(): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(vararg elements: T): LinkedList<T> { fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
val list = newLinkedList<T>() val list = newLinkedList<T>()
list.addAll(elements.asList()) list.addAll(elements.asList())
return list return list
} }
/** /**
@@ -293,9 +293,9 @@ fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> { fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
val list = newLinkedList<T>() val list = newLinkedList<T>()
list.addAll(elements) list.addAll(elements)
return list return list
} }
/** /**
@@ -306,11 +306,11 @@ fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> { fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
val list = newLinkedList<T>() val list = newLinkedList<T>()
for (element in elements) { for (element in elements) {
list.add(element) list.add(element)
} }
return list return list
} }
/** /**
@@ -321,7 +321,7 @@ fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
* @return 新创建的 LinkedList * @return 新创建的 LinkedList
*/ */
fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> { fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
return newLinkedList(elements.toList()) return newLinkedList(elements.toList())
} }
/** /**
@@ -331,7 +331,7 @@ fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(): Vector<T> { fun <T> newVector(): Vector<T> {
return Vector() return Vector()
} }
/** /**
@@ -342,9 +342,9 @@ fun <T> newVector(): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(vararg elements: T): Vector<T> { fun <T> newVector(vararg elements: T): Vector<T> {
val vector = newVector<T>() val vector = newVector<T>()
vector.addAll(elements.asList()) vector.addAll(elements.asList())
return vector return vector
} }
/** /**
@@ -355,9 +355,9 @@ fun <T> newVector(vararg elements: T): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(elements: Collection<T>): Vector<T> { fun <T> newVector(elements: Collection<T>): Vector<T> {
val vector = newVector<T>() val vector = newVector<T>()
vector.addAll(elements) vector.addAll(elements)
return vector return vector
} }
/** /**
@@ -368,11 +368,11 @@ fun <T> newVector(elements: Collection<T>): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(elements: Iterable<T>): Vector<T> { fun <T> newVector(elements: Iterable<T>): Vector<T> {
val vector = newVector<T>() val vector = newVector<T>()
for (element in elements) { for (element in elements) {
vector.add(element) vector.add(element)
} }
return vector return vector
} }
/** /**
@@ -383,7 +383,7 @@ fun <T> newVector(elements: Iterable<T>): Vector<T> {
* @return 新创建的 Vector * @return 新创建的 Vector
*/ */
fun <T> newVector(elements: Sequence<T>): Vector<T> { fun <T> newVector(elements: Sequence<T>): Vector<T> {
return newVector(elements.toList()) return newVector(elements.toList())
} }
@@ -394,7 +394,7 @@ fun <T> newVector(elements: Sequence<T>): Vector<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(): HashSet<T> { fun <T> newHashSet(): HashSet<T> {
return HashSet() return HashSet()
} }
/** /**
@@ -405,7 +405,7 @@ fun <T> newHashSet(): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(size: Int): HashSet<T> { fun <T> newHashSet(size: Int): HashSet<T> {
return HashSet(size) return HashSet(size)
} }
/** /**
@@ -416,9 +416,9 @@ fun <T> newHashSet(size: Int): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(vararg elements: T): HashSet<T> { fun <T> newHashSet(vararg elements: T): HashSet<T> {
val set = newHashSet<T>() val set = newHashSet<T>()
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -429,9 +429,9 @@ fun <T> newHashSet(vararg elements: T): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(elements: Collection<T>): HashSet<T> { fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
val set = newHashSet<T>() val set = newHashSet<T>()
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -442,11 +442,11 @@ fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(elements: Iterable<T>): HashSet<T> { fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
val set = newHashSet<T>() val set = newHashSet<T>()
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -457,7 +457,7 @@ fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
* @return 新创建的 HashSet * @return 新创建的 HashSet
*/ */
fun <T> newHashSet(elements: Sequence<T>): HashSet<T> { fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
return newHashSet(elements.toSet()) return newHashSet(elements.toSet())
} }
/** /**
@@ -467,7 +467,7 @@ fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(): LinkedHashSet<T> { fun <T> newLinkedHashSet(): LinkedHashSet<T> {
return LinkedHashSet() return LinkedHashSet()
} }
/** /**
@@ -478,7 +478,7 @@ fun <T> newLinkedHashSet(): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> { fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
return LinkedHashSet(size) return LinkedHashSet(size)
} }
/** /**
@@ -489,9 +489,9 @@ fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> { fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
val set = newLinkedHashSet<T>() val set = newLinkedHashSet<T>()
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -502,9 +502,9 @@ fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> { fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
val set = newLinkedHashSet<T>() val set = newLinkedHashSet<T>()
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -515,11 +515,11 @@ fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> { fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
val set = newLinkedHashSet<T>() val set = newLinkedHashSet<T>()
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -530,7 +530,7 @@ fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
* @return 新创建的 LinkedHashSet * @return 新创建的 LinkedHashSet
*/ */
fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> { fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
return newLinkedHashSet(elements.toSet()) return newLinkedHashSet(elements.toSet())
} }
/** /**
@@ -540,7 +540,7 @@ fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
return TreeSet() return TreeSet()
} }
/** /**
@@ -551,9 +551,9 @@ fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
val set = newTreeSet<T>() val set = newTreeSet<T>()
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -564,9 +564,9 @@ fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
val set = newTreeSet<T>() val set = newTreeSet<T>()
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -577,11 +577,11 @@ fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
val set = newTreeSet<T>() val set = newTreeSet<T>()
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -592,7 +592,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> { fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
return newTreeSet(elements.toSet()) return newTreeSet(elements.toSet())
} }
@@ -603,7 +603,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: ByteArray): ArrayList<Byte> { fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -613,7 +613,7 @@ fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: ShortArray): ArrayList<Short> { fun newArrayLists(elements: ShortArray): ArrayList<Short> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -623,7 +623,7 @@ fun newArrayLists(elements: ShortArray): ArrayList<Short> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: IntArray): ArrayList<Int> { fun newArrayLists(elements: IntArray): ArrayList<Int> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -633,7 +633,7 @@ fun newArrayLists(elements: IntArray): ArrayList<Int> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: LongArray): ArrayList<Long> { fun newArrayLists(elements: LongArray): ArrayList<Long> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -643,7 +643,7 @@ fun newArrayLists(elements: LongArray): ArrayList<Long> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: FloatArray): ArrayList<Float> { fun newArrayLists(elements: FloatArray): ArrayList<Float> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -653,7 +653,7 @@ fun newArrayLists(elements: FloatArray): ArrayList<Float> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: DoubleArray): ArrayList<Double> { fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -663,7 +663,7 @@ fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> { fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -673,7 +673,7 @@ fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
* @return 转换后的 ArrayList * @return 转换后的 ArrayList
*/ */
fun newArrayLists(elements: CharArray): ArrayList<Char> { fun newArrayLists(elements: CharArray): ArrayList<Char> {
return ArrayList(elements.toList()) return ArrayList(elements.toList())
} }
/** /**
@@ -683,7 +683,7 @@ fun newArrayLists(elements: CharArray): ArrayList<Char> {
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList() return java.util.concurrent.CopyOnWriteArrayList()
} }
/** /**
@@ -694,7 +694,7 @@ fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T>
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList(elements.asList()) return java.util.concurrent.CopyOnWriteArrayList(elements.asList())
} }
/** /**
@@ -705,7 +705,7 @@ fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOn
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList(elements) return java.util.concurrent.CopyOnWriteArrayList(elements)
} }
/** /**
@@ -715,7 +715,7 @@ fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.C
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> newStack(): Stack<T> { fun <T> newStack(): Stack<T> {
return Stack() return Stack()
} }
/** /**
@@ -726,9 +726,9 @@ fun <T> newStack(): Stack<T> {
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> newStack(vararg elements: T): Stack<T> { fun <T> newStack(vararg elements: T): Stack<T> {
val stack = newStack<T>() val stack = newStack<T>()
stack.addAll(elements.asList()) stack.addAll(elements.asList())
return stack return stack
} }
/** /**
@@ -739,9 +739,9 @@ fun <T> newStack(vararg elements: T): Stack<T> {
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> newStack(elements: Collection<T>): Stack<T> { fun <T> newStack(elements: Collection<T>): Stack<T> {
val stack = newStack<T>() val stack = newStack<T>()
stack.addAll(elements) stack.addAll(elements)
return stack return stack
} }
@@ -753,7 +753,7 @@ fun <T> newStack(elements: Collection<T>): Stack<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
return TreeSet(comparator) return TreeSet(comparator)
} }
/** /**
@@ -765,9 +765,9 @@ fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
val set = newTreeSet(comparator) val set = newTreeSet(comparator)
set.addAll(elements.asList()) set.addAll(elements.asList())
return set return set
} }
/** /**
@@ -779,9 +779,9 @@ fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> {
val set = newTreeSet(comparator) val set = newTreeSet(comparator)
set.addAll(elements) set.addAll(elements)
return set return set
} }
/** /**
@@ -793,11 +793,11 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> {
val set = newTreeSet(comparator) val set = newTreeSet(comparator)
for (element in elements) { for (element in elements) {
set.add(element) set.add(element)
} }
return set return set
} }
/** /**
@@ -809,7 +809,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T>
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> { fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> {
return newTreeSet(comparator, elements.toSet()) return newTreeSet(comparator, elements.toSet())
} }
/** /**
@@ -819,7 +819,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T>
* @return 新创建的 CopyOnWriteArrayList * @return 新创建的 CopyOnWriteArrayList
*/ */
fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> { fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> {
return java.util.concurrent.CopyOnWriteArrayList(this) return java.util.concurrent.CopyOnWriteArrayList(this)
} }
/** /**
@@ -829,9 +829,9 @@ fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWri
* @return 新创建的 Stack * @return 新创建的 Stack
*/ */
fun <T> Collection<T>.newStacks(): Stack<T> { fun <T> Collection<T>.newStacks(): Stack<T> {
val stack = Stack<T>() val stack = Stack<T>()
stack.addAll(this) stack.addAll(this)
return stack return stack
} }
/** /**
@@ -841,9 +841,9 @@ fun <T> Collection<T>.newStacks(): Stack<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> { fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
val set = TreeSet<T>() val set = TreeSet<T>()
set.addAll(this) set.addAll(this)
return set return set
} }
/** /**
@@ -854,9 +854,9 @@ fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
* @return 新创建的 TreeSet * @return 新创建的 TreeSet
*/ */
fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> { fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
val set = TreeSet(comparator) val set = TreeSet(comparator)
set.addAll(this) set.addAll(this)
return set return set
} }
/** /**
@@ -866,11 +866,11 @@ fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
* @return 转换后的字节数组 * @return 转换后的字节数组
*/ */
fun toArray(list: List<Byte>): ByteArray { fun toArray(list: List<Byte>): ByteArray {
val arr = ByteArray(list.size) val arr = ByteArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
@@ -881,11 +881,11 @@ fun toArray(list: List<Byte>): ByteArray {
* @return 转换后的短整型数组 * @return 转换后的短整型数组
*/ */
fun toArray(list: List<Short>): ShortArray { fun toArray(list: List<Short>): ShortArray {
val arr = ShortArray(list.size) val arr = ShortArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -895,11 +895,11 @@ fun toArray(list: List<Short>): ShortArray {
* @return 转换后的整型数组 * @return 转换后的整型数组
*/ */
fun toArray(list: List<Int>): IntArray { fun toArray(list: List<Int>): IntArray {
val arr = IntArray(list.size) val arr = IntArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -909,11 +909,11 @@ fun toArray(list: List<Int>): IntArray {
* @return 转换后的长整型数组 * @return 转换后的长整型数组
*/ */
fun toArray(list: List<Long>): LongArray { fun toArray(list: List<Long>): LongArray {
val arr = LongArray(list.size) val arr = LongArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -923,11 +923,11 @@ fun toArray(list: List<Long>): LongArray {
* @return 转换后的浮点数组 * @return 转换后的浮点数组
*/ */
fun toArray(list: List<Float>): FloatArray { fun toArray(list: List<Float>): FloatArray {
val arr = FloatArray(list.size) val arr = FloatArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -937,11 +937,11 @@ fun toArray(list: List<Float>): FloatArray {
* @return 转换后的双精度浮点数组 * @return 转换后的双精度浮点数组
*/ */
fun toArray(list: List<Double>): DoubleArray { fun toArray(list: List<Double>): DoubleArray {
val arr = DoubleArray(list.size) val arr = DoubleArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -951,11 +951,11 @@ fun toArray(list: List<Double>): DoubleArray {
* @return 转换后的布尔数组 * @return 转换后的布尔数组
*/ */
fun toArray(list: List<Boolean>): BooleanArray { fun toArray(list: List<Boolean>): BooleanArray {
val arr = BooleanArray(list.size) val arr = BooleanArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
/** /**
@@ -965,11 +965,11 @@ fun toArray(list: List<Boolean>): BooleanArray {
* @return 转换后的字符数组 * @return 转换后的字符数组
*/ */
fun toArray(list: List<Char>): CharArray { fun toArray(list: List<Char>): CharArray {
val arr = CharArray(list.size) val arr = CharArray(list.size)
for (i in list.indices) { for (i in list.indices) {
arr[i] = list[i] arr[i] = list[i]
} }
return arr return arr
} }
@@ -981,13 +981,13 @@ fun toArray(list: List<Char>): CharArray {
* @return 转换后的数组 * @return 转换后的数组
*/ */
inline fun <reified T> toArray(list: List<T>): Array<T> { inline fun <reified T> toArray(list: List<T>): Array<T> {
if (list.isEmpty()) if (list.isEmpty())
return arrayOf<T>() return arrayOf<T>()
return SuperStream.of<T>(list) return SuperStream.of<T>(list)
.toArray(T::class.java) .toArray(T::class.java)
} }
fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> { fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> {
return SuperStream.of<T>(list) return SuperStream.of<T>(list)
.toArray(clazz) .toArray(clazz)
} }
@@ -34,68 +34,68 @@ import java.util.concurrent.atomic.AtomicReference
*/ */
class IsChanged<T> { class IsChanged<T> {
/** /**
* 使用 AtomicReference 来保证对数据的原子操作 * 使用 AtomicReference 来保证对数据的原子操作
*/ */
private val atomicReferenceData: AtomicReference<T> = AtomicReference() private val atomicReferenceData: AtomicReference<T> = AtomicReference()
constructor() constructor()
/** /**
* 带参数的构造函数,使用指定的初始值初始化 * 带参数的构造函数,使用指定的初始值初始化
* *
* @param data 初始数据值 * @param data 初始数据值
*/ */
constructor(data: T) : super() { constructor(data: T) : super() {
atomicReferenceData.set(data) atomicReferenceData.set(data)
} }
/** /**
* 设置新的数据值,不检查是否发生变化 * 设置新的数据值,不检查是否发生变化
* *
* @param data 要设置的新数据值 * @param data 要设置的新数据值
*/ */
fun set(data: T) { fun set(data: T) {
atomicReferenceData.set(data) atomicReferenceData.set(data)
} }
/** /**
* 获取当前数据值 * 获取当前数据值
* *
* @return 当前数据值 * @return 当前数据值
*/ */
fun get(): T { fun get(): T {
return atomicReferenceData.get() return atomicReferenceData.get()
} }
/** /**
* 设置新的数据值并返回旧的数据值 * 设置新的数据值并返回旧的数据值
* *
* @param data 要设置的新数据值 * @param data 要设置的新数据值
* @return 设置前的旧数据值 * @return 设置前的旧数据值
*/ */
fun setAndGet(data: T): T { fun setAndGet(data: T): T {
return atomicReferenceData.getAndSet(data) return atomicReferenceData.getAndSet(data)
} }
/** /**
* 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false * 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false
* 使用 CAS(Compare-And-Swap) 操作确保线程安全 * 使用 CAS(Compare-And-Swap) 操作确保线程安全
* *
* @param data 要设置的新数据值 * @param data 要设置的新数据值
* @return 如果值发生变化返回 true,否则返回 false * @return 如果值发生变化返回 true,否则返回 false
*/ */
fun setAndChanged(data: T): Boolean { fun setAndChanged(data: T): Boolean {
var currentData: T var currentData: T
do { do {
currentData = get() currentData = get()
// 如果新值与当前值相等,则认为没有变化,直接返回 false // 如果新值与当前值相等,则认为没有变化,直接返回 false
if (Objects.equals(data, currentData)) { if (Objects.equals(data, currentData)) {
return false return false
} }
// 使用 CAS 操作尝试更新值,如果失败则重试 // 使用 CAS 操作尝试更新值,如果失败则重试
} while (!atomicReferenceData.compareAndSet(currentData, data)) } while (!atomicReferenceData.compareAndSet(currentData, data))
// 成功更新值,返回 true 表示发生了变化 // 成功更新值,返回 true 表示发生了变化
return true return true
} }
} }
@@ -1,5 +1,5 @@
/* /*
* Copyright 2026 mingliqiye * Copyright 2025 mingliqiye
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ConfigurationProp.kt * CurrentFile ConfigurationProp.kt
* LastUpdate 2026-07-01 12:37:05 * LastUpdate 2025-09-19 11:30:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -31,10 +31,10 @@ package com.mingliqiye.utils.configuration
*/ */
@Retention(AnnotationRetention.RUNTIME) @Retention(AnnotationRetention.RUNTIME)
@Target( @Target(
AnnotationTarget.TYPE_PARAMETER, AnnotationTarget.TYPE_PARAMETER,
AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.VALUE_PARAMETER,
AnnotationTarget.FIELD, // 添加字段支持 AnnotationTarget.FIELD, // 添加字段支持
AnnotationTarget.PROPERTY // 添加属性支持 AnnotationTarget.PROPERTY // 添加属性支持
) )
annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true) annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true)
@@ -45,7 +45,7 @@ annotation class ConfigurationProp(val name: String = "", val description: Strin
* @return 对应的 setter 方法名。 * @return 对应的 setter 方法名。
*/ */
private fun getSetterName(fieldName: String): String { private fun getSetterName(fieldName: String): String {
return "set" + fieldName.take(1).uppercase() + fieldName.substring(1) return "set" + fieldName.take(1).uppercase() + fieldName.substring(1)
} }
/** /**
@@ -55,7 +55,7 @@ private fun getSetterName(fieldName: String): String {
* @return 对应的 getter 方法名。 * @return 对应的 getter 方法名。
*/ */
private fun getGetterName(fieldName: String): String { private fun getGetterName(fieldName: String): String {
return "get" + fieldName.take(1).uppercase() + fieldName.substring(1) return "get" + fieldName.take(1).uppercase() + fieldName.substring(1)
} }
/** /**
@@ -63,211 +63,211 @@ private fun getGetterName(fieldName: String): String {
*/ */
open class ConfigurationProps { open class ConfigurationProps {
companion object { companion object {
/** /**
* 初始化配置类实例,并根据命令行参数填充其字段。 * 初始化配置类实例,并根据命令行参数填充其字段。
* *
* @param clazz 配置类的 Class 对象。 * @param clazz 配置类的 Class 对象。
* @param args 命令行参数数组。 * @param args 命令行参数数组。
* @return 初始化后的配置类实例。 * @return 初始化后的配置类实例。
*/ */
@JvmStatic @JvmStatic
fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T { fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
val mapsArgs = parseArguments(args) val mapsArgs = parseArguments(args)
val instance = clazz.getDeclaredConstructor().newInstance() val instance = clazz.getDeclaredConstructor().newInstance()
processFields(clazz, instance, mapsArgs) processFields(clazz, instance, mapsArgs)
return instance return instance
} }
/** /**
* 解析命令行参数,将其转换为键值对映射。 * 解析命令行参数,将其转换为键值对映射。
* *
* 支持以下格式: * 支持以下格式:
* - `--key=value` 或 `-k=value`:键值对形式。 * - `--key=value` 或 `-k=value`:键值对形式。
* - `--key value` 或 `-k value`:键和值分开的形式。 * - `--key value` 或 `-k value`:键和值分开的形式。
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。 * - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
* *
* @param args 命令行参数数组。 * @param args 命令行参数数组。
* @return 解析后的键值对映射。 * @return 解析后的键值对映射。
*/ */
private fun parseArguments(args: Array<String>): Map<String, List<String>> { private fun parseArguments(args: Array<String>): Map<String, List<String>> {
val mapsArgs = mutableMapOf<String, MutableList<String>>() val mapsArgs = mutableMapOf<String, MutableList<String>>()
var i = 0 var i = 0
while (i < args.size) { while (i < args.size) {
val arg = args[i] val arg = args[i]
when { when {
arg.startsWith("--") -> { arg.startsWith("--") -> {
// 处理 --key=value 格式 // 处理 --key=value 格式
if (arg.contains("=")) { if (arg.contains("=")) {
val (key, value) = arg.substring(2).split("=", limit = 2) val (key, value) = arg.substring(2).split("=", limit = 2)
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
} }
// 处理 --key value 格式 // 处理 --key value 格式
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) { else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
val key = arg.substring(2) val key = arg.substring(2)
val value = args[i + 1] val value = args[i + 1]
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
i++ // 跳过下一个参数 i++ // 跳过下一个参数
} }
// 处理 --flag 格式的布尔标志 // 处理 --flag 格式的布尔标志
else { else {
val key = arg.substring(2) val key = arg.substring(2)
mapsArgs.getOrPut(key) { mutableListOf() }.add("true") mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
} }
} }
arg.startsWith("-") -> { arg.startsWith("-") -> {
// 处理 -k=value 格式 // 处理 -k=value 格式
if (arg.contains("=")) { if (arg.contains("=")) {
val (key, value) = arg.substring(1).split("=", limit = 2) val (key, value) = arg.substring(1).split("=", limit = 2)
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
} }
// 处理 -k value 格式 // 处理 -k value 格式
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) { else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
val key = arg.substring(1) val key = arg.substring(1)
val value = args[i + 1] val value = args[i + 1]
mapsArgs.getOrPut(key) { mutableListOf() }.add(value) mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
i++ i++
} }
// 处理 -f 格式的布尔标志 // 处理 -f 格式的布尔标志
else { else {
val key = arg.substring(1) val key = arg.substring(1)
mapsArgs.getOrPut(key) { mutableListOf() }.add("true") mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
} }
} }
} }
i++ i++
} }
return mapsArgs return mapsArgs
} }
/** /**
* 处理配置类中的字段,根据解析出的参数设置字段值。 * 处理配置类中的字段,根据解析出的参数设置字段值。
* *
* @param clazz 配置类的 Class 对象。 * @param clazz 配置类的 Class 对象。
* @param instance 配置类的实例。 * @param instance 配置类的实例。
* @param mapsArgs 解析后的命令行参数映射。 * @param mapsArgs 解析后的命令行参数映射。
*/ */
private fun <T : ConfigurationProps> processFields( private fun <T : ConfigurationProps> processFields(
clazz: Class<T>, clazz: Class<T>,
instance: T, instance: T,
mapsArgs: Map<String, List<String>>, mapsArgs: Map<String, List<String>>
) { ) {
val fields = clazz.declaredFields val fields = clazz.declaredFields
for (field in fields) { for (field in fields) {
val configurationProp = field.getAnnotation(ConfigurationProp::class.java) val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
if (configurationProp != null) { if (configurationProp != null) {
val fieldName = configurationProp.name.ifEmpty { field.name } val fieldName = configurationProp.name.ifEmpty { field.name }
val values = mapsArgs[fieldName] val values = mapsArgs[fieldName]
if (values != null) { if (values != null) {
try { try {
val setter = clazz.getDeclaredMethod( val setter = clazz.getDeclaredMethod(
getSetterName(field.name), getSetterName(field.name),
field.type field.type
) )
val value = convertValue(field.type, values, configurationProp) val value = convertValue(field.type, values, configurationProp)
setter.invoke(instance, value) setter.invoke(instance, value)
} catch (e: Exception) { } catch (e: Exception) {
println("Warning: Failed to set field ${field.name}: ${e.message}") println("Warning: Failed to set field ${field.name}: ${e.message}")
} }
} }
} }
} }
} }
/** /**
* 将字符串值转换为目标类型。 * 将字符串值转换为目标类型。
* *
* @param type 目标类型。 * @param type 目标类型。
* @param values 字符串值列表。 * @param values 字符串值列表。
* @param annotation 配置属性注解。 * @param annotation 配置属性注解。
* @return 转换后的值。 * @return 转换后的值。
*/ */
private fun convertValue( private fun convertValue(
type: Class<*>, type: Class<*>,
values: List<String>, values: List<String>,
annotation: ConfigurationProp, annotation: ConfigurationProp
): Any? { ): Any? {
val lastValue = values.lastOrNull() ?: return null val lastValue = values.lastOrNull() ?: return null
return when (type) { return when (type) {
String::class.java -> lastValue String::class.java -> lastValue
Integer::class.java, Int::class.java -> try { Integer::class.java, Int::class.java -> try {
lastValue.toInt() lastValue.toInt()
} catch (e: NumberFormatException) { } catch (e: NumberFormatException) {
println("Warning: Invalid integer value '$lastValue'") println("Warning: Invalid integer value '$lastValue'")
null null
} }
Long::class.java, java.lang.Long::class.java -> try { Long::class.java, java.lang.Long::class.java -> try {
lastValue.toLong() lastValue.toLong()
} catch (e: NumberFormatException) { } catch (e: NumberFormatException) {
println("Warning: Invalid long value '$lastValue'") println("Warning: Invalid long value '$lastValue'")
null null
} }
Double::class.java, java.lang.Double::class.java -> try { Double::class.java, java.lang.Double::class.java -> try {
lastValue.toDouble() lastValue.toDouble()
} catch (e: NumberFormatException) { } catch (e: NumberFormatException) {
println("Warning: Invalid double value '$lastValue'") println("Warning: Invalid double value '$lastValue'")
null null
} }
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) { Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
"true", "1", "yes", "on" -> true "true", "1", "yes", "on" -> true
"false", "0", "no", "off" -> false "false", "0", "no", "off" -> false
else -> { else -> {
println("Warning: Invalid boolean value '$lastValue'") println("Warning: Invalid boolean value '$lastValue'")
null null
} }
} }
List::class.java -> values List::class.java -> values
else -> { else -> {
println("Warning: Unsupported type ${type.simpleName}") println("Warning: Unsupported type ${type.simpleName}")
null null
} }
} }
} }
} }
fun printHelp() { fun printHelp() {
val fields = this::class.java.declaredFields val fields = this::class.java.declaredFields
val help = StringBuilder() val help = StringBuilder()
for (field in fields) { for (field in fields) {
val configurationProp = field.getAnnotation(ConfigurationProp::class.java) val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
if (configurationProp != null && configurationProp.showHelper) { if (configurationProp != null && configurationProp.showHelper) {
val fieldName = configurationProp.name.ifEmpty { field.name } val fieldName = configurationProp.name.ifEmpty { field.name }
help.append("$fieldName -> Type: ${field.type.simpleName}") help.append("$fieldName -> 类型: ${field.type.simpleName}")
if (configurationProp.description.isNotEmpty()) { if (configurationProp.description.isNotEmpty()) {
help.append(" Description: ${configurationProp.description}") help.append(" 描述: ${configurationProp.description}")
} }
help.append("\n") help.append("\n")
} }
} }
println(help) println(help)
} }
val fields: Map<String, Any?> val fields: Map<String, Any?>
get() { get() {
val fields = this::class.java.declaredFields val fields = this::class.java.declaredFields
val fieldValues = mutableMapOf<String, Any?>() val fieldValues = mutableMapOf<String, Any?>()
for (field in fields) { for (field in fields) {
field.isAccessible = true field.isAccessible = true
val fieldName = field.name val fieldName = field.name
val fieldValue = field.get(this) val fieldValue = field.get(this)
fieldValues[fieldName] = fieldValue fieldValues[fieldName] = fieldValue
} }
return fieldValues return fieldValues
} }
} }
@@ -32,67 +32,67 @@ package com.mingliqiye.utils.data
*/ */
class ThreadLocalDataHolder<T> { class ThreadLocalDataHolder<T> {
private val threadLocal: ThreadLocal<T?> = ThreadLocal() private val threadLocal: ThreadLocal<T?> = ThreadLocal()
/** /**
* 获取当前线程存储的值 * 获取当前线程存储的值
* *
* @return 当前线程存储的值,如果没有则返回null * @return 当前线程存储的值,如果没有则返回null
*/ */
fun get(): T? { fun get(): T? {
return threadLocal.get() return threadLocal.get()
} }
/** /**
* 设置当前线程的值 * 设置当前线程的值
* *
* @param value 要存储的值 * @param value 要存储的值
*/ */
fun set(value: T) { fun set(value: T) {
threadLocal.set(value) threadLocal.set(value)
} }
/** /**
* 移除当前线程存储的值 * 移除当前线程存储的值
* *
* 防止内存泄漏,使用完毕后应调用此方法清理资源。 * 防止内存泄漏,使用完毕后应调用此方法清理资源。
*/ */
fun remove() { fun remove() {
threadLocal.remove() threadLocal.remove()
} }
/** /**
* 获取当前线程存储的值,如果不存在则返回默认值 * 获取当前线程存储的值,如果不存在则返回默认值
* *
* @param defaultValue 默认值 * @param defaultValue 默认值
* @return 当前线程存储的值或默认值 * @return 当前线程存储的值或默认值
*/ */
fun getOrDefault(defaultValue: T): T { fun getOrDefault(defaultValue: T): T {
val value = threadLocal.get() val value = threadLocal.get()
return value ?: defaultValue return value ?: defaultValue
} }
/** /**
* 安全获取值(避免NPE) * 安全获取值(避免NPE)
* *
* 在某些异常情况下防止抛出异常,直接返回 null。 * 在某些异常情况下防止抛出异常,直接返回 null。
* *
* @return 值或null * @return 值或null
*/ */
fun safeGet(): T? { fun safeGet(): T? {
return try { return try {
threadLocal.get() threadLocal.get()
} catch (e: Exception) { } catch (e: Exception) {
null null
} }
} }
/** /**
* 检查当前线程是否有值 * 检查当前线程是否有值
* *
* @return 是否有值 * @return 是否有值
*/ */
fun isPresent(): Boolean { fun isPresent(): Boolean {
return threadLocal.get() != null return threadLocal.get() != null
} }
} }
@@ -34,40 +34,40 @@ import java.lang.reflect.Field
* @return 返回一个新的对象实例,其字段值与原对象一致。 * @return 返回一个新的对象实例,其字段值与原对象一致。
*/ */
fun <T : Any> clone(obj: T): T { fun <T : Any> clone(obj: T): T {
val clazz = obj.javaClass val clazz = obj.javaClass
val constructor = clazz.getDeclaredConstructor().apply { val constructor = clazz.getDeclaredConstructor().apply {
isAccessible = true isAccessible = true
} }
val instance = constructor.newInstance() val instance = constructor.newInstance()
// 遍历类及其父类的所有字段进行赋值 // 遍历类及其父类的所有字段进行赋值
var currentClass: Class<*>? = clazz var currentClass: Class<*>? = clazz
while (currentClass != null) { while (currentClass != null) {
currentClass.declaredFields.forEach { field -> currentClass.declaredFields.forEach { field ->
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) { if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
field.isAccessible = true field.isAccessible = true
field.set(instance, field.get(obj)) field.set(instance, field.get(obj))
} }
} }
currentClass = currentClass.superclass currentClass = currentClass.superclass
} }
return instance return instance
} }
/** /**
* 定义 DTO 拷贝行为的枚举类型。 * 定义 DTO 拷贝行为的枚举类型。
*/ */
enum class DotCopyType { enum class DotCopyType {
/** /**
* 表示使用点拷贝(.copy)方式处理字段。 * 表示使用点拷贝(.copy)方式处理字段。
*/ */
DOT_COPY, DOT_COPY,
/** /**
* 表示普通拷贝方式处理字段。 * 表示普通拷贝方式处理字段。
*/ */
COPY COPY
} }
/** /**
@@ -77,10 +77,10 @@ enum class DotCopyType {
*/ */
@Retention(AnnotationRetention.RUNTIME) @Retention(AnnotationRetention.RUNTIME)
@Target( @Target(
AnnotationTarget.TYPE_PARAMETER, AnnotationTarget.TYPE_PARAMETER,
AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.VALUE_PARAMETER,
AnnotationTarget.FIELD, AnnotationTarget.FIELD,
AnnotationTarget.PROPERTY AnnotationTarget.PROPERTY
) )
annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY) annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
@@ -92,40 +92,40 @@ annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
* @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。 * @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。
*/ */
fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R { fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
val instance = dtoClass.getDeclaredConstructor().apply { val instance = dtoClass.getDeclaredConstructor().apply {
isAccessible = true isAccessible = true
}.newInstance() }.newInstance()
val sourceFields = getAllFields(obj.javaClass) val sourceFields = getAllFields(obj.javaClass)
for (sourceField in sourceFields) { for (sourceField in sourceFields) {
sourceField.isAccessible = true sourceField.isAccessible = true
val fieldName = sourceField.name val fieldName = sourceField.name
val fieldValue = sourceField.get(obj) val fieldValue = sourceField.get(obj)
try { try {
val targetField = dtoClass.getDeclaredField(fieldName).apply { val targetField = dtoClass.getDeclaredField(fieldName).apply {
isAccessible = true isAccessible = true
} }
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) { if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
continue continue
} }
val ta = targetField.getAnnotation(DtoCopy::class.java) val ta = targetField.getAnnotation(DtoCopy::class.java)
if (ta != null) { if (ta != null) {
if (ta.type == DotCopyType.DOT_COPY) { if (ta.type == DotCopyType.DOT_COPY) {
continue continue
} }
} }
targetField.set(instance, fieldValue) targetField.set(instance, fieldValue)
} catch (e: NoSuchFieldException) { } catch (e: NoSuchFieldException) {
continue continue
} catch (e: IllegalArgumentException) { } catch (e: IllegalArgumentException) {
continue continue
} }
} }
return instance return instance
} }
/** /**
@@ -135,11 +135,12 @@ fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
* @return 包含所有字段的列表。 * @return 包含所有字段的列表。
*/ */
private fun getAllFields(clazz: Class<*>): List<Field> { private fun getAllFields(clazz: Class<*>): List<Field> {
val fields = mutableListOf<Field>() val fields = mutableListOf<Field>()
var currentClass: Class<*>? = clazz var currentClass: Class<*>? = clazz
while (currentClass != null && currentClass != Any::class.java) { while (currentClass != null && currentClass != Any::class.java) {
fields.addAll(currentClass.declaredFields) fields.addAll(currentClass.declaredFields)
currentClass = currentClass.superclass currentClass = currentClass.superclass
} }
return fields return fields
} }
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile BadGatewayException.kt * CurrentFile BadGatewayException.kt
* LastUpdate 2026-10-22 22:07:34 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Bad Gateway" * @param message 异常信息,默认为 "Bad Gateway"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class BadGatewayException @JvmOverloads constructor( class BadGatewayException(
override val message: String? = "Bad Gateway", override val message: String? = "Bad Gateway",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(502, message, cause) ) : HttpStatusException(502, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile BadRequestException.kt * CurrentFile BadRequestException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Bad Request" * @param message 异常信息,默认为 "Bad Request"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class BadRequestException @JvmOverloads constructor( class BadRequestException(
override val message: String? = "Bad Request", override val message: String? = "Bad Request",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(400, message, cause) ) : HttpStatusException(400, message, cause)
@@ -1,30 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile CodecException.kt
* LastUpdate 2026-10-11 16:51:36
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.exception
class CodecException @JvmOverloads constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ConflictException.kt * CurrentFile ConflictException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Conflict" * @param message 异常信息,默认为 "Conflict"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ConflictException @JvmOverloads constructor( class ConflictException(
override val message: String? = "Conflict", override val message: String? = "Conflict",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(409, message, cause) ) : HttpStatusException(409, message, cause)
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile EmptyJsonException.kt * CurrentFile EmptyJsonException.kt
* LastUpdate 2026-10-11 16:53:26 * LastUpdate 2026-02-07 14:45:12
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class EmptyJsonException @JvmOverloads constructor( class EmptyJsonException : JsonException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : JsonException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ForbiddenException.kt * CurrentFile ForbiddenException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Forbidden" * @param message 异常信息,默认为 "Forbidden"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ForbiddenException @JvmOverloads constructor( class ForbiddenException(
override val message: String? = "Forbidden", override val message: String? = "Forbidden",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(403, message, cause) ) : HttpStatusException(403, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile FoundException.kt * CurrentFile FoundException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Found" * @param message 异常信息,默认为 "Found"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class FoundException @JvmOverloads constructor( class FoundException(
override val message: String? = "Found", override val message: String? = "Found",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(302, message, cause) ) : HttpStatusException(302, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile GatewayTimeoutException.kt * CurrentFile GatewayTimeoutException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Gateway Timeout" * @param message 异常信息,默认为 "Gateway Timeout"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class GatewayTimeoutException @JvmOverloads constructor( class GatewayTimeoutException(
override val message: String? = "Gateway Timeout", override val message: String? = "Gateway Timeout",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(504, message, cause) ) : HttpStatusException(504, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile GoneException.kt * CurrentFile GoneException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Gone" * @param message 异常信息,默认为 "Gone"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class GoneException @JvmOverloads constructor( class GoneException(
override val message: String? = "Gone", override val message: String? = "Gone",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(410, message, cause) ) : HttpStatusException(410, message, cause)
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpException.kt * CurrentFile HttpException.kt
* LastUpdate 2026-10-11 16:52:48 * LastUpdate 2026-02-05 14:44:15
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class HttpException @JvmOverloads constructor( open class HttpException : MingLiUtilsBaseException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpStatusException.kt * CurrentFile HttpStatusException.kt
* LastUpdate 2026-10-11 17:02:06 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -29,10 +29,8 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 null * @param message 异常信息,默认为 null
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
open class HttpStatusException @JvmOverloads constructor( sealed class HttpStatusException(
val statusCode: Int, open val statusCode: Int,
message: String? = null, override val message: String? = null,
throwable: Throwable? = null, override val cause: Throwable? = null
enableSuppression: Boolean = false, ) : MingLiUtilsBaseException(message, cause)
writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpUrlException.kt * CurrentFile HttpUrlException.kt
* LastUpdate 2026-10-11 16:53:00 * LastUpdate 2026-02-05 15:21:48
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class HttpUrlException @JvmOverloads constructor( open class HttpUrlException : HttpException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile HttpVersionNotSupportedException.kt * CurrentFile HttpVersionNotSupportedException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "HTTP Version Not Supported" * @param message 异常信息,默认为 "HTTP Version Not Supported"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class HttpVersionNotSupportedException @JvmOverloads constructor( class HttpVersionNotSupportedException(
override val message: String? = "HTTP Version Not Supported", override val message: String? = "HTTP Version Not Supported",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(505, message, cause) ) : HttpStatusException(505, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile InternalServerErrorException.kt * CurrentFile InternalServerErrorException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Internal Server Error" * @param message 异常信息,默认为 "Internal Server Error"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class InternalServerErrorException @JvmOverloads constructor( class InternalServerErrorException(
override val message: String? = "Internal Server Error", override val message: String? = "Internal Server Error",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(500, message, cause) ) : HttpStatusException(500, message, cause)
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile InvalidJsonException.kt * CurrentFile InvalidJsonException.kt
* LastUpdate 2026-10-11 16:53:31 * LastUpdate 2026-02-07 13:18:32
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class InvalidJsonException @JvmOverloads constructor( class InvalidJsonException : JsonException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : JsonException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonException.kt * CurrentFile JsonException.kt
* LastUpdate 2026-10-11 16:53:07 * LastUpdate 2026-02-07 13:17:50
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -30,9 +30,15 @@ package com.mingliqiye.utils.exception
* 2. 包含错误信息和原因(Throwable)的构造函数。 * 2. 包含错误信息和原因(Throwable)的构造函数。
* 3. 仅包含原因(Throwable)的构造函数。 * 3. 仅包含原因(Throwable)的构造函数。
*/ */
open class JsonException @JvmOverloads constructor( open class JsonException : MingLiUtilsBaseException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonObjectCastException.kt * CurrentFile JsonObjectCastException.kt
* LastUpdate 2026-10-11 16:53:36 * LastUpdate 2026-02-07 15:11:42
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonObjectCastException @JvmOverloads constructor( class JsonObjectCastException : JsonException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : JsonException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonParserException.kt * CurrentFile JsonParserException.kt
* LastUpdate 2026-10-11 16:53:41 * LastUpdate 2026-02-07 14:45:12
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonParserException @JvmOverloads constructor( class JsonParserException : JsonException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : JsonException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,15 +16,21 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile JsonTypeException.kt * CurrentFile JsonTypeException.kt
* LastUpdate 2026-10-11 16:53:45 * LastUpdate 2026-02-07 13:28:02
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
class JsonTypeException @JvmOverloads constructor( class JsonTypeException : JsonException {
message: String? = null, constructor()
throwable: Throwable? = null, constructor(message: String) : super(message)
enableSuppression: Boolean = false, constructor(throwable: Throwable) : super(throwable)
writableStackTrace: Boolean = true, constructor(message: String, throwable: Throwable) : super(message, throwable)
) : JsonException(message, throwable, enableSuppression, writableStackTrace) constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile LengthRequiredException.kt * CurrentFile LengthRequiredException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Length Required" * @param message 异常信息,默认为 "Length Required"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class LengthRequiredException @JvmOverloads constructor( class LengthRequiredException(
override val message: String? = "Length Required", override val message: String? = "Length Required",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(411, message, cause) ) : HttpStatusException(411, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile MethodNotAllowedException.kt * CurrentFile MethodNotAllowedException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Method Not Allowed" * @param message 异常信息,默认为 "Method Not Allowed"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class MethodNotAllowedException @JvmOverloads constructor( class MethodNotAllowedException(
override val message: String? = "Method Not Allowed", override val message: String? = "Method Not Allowed",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(405, message, cause) ) : HttpStatusException(405, message, cause)
@@ -16,15 +16,22 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile MingLiUtilsBaseException.kt * CurrentFile MingLiUtilsBaseException.kt
* LastUpdate 2026-10-11 16:39:21 * LastUpdate 2026-02-05 14:41:27
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.exception package com.mingliqiye.utils.exception
open class MingLiUtilsBaseException @JvmOverloads constructor( open class MingLiUtilsBaseException : RuntimeException {
message: String? = null,
cause: Throwable? = null, constructor()
enableSuppression: Boolean = false, constructor(message: String) : super(message)
writableStackTrace: Boolean = true, constructor(throwable: Throwable) : super(throwable)
) : RuntimeException(message, cause, enableSuppression, writableStackTrace) constructor(message: String, throwable: Throwable) : super(message, throwable)
constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = false
) : super(message, throwable, enableSuppression, writableStackTrace)
}
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile MovedPermanentlyException.kt * CurrentFile MovedPermanentlyException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Moved Permanently" * @param message 异常信息,默认为 "Moved Permanently"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class MovedPermanentlyException @JvmOverloads constructor( class MovedPermanentlyException(
override val message: String? = "Moved Permanently", override val message: String? = "Moved Permanently",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(301, message, cause) ) : HttpStatusException(301, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile MultipleChoicesException.kt * CurrentFile MultipleChoicesException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Multiple Choices" * @param message 异常信息,默认为 "Multiple Choices"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class MultipleChoicesException @JvmOverloads constructor( class MultipleChoicesException(
override val message: String? = "Multiple Choices", override val message: String? = "Multiple Choices",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(300, message, cause) ) : HttpStatusException(300, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile NotAcceptableException.kt * CurrentFile NotAcceptableException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Not Acceptable" * @param message 异常信息,默认为 "Not Acceptable"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotAcceptableException @JvmOverloads constructor( class NotAcceptableException(
override val message: String? = "Not Acceptable", override val message: String? = "Not Acceptable",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(406, message, cause) ) : HttpStatusException(406, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile NotFoundException.kt * CurrentFile NotFoundException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Not Found" * @param message 异常信息,默认为 "Not Found"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotFoundException @JvmOverloads constructor( class NotFoundException(
override val message: String? = "Not Found", override val message: String? = "Not Found",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(404, message, cause) ) : HttpStatusException(404, message, cause)
@@ -1,30 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName mingli-utils
* ModuleName mingli-utils.main
* CurrentFile NotFoundResourceException.kt
* LastUpdate 2026-10-11 16:53:58
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.exception
class NotFoundResourceException @JvmOverloads constructor(
message: String? = null,
throwable: Throwable? = null,
enableSuppression: Boolean = false,
writableStackTrace: Boolean = true,
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile NotImplementedException.kt * CurrentFile NotImplementedException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Not Implemented" * @param message 异常信息,默认为 "Not Implemented"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotImplementedException @JvmOverloads constructor( class NotImplementedException(
override val message: String? = "Not Implemented", override val message: String? = "Not Implemented",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(501, message, cause) ) : HttpStatusException(501, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile NotModifiedException.kt * CurrentFile NotModifiedException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Not Modified" * @param message 异常信息,默认为 "Not Modified"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class NotModifiedException @JvmOverloads constructor( class NotModifiedException(
override val message: String? = "Not Modified", override val message: String? = "Not Modified",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(304, message, cause) ) : HttpStatusException(304, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile PaymentRequiredException.kt * CurrentFile PaymentRequiredException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Payment Required" * @param message 异常信息,默认为 "Payment Required"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class PaymentRequiredException @JvmOverloads constructor( class PaymentRequiredException(
override val message: String? = "Payment Required", override val message: String? = "Payment Required",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(402, message, cause) ) : HttpStatusException(402, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile PreconditionFailedException.kt * CurrentFile PreconditionFailedException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Precondition Failed" * @param message 异常信息,默认为 "Precondition Failed"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class PreconditionFailedException @JvmOverloads constructor( class PreconditionFailedException(
override val message: String? = "Precondition Failed", override val message: String? = "Precondition Failed",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(412, message, cause) ) : HttpStatusException(412, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ProxyAuthenticationRequiredException.kt * CurrentFile ProxyAuthenticationRequiredException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Proxy Authentication Required" * @param message 异常信息,默认为 "Proxy Authentication Required"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ProxyAuthenticationRequiredException @JvmOverloads constructor( class ProxyAuthenticationRequiredException(
override val message: String? = "Proxy Authentication Required", override val message: String? = "Proxy Authentication Required",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(407, message, cause) ) : HttpStatusException(407, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile RequestEntityTooLargeException.kt * CurrentFile RequestEntityTooLargeException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Request Entity Too Large" * @param message 异常信息,默认为 "Request Entity Too Large"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestEntityTooLargeException @JvmOverloads constructor( class RequestEntityTooLargeException(
override val message: String? = "Request Entity Too Large", override val message: String? = "Request Entity Too Large",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(413, message, cause) ) : HttpStatusException(413, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile RequestTimeoutException.kt * CurrentFile RequestTimeoutException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Request Timeout" * @param message 异常信息,默认为 "Request Timeout"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestTimeoutException @JvmOverloads constructor( class RequestTimeoutException(
override val message: String? = "Request Timeout", override val message: String? = "Request Timeout",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(408, message, cause) ) : HttpStatusException(408, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile RequestUriTooLargeException.kt * CurrentFile RequestUriTooLargeException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Request URI Too Large" * @param message 异常信息,默认为 "Request URI Too Large"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestUriTooLargeException @JvmOverloads constructor( class RequestUriTooLargeException(
override val message: String? = "Request URI Too Large", override val message: String? = "Request URI Too Large",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(414, message, cause) ) : HttpStatusException(414, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile RequestedRangeNotSatisfiableException.kt * CurrentFile RequestedRangeNotSatisfiableException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Requested Range Not Satisfiable" * @param message 异常信息,默认为 "Requested Range Not Satisfiable"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class RequestedRangeNotSatisfiableException @JvmOverloads constructor( class RequestedRangeNotSatisfiableException(
override val message: String? = "Requested Range Not Satisfiable", override val message: String? = "Requested Range Not Satisfiable",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(416, message, cause) ) : HttpStatusException(416, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile SeeOtherException.kt * CurrentFile SeeOtherException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "See Other" * @param message 异常信息,默认为 "See Other"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class SeeOtherException @JvmOverloads constructor( class SeeOtherException(
override val message: String? = "See Other", override val message: String? = "See Other",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(303, message, cause) ) : HttpStatusException(303, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ServiceUnavailableException.kt * CurrentFile ServiceUnavailableException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Service Unavailable" * @param message 异常信息,默认为 "Service Unavailable"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class ServiceUnavailableException @JvmOverloads constructor( class ServiceUnavailableException(
override val message: String? = "Service Unavailable", override val message: String? = "Service Unavailable",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(503, message, cause) ) : HttpStatusException(503, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile TemporaryRedirectException.kt * CurrentFile TemporaryRedirectException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Temporary Redirect" * @param message 异常信息,默认为 "Temporary Redirect"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class TemporaryRedirectException @JvmOverloads constructor( class TemporaryRedirectException(
override val message: String? = "Temporary Redirect", override val message: String? = "Temporary Redirect",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(307, message, cause) ) : HttpStatusException(307, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile UnauthorizedException.kt * CurrentFile UnauthorizedException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Unauthorized" * @param message 异常信息,默认为 "Unauthorized"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class UnauthorizedException @JvmOverloads constructor( class UnauthorizedException(
override val message: String? = "Unauthorized", override val message: String? = "Unauthorized",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(401, message, cause) ) : HttpStatusException(401, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile UnsupportedMediaTypeException.kt * CurrentFile UnsupportedMediaTypeException.kt
* LastUpdate 2026-10-22 22:09:19 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Unsupported Media Type" * @param message 异常信息,默认为 "Unsupported Media Type"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class UnsupportedMediaTypeException @JvmOverloads constructor( class UnsupportedMediaTypeException(
override val message: String? = "Unsupported Media Type", override val message: String? = "Unsupported Media Type",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(415, message, cause) ) : HttpStatusException(415, message, cause)
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile UseProxyException.kt * CurrentFile UseProxyException.kt
* LastUpdate 2026-10-22 22:09:48 * LastUpdate 2026-02-05 14:55:04
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
* @param message 异常信息,默认为 "Use Proxy" * @param message 异常信息,默认为 "Use Proxy"
* @param cause 异常原因,默认为 null * @param cause 异常原因,默认为 null
*/ */
class UseProxyException @JvmOverloads constructor( class UseProxyException(
override val message: String? = "Use Proxy", override val message: String? = "Use Proxy",
override val cause: Throwable? = null, override val cause: Throwable? = null,
) : HttpStatusException(305, message, cause) ) : HttpStatusException(305, message, cause)
File diff suppressed because it is too large Load Diff
@@ -1,5 +1,5 @@
/* /*
* Copyright 2026 mingliqiye * Copyright 2025 mingliqiye
* *
* Licensed under the Apache License, Version 2.0 (the "License"); * Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License. * you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile ForEach.kt * CurrentFile ForEach.kt
* LastUpdate 2026-02-27 12:45:39 * LastUpdate 2025-09-15 12:44:46
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
@file:JvmName("ForEach") @file:JvmName("ForEach")
@@ -35,34 +35,36 @@ import com.mingliqiye.utils.functions.*
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
iterable: Iterable<T>, action: P2Function<in T, in Int>, iterable: Iterable<T>, action: P2Function<in T, in Int>
) { ) {
when (iterable) { when (iterable) {
is RandomAccess if iterable is MutableList<*> -> { is RandomAccess if iterable is MutableList<*> -> {
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能 // 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
action.call(list[i], i) action.call(list[i], i)
} }
} }
is MutableList<*> -> { is MutableList<*> -> {
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引 // 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
var index = 0 var index = 0
val it = iterable.iterator() val it = iterable.iterator()
while (it.hasNext()) { while (it.hasNext()) {
action.call(it.next(), index) action.call(it.next(), index)
index++ index++
} }
} }
else -> { else -> {
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引 // 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
for ((index, element) in iterable.withIndex()) { var index = 0
action.call(element, index) for (element in iterable) {
} action.call(element, index)
} index++
} }
}
}
} }
/** /**
@@ -74,20 +76,20 @@ fun <T> forEach(
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
iterable: Iterable<T>, action: P1Function<in T>, iterable: Iterable<T>, action: P1Function<in T>
) { ) {
if (iterable is RandomAccess) { if (iterable is RandomAccess) {
// 如果是支持随机访问的列表,则使用索引遍历以提高性能 // 如果是支持随机访问的列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
action.call(list[i]) action.call(list[i])
} }
} else { } else {
// 否则使用增强 for 循环进行遍历 // 否则使用增强 for 循环进行遍历
for (element in iterable) { for (element in iterable) {
action.call(element) action.call(element)
} }
} }
} }
/** /**
@@ -100,36 +102,36 @@ fun <T> forEach(
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean>, iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean>
) { ) {
when (iterable) { when (iterable) {
is RandomAccess if iterable is MutableList<*> -> { is RandomAccess if iterable is MutableList<*> -> {
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能 // 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
if (action.call(list[i], i)) return if (action.call(list[i], i)) return
} }
} }
is MutableList<*> -> { is MutableList<*> -> {
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引 // 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
var index = 0 var index = 0
val it = iterable.iterator() val it = iterable.iterator()
while (it.hasNext()) { while (it.hasNext()) {
if (action.call(it.next(), index)) return if (action.call(it.next(), index)) return
index++ index++
} }
} }
else -> { else -> {
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引 // 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
var index = 0 var index = 0
for (element in iterable) { for (element in iterable) {
if (action.call(element, index)) return if (action.call(element, index)) return
index++ index++
} }
} }
} }
} }
/** /**
@@ -142,20 +144,20 @@ fun <T> forEachB(
* @param <T> 可迭代对象中元素的类型 * @param <T> 可迭代对象中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
iterable: Iterable<T>, action: P1RFunction<in T, out Boolean>, iterable: Iterable<T>, action: P1RFunction<in T, out Boolean>
) { ) {
if (iterable is RandomAccess) { if (iterable is RandomAccess) {
// 如果是支持随机访问的列表,则使用索引遍历以提高性能 // 如果是支持随机访问的列表,则使用索引遍历以提高性能
val list = iterable as MutableList<T> val list = iterable as MutableList<T>
for (i in list.indices) { for (i in list.indices) {
if (action.call(list[i])) return if (action.call(list[i])) return
} }
} else { } else {
// 否则使用增强 for 循环进行遍历 // 否则使用增强 for 循环进行遍历
for (element in iterable) { for (element in iterable) {
if (action.call(element)) return if (action.call(element)) return
} }
} }
} }
/** /**
@@ -166,9 +168,9 @@ fun <T> forEachB(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
array: Array<T>, action: P2Function<in T, in Int>, array: Array<T>, action: P2Function<in T, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -179,9 +181,9 @@ fun <T> forEach(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEach( fun <T> forEach(
array: Array<T>, action: P1Function<in T>, array: Array<T>, action: P1Function<in T>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -193,9 +195,9 @@ fun <T> forEach(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
array: Array<T>, action: P2RFunction<in T, in Int, out Boolean>, array: Array<T>, action: P2RFunction<in T, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -207,9 +209,9 @@ fun <T> forEachB(
* @param <T> 数组中元素的类型 * @param <T> 数组中元素的类型
*/ */
fun <T> forEachB( fun <T> forEachB(
array: Array<T>, action: P1RFunction<in T, out Boolean>, array: Array<T>, action: P1RFunction<in T, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -219,9 +221,9 @@ fun <T> forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: ByteArray, action: P2Function<in Byte, in Int>, array: ByteArray, action: P2Function<in Byte, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -231,9 +233,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: ByteArray, action: P1Function<in Byte>, array: ByteArray, action: P1Function<in Byte>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -244,9 +246,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean>, array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -257,9 +259,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ByteArray, action: P1RFunction<in Byte, out Boolean>, array: ByteArray, action: P1RFunction<in Byte, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -269,9 +271,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: CharArray, action: P2Function<in Char, in Int>, array: CharArray, action: P2Function<in Char, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -281,9 +283,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: CharArray, action: P1Function<in Char>, array: CharArray, action: P1Function<in Char>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -294,9 +296,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: CharArray, action: P2RFunction<in Char, in Int, out Boolean>, array: CharArray, action: P2RFunction<in Char, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -307,9 +309,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: CharArray, action: P1RFunction<in Char, out Boolean>, array: CharArray, action: P1RFunction<in Char, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -319,9 +321,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: IntArray, action: P2Function<in Int, in Int>, array: IntArray, action: P2Function<in Int, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -331,9 +333,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: IntArray, action: P1Function<in Int>, array: IntArray, action: P1Function<in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -344,9 +346,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: IntArray, action: P2RFunction<in Int, in Int, out Boolean>, array: IntArray, action: P2RFunction<in Int, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -357,9 +359,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: IntArray, action: P1RFunction<in Int, out Boolean>, array: IntArray, action: P1RFunction<in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -369,9 +371,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: LongArray, action: P2Function<in Long, in Int>, array: LongArray, action: P2Function<in Long, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -381,9 +383,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: LongArray, action: P1Function<in Long>, array: LongArray, action: P1Function<in Long>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -394,9 +396,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: LongArray, action: P2RFunction<in Long, in Int, out Boolean>, array: LongArray, action: P2RFunction<in Long, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -407,9 +409,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: LongArray, action: P1RFunction<in Long, out Boolean>, array: LongArray, action: P1RFunction<in Long, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -419,9 +421,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: ShortArray, action: P2Function<in Short, in Int>, array: ShortArray, action: P2Function<in Short, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -431,9 +433,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: ShortArray, action: P1Function<in Short>, array: ShortArray, action: P1Function<in Short>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -444,9 +446,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean>, array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -457,9 +459,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: ShortArray, action: P1RFunction<in Short, out Boolean>, array: ShortArray, action: P1RFunction<in Short, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -469,9 +471,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: FloatArray, action: P2Function<in Float, in Int>, array: FloatArray, action: P2Function<in Float, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -481,9 +483,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: FloatArray, action: P1Function<in Float>, array: FloatArray, action: P1Function<in Float>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -494,9 +496,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean>, array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -507,9 +509,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: FloatArray, action: P1RFunction<in Float, out Boolean>, array: FloatArray, action: P1RFunction<in Float, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -519,9 +521,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: DoubleArray, action: P2Function<in Double, in Int>, array: DoubleArray, action: P2Function<in Double, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -531,9 +533,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: DoubleArray, action: P1Function<in Double>, array: DoubleArray, action: P1Function<in Double>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -544,9 +546,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean>, array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -557,9 +559,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: DoubleArray, action: P1RFunction<in Double, out Boolean>, array: DoubleArray, action: P1RFunction<in Double, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -569,9 +571,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数
*/ */
fun forEach( fun forEach(
array: BooleanArray, action: P2Function<in Boolean, in Int>, array: BooleanArray, action: P2Function<in Boolean, in Int>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -581,9 +583,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,只接收元素值作为参数 * @param action 要对每个元素执行的操作,只接收元素值作为参数
*/ */
fun forEach( fun forEach(
array: BooleanArray, action: P1Function<in Boolean>, array: BooleanArray, action: P1Function<in Boolean>
) { ) {
forEach(array.toList(), action) forEach(array.toList(), action)
} }
/** /**
@@ -594,9 +596,9 @@ fun forEach(
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean>, array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -607,9 +609,9 @@ fun forEachB(
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止 * @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
*/ */
fun forEachB( fun forEachB(
array: BooleanArray, action: P1RFunction<in Boolean, out Boolean>, array: BooleanArray, action: P1RFunction<in Boolean, out Boolean>
) { ) {
forEachB(array.toList(), action) forEachB(array.toList(), action)
} }
/** /**
@@ -623,9 +625,9 @@ fun forEachB(
* @param <A> 集合的具体类型 * @param <A> 集合的具体类型
*/ */
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB( fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
array: A, action: P3RFunction<in K, in V, in Int, out Boolean>, array: A, action: P3RFunction<in K, in V, in Int, out Boolean>
) { ) {
forEachB(array, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) }) forEachB(array, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
} }
/** /**
@@ -639,9 +641,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
* @param <A> 映射的具体类型 * @param <A> 映射的具体类型
*/ */
fun <K, V, A : Map<K, V>> forEachB( fun <K, V, A : Map<K, V>> forEachB(
map: A, action: P3RFunction<in K, in V, in Int, out Boolean>, map: A, action: P3RFunction<in K, in V, in Int, out Boolean>
) { ) {
forEachB(map.entries, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) }) forEachB(map.entries, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
} }
/** /**
@@ -654,9 +656,9 @@ fun <K, V, A : Map<K, V>> forEachB(
* @param <A> 集合的具体类型 * @param <A> 集合的具体类型
*/ */
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap( fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
array: A, action: P2Function<in K, in V>, array: A, action: P2Function<in K, in V>
) { ) {
forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) }) forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
} }
/** /**
@@ -669,9 +671,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
* @param <A> 映射的具体类型 * @param <A> 映射的具体类型
*/ */
fun <K, V, A : Map<K, V>> forEachMap( fun <K, V, A : Map<K, V>> forEachMap(
map: A, action: P2Function<in K, in V>, map: A, action: P2Function<in K, in V>
) { ) {
forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) }) forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
} }
/** /**
@@ -685,9 +687,9 @@ fun <K, V, A : Map<K, V>> forEachMap(
* @param <A> 集合的具体类型 * @param <A> 集合的具体类型
*/ */
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB( fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
array: A, action: P2RFunction<in K, in V, out Boolean>, array: A, action: P2RFunction<in K, in V, out Boolean>
) { ) {
forEachB(array, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) }) forEachB(array, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
} }
/** /**
@@ -701,7 +703,7 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
* @param <A> 映射的具体类型 * @param <A> 映射的具体类型
*/ */
fun <K, V, A : Map<K, V>> forEachMapB( fun <K, V, A : Map<K, V>> forEachMapB(
map: A, action: P2RFunction<in K, in V, out Boolean>, map: A, action: P2RFunction<in K, in V, out Boolean>
) { ) {
forEachB(map.entries, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) }) forEachB(map.entries, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
} }
@@ -16,13 +16,12 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile Debouncer.kt * CurrentFile Debouncer.kt
* LastUpdate 2026-05-23 10:30:38 * LastUpdate 2026-01-11 09:10:30
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.functions package com.mingliqiye.utils.functions
import com.mingliqiye.utils.netty.NamedThreadFactory
import java.util.concurrent.* import java.util.concurrent.*
/** /**
@@ -32,53 +31,51 @@ import java.util.concurrent.*
*/ */
class Debouncer(private val delay: Long, unit: TimeUnit) { class Debouncer(private val delay: Long, unit: TimeUnit) {
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor( private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor()
NamedThreadFactory { clazz, poolNumber, threadNumber -> private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
"Debouncer-$poolNumber-$threadNumber" private val delayMillis: Long = unit.toMillis(delay)
}
)
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
private val delayMillis: Long = unit.toMillis(delay)
/** /**
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时 * 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
* *
* @param key 任务的唯一标识符,用于区分不同任务 * @param key 任务的唯一标识符,用于区分不同任务
* @param task 要执行的任务 * @param task 要执行的任务
*/ */
fun debounce(key: Any, task: Runnable) { fun debounce(key: Any, task: Runnable) {
// 提交新任务并获取之前可能存在的任务 // 提交新任务并获取之前可能存在的任务
val prev = delayedMap.put( val prev = delayedMap.put(
key, key,
scheduler.schedule( scheduler.schedule(
{ {
try { try {
task.run() task.run()
} finally { } finally {
// 任务执行完成后从映射中移除 // 任务执行完成后从映射中移除
delayedMap.remove(key) delayedMap.remove(key)
} }
}, },
delayMillis, delayMillis,
TimeUnit.MILLISECONDS TimeUnit.MILLISECONDS
) )
) )
// 如果之前存在任务,则取消它 // 如果之前存在任务,则取消它
prev?.cancel(true) if (prev != null) {
} prev.cancel(true)
}
}
/** /**
* 关闭防抖器,取消所有待执行的任务并关闭调度器 * 关闭防抖器,取消所有待执行的任务并关闭调度器
*/ */
fun shutdown() { fun shutdown() {
// 先取消所有延迟任务 // 先取消所有延迟任务
for (future in delayedMap.values) { for (future in delayedMap.values) {
future.cancel(true) future.cancel(true)
} }
delayedMap.clear() delayedMap.clear()
// 再关闭调度器 // 再关闭调度器
scheduler.shutdownNow() scheduler.shutdownNow()
} }
} }
File diff suppressed because it is too large Load Diff
@@ -16,14 +16,14 @@
* ProjectName mingli-utils * ProjectName mingli-utils
* ModuleName mingli-utils.main * ModuleName mingli-utils.main
* CurrentFile Pipeline.kt * CurrentFile Pipeline.kt
* LastUpdate 2026-10-20 20:59:13 * LastUpdate 2026-02-05 15:22:21
* UpdateUser MingLiPro * UpdateUser MingLiPro
*/ */
package com.mingliqiye.utils.functions package com.mingliqiye.utils.functions
import com.mingliqiye.utils.require.requireTrue import com.mingliqiye.utils.require.Require
import kotlin.reflect.KClass import java.util.*
/** /**
* 流水线操作类,提供链式调用的操作方式来处理数据转换和操作 * 流水线操作类,提供链式调用的操作方式来处理数据转换和操作
@@ -31,275 +31,242 @@ import kotlin.reflect.KClass
*/ */
class Pipeline<T>(private val value: T) { class Pipeline<T>(private val value: T) {
/** /**
* 对当前值进行转换操作,并返回新的Pipeline实例 * 对当前值进行转换操作,并返回新的Pipeline实例
* @param transformer 转换函数,接收当前值并返回转换后的结果 * @param transformer 转换函数,接收当前值并返回转换后的结果
* @return 包含转换后结果的新Pipeline实例 * @return 包含转换后结果的新Pipeline实例
*/ */
fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value)) fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value))
/** /**
* 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择 * 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择
* @param transformer 转换函数,接收当前值并返回转换后的结果 * @param transformer 转换函数,接收当前值并返回转换后的结果
* @return 包含转换后结果的新Pipeline实例 * @return 包含转换后结果的新Pipeline实例
*/ */
fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer) fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer)
/** /**
* 消费当前值但不改变流水线状态,用于执行副作用操作 * 消费当前值但不改变流水线状态,用于执行副作用操作
* @param consumer 消费函数,接收当前值进行消费操作 * @param consumer 消费函数,接收当前值进行消费操作
* @return 当前Pipeline实例,支持链式调用 * @return 当前Pipeline实例,支持链式调用
*/ */
fun consume(consumer: P1Function<T>): Pipeline<T> { fun consume(consumer: P1Function<T>): Pipeline<T> {
consumer.call(value) consumer.call(value)
return this return this
} }
/** /**
* 判断当前值是否为null * 判断当前值是否为null
* @return true表示当前值为null,false表示不为null * @return true表示当前值为null,false表示不为null
*/ */
fun isNull(): Boolean = (value == null) fun isNull(): Boolean = (value == null)
/** /**
* 判断当前值是否不为null * 判断当前值是否不为null
* @return true表示当前值不为null,false表示为null * @return true表示当前值不为null,false表示为null
*/ */
fun isNotNull(): Boolean = (value != null) fun isNotNull(): Boolean = (value != null)
/** /**
* 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null * 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null
* @param predicate 过滤条件函数,接收当前值并返回布尔值 * @param predicate 过滤条件函数,接收当前值并返回布尔值
* @return 包含过滤后结果的Pipeline实例 * @return 包含过滤后结果的Pipeline实例
*/ */
fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
if (predicate.call(value)) Pipeline(value) else Pipeline(null) if (predicate.call(value)) Pipeline(value) else Pipeline(null)
/** /**
* 获取当前流水线中的值 * 获取当前流水线中的值
* @return 当前流水线中存储的值 * @return 当前流水线中存储的值
*/ */
fun getValue(): T = value fun getValue(): T = value
/** /**
* 安全地转换当前值,允许转换结果为null * 安全地转换当前值,允许转换结果为null
* @param transformer 转换函数,可能返回null * @param transformer 转换函数,可能返回null
* @return 包含转换后结果(可能为null)的Pipeline实例 * @return 包含转换后结果(可能为null)的Pipeline实例
*/ */
fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value)) fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value))
/** /**
* 将当前值映射为另一个Pipeline实例 * 将当前值映射为另一个Pipeline实例
* @param mapper 映射函数,接收当前值并返回Pipeline实例 * @param mapper 映射函数,接收当前值并返回Pipeline实例
* @return 映射后的Pipeline实例 * @return 映射后的Pipeline实例
*/ */
fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value) fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value)
/** /**
* 将当前值映射为非null结果,如果当前值为null则直接返回null * 将当前值映射为非null结果,如果当前值为null则直接返回null
* @param mapper 映射函数,可能返回null * @param mapper 映射函数,可能返回null
* @return 包含映射后结果的Pipeline实例 * @return 包含映射后结果的Pipeline实例
*/ */
fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> = fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> =
if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null) if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null)
/** /**
* 将当前值强制转换为指定类型 * 将当前值强制转换为指定类型
* @param type 目标类型Class对象 * @param type 目标类型Class对象
* @return 包含转换后类型的Pipeline实例 * @return 包含转换后类型的Pipeline实例
* @throws ClassCastException 当类型转换失败时抛出异常 * @throws ClassCastException 当类型转换失败时抛出异常
*/ */
@Throws(ClassCastException::class) @Throws(ClassCastException::class)
@Suppress("UNCHECKED_CAST") fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E)
fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E)
/** /**
* 根据条件判断是否保留当前值,条件满足时保留,否则返回null * 根据条件判断是否保留当前值,条件满足时保留,否则返回null
* @param predicate 条件判断函数 * @param predicate 条件判断函数
* @return 包含条件判断结果的Pipeline实例 * @return 包含条件判断结果的Pipeline实例
*/ */
fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null) fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null)
/** /**
* 根据条件判断是否保留当前值,条件不满足时保留,否则返回null * 根据条件判断是否保留当前值,条件不满足时保留,否则返回null
* @param predicate 条件判断函数 * @param predicate 条件判断函数
* @return 包含条件判断结果的Pipeline实例 * @return 包含条件判断结果的Pipeline实例
*/ */
fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
Pipeline(if (!predicate.call(value)) value else null) Pipeline(if (!predicate.call(value)) value else null)
/** /**
* 在当前值上执行指定操作并返回操作结果 * 在当前值上执行指定操作并返回操作结果
* @param block 执行函数,接收当前值并返回结果 * @param block 执行函数,接收当前值并返回结果
* @return 包含执行结果的Pipeline实例 * @return 包含执行结果的Pipeline实例
*/ */
fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value)) fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value))
/** /**
* 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例 * 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例
* @param defaultValue 默认值 * @param defaultValue 默认值
* @return 当前值或默认值的Pipeline实例 * @return 当前值或默认值的Pipeline实例
*/ */
fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue) fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue)
/** /**
* 如果当前值不为null则返回自身,否则通过供应商函数获取默认值 * 如果当前值不为null则返回自身,否则通过供应商函数获取默认值
* @param supplier 默认值供应商函数 * @param supplier 默认值供应商函数
* @return 当前值或供应商提供的值的Pipeline实例 * @return 当前值或供应商提供的值的Pipeline实例
*/ */
fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call()) fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call())
/** /**
* 验证当前值是否等于指定值,如果不相等则抛出异常 * 验证当前值是否等于指定值,如果不相等则抛出异常
* @param any 比较的目标值 * @param any 比较的目标值
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java, any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java
): Pipeline<T> { ): Pipeline<T> {
requireTrue(any == value, exception, message) Require.require(Objects.equals(any, value), message, exception)
return this return this
} }
/** /**
* 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常 * 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常
* @param any 比较的目标值 * @param any 比较的目标值
* @param message 错误消息 * @param message 错误消息
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
any: Any, message: String, any: Any, message: String
): Pipeline<T> { ): Pipeline<T> {
requireTrue(any == value, message) Require.RequireLayz.require(any == value, message)
return this return this
} }
/** /**
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常 * 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
* @param must 验证条件函数 * @param must 验证条件函数
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
must: P1RFunction<T, Boolean>, must: P1RFunction<T, Boolean>,
message: String, message: String,
exception: Class<out Throwable> = IllegalArgumentException::class.java, exception: Class<out Throwable> = IllegalArgumentException::class.java
): Pipeline<T> { ): Pipeline<T> {
requireTrue(must.call(value), exception, message) Require.require(must.call(value), message, exception)
return this return this
} }
/** /**
* 验证当前值是否等于指定值,如果不相等则抛出异常 * 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常
* @param any 比较的目标值 * @param must 验证条件函数
* @param message 错误消息 * @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException * @return 当前Pipeline实例
* @return 当前Pipeline实例 */
*/ fun require(
fun require( must: P1RFunction<T, Boolean>, message: String
any: Any, ): Pipeline<T> {
message: String, Require.require(must.call(value), message, IllegalArgumentException::class.java)
exception: KClass<out Throwable> = IllegalArgumentException::class, return this
): Pipeline<T> { }
requireTrue(any == value, exception.java, message)
return this
}
/**
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
* @param must 验证条件函数
* @param message 错误消息
* @param exception 异常类型,默认为IllegalArgumentException
* @return 当前Pipeline实例
*/
fun require(
must: (T) -> Boolean,
message: String,
exception: KClass<out Throwable> = IllegalArgumentException::class,
): Pipeline<T> {
requireTrue(must(value), exception.java, message)
return this
}
/**
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常
* @param must 验证条件函数
* @param message 错误消息
* @return 当前Pipeline实例
*/
fun require(
must: P1RFunction<T, Boolean>, message: String,
): Pipeline<T> {
requireTrue(must.call(value), message)
return this
}
/** /**
* 对当前值执行指定操作但不改变流水线状态 * 对当前值执行指定操作但不改变流水线状态
* @param block 执行函数,接收当前值 * @param block 执行函数,接收当前值
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun also(block: P1Function<T>): Pipeline<T> { fun also(block: P1Function<T>): Pipeline<T> {
block.call(value) block.call(value)
return this return this
} }
/** /**
* 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常 * 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常
* @param predicate 验证条件函数 * @param predicate 验证条件函数
* @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed" * @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed"
* @return 当前Pipeline实例 * @return 当前Pipeline实例
*/ */
fun require( fun require(
predicate: P1RFunction<T, Boolean>, predicate: P1RFunction<T, Boolean>,
lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" }, lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" }
): Pipeline<T> { ): Pipeline<T> {
if (!predicate.call(value)) { if (!predicate.call(value)) {
throw IllegalArgumentException(lazyMessage.call(value).toString()) throw IllegalArgumentException(lazyMessage.call(value).toString())
} }
return this return this
} }
/** /**
* 使用比较器比较当前值与另一个值 * 使用比较器比较当前值与另一个值
* @param other 另一个比较值 * @param other 另一个比较值
* @param comparator 比较器 * @param comparator 比较器
* @return 比较结果,负数表示小于,0表示相等,正数表示大于 * @return 比较结果,负数表示小于,0表示相等,正数表示大于
*/ */
fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other) fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other)
/** /**
* 使用选择器将当前值转换为可比较类型后与另一个值比较 * 使用选择器将当前值转换为可比较类型后与另一个值比较
* @param other 另一个比较值 * @param other 另一个比较值
* @param selector 选择器函数,将当前值转换为可比较类型 * @param selector 选择器函数,将当前值转换为可比较类型
* @return 比较结果 * @return 比较结果
*/ */
fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int = fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int =
selector.call(value).compareTo(other) selector.call(value).compareTo(other)
companion object { companion object {
/** /**
* 创建包含指定值的Pipeline实例 * 创建包含指定值的Pipeline实例
* @param value 要包装的值 * @param value 要包装的值
* @return 新的Pipeline实例 * @return 新的Pipeline实例
*/ */
@JvmStatic @JvmStatic
fun <T> of(value: T): Pipeline<T> = Pipeline(value) fun <T> of(value: T): Pipeline<T> = Pipeline(value)
/** /**
* 通过供应商函数创建Pipeline实例 * 通过供应商函数创建Pipeline实例
* @param transformer 值供应商函数 * @param transformer 值供应商函数
* @return 新的Pipeline实例 * @return 新的Pipeline实例
*/ */
@JvmStatic @JvmStatic
fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call()) fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call())
} }
} }
@@ -44,24 +44,24 @@ import java.security.NoSuchAlgorithmException
*/ */
@Throws(IOException::class, NoSuchAlgorithmException::class) @Throws(IOException::class, NoSuchAlgorithmException::class)
fun calculateFileHash(file: File, algorithm: String): String { fun calculateFileHash(file: File, algorithm: String): String {
// 检查文件是否存在 // 检查文件是否存在
if (!file.exists()) { if (!file.exists()) {
throw IOException("File not found: " + file.absolutePath) throw IOException("File not found: " + file.absolutePath)
} }
val digest = MessageDigest.getInstance(algorithm) val digest = MessageDigest.getInstance(algorithm)
FileInputStream(file).use { fis -> FileInputStream(file).use { fis ->
val buffer = ByteArray(8192) val buffer = ByteArray(8192)
var bytesRead: Int var bytesRead: Int
// 分块读取文件内容并更新摘要 // 分块读取文件内容并更新摘要
while (fis.read(buffer).also { bytesRead = it } != -1) { while (fis.read(buffer).also { bytesRead = it } != -1) {
digest.update(buffer, 0, bytesRead) digest.update(buffer, 0, bytesRead)
} }
} }
return bytesToHex(digest.digest()) return bytesToHex(digest.digest())
} }
/** /**
@@ -71,7 +71,7 @@ fun calculateFileHash(file: File, algorithm: String): String {
* @return 加密后的 BCrypt 哈希字符串 * @return 加密后的 BCrypt 哈希字符串
*/ */
fun bcrypt(string: String): String { fun bcrypt(string: String): String {
return hashpw(string) return hashpw(string)
} }
/** /**
@@ -82,5 +82,5 @@ fun bcrypt(string: String): String {
* @return 如果匹配返回 true,否则返回 false * @return 如果匹配返回 true,否则返回 false
*/ */
fun checkBcrypt(string: String, bcrypted: String): Boolean { fun checkBcrypt(string: String, bcrypted: String): Boolean {
return checkpw(string, bcrypted) return checkpw(string, bcrypted)
} }
@@ -1,42 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName FastBaseMapper.kt
* ModuleName mingli-utils.main
* CurrentFile BaseResponse.kt
* LastUpdate 2026-10-26 23:22:18
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.http
open class BaseResponse<T>(
open val time: String,
open var message: String,
open var data: T,
open var statusCode: Int,
) {
/**
* 返回响应对象的字符串表示
*
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
* 显示时间、消息、数据类型和值以及状态码。
*
* @return 格式化的字符串表示
*/
override fun toString(): String =
"${javaClass.simpleName}(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
}
File diff suppressed because it is too large Load Diff
@@ -1,65 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName FastBaseMapper.kt
* ModuleName mingli-utils.main
* CurrentFile PageData.kt
* LastUpdate 2026-10-26 23:22:18
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.http
import com.baomidou.mybatisplus.extension.plugins.pagination.Page
/**
* 分页数据类
*/
data class PageData<T>(
/**
* 当前页的数据列表
*/
val records: Collection<T> = emptyList(),
/**
* 总条数(总记录数)
*/
val totalCount: Long = 0,
/**
* 总页数
*/
val totalPages: Long = 0,
/**
* 每页大小
*/
val pageSize: Long = 0,
/**
* 当前页码(从 1 开始)
*/
val pageIndex: Long = 0,
) {
companion object {
fun <T> of(page: Page<T>): PageData<T> = PageData(
records = page.records,
totalCount = page.total,
totalPages = page.pages,
pageSize = page.size,
pageIndex = page.current,
)
}
}
@@ -1,216 +0,0 @@
/*
* Copyright 2026 mingliqiye
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* ProjectName FastBaseMapper.kt
* ModuleName mingli-utils.main
* CurrentFile PagedResponse.kt
* LastUpdate 2026-10-26 23:22:18
* UpdateUser MingLiPro
*/
package com.mingliqiye.utils.http
import com.baomidou.mybatisplus.extension.plugins.pagination.Page
import com.mingliqiye.utils.time.DateTime
data class PagedResponse<T>(
override val time: String, // 响应时间,一旦创建不可修改
override var message: String, // 响应消息,可通过setter修改
override var data: PageData<T>, // 响应数据,可通过setter修改
override var statusCode: Int, // HTTP状态码,可通过setter修改
) : BaseResponse<PageData<T>>(
time,
message,
data,
statusCode
) {
companion object {
/**
* 创建一个默认的成功响应对象
* 使用默认消息"操作成功",无数据,状态码200
*
* @return Response<Nothing> 默认的成功响应对象
*/
fun ok() = ok("操作成功")
/**
* 创建一个默认的错误响应对象
* 使用默认消息"服务器错误",无数据,状态码500
*
* @return Response<Nothing> 默认的成功响应对象
*/
fun error() = error("服务器错误")
/**
* 创建一个成功的响应对象(仅包含消息)
*
* @param message 响应消息
* @return Response<Any> 成功的响应对象,数据为null
*/
@JvmStatic
fun ok(message: String) = PagedResponse(
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = 200
)
/**
* 创建一个错误的响应对象
*
* @param message 错误消息,默认为"服务器错误"
* @param statusCode HTTP状态码,默认为500
* @return Response<Any> 错误的响应对象
*/
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
/**
* 创建一个成功的响应对象(仅包含数据)
* 使用默认消息"操作成功"
*
* @param T 响应数据的类型
* @param data 响应数据
* @return Response<T> 成功的响应对象,包含数据
*/
@JvmStatic
fun <T> okData(data: PageData<T>) = PagedResponse(
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
)
/**
* 从mybatisplus的page构建
*/
@JvmOverloads
fun <T> okPgae(
page: Page<T>,
time: String = DateTime.now().format(),
message: String = "操作成功",
statusCode: Int = 200,
): PagedResponse<T> {
return PagedResponse(
time = time, message = message, data = PageData.of(page), statusCode = statusCode
)
}
/**
* 创建一个成功的响应对象(包含数据和消息)
*
* @param T 响应数据的类型
* @param data 响应数据
* @param message 响应消息
* @return Response<T> 成功的响应对象,包含数据和消息
*/
@JvmStatic
fun <T> okData(data: PageData<T>, message: String) = PagedResponse(
time = DateTime.now().format(), message = message, data = data, statusCode = 200
)
/**
* 创建一个指定状态码的响应对象(仅包含状态码)
* 使用默认消息"操作成功",无数据
*
* @param statusCode HTTP状态码
* @return Response<Any> 指定状态码的响应对象
*/
@JvmStatic
fun code(statusCode: Int) = PagedResponse(
time = DateTime.now().format(), message = "操作成功", data = PageData<Nothing>(), statusCode = statusCode
)
/**
* 创建一个指定状态码的响应对象(包含状态码和消息)
* 无数据
*
* @param statusCode HTTP状态码
* @param message 响应消息
* @return Response<Any> 指定状态码和消息的响应对象
*/
@JvmStatic
fun code(statusCode: Int, message: String) = PagedResponse(
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = statusCode
)
}
/**
* 默认构造函数,创建一个默认的成功响应对象
* 使用当前时间、默认消息"操作成功"、状态码200、无数据
*/
constructor() : this(
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = PageData()
)
/**
* 设置响应数据
*
* 该方法允许修改响应数据,并返回当前对象以支持链式调用。
*
* @param data 新的响应数据
* @return Response<T> 当前响应对象(支持链式调用)
*/
fun setData(data: PageData<T>): PagedResponse<T> {
this.data = data
return this
}
/**
* 创建一个新的Response对象,使用指定的时间
*
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
* 如果时间相同,则返回原对象避免不必要的对象创建。
*
* @param time 新的响应时间
* @return Response<T> 新的响应对象(如果时间相同则返回原对象)
*/
fun withTime(time: String): PagedResponse<T> =
if (this.time == time) this else PagedResponse(time, message, data, statusCode)
/**
* 创建一个新的Response对象,使用指定的数据
*
* 该方法允许改变响应数据的类型,创建一个新的响应对象。
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
*
* @param D 新的数据类型
* @param data 新的响应数据
* @return Response<D> 新的响应对象,数据类型为D
*/
fun <D> withData(data: PageData<D>): PagedResponse<D> =
PagedResponse(this.time, this.message, data, this.statusCode)
/**
* 创建一个新的Response对象,使用指定的消息
*
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
* 如果消息相同,则返回原对象避免不必要的对象创建。
*
* @param message 新的响应消息
* @return Response<T> 新的响应对象(如果消息相同则返回原对象)
*/
fun withMessage(message: String): PagedResponse<T> =
if (this.message == message) this else PagedResponse(time, message, data, statusCode)
/**
* 创建一个新的Response对象,使用指定的状态码
*
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
* 如果状态码相同,则返回原对象避免不必要的对象创建。
*
* @param statusCode 新的状态码
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
*/
fun withStatusCode(statusCode: Int): PagedResponse<T> =
if (this.statusCode == statusCode) this else PagedResponse(time, message, data, statusCode)
}

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