Compare commits
40
Commits
450b4e1a93
..
master
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
ae41240806
|
||
|
|
cb7fdb4f19
|
||
|
|
3d1896bd64
|
||
|
|
0e0d2b03cc
|
||
|
|
2e54e3d651
|
||
|
|
528802d881
|
||
|
|
487f956f4f
|
||
|
|
64e3af50ed
|
||
|
|
7760201639
|
||
|
|
713342bbc6
|
||
|
|
988a0c0dc1
|
||
|
|
44ea9b114d
|
||
|
|
3bacf90940
|
||
|
|
28a2987dc3
|
||
|
|
8069de37f2
|
||
|
|
51eb838a36
|
||
|
|
d0887ea1f7
|
||
|
|
16da482de7
|
||
|
|
aa83f575b1
|
||
|
|
510ff69e2c
|
||
|
|
184db461d7
|
||
|
|
535c03d14a
|
||
|
|
5714aef444
|
||
|
|
7a3bc01b11
|
||
|
|
792ddf0255
|
||
|
|
f4025cbad9 | ||
|
|
eaf7ee7a31 | ||
|
|
38ad9884d0 | ||
|
|
0e5ce5597b | ||
|
|
85fd391849 | ||
|
|
390afa5462
|
||
|
|
31987b9b14 | ||
|
|
474071e43b
|
||
|
|
6624c00553
|
||
|
|
2c423c4aff
|
||
|
|
f7abd6c271
|
||
|
|
60ec0e2883
|
||
|
|
e00f8ad7a1 | ||
|
|
454cd53553
|
||
|
|
bc8927db26
|
@@ -0,0 +1,92 @@
|
||||
# Changelog
|
||||
|
||||

|
||||
|
||||
本文件记录 mingli-utils 各版本的主要变更。
|
||||
|
||||
## [5.5.4] - 2026-11-18
|
||||
|
||||
### 新增
|
||||
|
||||
- **hash**:新增 `HashCodec` 哈希编解码器接口——实现类只需重写 `hash(InputStream)` 一个方法,
|
||||
字节数组/字符串/文件/路径重载、十六进制输出(`hashHex`)与基于 `MessageDigest.isEqual`
|
||||
的常量时间校验(`verifyHash`)均由默认实现提供;新增 `MessageDigestCodec` 流式基类
|
||||
(8KB 缓冲、恒定内存、不关闭调用方流)及 13 种 JDK 标准算法实现
|
||||
(MD2、MD5、SHA-1、SHA-224/256/384/512、SHA-512/224、SHA-512/256、SHA3-224/256/384/512);
|
||||
提供 `HashUtils` 懒加载单例(`MD2`~`SHA512256`)与 `HashType` 枚举;
|
||||
新增 `TestHash` 测试覆盖已知向量、全部算法一致性、流生命周期与文件/路径重载。
|
||||
- **test**:新增非官方 Log4j2 配置 XSD(覆盖 21 种 Appender、13 种 Layout、11 种 Filter、
|
||||
滚动策略与清理条件等,未知插件元素以开放内容模型放行),`log4j2.xml` 接入 Schema 校验。
|
||||
|
||||
### 变更
|
||||
|
||||
- **springboot**:事件监听注解迁移为 Java 实现——新增 `ApplicationReadyEventListener`、
|
||||
`ContextClosedEventListener`;`ApplicationStartedRunner`、`ApplicationDestroyedRunner`
|
||||
标记为废弃;移除 Kotlin 版注解及 `ApplicationListener`、`ApplicationRunnerData`;
|
||||
`Okhttp3AutoConfiguration` 改用 `@ContextClosedEventListener`。
|
||||
- **http**:`MediaType` 枚举项之间补充空行(纯格式化,无内容变更)。
|
||||
|
||||
### 修复
|
||||
|
||||
- **build**:修正 `signing.secretKeyRingFile` 属性名笔误(误插入空格)。
|
||||
|
||||
### 文档
|
||||
|
||||
- hash 包全部接口、类、枚举与懒加载单例补全中文 KDoc;
|
||||
4 个 Spring Boot 事件监听注解补全 Javadoc。
|
||||
|
||||
## [5.5.2] - 2026-11-17
|
||||
|
||||
### 新增
|
||||
|
||||
- **tuple**:实现 `Tuple.compareTo` 字典序比较——同类型可比较元素按自然顺序,
|
||||
其余按字符串形式比较;公共前缀相等时元素个数较少的元组在前。
|
||||
新增 `TestTuple` 测试覆盖 6 种比较场景。
|
||||
|
||||
## [5.5.1] - 2026-11-17
|
||||
|
||||
### 新增
|
||||
|
||||
- **json**:新增 `reader` / `witer` / `judgment` 三组抽象,为 Jackson2 与 Jackson3 分别提供
|
||||
`JsonReader`、`JsonArrayReader`、`JsonObjectReader`、`JsonWriter`、`ArrayWriter`、`ObjectWriter`
|
||||
与 `ReaderJudgment` 实现(`BaseJsonReader` / `BaseJsonWriter` / `BaseJsonJudgment` 等基类)。
|
||||
- **exception**:新增 `JsonFormatException`,表示 JSON 格式错误,继承自 `JsonException`。
|
||||
- **time**:`DateTime.now(zone)` 支持指定时区;新增 `DateTime.atZone(zoneId)` 时区转换方法,
|
||||
`toString()` 输出包含 `zoneId`。
|
||||
|
||||
### 变更
|
||||
|
||||
- **json**:重构转换器体系——移除按类型划分的 `BaseJsonIntConverter`、`BaseJsonStringConverter`
|
||||
等 10 个转换器及 `JsonConverter` 接口,统一由 `BaseJsonConverter` 与 `JsonConverterUtils` 处理;
|
||||
简化 `DateTimeJsonConverter`、`UUIDJsonConverter`、`NetworkEndpointJsonConverter` 与
|
||||
Jackson2/Jackson3 序列化/反序列化桥接实现;精简 `JSONA` 与 `JsonApi` 门面。
|
||||
- **tuple**:`Tuple` 声明实现 `Comparable<Tuple>`;迭代器改为基于 `toMutableList()` 的简化实现。
|
||||
- **springboot**:`JsonAutoConfiguration` 与 `JacksonJsonBuilder` / `JacksonJsonBuilderImpl`
|
||||
同步适配新的 JSON 转换器体系。
|
||||
|
||||
### 文档
|
||||
|
||||
- 补全 src 下全部 Kotlin 文件的中文 KDoc 与 Java 文件的 Javadoc(约 1.3 万处),
|
||||
覆盖 exception、json、springboot、mybatis/mybatisplus、thread/netty/http、
|
||||
Tuple1~Tuple100 生成类、MediaType 全部枚举项及测试代码;已有文档保持不变。
|
||||
|
||||
## [5.4.4] - 2026-11-17
|
||||
|
||||
- 构建脚本调整(build.gradle.kts 发布配置完善)。
|
||||
- SpringBoot 自动配置重构:新增 `JsonAutoConfiguration` 与 `JacksonBuilder`,
|
||||
精简 Jackson2/Jackson3 JsonApi 自动配置。
|
||||
|
||||
## [5.4.3] - 2026-11-17
|
||||
|
||||
- 新增 `JacksonJsonBuilder` / `JacksonJsonBuilderImpl` 构建器。
|
||||
- `DateTime`、`UUID` 小幅调整;补充 log4j2 测试配置。
|
||||
|
||||
## [5.4.2] - 2026-11
|
||||
|
||||
- 修复 `JSONA.jsonApi` 编译错误。
|
||||
- **mybatisplus**:新增 `FastBaseIServiceNew3518`(适配 MyBatis-Plus 3.5.18)。
|
||||
|
||||
## [5.4.0] - 2026-11
|
||||
|
||||
- **mybatisplus**:新增 `FastBaseIService`。
|
||||
- 全项目统一 Tab 缩进并补全尾随逗号。
|
||||
+197
-165
@@ -16,226 +16,258 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils
|
||||
* CurrentFile build.gradle.kts
|
||||
* LastUpdate 2026-02-08 03:14:06
|
||||
* LastUpdate 2026-11-18 08:42:41
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
import java.time.LocalDateTime
|
||||
import java.time.format.DateTimeFormatter
|
||||
|
||||
/*
|
||||
* 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
|
||||
* CurrentFile build.gradle.kts
|
||||
* LastUpdate 2026-11-17 10:18:28
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
|
||||
|
||||
plugins {
|
||||
idea
|
||||
java
|
||||
signing
|
||||
`java-library`
|
||||
`maven-publish`
|
||||
kotlin("jvm") version "2.2.20"
|
||||
id("org.jetbrains.dokka") version "2.0.0"
|
||||
kotlin("kapt") version "2.2.20"
|
||||
idea
|
||||
java
|
||||
signing
|
||||
`java-library`
|
||||
`maven-publish`
|
||||
kotlin("jvm") 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 VERSIONS = project.properties["VERSIONS"] as String
|
||||
val ARTIFACTID = project.properties["ARTIFACTID"] as String
|
||||
val JDKVERSIONS = (project.properties["JDKVERSIONS"] as String).toInt()
|
||||
|
||||
|
||||
group = GROUPSID
|
||||
version = VERSIONS
|
||||
|
||||
base {
|
||||
archivesName.set(ARTIFACTID)
|
||||
archivesName.set(ARTIFACTID)
|
||||
}
|
||||
|
||||
val buildDir: java.nio.file.Path = File("build").toPath()
|
||||
|
||||
sourceSets {
|
||||
main {
|
||||
java {
|
||||
srcDirs("src/main/java")
|
||||
}
|
||||
kotlin {
|
||||
srcDirs("src/main/kotlin")
|
||||
}
|
||||
resources {
|
||||
srcDirs("src/main/resources")
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
tasks.test {
|
||||
useJUnitPlatform()
|
||||
}
|
||||
|
||||
java {
|
||||
withSourcesJar()
|
||||
toolchain.languageVersion.set(JavaLanguageVersion.of(8))
|
||||
toolchain.languageVersion.set(JavaLanguageVersion.of(JDKVERSIONS))
|
||||
withSourcesJar()
|
||||
}
|
||||
kotlin {
|
||||
jvmToolchain(JDKVERSIONS)
|
||||
}
|
||||
|
||||
repositories {
|
||||
mavenLocal()
|
||||
maven {
|
||||
name = "mingliqiye-public"
|
||||
url = uri("https://repository.mingliqiye.com/repository/maven-public/")
|
||||
}
|
||||
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")
|
||||
|
||||
implementation("org.slf4j:slf4j-api:2.0.17")
|
||||
implementation("com.mingliqiye.utils.jna:WinKernel32Api:1.0.1")
|
||||
implementation(kotlin("reflect"))
|
||||
testImplementation("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
||||
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
|
||||
|
||||
compileOnly("org.mindrot:jbcrypt:0.4")
|
||||
testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0")
|
||||
testImplementation("tools.jackson.core:jackson-databind:3.1.0")
|
||||
testImplementation(kotlin("test"))
|
||||
}
|
||||
|
||||
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")
|
||||
repositories {
|
||||
mavenLocal()
|
||||
}
|
||||
|
||||
|
||||
tasks.withType<JavaCompile> {
|
||||
options.encoding = "UTF-8"
|
||||
tasks.withType<JavaCompile>().configureEach {
|
||||
options.encoding = "UTF-8"
|
||||
}
|
||||
|
||||
tasks.named<Test>("test") {
|
||||
useJUnitPlatform()
|
||||
}
|
||||
|
||||
|
||||
tasks.withType<JavaExec>().configureEach {
|
||||
jvmArgs = listOf(
|
||||
"-Dfile.encoding=UTF-8", "-Dsun.stdout.encoding=UTF-8", "-Dsun.stderr.encoding=UTF-8"
|
||||
)
|
||||
tasks.withType<JavaExec> {
|
||||
jvmArgs(
|
||||
"-Dfile.encoding=UTF-8", "-Dsun.stdout.encoding=UTF-8", "-Dsun.stderr.encoding=UTF-8"
|
||||
)
|
||||
}
|
||||
|
||||
kapt {
|
||||
arguments {
|
||||
arg(
|
||||
"kapt.kotlin.generated",
|
||||
project.layout.buildDirectory.dir("generated/source/kapt/main").get().asFile.absolutePath
|
||||
)
|
||||
}
|
||||
arguments {
|
||||
arg(
|
||||
"kapt.kotlin.generated",
|
||||
project.layout.buildDirectory.dir("generated/source/kapt/main").get().asFile.absolutePath
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
tasks.withType<org.gradle.jvm.tasks.Jar> {
|
||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||
from("LICENSE") { into("META-INF") }
|
||||
from("NOTICE") { into("META-INF") }
|
||||
manifest {
|
||||
attributes(
|
||||
mapOf(
|
||||
"Main-Class" to "com.mingliqiye.utils.main.Main",
|
||||
"Specification-Title" to ARTIFACTID,
|
||||
"Specification-Version" to VERSIONS,
|
||||
"Specification-Vendor" to "minglipro",
|
||||
"Specification-Build-Time" to LocalDateTime.now()
|
||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")),
|
||||
"Specification-Package" to GROUPSID,
|
||||
"Specification-Build-Number" to "1",
|
||||
"Specification-Build-OS" to System.getProperty("os.name"),
|
||||
"Specification-Build-Java" to System.getProperty("java.version"),
|
||||
"Specification-Build-Java-Vendor" to System.getProperty("java.vendor"),
|
||||
"Specification-Build-Java-Vendor-URL" to System.getProperty("java.vendor.url"),
|
||||
"Implementation-Title" to ARTIFACTID,
|
||||
"Implementation-Version" to VERSIONS,
|
||||
"Implementation-Package" to GROUPSID,
|
||||
"Implementation-Vendor" to "minglipro",
|
||||
"Implementation-Build-Time" to LocalDateTime.now()
|
||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
|
||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||
from("LICENSE") { into("META-INF") }
|
||||
from("NOTICE") { into("META-INF") }
|
||||
manifest {
|
||||
attributes(
|
||||
mapOf(
|
||||
"Main-Class" to "com.mingliqiye.utils.main.Main",
|
||||
"Specification-Title" to ARTIFACTID,
|
||||
"Specification-Version" to VERSIONS,
|
||||
"Specification-Vendor" to "minglipro",
|
||||
"Specification-Build-Time" to LocalDateTime.now()
|
||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")),
|
||||
"Specification-Package" to GROUPSID,
|
||||
"Specification-Build-Number" to "1",
|
||||
"Specification-Build-OS" to System.getProperty("os.name"),
|
||||
"Specification-Build-Java" to System.getProperty("java.version"),
|
||||
"Specification-Build-Java-Vendor" to System.getProperty("java.vendor"),
|
||||
"Specification-Build-Java-Vendor-URL" to System.getProperty("java.vendor.url"),
|
||||
"Implementation-Title" to ARTIFACTID,
|
||||
"Implementation-Version" to VERSIONS,
|
||||
"Implementation-Package" to GROUPSID,
|
||||
"Implementation-Vendor" to "minglipro",
|
||||
"Implementation-Build-Time" to LocalDateTime.now()
|
||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
|
||||
|
||||
)
|
||||
)
|
||||
}
|
||||
)
|
||||
)
|
||||
}
|
||||
}
|
||||
val isJdk8Build = project.findProperty("buildForJdk8") == "true"
|
||||
|
||||
|
||||
dokka {
|
||||
pluginsConfiguration.html {
|
||||
customAssets.from("logo.png")
|
||||
}
|
||||
}
|
||||
|
||||
repositories {
|
||||
maven {
|
||||
url = uri("https://maven.aliyun.com/repository/public/")
|
||||
}
|
||||
mavenCentral()
|
||||
}
|
||||
tasks.register<Jar>("javaDocJar") {
|
||||
group = "build"
|
||||
archiveClassifier.set("javadoc")
|
||||
dependsOn("dokkaJavadoc")
|
||||
from(buildDir.resolve("dokka/javadoc"))
|
||||
group = "build"
|
||||
archiveClassifier.set("javadoc")
|
||||
dependsOn("dokkaGenerateJavadoc")
|
||||
from(buildDir.resolve("dokka/javadoc"))
|
||||
}
|
||||
|
||||
tasks.register<Jar>("kotlinDocJar") {
|
||||
group = "build"
|
||||
archiveClassifier.set("kotlindoc")
|
||||
dependsOn("dokkaHtml")
|
||||
from(buildDir.resolve("dokka/html"))
|
||||
group = "build"
|
||||
archiveClassifier.set("kotlindoc")
|
||||
dependsOn("dokkaGeneratePublicationHtml")
|
||||
from(buildDir.resolve("dokka/html"))
|
||||
}
|
||||
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"])
|
||||
artifact(tasks.named("javaDocJar"))
|
||||
artifact(tasks.named("kotlinDocJar"))
|
||||
artifactId = ARTIFACTID
|
||||
java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
|
||||
pom {
|
||||
name = "mingli-utils"
|
||||
url = "https://mingli-utils.mingliqiye.com"
|
||||
description = "A Java/kotlin Utils"
|
||||
licenses {
|
||||
license {
|
||||
name = "The Apache License, Version 2.0"
|
||||
url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
|
||||
}
|
||||
}
|
||||
developers {
|
||||
developer {
|
||||
id = "minglipro"
|
||||
name = "mingli"
|
||||
email = "minglipro@163.com"
|
||||
}
|
||||
}
|
||||
scm {
|
||||
connection = "scm:git:https://git.mingliqiye.com/minglipro/mingli-utils.git"
|
||||
developerConnection = "scm:git:https://git.mingliqiye.com:minglipro/mingli-utils.git"
|
||||
url = "https://git.mingliqiye.com/minglipro/mingli-utils"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
signing {
|
||||
sign(publishing.publications)
|
||||
}
|
||||
publications {
|
||||
create<MavenPublication>("mavenJava") {
|
||||
from(components["java"])
|
||||
artifact(tasks.named("javaDocJar"))
|
||||
artifact(tasks.named("kotlinDocJar"))
|
||||
artifactId = ARTIFACTID
|
||||
pom {
|
||||
name = "mingli-utils"
|
||||
url = "https://mingli-utils.mingliqiye.com"
|
||||
description = "A Java/kotlin Utils"
|
||||
licenses {
|
||||
license {
|
||||
name = "The Apache License, Version 2.0"
|
||||
url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
|
||||
}
|
||||
}
|
||||
developers {
|
||||
developer {
|
||||
id = "minglipro"
|
||||
name = "mingli"
|
||||
email = "minglipro@163.com"
|
||||
}
|
||||
}
|
||||
scm {
|
||||
connection = "scm:git:https://git.mingliqiye.com/minglipro/mingli-utils.git"
|
||||
developerConnection = "scm:git:https://git.mingliqiye.com:minglipro/mingli-utils.git"
|
||||
url = "https://git.mingliqiye.com/minglipro/mingli-utils"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
signing {
|
||||
sign(publishing.publications)
|
||||
}
|
||||
}
|
||||
|
||||
tasks.build {
|
||||
dependsOn("javaDocJar", "kotlinDocJar")
|
||||
dependsOn("javaDocJar", "kotlinDocJar")
|
||||
}
|
||||
|
||||
|
||||
|
||||
|
||||
tasks.processResources {
|
||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||
outputs.upToDateWhen { false }
|
||||
filesMatching(listOf("META-INF/meta-data", "fabric.mod.json")) {
|
||||
expand(
|
||||
project.properties + mapOf(
|
||||
"buildTime" to LocalDateTime.now().format(
|
||||
DateTimeFormatter.ofPattern(
|
||||
"yyyy-MM-dd HH:mm:ss.SSSSSSS"
|
||||
)
|
||||
)
|
||||
)
|
||||
)
|
||||
}
|
||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||
outputs.upToDateWhen { false }
|
||||
filesMatching(listOf("META-INF/meta-data", "fabric.mod.json")) {
|
||||
expand(
|
||||
project.properties + mapOf(
|
||||
"buildTime" to LocalDateTime.now().format(
|
||||
DateTimeFormatter.ofPattern(
|
||||
"yyyy-MM-dd HH:mm:ss.SSSSSSS"
|
||||
)
|
||||
)
|
||||
)
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
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", "")
|
||||
}
|
||||
|
||||
+3
-6
@@ -16,13 +16,10 @@
|
||||
# ProjectName mingli-utils
|
||||
# ModuleName mingli-utils
|
||||
# CurrentFile gradle.properties
|
||||
# LastUpdate 2026-02-08 03:15:06
|
||||
# LastUpdate 2026-11-18 19:46:50
|
||||
# UpdateUser MingLiPro
|
||||
#
|
||||
JDKVERSIONS=1.8
|
||||
JDKVERSIONS=17
|
||||
GROUPSID=com.mingliqiye.utils
|
||||
ARTIFACTID=mingli-utils
|
||||
VERSIONS=4.6.4
|
||||
signing.keyId=B22AA93B
|
||||
signing.password=
|
||||
signing.secretKeyRingFile=secret.gpg
|
||||
VERSIONS=5.5.5
|
||||
|
||||
@@ -1,89 +0,0 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
* You may obtain a copy of the License at
|
||||
*
|
||||
* http://www.apache.org/licenses/LICENSE-2.0
|
||||
*
|
||||
* Unless required by applicable law or agreed to in writing, software
|
||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.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")
|
||||
}
|
||||
@@ -1,23 +0,0 @@
|
||||
#
|
||||
# Copyright 2025 mingliqiye
|
||||
#
|
||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||
# you may not use this file except in compliance with the License.
|
||||
# You may obtain a copy of the License at
|
||||
#
|
||||
# http://www.apache.org/licenses/LICENSE-2.0
|
||||
#
|
||||
# Unless required by applicable law or agreed to in writing, software
|
||||
# distributed under the License is distributed on an "AS IS" BASIS,
|
||||
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||
# See the License for the specific language governing permissions and
|
||||
# limitations under the License.
|
||||
#
|
||||
# ProjectName mingli-utils
|
||||
# ModuleName mingli-utils.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.
+13
-2
@@ -16,10 +16,21 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils
|
||||
* CurrentFile settings.gradle.kts
|
||||
* LastUpdate 2026-02-07 17:00:59
|
||||
* LastUpdate 2026-02-26 10:52:01
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
include("jdk8")
|
||||
plugins {
|
||||
id("com.gradleup.nmcp.settings").version("1.4.4")
|
||||
}
|
||||
|
||||
val ARTIFACTID: String by settings.extra
|
||||
rootProject.name = ARTIFACTID
|
||||
|
||||
nmcpSettings {
|
||||
centralPortal {
|
||||
username = System.getenv("sonatype.username")
|
||||
password = System.getenv("sonatype.password")
|
||||
publishingType = "AUTOMATIC"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -0,0 +1,43 @@
|
||||
/*
|
||||
* 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;
|
||||
|
||||
|
||||
/**
|
||||
* Jackson 3 API 的 Java 辅助类,用于在 Java 侧调用 Kotlin 内联/受限 API。
|
||||
*/
|
||||
public class Jackson3ApiJavaHelper {
|
||||
/**
|
||||
* 基于现有 ObjectMapper 创建可重新配置的 MapperBuilder。
|
||||
*
|
||||
* @param objectMapper 需要重建的 ObjectMapper 实例
|
||||
* @return 由该 ObjectMapper 派生的 MapperBuilder
|
||||
*/
|
||||
@SuppressWarnings("rawtypes")
|
||||
static MapperBuilder rebuild(ObjectMapper objectMapper) {
|
||||
return objectMapper.rebuild();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,152 @@
|
||||
/*
|
||||
* 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;
|
||||
|
||||
/**
|
||||
* 工具库入口类,提供启动 Banner 打印以及进程、主机、用户等基础信息的获取方法。
|
||||
*/
|
||||
public class Main {
|
||||
/**
|
||||
* 启动时打印的 ASCII 艺术 Banner 文本
|
||||
*/
|
||||
public final static String BANNER =
|
||||
"| $$\\ $$\\ $$\\ $$\\ $$\\ $$$$$$$$\\ $$$$$$\\ \n" +
|
||||
"| $$$\\ $$$ |$$ | $$ | $$ |\\__$$ __|$$ __$$\\ \n" +
|
||||
"| $$$$\\ $$$$ |$$ | $$ | $$ | $$ | $$ / \\__| \n" +
|
||||
"| $$\\$$\\$$ $$ |$$ | $$ | $$ | $$ | \\$$$$$$\\ \n" +
|
||||
"| $$ \\$$$ $$ |$$ | $$ | $$ | $$ | \\____$$\\ \n" +
|
||||
"| $$ |\\$ /$$ |$$ | $$ | $$ | $$ | $$\\ $$ | \n" +
|
||||
"| $$ | \\_/ $$ |$$$$$$$$\\\\$$$$$$ | $$ | \\$$$$$$ \n" +
|
||||
"| \\__| \\__|\\________|\\______/ \\__| \\______/ \n|\n";
|
||||
|
||||
/**
|
||||
* 程序入口,打印 Banner 与构建元数据信息,打印失败时静默忽略。
|
||||
*
|
||||
* @param args 命令行参数(未使用)
|
||||
*/
|
||||
public static void main(String[] args) {
|
||||
try {
|
||||
printb();
|
||||
} catch (IOException ignored) {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取当前进程 PID 字符串。
|
||||
*
|
||||
* @return 当前进程 PID;获取失败时返回 "-1"
|
||||
*/
|
||||
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";
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取计算机名,依次尝试环境变量 COMPUTERNAME、HOSTNAME 与本机主机名。
|
||||
*
|
||||
* @return 计算机名;获取失败时返回 "unknown"
|
||||
*/
|
||||
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";
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取当前用户名,依次尝试环境变量 USERNAME、USER 与 user.name。
|
||||
*
|
||||
* @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";
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 打印 Banner 及构建元数据、JDK 版本、PID、计算机名、用户名与当前时间。
|
||||
* 若元数据资源不存在则直接返回。
|
||||
*
|
||||
* @throws IOException 读取元数据资源失败时抛出
|
||||
*/
|
||||
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);
|
||||
}
|
||||
}
|
||||
+83
@@ -0,0 +1,83 @@
|
||||
/*
|
||||
* 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 ApplicationDestroyedRunner.java
|
||||
* LastUpdate 2026-11-18 08:21:37
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.springboot.annotation;
|
||||
|
||||
import org.springframework.context.event.ContextClosedEvent;
|
||||
import org.springframework.context.event.EventListener;
|
||||
import org.springframework.core.Ordered;
|
||||
import org.springframework.core.annotation.AliasFor;
|
||||
import org.springframework.core.annotation.Order;
|
||||
|
||||
import java.lang.annotation.*;
|
||||
|
||||
/**
|
||||
* 应用销毁(上下文关闭)事件监听注解。
|
||||
*
|
||||
* <p>标注在 Spring Bean 的方法上,当 Spring 应用上下文关闭
|
||||
* ({@link ContextClosedEvent} 发布)时自动调用该方法。</p>
|
||||
*
|
||||
* @deprecated 已弃用,请改用 {@link ContextClosedEventListener}(监听相同事件,命名更规范)。
|
||||
* @see ContextClosedEventListener
|
||||
* @see EventListener
|
||||
* @see ContextClosedEvent
|
||||
*/
|
||||
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
|
||||
@Retention(RetentionPolicy.RUNTIME)
|
||||
@Documented
|
||||
@EventListener(ContextClosedEvent.class)
|
||||
@Order
|
||||
@Deprecated(since = "use ApplicationReadyEventListener")
|
||||
public @interface ApplicationDestroyedRunner {
|
||||
/**
|
||||
* SpEL 条件表达式,仅当表达式求值为 true 时才执行监听方法。
|
||||
*
|
||||
* @return 条件表达式,默认为空字符串(无条件执行)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "condition")
|
||||
String condition() default "";
|
||||
|
||||
/**
|
||||
* 当事件不是 {@link ContextClosedEvent} 类型时是否仍默认执行监听方法。
|
||||
*
|
||||
* @return 是否默认执行,默认为 true
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "defaultExecution")
|
||||
boolean defaultExecution() default true;
|
||||
|
||||
/**
|
||||
* 监听器的唯一标识,用于注册可指定 id 的监听器。
|
||||
*
|
||||
* @return 监听器 id,默认为空字符串(自动生成)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "id")
|
||||
String id() default "";
|
||||
|
||||
/**
|
||||
* 监听器的执行顺序,值越小优先级越高。
|
||||
*
|
||||
* @return 顺序值,默认为 {@link Ordered#LOWEST_PRECEDENCE}
|
||||
* @see Ordered#getOrder()
|
||||
*/
|
||||
@AliasFor(annotation = Order.class, attribute = "value")
|
||||
int order() default Ordered.LOWEST_PRECEDENCE;
|
||||
}
|
||||
+95
@@ -0,0 +1,95 @@
|
||||
/*
|
||||
* 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 ApplicationReadyEventListener.java
|
||||
* LastUpdate 2026-11-18 08:21:57
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.springboot.annotation;
|
||||
|
||||
|
||||
import org.springframework.boot.context.event.ApplicationReadyEvent;
|
||||
import org.springframework.context.event.EventListener;
|
||||
import org.springframework.core.Ordered;
|
||||
import org.springframework.core.annotation.AliasFor;
|
||||
import org.springframework.core.annotation.Order;
|
||||
|
||||
import java.lang.annotation.*;
|
||||
|
||||
|
||||
/**
|
||||
* 应用就绪事件监听注解。
|
||||
*
|
||||
* <p>标注在 Spring Bean 的方法上,当 Spring Boot 应用完成启动并就绪
|
||||
* ({@link ApplicationReadyEvent} 发布)时自动调用该方法,
|
||||
* 等价于 {@code @EventListener(ApplicationReadyEvent.class)} 的组合简化写法。</p>
|
||||
*
|
||||
* <p>使用示例:</p>
|
||||
* <pre>{@code
|
||||
* @Component
|
||||
* public class InitTask {
|
||||
* @ApplicationReadyEventListener(order = 0)
|
||||
* public void onReady() {
|
||||
* // 应用就绪后执行的初始化逻辑
|
||||
* }
|
||||
* }
|
||||
* }</pre>
|
||||
*
|
||||
* @see EventListener
|
||||
* @see ApplicationReadyEvent
|
||||
*/
|
||||
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
|
||||
@Retention(RetentionPolicy.RUNTIME)
|
||||
@Documented
|
||||
@EventListener(ApplicationReadyEvent.class)
|
||||
@Order
|
||||
public @interface ApplicationReadyEventListener {
|
||||
/**
|
||||
* SpEL 条件表达式,仅当表达式求值为 true 时才执行监听方法。
|
||||
*
|
||||
* @return 条件表达式,默认为空字符串(无条件执行)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "condition")
|
||||
String condition() default "";
|
||||
|
||||
/**
|
||||
* 当事件不是 {@link ApplicationReadyEvent} 类型时是否仍默认执行监听方法。
|
||||
*
|
||||
* @return 是否默认执行,默认为 true
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "defaultExecution")
|
||||
boolean defaultExecution() default true;
|
||||
|
||||
/**
|
||||
* 监听器的唯一标识,用于注册可指定 id 的监听器。
|
||||
*
|
||||
* @return 监听器 id,默认为空字符串(自动生成)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "id")
|
||||
String id() default "";
|
||||
|
||||
|
||||
/**
|
||||
* 监听器的执行顺序,值越小优先级越高。
|
||||
*
|
||||
* @return 顺序值,默认为 {@link Ordered#LOWEST_PRECEDENCE}
|
||||
* @see Ordered#getOrder()
|
||||
*/
|
||||
@AliasFor(annotation = Order.class, attribute = "value")
|
||||
int order() default Ordered.LOWEST_PRECEDENCE;
|
||||
}
|
||||
+84
@@ -0,0 +1,84 @@
|
||||
/*
|
||||
* 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 ApplicationStartedRunner.java
|
||||
* LastUpdate 2026-11-18 08:21:57
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.springboot.annotation;
|
||||
|
||||
import org.springframework.boot.context.event.ApplicationReadyEvent;
|
||||
import org.springframework.context.event.EventListener;
|
||||
import org.springframework.core.Ordered;
|
||||
import org.springframework.core.annotation.AliasFor;
|
||||
import org.springframework.core.annotation.Order;
|
||||
|
||||
import java.lang.annotation.*;
|
||||
|
||||
/**
|
||||
* 应用启动完成事件监听注解。
|
||||
*
|
||||
* <p>标注在 Spring Bean 的方法上,当 Spring Boot 应用完成启动并就绪
|
||||
* ({@link ApplicationReadyEvent} 发布)时自动调用该方法。</p>
|
||||
*
|
||||
* @deprecated 已弃用,请改用 {@link ApplicationReadyEventListener}(功能完全一致,命名更规范)。
|
||||
* @see ApplicationReadyEventListener
|
||||
* @see EventListener
|
||||
* @see ApplicationReadyEvent
|
||||
*/
|
||||
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
|
||||
@Retention(RetentionPolicy.RUNTIME)
|
||||
@Documented
|
||||
@EventListener(ApplicationReadyEvent.class)
|
||||
@Order
|
||||
@Deprecated(since = "use ApplicationReadyEventListener")
|
||||
public @interface ApplicationStartedRunner {
|
||||
/**
|
||||
* SpEL 条件表达式,仅当表达式求值为 true 时才执行监听方法。
|
||||
*
|
||||
* @return 条件表达式,默认为空字符串(无条件执行)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "condition")
|
||||
String condition() default "";
|
||||
|
||||
/**
|
||||
* 当事件不是 {@link ApplicationReadyEvent} 类型时是否仍默认执行监听方法。
|
||||
*
|
||||
* @return 是否默认执行,默认为 true
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "defaultExecution")
|
||||
boolean defaultExecution() default true;
|
||||
|
||||
/**
|
||||
* 监听器的唯一标识,用于注册可指定 id 的监听器。
|
||||
*
|
||||
* @return 监听器 id,默认为空字符串(自动生成)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "id")
|
||||
String id() default "";
|
||||
|
||||
|
||||
/**
|
||||
* 监听器的执行顺序,值越小优先级越高。
|
||||
*
|
||||
* @return 顺序值,默认为 {@link Ordered#LOWEST_PRECEDENCE}
|
||||
* @see Ordered#getOrder()
|
||||
*/
|
||||
@AliasFor(annotation = Order.class, attribute = "value")
|
||||
int order() default Ordered.LOWEST_PRECEDENCE;
|
||||
}
|
||||
+93
@@ -0,0 +1,93 @@
|
||||
/*
|
||||
* 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 ContextClosedEventListener.java
|
||||
* LastUpdate 2026-11-18 08:21:23
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.springboot.annotation;
|
||||
|
||||
import org.springframework.context.event.ContextClosedEvent;
|
||||
import org.springframework.context.event.EventListener;
|
||||
import org.springframework.core.Ordered;
|
||||
import org.springframework.core.annotation.AliasFor;
|
||||
import org.springframework.core.annotation.Order;
|
||||
|
||||
import java.lang.annotation.*;
|
||||
|
||||
/**
|
||||
* 应用上下文关闭事件监听注解。
|
||||
*
|
||||
* <p>标注在 Spring Bean 的方法上,当 Spring 应用上下文关闭
|
||||
* ({@link ContextClosedEvent} 发布)时自动调用该方法,
|
||||
* 等价于 {@code @EventListener(ContextClosedEvent.class)} 的组合简化写法,
|
||||
* 适用于应用停机前的资源清理、状态保存等场景。</p>
|
||||
*
|
||||
* <p>使用示例:</p>
|
||||
* <pre>{@code
|
||||
* @Component
|
||||
* public class CleanupTask {
|
||||
* @ContextClosedEventListener
|
||||
* public void onClosed() {
|
||||
* // 上下文关闭前执行的清理逻辑
|
||||
* }
|
||||
* }
|
||||
* }</pre>
|
||||
*
|
||||
* @see EventListener
|
||||
* @see ContextClosedEvent
|
||||
*/
|
||||
@Target({ElementType.METHOD, ElementType.ANNOTATION_TYPE})
|
||||
@Retention(RetentionPolicy.RUNTIME)
|
||||
@Documented
|
||||
@EventListener(ContextClosedEvent.class)
|
||||
@Order
|
||||
public @interface ContextClosedEventListener {
|
||||
/**
|
||||
* SpEL 条件表达式,仅当表达式求值为 true 时才执行监听方法。
|
||||
*
|
||||
* @return 条件表达式,默认为空字符串(无条件执行)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "condition")
|
||||
String condition() default "";
|
||||
|
||||
/**
|
||||
* 当事件不是 {@link ContextClosedEvent} 类型时是否仍默认执行监听方法。
|
||||
*
|
||||
* @return 是否默认执行,默认为 true
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "defaultExecution")
|
||||
boolean defaultExecution() default true;
|
||||
|
||||
/**
|
||||
* 监听器的唯一标识,用于注册可指定 id 的监听器。
|
||||
*
|
||||
* @return 监听器 id,默认为空字符串(自动生成)
|
||||
*/
|
||||
@AliasFor(annotation = EventListener.class, attribute = "id")
|
||||
String id() default "";
|
||||
|
||||
/**
|
||||
* 监听器的执行顺序,值越小优先级越高。
|
||||
*
|
||||
* @return 顺序值,默认为 {@link Ordered#LOWEST_PRECEDENCE}
|
||||
* @see Ordered#getOrder()
|
||||
*/
|
||||
@AliasFor(annotation = Order.class, attribute = "value")
|
||||
int order() default Ordered.LOWEST_PRECEDENCE;
|
||||
}
|
||||
@@ -13,10 +13,10 @@
|
||||
* See the License for the specific language governing permissions and
|
||||
* limitations under the License.
|
||||
*
|
||||
* ProjectName mingli-utils
|
||||
* ProjectName FastBaseMapper.kt
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile SuperStream.java
|
||||
* LastUpdate 2026-01-20 13:27:09
|
||||
* LastUpdate 2026-10-26 23:22:18
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -103,6 +103,17 @@ public class SuperStream<T> implements Stream<T> {
|
||||
return of(Collections.newArrayLists(args));
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建一个包含指定布尔元素的SuperStream
|
||||
*
|
||||
* @param args 可变参数的布尔数组
|
||||
* @return 包含指定布尔的SuperStream实例
|
||||
*/
|
||||
public static SuperStream<Boolean> of(boolean... args) {
|
||||
return of(Collections.newArrayLists(args));
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 创建一个包含指定浮点数元素的SuperStream
|
||||
*
|
||||
@@ -696,7 +707,7 @@ public class SuperStream<T> implements Stream<T> {
|
||||
* @param <T> 输入元素的类型
|
||||
* @return 产生List的收集器
|
||||
*/
|
||||
public static <T> Collector<T, ?, List<T>> toList() {
|
||||
public static <T> Collector<T, ?, List<T>> toListCollector() {
|
||||
return Collectors.toList();
|
||||
}
|
||||
|
||||
@@ -1219,7 +1230,7 @@ public class SuperStream<T> implements Stream<T> {
|
||||
* @return 包含流中所有元素的List
|
||||
*/
|
||||
public List<T> toAList() {
|
||||
return collect(toList());
|
||||
return collect(toListCollector());
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
* 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.
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile AesUtils.kt
|
||||
* LastUpdate 2025-09-19 21:35:53
|
||||
* LastUpdate 2026-03-12 10:34:36
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -25,7 +25,7 @@
|
||||
|
||||
package com.mingliqiye.utils.aes
|
||||
|
||||
import com.mingliqiye.utils.base.BASE64
|
||||
import com.mingliqiye.utils.base.BaseType
|
||||
import java.nio.charset.StandardCharsets
|
||||
import java.security.GeneralSecurityException
|
||||
import java.security.MessageDigest
|
||||
@@ -34,10 +34,15 @@ import javax.crypto.Cipher
|
||||
import javax.crypto.spec.GCMParameterSpec
|
||||
import javax.crypto.spec.SecretKeySpec
|
||||
|
||||
/** 加密算法名称:AES。 */
|
||||
const val ALGORITHM = "AES"
|
||||
/** AES 加密变换模式:GCM 模式,无填充。 */
|
||||
const val TRANSFORMATION = "AES/GCM/NoPadding"
|
||||
/** GCM 模式初始化向量(IV)长度,单位字节。 */
|
||||
const val GCM_IV_LENGTH = 12
|
||||
/** GCM 模式认证标签(Tag)长度,单位字节。 */
|
||||
const val GCM_TAG_LENGTH = 16
|
||||
/** 全局安全随机数生成器,用于生成加密安全的随机 IV。 */
|
||||
val SECURE_RANDOM = SecureRandom()
|
||||
|
||||
|
||||
@@ -50,30 +55,30 @@ val SECURE_RANDOM = SecureRandom()
|
||||
*/
|
||||
@Throws(GeneralSecurityException::class)
|
||||
fun encrypt(sSrc: String, sKey: String?): String? {
|
||||
if (sKey == null) {
|
||||
return null
|
||||
}
|
||||
if (sKey == null) {
|
||||
return null
|
||||
}
|
||||
|
||||
// 生成密钥
|
||||
val secretKeySpec = createSecretKey(sKey)
|
||||
// 生成密钥
|
||||
val secretKeySpec = createSecretKey(sKey)
|
||||
|
||||
// 生成安全随机IV
|
||||
val iv = ByteArray(GCM_IV_LENGTH)
|
||||
SECURE_RANDOM.nextBytes(iv)
|
||||
// 生成安全随机IV
|
||||
val iv = ByteArray(GCM_IV_LENGTH)
|
||||
SECURE_RANDOM.nextBytes(iv)
|
||||
|
||||
// 初始化加密器
|
||||
val cipher = Cipher.getInstance(TRANSFORMATION)
|
||||
val gcmParameterSpec = GCMParameterSpec(
|
||||
GCM_TAG_LENGTH * 8, iv
|
||||
)
|
||||
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
||||
// 初始化加密器
|
||||
val cipher = Cipher.getInstance(TRANSFORMATION)
|
||||
val gcmParameterSpec = GCMParameterSpec(
|
||||
GCM_TAG_LENGTH * 8, iv
|
||||
)
|
||||
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
||||
|
||||
val encrypted = cipher.doFinal(
|
||||
sSrc.toByteArray(StandardCharsets.UTF_8)
|
||||
)
|
||||
return BASE64.encode(
|
||||
"${BASE64.encode(iv)}:${BASE64.encode(encrypted)}".toByteArray()
|
||||
)
|
||||
val encrypted = cipher.doFinal(
|
||||
sSrc.toByteArray(StandardCharsets.UTF_8)
|
||||
)
|
||||
return BaseType.BASE64.encode(
|
||||
"${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray()
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -83,29 +88,29 @@ fun encrypt(sSrc: String, sKey: String?): String? {
|
||||
* @return 解密后的原始字符串
|
||||
*/
|
||||
fun decrypt(sSrc: String, sKey: String): String? {
|
||||
try {
|
||||
// 分割IV和加密数据
|
||||
val sSrcs = String(BASE64.decode(sSrc))
|
||||
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
|
||||
if (parts.size != 2) {
|
||||
return null
|
||||
}
|
||||
val iv = BASE64.decode(parts[0]!!)
|
||||
val encryptedData = BASE64.decode(parts[1]!!)
|
||||
if (iv.size != GCM_IV_LENGTH) {
|
||||
return null
|
||||
}
|
||||
val secretKeySpec = createSecretKey(sKey)
|
||||
val cipher = Cipher.getInstance(TRANSFORMATION)
|
||||
val gcmParameterSpec = GCMParameterSpec(
|
||||
GCM_TAG_LENGTH * 8, iv
|
||||
)
|
||||
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
||||
val original = cipher.doFinal(encryptedData)
|
||||
return String(original, StandardCharsets.UTF_8)
|
||||
} catch (e: Exception) {
|
||||
return null
|
||||
}
|
||||
try {
|
||||
// 分割IV和加密数据
|
||||
val sSrcs = String(BaseType.BASE64.decode(sSrc))
|
||||
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
|
||||
if (parts.size != 2) {
|
||||
return null
|
||||
}
|
||||
val iv = BaseType.BASE64.decode(parts[0]!!)
|
||||
val encryptedData = BaseType.BASE64.decode(parts[1]!!)
|
||||
if (iv.size != GCM_IV_LENGTH) {
|
||||
return null
|
||||
}
|
||||
val secretKeySpec = createSecretKey(sKey)
|
||||
val cipher = Cipher.getInstance(TRANSFORMATION)
|
||||
val gcmParameterSpec = GCMParameterSpec(
|
||||
GCM_TAG_LENGTH * 8, iv
|
||||
)
|
||||
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
||||
val original = cipher.doFinal(encryptedData)
|
||||
return String(original, StandardCharsets.UTF_8)
|
||||
} catch (e: Exception) {
|
||||
return null
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -116,9 +121,8 @@ fun decrypt(sSrc: String, sKey: String): String? {
|
||||
*/
|
||||
@Throws(Exception::class)
|
||||
private fun createSecretKey(sKey: String): SecretKeySpec {
|
||||
val key = sKey.toByteArray(StandardCharsets.UTF_8)
|
||||
val md = MessageDigest.getInstance("MD5")
|
||||
val digest = md.digest(key)
|
||||
return SecretKeySpec(digest, ALGORITHM)
|
||||
val key = sKey.toByteArray(StandardCharsets.UTF_8)
|
||||
val md = MessageDigest.getInstance("MD5")
|
||||
val digest = md.digest(key)
|
||||
return SecretKeySpec(digest, ALGORITHM)
|
||||
}
|
||||
|
||||
|
||||
@@ -37,5 +37,5 @@ import kotlin.reflect.KClass
|
||||
@Target(AnnotationTarget.CLASS)
|
||||
@Retention(AnnotationRetention.SOURCE)
|
||||
annotation class AutoService(
|
||||
val value: Array<KClass<*>> = []
|
||||
val value: Array<KClass<*>> = [],
|
||||
)
|
||||
|
||||
@@ -33,7 +33,7 @@ import com.mingliqiye.utils.time.Formatter
|
||||
*/
|
||||
@Target(AnnotationTarget.FIELD)
|
||||
annotation class DateTimeJsonFormat(
|
||||
val value: Formatter = Formatter.NONE,
|
||||
val formatter: String = "",
|
||||
val repcZero: Boolean = true,
|
||||
val value: Formatter = Formatter.NONE,
|
||||
val formatter: String = "",
|
||||
val repcZero: Boolean = true,
|
||||
)
|
||||
|
||||
@@ -33,6 +33,6 @@ import com.mingliqiye.utils.uuid.UUIDFormatType
|
||||
*/
|
||||
@Target(AnnotationTarget.FIELD)
|
||||
annotation class UUIDJsonFormat(
|
||||
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
|
||||
val base: BaseType = BaseType.BASE16
|
||||
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
|
||||
val base: BaseType = BaseType.BASE16,
|
||||
)
|
||||
|
||||
@@ -16,14 +16,13 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile AutoServiceProcessor.kt
|
||||
* LastUpdate 2026-02-08 01:24:16
|
||||
* LastUpdate 2026-03-11 08:46:40
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.annotation.processor
|
||||
|
||||
import com.mingliqiye.utils.annotation.AutoService
|
||||
import com.mingliqiye.utils.io.IO.println
|
||||
import javax.annotation.processing.AbstractProcessor
|
||||
import javax.annotation.processing.ProcessingEnvironment
|
||||
import javax.annotation.processing.RoundEnvironment
|
||||
@@ -34,72 +33,92 @@ import javax.lang.model.type.TypeMirror
|
||||
import javax.tools.StandardLocation
|
||||
|
||||
|
||||
/**
|
||||
* [AutoService] 注解的编译期处理器。
|
||||
*
|
||||
* 扫描标注了 [AutoService] 的类,收集服务接口与实现类的映射关系,
|
||||
* 并在编译输出目录的 META-INF/services 下生成对应的服务注册文件。
|
||||
*/
|
||||
@SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService")
|
||||
class AutoServiceProcessor : AbstractProcessor() {
|
||||
override fun init(processingEnv: ProcessingEnvironment) {
|
||||
super.init(processingEnv)
|
||||
}
|
||||
override fun init(processingEnv: ProcessingEnvironment) {
|
||||
super.init(processingEnv)
|
||||
}
|
||||
|
||||
override fun process(
|
||||
annotations: Set<TypeElement>,
|
||||
roundEnv: RoundEnvironment
|
||||
): Boolean {
|
||||
/**
|
||||
* 处理标注了 [AutoService] 的元素,收集服务接口与实现类的映射并生成服务注册文件。
|
||||
* 若注解未显式指定服务接口,则默认使用该类直接实现的接口。
|
||||
*
|
||||
* @param annotations 本轮处理的注解类型集合
|
||||
* @param roundEnv 当前轮次的处理环境
|
||||
* @return 是否已处理该注解,存在标注元素时返回 true,否则返回 false
|
||||
*/
|
||||
override fun process(
|
||||
annotations: Set<TypeElement>,
|
||||
roundEnv: RoundEnvironment,
|
||||
): Boolean {
|
||||
|
||||
val service = mutableMapOf<String, MutableList<String>>()
|
||||
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
|
||||
if (elements.isEmpty()) return false
|
||||
for (element in elements) {
|
||||
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
|
||||
var asd = (try {
|
||||
autoServiceAnnotation!!.value.map { it.java.name }
|
||||
} catch (e: MirroredTypesException) {
|
||||
e.typeMirrors.map(TypeMirror::toString)
|
||||
})
|
||||
val service = mutableMapOf<String, MutableList<String>>()
|
||||
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
|
||||
if (elements.isEmpty()) return false
|
||||
for (element in elements) {
|
||||
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
|
||||
var asd = (try {
|
||||
autoServiceAnnotation!!.value.map { it.java.name }
|
||||
} catch (e: MirroredTypesException) {
|
||||
e.typeMirrors.map(TypeMirror::toString)
|
||||
})
|
||||
|
||||
if (asd.isEmpty()) {
|
||||
if (element is TypeElement) {
|
||||
asd = element.interfaces.map { it.toString() }
|
||||
}
|
||||
}
|
||||
for (data in asd) {
|
||||
var ldata: MutableList<String>? = service[data]
|
||||
if (ldata == null) {
|
||||
ldata = mutableListOf()
|
||||
service[data] = ldata
|
||||
}
|
||||
ldata.add(element.toString())
|
||||
}
|
||||
}
|
||||
processClassAnnotation(service)
|
||||
return true
|
||||
}
|
||||
if (asd.isEmpty()) {
|
||||
if (element is TypeElement) {
|
||||
asd = element.interfaces.map { it.toString() }
|
||||
}
|
||||
}
|
||||
for (data in asd) {
|
||||
var ldata: MutableList<String>? = service[data]
|
||||
if (ldata == null) {
|
||||
ldata = mutableListOf()
|
||||
service[data] = ldata
|
||||
}
|
||||
ldata.add(element.toString())
|
||||
}
|
||||
}
|
||||
processClassAnnotation(service)
|
||||
return true
|
||||
}
|
||||
|
||||
fun processClassAnnotation(map: Map<String, MutableList<String>>) {
|
||||
map.forEach { (interfaceName, implementations) ->
|
||||
if (implementations.isEmpty()) {
|
||||
println("警告: $interfaceName 的实现列表为空!")
|
||||
return@forEach
|
||||
}
|
||||
try {
|
||||
val serviceFile = processingEnv.filer.createResource(
|
||||
StandardLocation.CLASS_OUTPUT,
|
||||
"",
|
||||
"META-INF/services/$interfaceName"
|
||||
)
|
||||
val content = StringBuilder()
|
||||
serviceFile.openWriter().use { writer ->
|
||||
implementations.forEach { impl ->
|
||||
val line = "$impl\n"
|
||||
content.append(line)
|
||||
writer.write(line)
|
||||
}
|
||||
writer.flush()
|
||||
}
|
||||
/**
|
||||
* 根据服务接口与实现类的映射,在 META-INF/services 目录下生成服务注册文件。
|
||||
* 实现列表为空或文件创建失败时打印提示信息并跳过。
|
||||
*
|
||||
* @param map 服务接口全限定名到实现类全限定名列表的映射
|
||||
*/
|
||||
fun processClassAnnotation(map: Map<String, MutableList<String>>) {
|
||||
map.forEach { (interfaceName, implementations) ->
|
||||
if (implementations.isEmpty()) {
|
||||
println("警告: $interfaceName 的实现列表为空!")
|
||||
return@forEach
|
||||
}
|
||||
try {
|
||||
val serviceFile = processingEnv.filer.createResource(
|
||||
StandardLocation.CLASS_OUTPUT,
|
||||
"",
|
||||
"META-INF/services/$interfaceName"
|
||||
)
|
||||
val content = StringBuilder()
|
||||
serviceFile.openWriter().use { writer ->
|
||||
implementations.forEach { impl ->
|
||||
val line = "$impl\n"
|
||||
content.append(line)
|
||||
writer.write(line)
|
||||
}
|
||||
writer.flush()
|
||||
}
|
||||
|
||||
} catch (e: Exception) {
|
||||
println("文件创建失败: ${e.javaClass.name} - ${e.message}")
|
||||
e.printStackTrace()
|
||||
}
|
||||
}
|
||||
}
|
||||
} catch (e: Exception) {
|
||||
println("文件创建失败: ${e.javaClass.name} - ${e.message}")
|
||||
e.printStackTrace()
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ArrayUtils.kt
|
||||
* LastUpdate 2026-02-06 14:01:56
|
||||
* LastUpdate 2026-03-12 10:08:42
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -25,7 +25,7 @@
|
||||
|
||||
package com.mingliqiye.utils.array
|
||||
|
||||
import com.mingliqiye.utils.base.BASE16
|
||||
import com.mingliqiye.utils.base.BaseType
|
||||
|
||||
|
||||
/**
|
||||
@@ -35,7 +35,7 @@ import com.mingliqiye.utils.base.BASE16
|
||||
* @since 4.6.0
|
||||
* @see toHexByteArray
|
||||
*/
|
||||
fun ByteArray.toHexString(): String = BASE16.encode(this).uppercase()
|
||||
fun ByteArray.toHexString(): String = BaseType.BASE16.encode(this).uppercase()
|
||||
|
||||
/**
|
||||
* 将十六进制字符串转换为字节数组
|
||||
@@ -45,9 +45,7 @@ fun ByteArray.toHexString(): String = BASE16.encode(this).uppercase()
|
||||
* @since 4.6.0
|
||||
* @see toHexString
|
||||
*/
|
||||
fun String.toHexByteArray(): ByteArray = BASE16.decode(this.lowercase())
|
||||
|
||||
/* ==================== 数组复制扩展函数 ==================== */
|
||||
fun String.toHexByteArray(): ByteArray = BaseType.BASE16.decode(this.lowercase())
|
||||
|
||||
/**
|
||||
* 将当前数组的指定范围复制到目标数组
|
||||
@@ -63,7 +61,7 @@ fun String.toHexByteArray(): ByteArray = BASE16.decode(this.lowercase())
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -78,12 +76,12 @@ fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Ar
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
|
||||
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
|
||||
System.arraycopy(this, srcPos, it, distPos, len)
|
||||
}.let {
|
||||
@Suppress("UNCHECKED_CAST")
|
||||
it as Array<T>
|
||||
}
|
||||
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
|
||||
System.arraycopy(this, srcPos, it, distPos, len)
|
||||
}.let {
|
||||
@Suppress("UNCHECKED_CAST")
|
||||
it as Array<T>
|
||||
}
|
||||
|
||||
/**
|
||||
* 将源数组的指定范围复制到当前数组
|
||||
@@ -98,7 +96,7 @@ fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -109,7 +107,7 @@ fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): A
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -118,9 +116,9 @@ fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int)
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
|
||||
BooleanArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
BooleanArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -128,7 +126,7 @@ fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -139,7 +137,7 @@ fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -148,9 +146,9 @@ fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): Byte
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
|
||||
ByteArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
ByteArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -158,7 +156,7 @@ fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -169,7 +167,7 @@ fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): Byt
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -178,9 +176,9 @@ fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): Char
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
|
||||
CharArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
CharArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -188,7 +186,7 @@ fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -199,7 +197,7 @@ fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): Cha
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -208,9 +206,9 @@ fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int):
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
|
||||
DoubleArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
DoubleArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -218,7 +216,7 @@ fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -229,7 +227,7 @@ fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int):
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -238,9 +236,9 @@ fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): Fl
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
|
||||
FloatArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
FloatArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -248,7 +246,7 @@ fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -259,7 +257,7 @@ fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): F
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -268,9 +266,9 @@ fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArr
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
|
||||
IntArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
IntArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -278,7 +276,7 @@ fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -289,7 +287,7 @@ fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntAr
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -298,9 +296,9 @@ fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): Long
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
|
||||
LongArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
LongArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -308,7 +306,7 @@ fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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 扩展 ==================== */
|
||||
@@ -319,7 +317,7 @@ fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): Lon
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -328,9 +326,9 @@ fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): Sh
|
||||
*/
|
||||
@JvmName("arrayCopy")
|
||||
fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
|
||||
ShortArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
ShortArray(len).also { newArray ->
|
||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||
}
|
||||
|
||||
/**
|
||||
* @see Array.copyFrom
|
||||
@@ -338,5 +336,5 @@ fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
|
||||
*/
|
||||
@JvmName("arrayCopyFrom")
|
||||
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)
|
||||
}
|
||||
|
||||
@@ -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 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
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,73 @@
|
||||
/*
|
||||
* 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
|
||||
|
||||
/**
|
||||
* Base10 编解码器实现类。
|
||||
*
|
||||
* 提供字节数组与十进制字符串之间的相互转换功能,基于 [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
|
||||
}
|
||||
}
|
||||
@@ -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 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()
|
||||
}
|
||||
|
||||
}
|
||||
@@ -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 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()
|
||||
}
|
||||
|
||||
}
|
||||
@@ -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 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
|
||||
}
|
||||
}
|
||||
@@ -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 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
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,329 @@
|
||||
/*
|
||||
* 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 {
|
||||
|
||||
/**
|
||||
* 伴生对象,持有 Base256 的编码字符集及其反向索引表。
|
||||
*/
|
||||
companion object {
|
||||
/**
|
||||
* Base256 编码字符集,共 256 个字符,数组索引即对应的字节值(0~255)。
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
* 将 Base256 字符串解码为字节数组。
|
||||
*
|
||||
* @param string 待解码的字符串,所有字符必须属于编码字符集
|
||||
* @return 解码后的字节数组
|
||||
* @throws NullPointerException 如果字符串中包含字符集之外的字符
|
||||
*/
|
||||
override fun decode(string: String): ByteArray {
|
||||
val result = ByteArray(string.length)
|
||||
for (i in string.indices) {
|
||||
result[i] = codeMap[string[i]]!!.toByte()
|
||||
}
|
||||
return result
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
/*
|
||||
* 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
|
||||
|
||||
/**
|
||||
* Base2 编解码器实现类。
|
||||
*
|
||||
* 提供字节数组与二进制字符串(每字节 8 位,高位在前)之间的相互转换功能。
|
||||
*/
|
||||
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()
|
||||
}
|
||||
|
||||
/**
|
||||
* 将二进制字符串解码为字节数组。
|
||||
*
|
||||
* @param string 待解码的二进制字符串,长度必须为 8 的倍数且仅包含字符 '0' 和 '1'
|
||||
* @return 解码后的字节数组
|
||||
* @throws IllegalArgumentException 如果字符串长度不是 8 的倍数或包含非法字符
|
||||
*/
|
||||
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
|
||||
}
|
||||
}
|
||||
@@ -1,62 +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 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)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,64 @@
|
||||
/*
|
||||
* 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)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,65 @@
|
||||
/*
|
||||
* 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 Base64NoPaddingCodec.kt
|
||||
* LastUpdate 2026-11-16 14:24:59
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.base
|
||||
|
||||
import java.util.*
|
||||
|
||||
/**
|
||||
* 无填充 Base64 URL 编解码器实现类。
|
||||
*
|
||||
* 使用 URL 安全的 Base64 字母表,编码结果不带末尾的 '=' 填充字符。
|
||||
*/
|
||||
internal class Base64NoPaddingCodec : BaseCodec {
|
||||
|
||||
/**
|
||||
* Base64编码器实例
|
||||
* 用于执行字节数组到Base64字符串的编码操作
|
||||
*/
|
||||
val encoder: Base64.Encoder = Base64.getUrlEncoder().withoutPadding()
|
||||
|
||||
/**
|
||||
* 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,65 @@
|
||||
/*
|
||||
* 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-11-16 14:24:59
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.base
|
||||
|
||||
import java.util.*
|
||||
|
||||
/**
|
||||
* URL 安全 Base64 编解码器实现类。
|
||||
*
|
||||
* 使用 '-' 和 '_' 替代标准 Base64 中的 '+' 和 '/',适用于 URL 与文件名场景。
|
||||
*/
|
||||
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)
|
||||
}
|
||||
}
|
||||
@@ -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 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)
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,407 @@
|
||||
/*
|
||||
* 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 {
|
||||
|
||||
/**
|
||||
* 伴生对象,持有 Base91 的编码表与解码表。
|
||||
*/
|
||||
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 2025 mingliqiye
|
||||
* 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.
|
||||
@@ -16,158 +16,163 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile BaseCodec.kt
|
||||
* LastUpdate 2025-09-18 14:07:35
|
||||
* LastUpdate 2026-10-11 16:52:16
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.base
|
||||
|
||||
import com.mingliqiye.utils.exception.CodecException
|
||||
import java.io.File
|
||||
import java.io.IOException
|
||||
import java.nio.file.Path
|
||||
|
||||
/**
|
||||
* BaseCodec 接口定义了一组用于编码和解码数据的基本方法。
|
||||
* 提供了对字节数组、字符串、文件和路径的编码与解码功能,
|
||||
* 并支持安全操作(在发生异常时返回默认值或布尔状态)。
|
||||
*/
|
||||
interface BaseCodec {
|
||||
/**
|
||||
* 将字节数组编码为Base64字符串
|
||||
*
|
||||
* @param bytes 需要编码的字节数组
|
||||
* @return 编码后的Base64字符串
|
||||
*/
|
||||
fun encode(bytes: ByteArray): String
|
||||
|
||||
/**
|
||||
* 将Base64字符串解码为字节数组
|
||||
*
|
||||
* @param string 需要解码的Base64字符串
|
||||
* @return 解码后的字节数组
|
||||
*/
|
||||
fun decode(string: String): ByteArray
|
||||
/**
|
||||
* 对字节数组进行编码,并捕获可能发生的异常。
|
||||
*
|
||||
* @param bytes 需要编码的字节数组
|
||||
* @return 编码后的字符串结果
|
||||
* @throws CodecException 如果编码过程中发生异常
|
||||
*/
|
||||
fun catchEncode(bytes: ByteArray) = try {
|
||||
encode(bytes)
|
||||
} catch (e: Exception) {
|
||||
throw CodecException(throwable = e)
|
||||
}
|
||||
|
||||
/**
|
||||
* 将文件内容编码为Base64字符串
|
||||
*
|
||||
* @param file 需要编码的文件
|
||||
* @return 文件内容的Base64编码字符串
|
||||
* @throws IOException 当文件读取失败时抛出
|
||||
*/
|
||||
@Throws(IOException::class)
|
||||
fun encode(file: File): String {
|
||||
return encode(file.readBytes())
|
||||
}
|
||||
/**
|
||||
* 对字符串进行解码,并捕获可能发生的异常。
|
||||
*
|
||||
* @param string 需要解码的字符串
|
||||
* @return 解码后的字节数组结果
|
||||
* @throws CodecException 如果解码过程中发生异常
|
||||
*/
|
||||
fun catchDecode(string: String) = try {
|
||||
decode(string)
|
||||
} catch (e: Exception) {
|
||||
throw CodecException(throwable = e)
|
||||
}
|
||||
|
||||
/**
|
||||
* 将Base64字符串解码并写入文件
|
||||
*
|
||||
* @param file 目标文件
|
||||
* @param string 需要解码的Base64字符串
|
||||
* @throws IOException 当文件写入失败时抛出
|
||||
*/
|
||||
@Throws(IOException::class)
|
||||
fun decode(file: File, string: String) {
|
||||
file.writeBytes(decode(string))
|
||||
}
|
||||
/**
|
||||
* 将字节数组编码为字符串。
|
||||
*
|
||||
* @param bytes 需要编码的字节数组
|
||||
* @return 编码后的字符串结果
|
||||
*/
|
||||
fun encode(bytes: ByteArray): String
|
||||
|
||||
/**
|
||||
* 安全地将文件内容编码为Base64字符串,出现异常时返回null
|
||||
*
|
||||
* @param file 需要编码的文件
|
||||
* @return 文件内容的Base64编码字符串,失败时返回null
|
||||
*/
|
||||
fun encodeSafe(file: File): String? {
|
||||
return try {
|
||||
encode(file)
|
||||
} catch (_: Exception) {
|
||||
null
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 将字符串解码为字节数组。
|
||||
*
|
||||
* @param string 需要解码的字符串
|
||||
* @return 解码后的字节数组结果
|
||||
*/
|
||||
fun decode(string: String): ByteArray
|
||||
|
||||
/**
|
||||
* 安全地将Base64字符串解码并写入文件,返回操作是否成功
|
||||
*
|
||||
* @param file 目标文件
|
||||
* @param string 需要解码的Base64字符串
|
||||
* @return 操作成功返回true,失败返回false
|
||||
*/
|
||||
fun decodeSafe(file: File, string: String): Boolean {
|
||||
return try {
|
||||
decode(file, string)
|
||||
true
|
||||
} catch (_: Exception) {
|
||||
false
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 对文件内容进行编码。
|
||||
*
|
||||
* @param file 需要编码的文件对象
|
||||
* @return 文件内容编码后的字符串结果
|
||||
*/
|
||||
fun encode(file: File) = catchEncode(file.readBytes())
|
||||
|
||||
/**
|
||||
* 将路径对应的文件内容编码为Base64字符串
|
||||
*
|
||||
* @param path 需要编码的文件路径
|
||||
* @return 文件内容的Base64编码字符串
|
||||
* @throws IOException 当文件读取失败时抛出
|
||||
*/
|
||||
@Throws(IOException::class)
|
||||
fun encode(path: Path): String {
|
||||
return encode(path.toFile().readBytes())
|
||||
}
|
||||
/**
|
||||
* 将字符串解码后写入指定文件。
|
||||
*
|
||||
* @param file 目标文件对象
|
||||
* @param string 需要解码的字符串
|
||||
*/
|
||||
fun decode(file: File, string: String) =
|
||||
file.writeBytes(catchDecode(string))
|
||||
|
||||
/**
|
||||
* 将Base64字符串解码并写入路径指定的文件
|
||||
*
|
||||
* @param path 目标文件路径
|
||||
* @param string 需要解码的Base64字符串
|
||||
* @throws IOException 当文件写入失败时抛出
|
||||
*/
|
||||
@Throws(IOException::class)
|
||||
fun decode(path: Path, string: String) {
|
||||
path.toFile().writeBytes(decode(string))
|
||||
}
|
||||
/**
|
||||
* 安全地对文件内容进行编码,如果发生异常则返回 null。
|
||||
*
|
||||
* @param file 需要编码的文件对象
|
||||
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
||||
*/
|
||||
fun encodeSafe(file: File) = try {
|
||||
encode(file)
|
||||
} catch (_: Exception) {
|
||||
null
|
||||
}
|
||||
|
||||
/**
|
||||
* 安全地将路径对应的文件内容编码为Base64字符串,出现异常时返回null
|
||||
*
|
||||
* @param path 需要编码的文件路径
|
||||
* @return 文件内容的Base64编码字符串,失败时返回null
|
||||
*/
|
||||
fun encodeSafe(path: Path): String? {
|
||||
return try {
|
||||
encode(path)
|
||||
} catch (_: Exception) {
|
||||
null
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。
|
||||
*
|
||||
* @param file 目标文件对象
|
||||
* @param string 需要解码的字符串
|
||||
* @return 操作是否成功的布尔值
|
||||
*/
|
||||
fun decodeSafe(file: File, string: String) = try {
|
||||
decode(file, string)
|
||||
true
|
||||
} catch (_: Exception) {
|
||||
false
|
||||
}
|
||||
|
||||
/**
|
||||
* 安全地将Base64字符串解码并写入路径指定的文件,返回操作是否成功
|
||||
*
|
||||
* @param path 目标文件路径
|
||||
* @param string 需要解码的Base64字符串
|
||||
* @return 操作成功返回true,失败返回false
|
||||
*/
|
||||
fun decodeSafe(path: Path, string: String): Boolean {
|
||||
return try {
|
||||
decode(path, string)
|
||||
true
|
||||
} catch (_: Exception) {
|
||||
false
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 对路径指向的文件内容进行编码。
|
||||
*
|
||||
* @param path 需要编码的文件路径
|
||||
* @return 文件内容编码后的字符串结果
|
||||
*/
|
||||
fun encode(path: Path) = catchEncode(path.toFile().readBytes())
|
||||
|
||||
/**
|
||||
* 将字符串编码为Base64字符串
|
||||
*
|
||||
* @param string 需要编码的字符串
|
||||
* @return 编码后的Base64字符串
|
||||
*/
|
||||
fun encode(string: String): String {
|
||||
return encode(string.toByteArray())
|
||||
}
|
||||
/**
|
||||
* 将字符串解码后写入指定路径的文件。
|
||||
*
|
||||
* @param path 目标文件路径
|
||||
* @param string 需要解码的字符串
|
||||
*/
|
||||
fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string))
|
||||
|
||||
/**
|
||||
* 将Base64字符串解码为字符串
|
||||
*
|
||||
* @param string 需要解码的Base64字符串
|
||||
* @return 解码后的字符串
|
||||
*/
|
||||
fun decodetoString(string: String): String {
|
||||
return decode(string).toString(Charsets.UTF_8)
|
||||
}
|
||||
/**
|
||||
* 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。
|
||||
*
|
||||
* @param path 需要编码的文件路径
|
||||
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
||||
*/
|
||||
fun encodeSafe(path: Path) = try {
|
||||
encode(path)
|
||||
} 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,15 +16,55 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile BaseType.kt
|
||||
* LastUpdate 2026-02-04 21:54:04
|
||||
* LastUpdate 2026-11-16 14:21:51
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.base
|
||||
|
||||
enum class BaseType(val baseCodec: BaseCodec) {
|
||||
BASE16(com.mingliqiye.utils.base.BASE16),
|
||||
BASE64(com.mingliqiye.utils.base.BASE64),
|
||||
BASE91(com.mingliqiye.utils.base.BASE91),
|
||||
BASE256(com.mingliqiye.utils.base.BASE256),
|
||||
import com.mingliqiye.utils.base.code.BASE10 as CODE_BASE10
|
||||
import com.mingliqiye.utils.base.code.BASE16 as CODE_BASE16
|
||||
import com.mingliqiye.utils.base.code.BASE2 as CODE_BASE2
|
||||
import com.mingliqiye.utils.base.code.BASE256 as CODE_BASE256
|
||||
import com.mingliqiye.utils.base.code.BASE64 as CODE_BASE64
|
||||
import com.mingliqiye.utils.base.code.BASE64_NO_PADDING as CODE_BASE64_NO_PADDING
|
||||
import com.mingliqiye.utils.base.code.BASE64_URL as CODE_BASE64_URL
|
||||
import com.mingliqiye.utils.base.code.BASE91 as CODE_BASE91
|
||||
|
||||
/**
|
||||
* Base 编码类型枚举。
|
||||
*
|
||||
* 每个枚举项持有一个编解码器的工厂函数,枚举本身实现了 [BaseCodec],
|
||||
* 可直接作为编解码器使用,编码与解码操作委托给对应的编解码器实例。
|
||||
*
|
||||
* @param baseCodec 编解码器的工厂函数,每次访问 [codec] 时调用以创建实例
|
||||
*/
|
||||
enum class BaseType(private val baseCodec: () -> BaseCodec) : BaseCodec {
|
||||
|
||||
/** 二进制(Base2)编解码。 */
|
||||
BASE2(::CODE_BASE2),
|
||||
/** 十进制(Base10)编解码。 */
|
||||
BASE10(::CODE_BASE10),
|
||||
/** 十六进制(Base16)编解码。 */
|
||||
BASE16(::CODE_BASE16),
|
||||
/** 标准 Base64 编解码。 */
|
||||
BASE64(::CODE_BASE64),
|
||||
/** URL 安全的 Base64 编解码。 */
|
||||
BASE64_URL(::CODE_BASE64_URL),
|
||||
/** 无填充(不带末尾 '=')的 URL 安全 Base64 编解码。 */
|
||||
BASE64_NO_PADDING(::CODE_BASE64_NO_PADDING),
|
||||
/** Base91 编解码。 */
|
||||
BASE91(::CODE_BASE91),
|
||||
/** Base256 编解码。 */
|
||||
BASE256(::CODE_BASE256);
|
||||
|
||||
/**
|
||||
* 获取当前类型对应的编解码器实例(每次访问都会通过工厂函数新建)。
|
||||
*/
|
||||
val codec
|
||||
get() = baseCodec()
|
||||
|
||||
override fun encode(bytes: ByteArray) = codec.encode(bytes)
|
||||
override fun decode(string: String) = codec.decode(string)
|
||||
|
||||
}
|
||||
|
||||
@@ -1,72 +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 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
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile BaseCodes.kt
|
||||
* LastUpdate 2026-02-08 03:10:03
|
||||
* LastUpdate 2026-11-16 14:10:57
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -30,52 +30,71 @@ import com.mingliqiye.utils.base.*
|
||||
* 提供Base2编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为二进制格式。
|
||||
*/
|
||||
@get:JvmName("Base2")
|
||||
val Base2: BaseCodec by lazy {
|
||||
Base2()
|
||||
@get:JvmName("base2")
|
||||
val BASE2: BaseCodec by lazy {
|
||||
Base2Codec()
|
||||
}
|
||||
|
||||
/**
|
||||
* 提供Base10编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为十进制格式。
|
||||
*/
|
||||
@get:JvmName("Base10")
|
||||
val Base10: BaseCodec by lazy {
|
||||
Base10()
|
||||
@get:JvmName("base10")
|
||||
val BASE10: BaseCodec by lazy {
|
||||
Base10Codec()
|
||||
}
|
||||
|
||||
/**
|
||||
* 提供Base16编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为十六进制格式。
|
||||
*/
|
||||
@get:JvmName("Base16")
|
||||
val Base16: BaseCodec by lazy {
|
||||
Base16()
|
||||
@get:JvmName("base16")
|
||||
val BASE16: BaseCodec by lazy {
|
||||
Base16Codec()
|
||||
}
|
||||
|
||||
/**
|
||||
* 提供Base64编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为Base64格式,常用于URL安全传输或存储。
|
||||
*/
|
||||
@get:JvmName("Base64")
|
||||
val Base64: BaseCodec by lazy {
|
||||
Base64()
|
||||
@get:JvmName("base64")
|
||||
val BASE64: BaseCodec by lazy {
|
||||
Base64Codec()
|
||||
}
|
||||
|
||||
/**
|
||||
* 提供Base64 URL编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为URL安全的Base64格式。
|
||||
*/
|
||||
@get:JvmName("base64Url")
|
||||
val BASE64_URL: BaseCodec by lazy {
|
||||
Base64UrlCodec()
|
||||
}
|
||||
|
||||
/**
|
||||
* 提供无填充Base64 URL编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为URL安全的Base64格式,且结果不带末尾的'='填充字符。
|
||||
*/
|
||||
@get:JvmName("base64NoPadding")
|
||||
val BASE64_NO_PADDING: BaseCodec by lazy {
|
||||
Base64NoPaddingCodec()
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 提供Base91编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为Base91格式,具有较高的压缩效率。
|
||||
*/
|
||||
@get:JvmName("Base91")
|
||||
val Base91: BaseCodec by lazy {
|
||||
Base91()
|
||||
@get:JvmName("base91")
|
||||
val BASE91: BaseCodec by lazy {
|
||||
Base91Codec()
|
||||
}
|
||||
|
||||
/**
|
||||
* 提供Base256编码器的懒加载实例。
|
||||
* 该编码器用于将数据编码为Base256格式,适用于字节级数据处理。
|
||||
*/
|
||||
@get:JvmName("Base256")
|
||||
val Base256: BaseCodec by lazy {
|
||||
Base256()
|
||||
@get:JvmName("base256")
|
||||
val BASE256: BaseCodec by lazy {
|
||||
Base256Codec()
|
||||
}
|
||||
|
||||
@@ -29,31 +29,69 @@ import java.security.SecureRandom
|
||||
import org.mindrot.jbcrypt.BCrypt as JBCrypt
|
||||
|
||||
|
||||
/**
|
||||
* 使用随机生成的盐对字符串进行 BCrypt 哈希。
|
||||
*
|
||||
* @param string 需要哈希的明文字符串
|
||||
* @return BCrypt 哈希字符串
|
||||
*/
|
||||
fun hashpw(string: String): String {
|
||||
return hashpw(string, gensalt())
|
||||
return hashpw(string, gensalt())
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 使用指定的盐对字符串进行 BCrypt 哈希。
|
||||
*
|
||||
* @param string 需要哈希的明文字符串
|
||||
* @param salt BCrypt 盐字符串,默认随机生成
|
||||
* @return BCrypt 哈希字符串
|
||||
*/
|
||||
fun hashpw(string: String, salt: String = gensalt()): String {
|
||||
return JBCrypt.hashpw(string, salt)
|
||||
return JBCrypt.hashpw(string, salt)
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 验证明文字符串与 BCrypt 哈希是否匹配。
|
||||
*
|
||||
* @param string 明文字符串
|
||||
* @param bcrypted 已生成的 BCrypt 哈希字符串
|
||||
* @return 匹配返回 true,否则返回 false
|
||||
*/
|
||||
fun checkpw(string: String, bcrypted: String): Boolean {
|
||||
return JBCrypt.checkpw(string, bcrypted)
|
||||
return JBCrypt.checkpw(string, bcrypted)
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 生成默认工作因子(10)的 BCrypt 盐。
|
||||
*
|
||||
* @return BCrypt 盐字符串
|
||||
*/
|
||||
fun gensalt(): String {
|
||||
return JBCrypt.gensalt()
|
||||
return JBCrypt.gensalt()
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 生成指定工作因子的 BCrypt 盐。
|
||||
*
|
||||
* @param long 工作因子(log2 迭代次数),值越大计算越慢
|
||||
* @return BCrypt 盐字符串
|
||||
*/
|
||||
fun gensalt(long: Int): String {
|
||||
return JBCrypt.gensalt(long)
|
||||
return JBCrypt.gensalt(long)
|
||||
}
|
||||
|
||||
|
||||
/**
|
||||
* 使用指定的安全随机数生成器生成 BCrypt 盐。
|
||||
*
|
||||
* @param long 工作因子(log2 迭代次数)
|
||||
* @param secureRandom 用于生成盐的安全随机数生成器
|
||||
* @return BCrypt 盐字符串
|
||||
*/
|
||||
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
@@ -0,0 +1,383 @@
|
||||
/*
|
||||
* 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
|
||||
|
||||
/**
|
||||
* ByteBufferWrapper 类型转换器接口。
|
||||
*
|
||||
* 定义某种类型与 [ByteBufferWrapper] 之间的读写规则。
|
||||
*
|
||||
* @param T 该转换器处理的数据类型
|
||||
*/
|
||||
interface ByteBufferWrapperConvertorInterface<T : Any> {
|
||||
/**
|
||||
* 将对象写入缓冲区。
|
||||
*
|
||||
* @param obj 要写入的对象
|
||||
* @param byteBufferWrapper 目标缓冲区包装器
|
||||
*/
|
||||
fun write(obj: T, byteBufferWrapper: ByteBufferWrapper)
|
||||
|
||||
/**
|
||||
* 从缓冲区中读取对象。
|
||||
*
|
||||
* @param byteBufferWrapper 源缓冲区包装器
|
||||
* @param parameters 读取时需要的额外参数(如数组长度)
|
||||
* @return 读取并转换后的对象
|
||||
*/
|
||||
fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T
|
||||
|
||||
/**
|
||||
* 获取该转换器处理的数据类型。
|
||||
*
|
||||
* @return 类型对应的 Class 对象
|
||||
*/
|
||||
fun getType(): Class<T>
|
||||
}
|
||||
|
||||
/**
|
||||
* ByteBufferWrapper 类型转换器抽象基类。
|
||||
*
|
||||
* 提供转换器实例的缓存创建以及默认转换器的注册功能。
|
||||
*
|
||||
* @param 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<*>>()
|
||||
|
||||
/**
|
||||
* 获取指定转换器类的实例,不存在时通过无参构造函数创建并缓存。
|
||||
*
|
||||
* @param clazz 转换器类对应的 Class 对象
|
||||
* @return 缓存的或新创建的转换器实例
|
||||
*/
|
||||
@JvmStatic
|
||||
fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> {
|
||||
return _instantiations.getOrPut(clazz) {
|
||||
clazz.getConstructor().newInstance()
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取具体化类型 T 对应的转换器实例,不存在时创建并缓存。
|
||||
*
|
||||
* @param T 转换器类型,必须提供无参构造函数
|
||||
* @return 缓存的或新创建的转换器实例
|
||||
*/
|
||||
@JvmStatic
|
||||
@Suppress("UNCHECKED_CAST")
|
||||
inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> {
|
||||
return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>)
|
||||
}
|
||||
|
||||
/**
|
||||
* 安装所有默认转换器。
|
||||
*
|
||||
* 将基础类型、大数、字符串、时间、UUID 及各类数组的转换器注册到 [ByteBufferWrapper]。
|
||||
*/
|
||||
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>()
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 基于读写函数构造的通用对象转换器。
|
||||
*
|
||||
* 通过传入的写入函数、读取函数和类型信息实现转换逻辑,读取时忽略额外参数。
|
||||
*
|
||||
* @param T 该转换器处理的数据类型
|
||||
* @param write 写入函数,将对象写入缓冲区
|
||||
* @param read 读取函数,从缓冲区读取对象
|
||||
* @param typer 该转换器处理的数据类型对应的 Class 对象
|
||||
*/
|
||||
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
|
||||
}
|
||||
|
||||
|
||||
/** [Byte] 类型转换器,使用 putByte/getByte 读写。 */
|
||||
class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>(
|
||||
ByteBufferWrapper::putByte,
|
||||
ByteBufferWrapper::getByte,
|
||||
Byte::class.java,
|
||||
)
|
||||
|
||||
/** [Char] 类型转换器,使用 putChar/getChar 读写。 */
|
||||
class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>(
|
||||
ByteBufferWrapper::putChar,
|
||||
ByteBufferWrapper::getChar,
|
||||
Char::class.java,
|
||||
)
|
||||
|
||||
/** [Short] 类型转换器,使用 putShort/getShort 读写。 */
|
||||
class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>(
|
||||
ByteBufferWrapper::putShort,
|
||||
ByteBufferWrapper::getShort,
|
||||
Short::class.java,
|
||||
)
|
||||
|
||||
/** [Int] 类型转换器,使用 putInt/getInt 读写。 */
|
||||
class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>(
|
||||
ByteBufferWrapper::putInt,
|
||||
ByteBufferWrapper::getInt,
|
||||
Int::class.java,
|
||||
)
|
||||
|
||||
/** [Long] 类型转换器,使用 putLong/getLong 读写。 */
|
||||
class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>(
|
||||
ByteBufferWrapper::putLong,
|
||||
ByteBufferWrapper::getLong,
|
||||
Long::class.java,
|
||||
)
|
||||
|
||||
/** [Double] 类型转换器,使用 putDouble/getDouble 读写。 */
|
||||
class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>(
|
||||
ByteBufferWrapper::putDouble,
|
||||
ByteBufferWrapper::getDouble,
|
||||
Double::class.java,
|
||||
)
|
||||
|
||||
/** [Float] 类型转换器,使用 putFloat/getFloat 读写。 */
|
||||
class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>(
|
||||
ByteBufferWrapper::putFloat,
|
||||
ByteBufferWrapper::getFloat,
|
||||
Float::class.java,
|
||||
)
|
||||
|
||||
/** [BigInteger] 类型转换器,使用 putBigInteger/getBigInteger 读写。 */
|
||||
class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>(
|
||||
ByteBufferWrapper::putBigInteger,
|
||||
ByteBufferWrapper::getBigInteger,
|
||||
BigInteger::class.java,
|
||||
)
|
||||
|
||||
/** [BigDecimal] 类型转换器,使用 putBigDecimal/getBigDecimal 读写。 */
|
||||
class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>(
|
||||
ByteBufferWrapper::putBigDecimal,
|
||||
ByteBufferWrapper::getBigDecimal,
|
||||
BigDecimal::class.java,
|
||||
)
|
||||
|
||||
/** [Boolean] 类型转换器,使用 putBoolean/getBoolean 读写。 */
|
||||
class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>(
|
||||
ByteBufferWrapper::putBoolean,
|
||||
ByteBufferWrapper::getBoolean,
|
||||
Boolean::class.java,
|
||||
)
|
||||
|
||||
/** [String] 类型转换器,使用 putString/getString 读写。 */
|
||||
class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>(
|
||||
ByteBufferWrapper::putString,
|
||||
ByteBufferWrapper::getString,
|
||||
String::class.java,
|
||||
)
|
||||
|
||||
/** [ByteFlags] 类型转换器,使用 putFlag/getFlag 读写。 */
|
||||
class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>(
|
||||
ByteBufferWrapper::putFlag,
|
||||
ByteBufferWrapper::getFlag,
|
||||
ByteFlags::class.java,
|
||||
)
|
||||
|
||||
|
||||
/** Java [JUUID] 类型转换器,使用 putUUID/getJUUID 读写。 */
|
||||
class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>(
|
||||
ByteBufferWrapper::putUUID,
|
||||
ByteBufferWrapper::getJUUID,
|
||||
JUUID::class.java,
|
||||
)
|
||||
|
||||
/** 自定义 [UUID] 类型转换器,使用 putUUID/getUUID 读写。 */
|
||||
class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>(
|
||||
ByteBufferWrapper::putUUID,
|
||||
ByteBufferWrapper::getUUID,
|
||||
UUID::class.java,
|
||||
)
|
||||
|
||||
/** [DateTime] 类型转换器,使用 putDateTime/getDateTime 读写。 */
|
||||
class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>(
|
||||
ByteBufferWrapper::putDateTime,
|
||||
ByteBufferWrapper::getDateTime,
|
||||
DateTime::class.java,
|
||||
)
|
||||
|
||||
/** [LocalDateTime] 类型转换器,使用 putLocalDateTime/getLocalDateTime 读写。 */
|
||||
class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>(
|
||||
ByteBufferWrapper::putLocalDateTime,
|
||||
ByteBufferWrapper::getLocalDateTime,
|
||||
LocalDateTime::class.java,
|
||||
)
|
||||
|
||||
/** [Date] 类型转换器,使用 putDate/getDate 读写。 */
|
||||
class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>(
|
||||
ByteBufferWrapper::putDate,
|
||||
ByteBufferWrapper::getDate,
|
||||
Date::class.java,
|
||||
)
|
||||
|
||||
/**
|
||||
* 基于读写函数构造的通用数组转换器。
|
||||
*
|
||||
* 读取时要求额外参数的第一个元素为 Int 类型的数组长度。
|
||||
*
|
||||
* @param T 该转换器处理的数组类型
|
||||
* @param write 写入函数,将数组写入缓冲区
|
||||
* @param read 读取函数,按指定长度从缓冲区读取数组
|
||||
* @param typer 该转换器处理的数组类型对应的 Class 对象
|
||||
*/
|
||||
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)
|
||||
/**
|
||||
* 从缓冲区读取数组,要求 parameters[0] 为 Int 类型的长度。
|
||||
*
|
||||
* @throws IllegalArgumentException 如果参数为空或第一个参数不是 Int
|
||||
*/
|
||||
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
|
||||
}
|
||||
|
||||
/** [ByteArray] 类型转换器,使用 putByteArray/getByteArray 读写。 */
|
||||
class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>(
|
||||
ByteBufferWrapper::putByteArray,
|
||||
ByteBufferWrapper::getByteArray,
|
||||
ByteArray::class.java,
|
||||
)
|
||||
|
||||
/** [CharArray] 类型转换器,使用 putCharArray/getCharArray 读写。 */
|
||||
class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>(
|
||||
ByteBufferWrapper::putCharArray,
|
||||
ByteBufferWrapper::getCharArray,
|
||||
CharArray::class.java,
|
||||
)
|
||||
|
||||
/** [ShortArray] 类型转换器,使用 putShortArray/getShortArray 读写。 */
|
||||
class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>(
|
||||
ByteBufferWrapper::putShortArray,
|
||||
ByteBufferWrapper::getShortArray,
|
||||
ShortArray::class.java,
|
||||
)
|
||||
|
||||
/** [IntArray] 类型转换器,使用 putIntArray/getIntArray 读写。 */
|
||||
class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>(
|
||||
ByteBufferWrapper::putIntArray,
|
||||
ByteBufferWrapper::getIntArray,
|
||||
IntArray::class.java,
|
||||
)
|
||||
|
||||
/** [LongArray] 类型转换器,使用 putLongArray/getLongArray 读写。 */
|
||||
class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>(
|
||||
ByteBufferWrapper::putLongArray,
|
||||
ByteBufferWrapper::getLongArray,
|
||||
LongArray::class.java,
|
||||
)
|
||||
|
||||
/** [FloatArray] 类型转换器,使用 putFloatArray/getFloatArray 读写。 */
|
||||
class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>(
|
||||
ByteBufferWrapper::putFloatArray,
|
||||
ByteBufferWrapper::getFloatArray,
|
||||
FloatArray::class.java,
|
||||
)
|
||||
|
||||
/** [DoubleArray] 类型转换器,使用 putDoubleArray/getDoubleArray 读写。 */
|
||||
class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>(
|
||||
ByteBufferWrapper::putDoubleArray,
|
||||
ByteBufferWrapper::getDoubleArray,
|
||||
DoubleArray::class.java,
|
||||
)
|
||||
|
||||
|
||||
/** [BooleanArray] 类型转换器,使用 putBooleanArray/getBooleanArray 读写。 */
|
||||
class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>(
|
||||
ByteBufferWrapper::putBooleanArray,
|
||||
ByteBufferWrapper::getBooleanArray,
|
||||
BooleanArray::class.java,
|
||||
)
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ByteBufferUtils.kt
|
||||
* LastUpdate 2026-01-11 09:44:19
|
||||
* LastUpdate 2026-07-02 09:31:01
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -26,6 +26,7 @@ package com.mingliqiye.utils.bytes
|
||||
|
||||
import java.io.IOException
|
||||
import java.io.OutputStream
|
||||
import java.nio.BufferUnderflowException
|
||||
import java.nio.ByteBuffer
|
||||
import java.nio.charset.Charset
|
||||
|
||||
@@ -39,7 +40,7 @@ import java.nio.charset.Charset
|
||||
* @return 当前 [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`)结尾的字符串。
|
||||
@@ -52,15 +53,15 @@ fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): Byt
|
||||
* @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符)
|
||||
*/
|
||||
fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
|
||||
val data = ArrayList<Byte>()
|
||||
while (true) {
|
||||
val byte = this.get()
|
||||
if (byte == 0x00.toByte()) {
|
||||
break
|
||||
}
|
||||
data.add(byte)
|
||||
}
|
||||
return String(data.toByteArray(), charset)
|
||||
val data = ArrayList<Byte>()
|
||||
while (true) {
|
||||
val byte = this.get()
|
||||
if (byte == 0x00.toByte()) {
|
||||
break
|
||||
}
|
||||
data.add(byte)
|
||||
}
|
||||
return String(data.toByteArray(), charset)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -71,9 +72,9 @@ fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
|
||||
* @return 包含剩余字节的新字节数组
|
||||
*/
|
||||
fun ByteBuffer.toByteArray(): ByteArray {
|
||||
val ba = ByteArray(this.remaining())
|
||||
this.get(ba)
|
||||
return ba
|
||||
val ba = ByteArray(this.remaining())
|
||||
this.get(ba)
|
||||
return ba
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -86,18 +87,18 @@ fun ByteBuffer.toByteArray(): ByteArray {
|
||||
* @throws IndexOutOfBoundsException 如果列表长度不足 8
|
||||
*/
|
||||
fun ByteBuffer.putByteFlags(
|
||||
bit: List<Boolean> = List(8) { false },
|
||||
bit: List<Boolean> = List(8) { false },
|
||||
): ByteBuffer = this.putByteFlags(
|
||||
ByteFlags(
|
||||
bit[0],
|
||||
bit[1],
|
||||
bit[2],
|
||||
bit[3],
|
||||
bit[4],
|
||||
bit[5],
|
||||
bit[6],
|
||||
bit[7],
|
||||
)
|
||||
ByteFlags(
|
||||
bit[0],
|
||||
bit[1],
|
||||
bit[2],
|
||||
bit[3],
|
||||
bit[4],
|
||||
bit[5],
|
||||
bit[6],
|
||||
bit[7],
|
||||
)
|
||||
)
|
||||
|
||||
/**
|
||||
@@ -110,18 +111,18 @@ fun ByteBuffer.putByteFlags(
|
||||
* @throws IndexOutOfBoundsException 如果数组长度不足 8
|
||||
*/
|
||||
fun ByteBuffer.putByteFlags(
|
||||
bit: BooleanArray = BooleanArray(8),
|
||||
bit: BooleanArray = BooleanArray(8),
|
||||
): ByteBuffer = this.putByteFlags(
|
||||
ByteFlags(
|
||||
bit[0],
|
||||
bit[1],
|
||||
bit[2],
|
||||
bit[3],
|
||||
bit[4],
|
||||
bit[5],
|
||||
bit[6],
|
||||
bit[7],
|
||||
)
|
||||
ByteFlags(
|
||||
bit[0],
|
||||
bit[1],
|
||||
bit[2],
|
||||
bit[3],
|
||||
bit[4],
|
||||
bit[5],
|
||||
bit[6],
|
||||
bit[7],
|
||||
)
|
||||
)
|
||||
|
||||
/**
|
||||
@@ -148,25 +149,25 @@ fun ByteBuffer.putByteFlags(byteFlags: ByteFlags): ByteBuffer = this.put(byteFla
|
||||
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||
*/
|
||||
fun ByteBuffer.putByteFlags(
|
||||
bit0: Boolean = false,
|
||||
bit1: Boolean = false,
|
||||
bit2: Boolean = false,
|
||||
bit3: Boolean = false,
|
||||
bit4: Boolean = false,
|
||||
bit5: Boolean = false,
|
||||
bit6: Boolean = false,
|
||||
bit7: Boolean = false,
|
||||
bit0: Boolean = false,
|
||||
bit1: Boolean = false,
|
||||
bit2: Boolean = false,
|
||||
bit3: Boolean = false,
|
||||
bit4: Boolean = false,
|
||||
bit5: Boolean = false,
|
||||
bit6: Boolean = false,
|
||||
bit7: Boolean = false,
|
||||
): ByteBuffer = this.putByteFlags(
|
||||
ByteFlags(
|
||||
bit0,
|
||||
bit1,
|
||||
bit2,
|
||||
bit3,
|
||||
bit4,
|
||||
bit5,
|
||||
bit6,
|
||||
bit7,
|
||||
)
|
||||
ByteFlags(
|
||||
bit0,
|
||||
bit1,
|
||||
bit2,
|
||||
bit3,
|
||||
bit4,
|
||||
bit5,
|
||||
bit6,
|
||||
bit7,
|
||||
)
|
||||
)
|
||||
|
||||
/**
|
||||
@@ -203,7 +204,7 @@ fun ByteBuffer.putBoolean(boolean: Boolean): ByteBuffer = this.put(if (boolean)
|
||||
* @return 包装后的 [ByteBuffer] 实例
|
||||
*/
|
||||
fun ByteArray.toByteBuffer(): ByteBuffer {
|
||||
return ByteBuffer.wrap(this)
|
||||
return ByteBuffer.wrap(this)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -218,19 +219,19 @@ fun ByteArray.toByteBuffer(): ByteBuffer {
|
||||
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||
*/
|
||||
fun ByteBuffer.getVarLong(size: Int = 8): Long {
|
||||
var numRead = 0
|
||||
var result: Long = 0
|
||||
var read: Byte
|
||||
do {
|
||||
read = this.get()
|
||||
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
|
||||
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||
numRead++
|
||||
if (numRead > size) {
|
||||
throw IOException("VarNumber is too big")
|
||||
}
|
||||
} while ((read.toLong() and 128) != 0L)
|
||||
return result
|
||||
var numRead = 0
|
||||
var result: Long = 0
|
||||
var read: Byte
|
||||
do {
|
||||
read = this.get()
|
||||
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
|
||||
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||
numRead++
|
||||
if (numRead > size) {
|
||||
throw IOException("VarNumber is too big")
|
||||
}
|
||||
} while ((read.toLong() and 128) != 0L)
|
||||
return result
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -268,13 +269,13 @@ fun ByteBuffer.getVarLong(): Long = this.getVarLong(8)
|
||||
* @return 当前ByteBuffer实例(支持链式调用)
|
||||
*/
|
||||
fun ByteBuffer.putVarLong(value: Long): ByteBuffer {
|
||||
var v = value
|
||||
while (v >= 0x80) {
|
||||
this.put((v and 0x7F or 0x80).toByte())
|
||||
v = v shr 7
|
||||
}
|
||||
this.put(v.toByte())
|
||||
return this
|
||||
var v = value
|
||||
while (v >= 0x80) {
|
||||
this.put((v and 0x7F or 0x80).toByte())
|
||||
v = v shr 7
|
||||
}
|
||||
this.put(v.toByte())
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -294,4 +295,12 @@ fun ByteBuffer.putVarInt(value: Int): ByteBuffer = this.putVarLong(value.toLong(
|
||||
fun ByteBuffer.putVarShort(value: Short): ByteBuffer = this.putVarLong(value.toLong())
|
||||
|
||||
|
||||
/**
|
||||
* 将 [ByteBuffer] 中剩余的全部字节写入指定的输出流。
|
||||
*
|
||||
* 此操作会读取从当前位置到 limit 之间的所有字节,并推进 position。
|
||||
*
|
||||
* @param outputStream 目标输出流
|
||||
* @throws IOException 如果写入过程中发生 I/O 错误
|
||||
*/
|
||||
fun ByteBuffer.writeStream(outputStream: OutputStream) = outputStream.write(this.toByteArray())
|
||||
|
||||
@@ -0,0 +1,83 @@
|
||||
/*
|
||||
* 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
|
||||
|
||||
/**
|
||||
* 可转换为字节数组的对象接口。
|
||||
*
|
||||
* 实现该接口的对象可以将自身序列化为字节数组,并支持写入输出流或 [ByteBuffer]。
|
||||
*/
|
||||
interface ByteConvertible : Serializable {
|
||||
|
||||
/**
|
||||
* 将当前对象转换为字节数组。
|
||||
*
|
||||
* @return 表示当前对象的字节数组
|
||||
*/
|
||||
fun toBytes(): ByteArray
|
||||
|
||||
/**
|
||||
* 将当前对象转换后的字节数组写入指定的输出流。
|
||||
*
|
||||
* @param outputStream 目标输出流
|
||||
*/
|
||||
fun writeToStream(outputStream: OutputStream) {
|
||||
outputStream.write(toBytes())
|
||||
}
|
||||
|
||||
/**
|
||||
* 将当前对象转换后的字节数组写入指定的 [ByteBuffer]。
|
||||
*
|
||||
* @param byteBuffer 目标缓冲区
|
||||
*/
|
||||
fun putToByteBuffer(byteBuffer: ByteBuffer) {
|
||||
byteBuffer.put(toBytes())
|
||||
}
|
||||
|
||||
/**
|
||||
* 伴生对象,提供面向输出流和缓冲区的便捷扩展函数。
|
||||
*/
|
||||
companion object {
|
||||
/**
|
||||
* 将 [ByteConvertible] 对象写入当前输出流。
|
||||
*
|
||||
* @param byteConvertible 要写入的可转换对象
|
||||
*/
|
||||
fun OutputStream.write(byteConvertible: ByteConvertible) {
|
||||
byteConvertible.writeToStream(this)
|
||||
}
|
||||
|
||||
/**
|
||||
* 将 [ByteConvertible] 对象写入当前 [ByteBuffer]。
|
||||
*
|
||||
* @param byteConvertible 要写入的可转换对象
|
||||
*/
|
||||
fun ByteBuffer.put(byteConvertible: ByteConvertible) {
|
||||
byteConvertible.putToByteBuffer(this)
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ByteFlags.kt
|
||||
* LastUpdate 2026-01-07 09:37:09
|
||||
* LastUpdate 2026-11-16 21:35:04
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -32,429 +32,454 @@ package com.mingliqiye.utils.bytes
|
||||
* 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。
|
||||
*/
|
||||
data class ByteFlags(
|
||||
/** 第 0 位(最低位,0x01) */
|
||||
var b0: Boolean = false,
|
||||
/** 第 1 位(0x02) */
|
||||
var b1: Boolean = false,
|
||||
/** 第 2 位(0x04) */
|
||||
var b2: Boolean = false,
|
||||
/** 第 3 位(0x08) */
|
||||
var b3: Boolean = false,
|
||||
/** 第 4 位(0x10) */
|
||||
var b4: Boolean = false,
|
||||
/** 第 5 位(0x20) */
|
||||
var b5: Boolean = false,
|
||||
/** 第 6 位(0x40) */
|
||||
var b6: Boolean = false,
|
||||
/** 第 7 位(最高位,0x80) */
|
||||
var b7: Boolean = false
|
||||
/** 第 0 位(最低位,0x01) */
|
||||
var b0: Boolean = false,
|
||||
/** 第 1 位(0x02) */
|
||||
var b1: Boolean = false,
|
||||
/** 第 2 位(0x04) */
|
||||
var b2: Boolean = false,
|
||||
/** 第 3 位(0x08) */
|
||||
var b3: Boolean = false,
|
||||
/** 第 4 位(0x10) */
|
||||
var b4: Boolean = false,
|
||||
/** 第 5 位(0x20) */
|
||||
var b5: Boolean = false,
|
||||
/** 第 6 位(0x40) */
|
||||
var b6: Boolean = false,
|
||||
/** 第 7 位(最高位,0x80) */
|
||||
var b7: Boolean = false,
|
||||
) {
|
||||
|
||||
/**
|
||||
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。
|
||||
*
|
||||
* @param byte 用于初始化的字节值(仅使用低 8 位)
|
||||
*/
|
||||
constructor(byte: Byte) : this() {
|
||||
fromByte(byte)
|
||||
}
|
||||
/**
|
||||
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。
|
||||
*
|
||||
* @param byte 用于初始化的字节值(仅使用低 8 位)
|
||||
*/
|
||||
constructor(byte: Byte) : this() {
|
||||
fromByte(byte)
|
||||
}
|
||||
|
||||
/**
|
||||
* 从给定的 [Byte] 值解析并设置各个位标志。
|
||||
*
|
||||
* @param byte 要解析的字节
|
||||
*/
|
||||
fun fromByte(byte: Byte) {
|
||||
val value = byte.toInt() and 0xFF
|
||||
b0 = (value and 0x01) != 0
|
||||
b1 = (value and 0x02) != 0
|
||||
b2 = (value and 0x04) != 0
|
||||
b3 = (value and 0x08) != 0
|
||||
b4 = (value and 0x10) != 0
|
||||
b5 = (value and 0x20) != 0
|
||||
b6 = (value and 0x40) != 0
|
||||
b7 = (value and 0x80) != 0
|
||||
}
|
||||
/**
|
||||
* 从给定的 [Byte] 值解析并设置各个位标志。
|
||||
*
|
||||
* @param byte 要解析的字节
|
||||
*/
|
||||
fun fromByte(byte: Byte): ByteFlags {
|
||||
val value = byte.toInt() and 0xFF
|
||||
b0 = (value and 0x01) != 0
|
||||
b1 = (value and 0x02) != 0
|
||||
b2 = (value and 0x04) != 0
|
||||
b3 = (value and 0x08) != 0
|
||||
b4 = (value and 0x10) != 0
|
||||
b5 = (value and 0x20) != 0
|
||||
b6 = (value and 0x40) != 0
|
||||
b7 = (value and 0x80) != 0
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 将当前标志状态转换为一个 [Byte] 值。
|
||||
*
|
||||
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
|
||||
*/
|
||||
fun toByte(): Byte {
|
||||
var result = 0
|
||||
if (b0) result = result or 0x01
|
||||
if (b1) result = result or 0x02
|
||||
if (b2) result = result or 0x04
|
||||
if (b3) result = result or 0x08
|
||||
if (b4) result = result or 0x10
|
||||
if (b5) result = result or 0x20
|
||||
if (b6) result = result or 0x40
|
||||
if (b7) result = result or 0x80
|
||||
return result.toByte()
|
||||
}
|
||||
/**
|
||||
* 将当前标志状态转换为一个 [Byte] 值。
|
||||
*
|
||||
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
|
||||
*/
|
||||
fun toByte(): Byte {
|
||||
var result = 0
|
||||
if (b0) result = result or 0x01
|
||||
if (b1) result = result or 0x02
|
||||
if (b2) result = result or 0x04
|
||||
if (b3) result = result or 0x08
|
||||
if (b4) result = result or 0x10
|
||||
if (b5) result = result or 0x20
|
||||
if (b6) result = result or 0x40
|
||||
if (b7) result = result or 0x80
|
||||
return result.toByte()
|
||||
}
|
||||
|
||||
/**
|
||||
* 通过索引(0~7)获取对应位的布尔值。
|
||||
*
|
||||
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||
* @return 该位是否为 true
|
||||
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||
*/
|
||||
operator fun get(index: Int): Boolean {
|
||||
return when (index) {
|
||||
0 -> b0
|
||||
1 -> b1
|
||||
2 -> b2
|
||||
3 -> b3
|
||||
4 -> b4
|
||||
5 -> b5
|
||||
6 -> b6
|
||||
7 -> b7
|
||||
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 通过索引(0~7)获取对应位的布尔值。
|
||||
*
|
||||
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||
* @return 该位是否为 true
|
||||
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||
*/
|
||||
operator fun get(index: Int): Boolean {
|
||||
return when (index) {
|
||||
0 -> b0
|
||||
1 -> b1
|
||||
2 -> b2
|
||||
3 -> b3
|
||||
4 -> b4
|
||||
5 -> b5
|
||||
6 -> b6
|
||||
7 -> b7
|
||||
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 通过索引(0~7)设置对应位的布尔值。
|
||||
*
|
||||
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||
* @param value 要设置的布尔值
|
||||
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||
*/
|
||||
operator fun set(index: Int, value: Boolean) {
|
||||
when (index) {
|
||||
0 -> b0 = value
|
||||
1 -> b1 = value
|
||||
2 -> b2 = value
|
||||
3 -> b3 = value
|
||||
4 -> b4 = value
|
||||
5 -> b5 = value
|
||||
6 -> b6 = value
|
||||
7 -> b7 = value
|
||||
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 通过索引(0~7)设置对应位的布尔值。
|
||||
*
|
||||
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||
* @param value 要设置的布尔值
|
||||
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||
*/
|
||||
operator fun set(index: Int, value: Boolean): ByteFlags {
|
||||
when (index) {
|
||||
0 -> b0 = value
|
||||
1 -> b1 = value
|
||||
2 -> b2 = value
|
||||
3 -> b3 = value
|
||||
4 -> b4 = value
|
||||
5 -> b5 = value
|
||||
6 -> b6 = value
|
||||
7 -> b7 = value
|
||||
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||
}
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 将所有 8 个位设置为 `true`。
|
||||
*/
|
||||
fun setAll() {
|
||||
b0 = true
|
||||
b1 = true
|
||||
b2 = true
|
||||
b3 = true
|
||||
b4 = true
|
||||
b5 = true
|
||||
b6 = true
|
||||
b7 = true
|
||||
}
|
||||
/**
|
||||
* 将所有 8 个位设置为 `true`。
|
||||
*/
|
||||
fun setAll(): ByteFlags {
|
||||
b0 = true
|
||||
b1 = true
|
||||
b2 = true
|
||||
b3 = true
|
||||
b4 = true
|
||||
b5 = true
|
||||
b6 = true
|
||||
b7 = true
|
||||
|
||||
/**
|
||||
* 将所有 8 个位设置为 `false`。
|
||||
*/
|
||||
fun clearAll() {
|
||||
b0 = false
|
||||
b1 = false
|
||||
b2 = false
|
||||
b3 = false
|
||||
b4 = false
|
||||
b5 = false
|
||||
b6 = false
|
||||
b7 = false
|
||||
}
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 对所有位执行逻辑取反(true ↔ false)。
|
||||
*/
|
||||
fun toggleAll() {
|
||||
b0 = !b0
|
||||
b1 = !b1
|
||||
b2 = !b2
|
||||
b3 = !b3
|
||||
b4 = !b4
|
||||
b5 = !b5
|
||||
b6 = !b6
|
||||
b7 = !b7
|
||||
}
|
||||
/**
|
||||
* 将所有 8 个位设置为 `false`。
|
||||
*/
|
||||
fun clearAll(): ByteFlags {
|
||||
b0 = false
|
||||
b1 = false
|
||||
b2 = false
|
||||
b3 = false
|
||||
b4 = false
|
||||
b5 = false
|
||||
b6 = false
|
||||
b7 = false
|
||||
|
||||
/**
|
||||
* 切换指定索引位的状态(true 变 false,反之亦然)。
|
||||
*
|
||||
* @param index 要切换的位索引(0~7)
|
||||
* @throws IndexOutOfBoundsException 如果索引无效
|
||||
*/
|
||||
fun toggle(index: Int) {
|
||||
this[index] = !this[index]
|
||||
}
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查是否所有位都为 `true`。
|
||||
*
|
||||
* @return 若全部为 true 则返回 true,否则 false
|
||||
*/
|
||||
fun allTrue(): Boolean {
|
||||
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
|
||||
}
|
||||
/**
|
||||
* 对所有位执行逻辑取反(true ↔ false)。
|
||||
*/
|
||||
fun toggleAll(): ByteFlags {
|
||||
b0 = !b0
|
||||
b1 = !b1
|
||||
b2 = !b2
|
||||
b3 = !b3
|
||||
b4 = !b4
|
||||
b5 = !b5
|
||||
b6 = !b6
|
||||
b7 = !b7
|
||||
|
||||
/**
|
||||
* 检查是否所有位都为 `false`。
|
||||
*
|
||||
* @return 若全部为 false 则返回 true,否则 false
|
||||
*/
|
||||
fun allFalse(): Boolean {
|
||||
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
|
||||
}
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 统计值为 `true` 的位数量。
|
||||
*
|
||||
* @return true 位的个数(0~8)
|
||||
*/
|
||||
fun countTrue(): Int {
|
||||
var count = 0
|
||||
if (b0) count++
|
||||
if (b1) count++
|
||||
if (b2) count++
|
||||
if (b3) count++
|
||||
if (b4) count++
|
||||
if (b5) count++
|
||||
if (b6) count++
|
||||
if (b7) count++
|
||||
return count
|
||||
}
|
||||
/**
|
||||
* 切换指定索引位的状态(true 变 false,反之亦然)。
|
||||
*
|
||||
* @param index 要切换的位索引(0~7)
|
||||
* @throws IndexOutOfBoundsException 如果索引无效
|
||||
*/
|
||||
fun toggle(index: Int): ByteFlags {
|
||||
this[index] = !this[index]
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 统计值为 `false` 的位数量。
|
||||
*
|
||||
* @return false 位的个数(0~8)
|
||||
*/
|
||||
fun countFalse(): Int = 8 - countTrue()
|
||||
/**
|
||||
* 检查是否所有位都为 `true`。
|
||||
*
|
||||
* @return 若全部为 true 则返回 true,否则 false
|
||||
*/
|
||||
fun allTrue(): Boolean {
|
||||
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
|
||||
}
|
||||
|
||||
/**
|
||||
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
|
||||
*
|
||||
* 支持别名:`bN` 或 `bitN`(不区分大小写)。
|
||||
*
|
||||
* @param name 位的名称(例如 "b0", "BIT5")
|
||||
* @return 对应位的布尔值
|
||||
* @throws IllegalArgumentException 如果名称无效
|
||||
*/
|
||||
fun getByName(name: String): Boolean {
|
||||
return when (name.lowercase()) {
|
||||
"b0", "bit0" -> b0
|
||||
"b1", "bit1" -> b1
|
||||
"b2", "bit2" -> b2
|
||||
"b3", "bit3" -> b3
|
||||
"b4", "bit4" -> b4
|
||||
"b5", "bit5" -> b5
|
||||
"b6", "bit6" -> b6
|
||||
"b7", "bit7" -> b7
|
||||
else -> throw IllegalArgumentException("未知的位名称: $name")
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 检查是否所有位都为 `false`。
|
||||
*
|
||||
* @return 若全部为 false 则返回 true,否则 false
|
||||
*/
|
||||
fun allFalse(): Boolean {
|
||||
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
|
||||
}
|
||||
|
||||
/**
|
||||
* 将当前状态转换为标准二进制字符串(MSB 在前)。
|
||||
*
|
||||
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
|
||||
*
|
||||
* @return 8 位二进制字符串(高位在左)
|
||||
*/
|
||||
fun toBinaryString(): String {
|
||||
return buildString {
|
||||
if (b7) append('1') else append('0')
|
||||
if (b6) append('1') else append('0')
|
||||
if (b5) append('1') else append('0')
|
||||
if (b4) append('1') else append('0')
|
||||
if (b3) append('1') else append('0')
|
||||
if (b2) append('1') else append('0')
|
||||
if (b1) append('1') else append('0')
|
||||
if (b0) append('1') else append('0')
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 统计值为 `true` 的位数量。
|
||||
*
|
||||
* @return true 位的个数(0~8)
|
||||
*/
|
||||
fun countTrue(): Int {
|
||||
var count = 0
|
||||
if (b0) count++
|
||||
if (b1) count++
|
||||
if (b2) count++
|
||||
if (b3) count++
|
||||
if (b4) count++
|
||||
if (b5) count++
|
||||
if (b6) count++
|
||||
if (b7) count++
|
||||
return count
|
||||
}
|
||||
|
||||
/**
|
||||
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
|
||||
*
|
||||
* 例如:若值为 10,则返回 "0x0A"
|
||||
*
|
||||
* @return 格式如 "0xXX" 的十六进制字符串
|
||||
*/
|
||||
fun toHexString(): String {
|
||||
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
|
||||
}
|
||||
/**
|
||||
* 统计值为 `false` 的位数量。
|
||||
*
|
||||
* @return false 位的个数(0~8)
|
||||
*/
|
||||
fun countFalse(): Int = 8 - countTrue()
|
||||
|
||||
/**
|
||||
* 将当前位状态转换为布尔数组。
|
||||
*
|
||||
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
|
||||
*
|
||||
* @return 长度为 8 的布尔数组
|
||||
*/
|
||||
fun toBooleanArray(): BooleanArray {
|
||||
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
|
||||
}
|
||||
/**
|
||||
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
|
||||
*
|
||||
* 支持别名:`bN` 或 `bitN`(不区分大小写)。
|
||||
*
|
||||
* @param name 位的名称(例如 "b0", "BIT5")
|
||||
* @return 对应位的布尔值
|
||||
* @throws IllegalArgumentException 如果名称无效
|
||||
*/
|
||||
fun getByName(name: String): Boolean {
|
||||
return when (name.lowercase()) {
|
||||
"b0", "bit0" -> b0
|
||||
"b1", "bit1" -> b1
|
||||
"b2", "bit2" -> b2
|
||||
"b3", "bit3" -> b3
|
||||
"b4", "bit4" -> b4
|
||||
"b5", "bit5" -> b5
|
||||
"b6", "bit6" -> b6
|
||||
"b7", "bit7" -> b7
|
||||
else -> throw IllegalArgumentException("未知的位名称: $name")
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 从布尔数组初始化位状态。
|
||||
*
|
||||
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
||||
*
|
||||
* @param array 布尔数组(长度至少为 8)
|
||||
* @throws IllegalArgumentException 如果数组长度不足 8
|
||||
*/
|
||||
fun fromBooleanArray(array: BooleanArray) {
|
||||
require(array.size >= 8) { "数组长度至少为8" }
|
||||
b0 = array[0]
|
||||
b1 = array[1]
|
||||
b2 = array[2]
|
||||
b3 = array[3]
|
||||
b4 = array[4]
|
||||
b5 = array[5]
|
||||
b6 = array[6]
|
||||
b7 = array[7]
|
||||
}
|
||||
/**
|
||||
* 将当前状态转换为标准二进制字符串(MSB 在前)。
|
||||
*
|
||||
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
|
||||
*
|
||||
* @return 8 位二进制字符串(高位在左)
|
||||
*/
|
||||
fun toBinaryString(): String {
|
||||
return buildString {
|
||||
if (b7) append('1') else append('0')
|
||||
if (b6) append('1') else append('0')
|
||||
if (b5) append('1') else append('0')
|
||||
if (b4) append('1') else append('0')
|
||||
if (b3) append('1') else append('0')
|
||||
if (b2) append('1') else append('0')
|
||||
if (b1) append('1') else append('0')
|
||||
if (b0) append('1') else append('0')
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。
|
||||
*
|
||||
* 结果的每一位 = this位 && other位
|
||||
*
|
||||
* @param other 另一个 ByteFlags 实例
|
||||
* @return 新的 ByteFlags 实例,表示 AND 结果
|
||||
*/
|
||||
infix fun and(other: ByteFlags): ByteFlags {
|
||||
return ByteFlags(
|
||||
this.b0 && other.b0,
|
||||
this.b1 && other.b1,
|
||||
this.b2 && other.b2,
|
||||
this.b3 && other.b3,
|
||||
this.b4 && other.b4,
|
||||
this.b5 && other.b5,
|
||||
this.b6 && other.b6,
|
||||
this.b7 && other.b7
|
||||
)
|
||||
}
|
||||
/**
|
||||
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
|
||||
*
|
||||
* 例如:若值为 10,则返回 "0x0A"
|
||||
*
|
||||
* @return 格式如 "0xXX" 的十六进制字符串
|
||||
*/
|
||||
fun toHexString(): String {
|
||||
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
|
||||
}
|
||||
|
||||
/**
|
||||
* 对两个 [ByteFlags] 执行按位“或”操作(OR)。
|
||||
*
|
||||
* 结果的每一位 = this位 || other位
|
||||
*
|
||||
* @param other 另一个 ByteFlags 实例
|
||||
* @return 新的 ByteFlags 实例,表示 OR 结果
|
||||
*/
|
||||
infix fun or(other: ByteFlags): ByteFlags {
|
||||
return ByteFlags(
|
||||
this.b0 || other.b0,
|
||||
this.b1 || other.b1,
|
||||
this.b2 || other.b2,
|
||||
this.b3 || other.b3,
|
||||
this.b4 || other.b4,
|
||||
this.b5 || other.b5,
|
||||
this.b6 || other.b6,
|
||||
this.b7 || other.b7
|
||||
)
|
||||
}
|
||||
/**
|
||||
* 将当前位状态转换为布尔数组。
|
||||
*
|
||||
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
|
||||
*
|
||||
* @return 长度为 8 的布尔数组
|
||||
*/
|
||||
fun toBooleanArray(): BooleanArray {
|
||||
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
|
||||
}
|
||||
|
||||
/**
|
||||
* 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。
|
||||
*
|
||||
* 结果的每一位 = this位 != other位
|
||||
*
|
||||
* @param other 另一个 ByteFlags 实例
|
||||
* @return 新的 ByteFlags 实例,表示 XOR 结果
|
||||
*/
|
||||
infix fun xor(other: ByteFlags): ByteFlags {
|
||||
return ByteFlags(
|
||||
this.b0 != other.b0,
|
||||
this.b1 != other.b1,
|
||||
this.b2 != other.b2,
|
||||
this.b3 != other.b3,
|
||||
this.b4 != other.b4,
|
||||
this.b5 != other.b5,
|
||||
this.b6 != other.b6,
|
||||
this.b7 != other.b7
|
||||
)
|
||||
}
|
||||
/**
|
||||
* 从布尔数组初始化位状态。
|
||||
*
|
||||
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
||||
*
|
||||
* @param array 布尔数组(长度至少为 8)
|
||||
* @throws IllegalArgumentException 如果数组长度不足 8
|
||||
*/
|
||||
fun fromBooleanArray(array: BooleanArray): ByteFlags {
|
||||
require(array.size >= 8) { "数组长度至少为8" }
|
||||
b0 = array[0]
|
||||
b1 = array[1]
|
||||
b2 = array[2]
|
||||
b3 = array[3]
|
||||
b4 = array[4]
|
||||
b5 = array[5]
|
||||
b6 = array[6]
|
||||
b7 = array[7]
|
||||
return this
|
||||
}
|
||||
|
||||
/**
|
||||
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
|
||||
*
|
||||
* 每一位取反。
|
||||
*
|
||||
* @return 新的 ByteFlags 实例,所有位取反
|
||||
*/
|
||||
operator fun not(): ByteFlags {
|
||||
return ByteFlags(
|
||||
!b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7
|
||||
)
|
||||
}
|
||||
/**
|
||||
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。
|
||||
*
|
||||
* 结果的每一位 = this位 && other位
|
||||
*
|
||||
* @param other 另一个 ByteFlags 实例
|
||||
* @return 新的 ByteFlags 实例,表示 AND 结果
|
||||
*/
|
||||
infix fun and(other: ByteFlags): ByteFlags {
|
||||
return ByteFlags(
|
||||
this.b0 && other.b0,
|
||||
this.b1 && other.b1,
|
||||
this.b2 && other.b2,
|
||||
this.b3 && other.b3,
|
||||
this.b4 && other.b4,
|
||||
this.b5 && other.b5,
|
||||
this.b6 && other.b6,
|
||||
this.b7 && other.b7
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 返回可读的字符串表示,包含二进制和十六进制形式。
|
||||
*
|
||||
* 示例:`ByteFlags(10100001 = 0xA1)`
|
||||
*
|
||||
* @return 字符串描述
|
||||
*/
|
||||
override fun toString(): String {
|
||||
return "ByteFlags(${toBinaryString()} = ${toHexString()})"
|
||||
}
|
||||
/**
|
||||
* 对两个 [ByteFlags] 执行按位“或”操作(OR)。
|
||||
*
|
||||
* 结果的每一位 = this位 || other位
|
||||
*
|
||||
* @param other 另一个 ByteFlags 实例
|
||||
* @return 新的 ByteFlags 实例,表示 OR 结果
|
||||
*/
|
||||
infix fun or(other: ByteFlags): ByteFlags {
|
||||
return ByteFlags(
|
||||
this.b0 || other.b0,
|
||||
this.b1 || other.b1,
|
||||
this.b2 || other.b2,
|
||||
this.b3 || other.b3,
|
||||
this.b4 || other.b4,
|
||||
this.b5 || other.b5,
|
||||
this.b6 || other.b6,
|
||||
this.b7 || other.b7
|
||||
)
|
||||
}
|
||||
|
||||
companion object {
|
||||
/**
|
||||
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
|
||||
*
|
||||
* @return 全 1 的 ByteFlags(值为 0xFF)
|
||||
*/
|
||||
fun allTrue(): ByteFlags {
|
||||
return ByteFlags(true, true, true, true, true, true, true, true)
|
||||
}
|
||||
/**
|
||||
* 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。
|
||||
*
|
||||
* 结果的每一位 = this位 != other位
|
||||
*
|
||||
* @param other 另一个 ByteFlags 实例
|
||||
* @return 新的 ByteFlags 实例,表示 XOR 结果
|
||||
*/
|
||||
infix fun xor(other: ByteFlags): ByteFlags {
|
||||
return ByteFlags(
|
||||
this.b0 != other.b0,
|
||||
this.b1 != other.b1,
|
||||
this.b2 != other.b2,
|
||||
this.b3 != other.b3,
|
||||
this.b4 != other.b4,
|
||||
this.b5 != other.b5,
|
||||
this.b6 != other.b6,
|
||||
this.b7 != other.b7
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建一个所有位均为 `false` 的 [ByteFlags] 实例。
|
||||
*
|
||||
* @return 全 0 的 ByteFlags(值为 0x00)
|
||||
*/
|
||||
fun allFalse(): ByteFlags {
|
||||
return ByteFlags()
|
||||
}
|
||||
/**
|
||||
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
|
||||
*
|
||||
* 每一位取反。
|
||||
*
|
||||
* @return 新的 ByteFlags 实例,所有位取反
|
||||
*/
|
||||
operator fun not(): ByteFlags {
|
||||
return ByteFlags(
|
||||
!b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 从 8 位二进制字符串创建 [ByteFlags] 实例。
|
||||
*
|
||||
* 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。
|
||||
*
|
||||
* @param binary 8 位二进制字符串(仅含 '0' 和 '1')
|
||||
* @return 对应的 ByteFlags 实例
|
||||
* @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符
|
||||
*/
|
||||
fun fromBinaryString(binary: String): ByteFlags {
|
||||
require(binary.length == 8) { "二进制字符串长度必须为8" }
|
||||
require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" }
|
||||
/**
|
||||
* 返回可读的字符串表示,包含二进制和十六进制形式。
|
||||
*
|
||||
* 示例:`ByteFlags(10100001 = 0xA1)`
|
||||
*
|
||||
* @return 字符串描述
|
||||
*/
|
||||
override fun toString(): String {
|
||||
return "ByteFlags(${toBinaryString()} = ${toHexString()})"
|
||||
}
|
||||
|
||||
return ByteFlags(
|
||||
binary[7] == '1', // b0 是最低位(对应字符串最后一位)
|
||||
binary[6] == '1',
|
||||
binary[5] == '1',
|
||||
binary[4] == '1',
|
||||
binary[3] == '1',
|
||||
binary[2] == '1',
|
||||
binary[1] == '1',
|
||||
binary[0] == '1' // b7 是最高位(对应字符串第一位)
|
||||
)
|
||||
}
|
||||
/**
|
||||
* 伴生对象,提供 [ByteFlags] 的多种静态工厂方法。
|
||||
*/
|
||||
companion object {
|
||||
/**
|
||||
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
|
||||
*
|
||||
* @return 全 1 的 ByteFlags(值为 0xFF)
|
||||
*/
|
||||
fun allTrue(): ByteFlags {
|
||||
return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true)
|
||||
}
|
||||
|
||||
/**
|
||||
* 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。
|
||||
*
|
||||
* @param value 输入整数
|
||||
* @return 对应的 ByteFlags 实例
|
||||
*/
|
||||
fun fromInt(value: Int): ByteFlags {
|
||||
return ByteFlags((value and 0xFF).toByte())
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 创建一个所有位均为 `false` 的 [ByteFlags] 实例。
|
||||
*
|
||||
* @return 全 0 的 ByteFlags(值为 0x00)
|
||||
*/
|
||||
fun allFalse(): ByteFlags {
|
||||
return ByteFlags()
|
||||
}
|
||||
|
||||
/**
|
||||
* 从 8 位二进制字符串创建 [ByteFlags] 实例。
|
||||
*
|
||||
* 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。
|
||||
*
|
||||
* @param binary 8 位二进制字符串(仅含 '0' 和 '1')
|
||||
* @return 对应的 ByteFlags 实例
|
||||
* @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符
|
||||
*/
|
||||
fun fromBinaryString(binary: String): ByteFlags {
|
||||
require(binary.length == 8) { "二进制字符串长度必须为8" }
|
||||
require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" }
|
||||
return ByteFlags(
|
||||
binary[7] == '1', // b0 是最低位(对应字符串最后一位)
|
||||
binary[6] == '1',
|
||||
binary[5] == '1',
|
||||
binary[4] == '1',
|
||||
binary[3] == '1',
|
||||
binary[2] == '1',
|
||||
binary[1] == '1',
|
||||
binary[0] == '1' // b7 是最高位(对应字符串第一位)
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* 从布尔数组创建 [ByteFlags] 实例。
|
||||
*
|
||||
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
||||
*
|
||||
* @param booleanArray 布尔数组(长度至少为 8)
|
||||
* @return 对应的 ByteFlags 实例
|
||||
* @throws IllegalArgumentException 如果数组长度不足 8
|
||||
*/
|
||||
fun fromBooleanArray(booleanArray: BooleanArray): ByteFlags {
|
||||
return ByteFlags().fromBooleanArray(booleanArray)
|
||||
}
|
||||
|
||||
/**
|
||||
* 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。
|
||||
*
|
||||
* @param value 输入整数
|
||||
* @return 对应的 ByteFlags 实例
|
||||
*/
|
||||
fun fromInt(value: Int): ByteFlags {
|
||||
return ByteFlags((value and 0xFF).toByte())
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -16,14 +16,14 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ByteUtils.kt
|
||||
* LastUpdate 2026-01-14 13:01:44
|
||||
* LastUpdate 2026-05-22 13:26:55
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
@file:JvmName("ByteUtils")
|
||||
|
||||
package com.mingliqiye.utils.bytes
|
||||
|
||||
import com.mingliqiye.utils.base.BASE16
|
||||
import com.mingliqiye.utils.base.BaseType
|
||||
import com.mingliqiye.utils.stream.SuperStream
|
||||
|
||||
/**
|
||||
@@ -87,8 +87,8 @@ const val ESC_RESERVED: Byte = 0x06
|
||||
* @return 包含每个字节对应十六进制字符串的列表
|
||||
*/
|
||||
fun ByteArray.getByteArrayString(): MutableList<String> {
|
||||
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
|
||||
.collect(SuperStream.toList()) as MutableList<String>
|
||||
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
|
||||
.collect(SuperStream.toListCollector()) as MutableList<String>
|
||||
}
|
||||
|
||||
|
||||
@@ -99,12 +99,12 @@ fun ByteArray.getByteArrayString(): MutableList<String> {
|
||||
* @throws NumberFormatException 当字符不是有效的十六进制字符时抛出
|
||||
*/
|
||||
fun Char.hexDigitToValue(): Int {
|
||||
return when (this) {
|
||||
in '0'..'9' -> this - '0'
|
||||
in 'A'..'F' -> this - 'A' + 10
|
||||
in 'a'..'f' -> this - 'a' + 10
|
||||
else -> throw NumberFormatException("Invalid hex character: $this")
|
||||
}
|
||||
return when (this) {
|
||||
in '0'..'9' -> this - '0'
|
||||
in 'A'..'F' -> this - 'A' + 10
|
||||
in 'a'..'f' -> this - 'a' + 10
|
||||
else -> throw NumberFormatException("Invalid hex character: $this")
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -114,7 +114,7 @@ fun Char.hexDigitToValue(): Int {
|
||||
* @return 转换后的字节数组
|
||||
*/
|
||||
fun hexStringToByteArray(string: String): ByteArray {
|
||||
return string.hexToByteArray()
|
||||
return string.hexToByteArray()
|
||||
}
|
||||
|
||||
|
||||
@@ -125,5 +125,5 @@ fun hexStringToByteArray(string: String): ByteArray {
|
||||
* @return 对应的十六进制字符串
|
||||
*/
|
||||
fun bytesToHex(bytes: ByteArray): String {
|
||||
return BASE16.encode(bytes)
|
||||
return BaseType.BASE16.encode(bytes)
|
||||
}
|
||||
|
||||
@@ -41,23 +41,23 @@ import java.io.OutputStream
|
||||
*/
|
||||
@Throws(IOException::class)
|
||||
fun InputStream.readVarNumber(size: Int = 8): Long {
|
||||
var numRead = 0
|
||||
var result: Long = 0
|
||||
var read: Byte
|
||||
do {
|
||||
read = this.read().let {
|
||||
if (it == -1) {
|
||||
throw IOException("Reached end of stream")
|
||||
}
|
||||
it.toByte()
|
||||
}
|
||||
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||
numRead++
|
||||
if (numRead > size) {
|
||||
throw IOException("VarNumber is too big")
|
||||
}
|
||||
} while ((read.toLong() and 128) != 0L)
|
||||
return result
|
||||
var numRead = 0
|
||||
var result: Long = 0
|
||||
var read: Byte
|
||||
do {
|
||||
read = this.read().let {
|
||||
if (it == -1) {
|
||||
throw IOException("Reached end of stream")
|
||||
}
|
||||
it.toByte()
|
||||
}
|
||||
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||
numRead++
|
||||
if (numRead > size) {
|
||||
throw IOException("VarNumber is too big")
|
||||
}
|
||||
} while ((read.toLong() and 128) != 0L)
|
||||
return result
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -102,20 +102,20 @@ fun InputStream.readVarLong(): Long = this.readVarNumber()
|
||||
*/
|
||||
@Throws(IOException::class)
|
||||
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
|
||||
var v = value
|
||||
var numWritten = 0
|
||||
var v = value
|
||||
var numWritten = 0
|
||||
|
||||
while (v >= 0x80 && numWritten < size - 1) {
|
||||
this.write((v and 0x7F or 0x80).toInt())
|
||||
v = v ushr 7
|
||||
numWritten++
|
||||
}
|
||||
while (v >= 0x80 && numWritten < size - 1) {
|
||||
this.write((v and 0x7F or 0x80).toInt())
|
||||
v = v ushr 7
|
||||
numWritten++
|
||||
}
|
||||
|
||||
if (numWritten >= size) {
|
||||
throw IOException("VarNumber is too big")
|
||||
}
|
||||
if (numWritten >= size) {
|
||||
throw IOException("VarNumber is too big")
|
||||
}
|
||||
|
||||
this.write(v.toInt())
|
||||
this.write(v.toInt())
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile CloneUtils.kt
|
||||
* LastUpdate 2026-02-05 14:41:27
|
||||
* LastUpdate 2026-02-08 10:36:51
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
@file:JvmName("CloneUtils")
|
||||
@@ -24,38 +24,62 @@
|
||||
package com.mingliqiye.utils.clone
|
||||
|
||||
import com.mingliqiye.utils.exception.JsonException
|
||||
import com.mingliqiye.utils.json.api.base.JsonApi
|
||||
import com.mingliqiye.utils.json.api.JSONA
|
||||
import java.io.*
|
||||
|
||||
|
||||
inline fun <reified T> Serializable.deepClone(): T {
|
||||
return deepClone(this) as T
|
||||
/**
|
||||
* 通过 Java 序列化机制对当前对象进行深克隆。
|
||||
*
|
||||
* @param T 对象类型,必须实现 [Serializable]
|
||||
* @return 深克隆后的新对象
|
||||
*/
|
||||
@JvmName("_inline_deepClone")
|
||||
inline fun <reified T : Serializable> T.deepClone(): T {
|
||||
return deepClone(this)
|
||||
}
|
||||
|
||||
inline fun <reified T> T.deepJsonClone(jsonApi: JsonApi): T {
|
||||
try {
|
||||
return jsonApi.convert(this as Any, this!!.javaClass) as T
|
||||
} catch (e: Exception) {
|
||||
throw JsonException(
|
||||
"Failed to deep clone object using JSON", e
|
||||
)
|
||||
}
|
||||
/**
|
||||
* 通过 JSON 序列化与反序列化对当前对象进行深克隆。
|
||||
*
|
||||
* @param T 对象类型
|
||||
* @return 深克隆后的新对象
|
||||
* @throws JsonException 如果 JSON 转换过程中发生异常
|
||||
*/
|
||||
inline fun <reified T> T.deepJsonClone(): T {
|
||||
try {
|
||||
return JSONA.convert(this as Any, this!!.javaClass) as T
|
||||
} catch (e: Exception) {
|
||||
throw JsonException(
|
||||
"Failed to deep clone object using JSON", e
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 通过 Java 序列化机制对对象进行深克隆。
|
||||
*
|
||||
* 将对象序列化到内存后再反序列化,得到一个全新的对象副本。
|
||||
*
|
||||
* @param T 对象类型,必须实现 [Serializable]
|
||||
* @param obj 要克隆的对象
|
||||
* @return 深克隆后的新对象
|
||||
* @throws RuntimeException 如果序列化或反序列化过程中发生 I/O 异常或类找不到
|
||||
*/
|
||||
@Suppress("UNCHECKED_CAST")
|
||||
fun <T : Serializable?> deepClone(obj: T): T {
|
||||
try {
|
||||
val bao = ByteArrayOutputStream()
|
||||
val oos = ObjectOutputStream(bao)
|
||||
oos.writeObject(obj)
|
||||
val bis = ByteArrayInputStream(
|
||||
bao.toByteArray()
|
||||
)
|
||||
val ois = ObjectInputStream(bis)
|
||||
return ois.readObject() as T
|
||||
} catch (e: IOException) {
|
||||
throw RuntimeException(e)
|
||||
} catch (e: ClassNotFoundException) {
|
||||
throw RuntimeException(e)
|
||||
}
|
||||
try {
|
||||
val bao = ByteArrayOutputStream()
|
||||
val oos = ObjectOutputStream(bao)
|
||||
oos.writeObject(obj)
|
||||
val bis = ByteArrayInputStream(
|
||||
bao.toByteArray()
|
||||
)
|
||||
val ois = ObjectInputStream(bis)
|
||||
return ois.readObject() as T
|
||||
} catch (e: IOException) {
|
||||
throw RuntimeException(e)
|
||||
} catch (e: ClassNotFoundException) {
|
||||
throw RuntimeException(e)
|
||||
}
|
||||
}
|
||||
|
||||
@@ -36,7 +36,7 @@ import java.util.stream.Collectors
|
||||
* @return 转换后的数组
|
||||
*/
|
||||
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")
|
||||
inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
|
||||
return this.stream().collect(
|
||||
SuperStream.toMap(
|
||||
v
|
||||
)
|
||||
) as Map<T, V>
|
||||
return this.stream().collect(
|
||||
SuperStream.toMap(
|
||||
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
|
||||
*/
|
||||
inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> {
|
||||
return this.stream().collect(
|
||||
Collectors.toMap(
|
||||
k, v
|
||||
)
|
||||
)
|
||||
return this.stream().collect(
|
||||
Collectors.toMap(
|
||||
k, v
|
||||
)
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -82,7 +82,7 @@ inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline
|
||||
* @return 转换后的 Set
|
||||
*/
|
||||
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
|
||||
*/
|
||||
inline fun <reified T> Collection<T>.getFirst(): T? {
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
if (this is MutableList<T>) {
|
||||
return this.first()
|
||||
}
|
||||
return this.iterator().next()
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
if (this is MutableList<T>) {
|
||||
return this.first()
|
||||
}
|
||||
return this.iterator().next()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -109,10 +109,10 @@ inline fun <reified T> Collection<T>.getFirst(): T? {
|
||||
* @return 第一个元素或 null
|
||||
*/
|
||||
inline fun <reified T> Array<T>.getFirst(): T? {
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
return this.first()
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
return this.first()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -122,17 +122,17 @@ inline fun <reified T> Array<T>.getFirst(): T? {
|
||||
* @return 最后一个元素或 null
|
||||
*/
|
||||
inline fun <reified T> Collection<T>.getLast(): T? {
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
if (this is MutableList<T>) {
|
||||
return this.last()
|
||||
}
|
||||
var lastElement: T? = null
|
||||
for (element in this) {
|
||||
lastElement = element
|
||||
}
|
||||
return lastElement
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
if (this is MutableList<T>) {
|
||||
return this.last()
|
||||
}
|
||||
var lastElement: T? = null
|
||||
for (element in this) {
|
||||
lastElement = element
|
||||
}
|
||||
return lastElement
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -142,10 +142,10 @@ inline fun <reified T> Collection<T>.getLast(): T? {
|
||||
* @return 最后一个元素或 null
|
||||
*/
|
||||
inline fun <reified T> Array<T>.getLast(): T? {
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
return this.last()
|
||||
if (this.isEmpty()) {
|
||||
return null
|
||||
}
|
||||
return this.last()
|
||||
}
|
||||
|
||||
|
||||
@@ -158,22 +158,22 @@ inline fun <reified T> Array<T>.getLast(): T? {
|
||||
* @return 指定索引处的元素或默认值
|
||||
*/
|
||||
inline fun <reified T> Collection<T>.getOrDefault(
|
||||
index: Int, defaultValue: T
|
||||
index: Int, defaultValue: T,
|
||||
): T {
|
||||
if (!(!this.isEmpty() && index < this.size)) {
|
||||
return defaultValue
|
||||
}
|
||||
if (this is List<T>) {
|
||||
return this[index]
|
||||
}
|
||||
var i = 0
|
||||
for (element in this) {
|
||||
if (i == index) {
|
||||
return element
|
||||
}
|
||||
i++
|
||||
}
|
||||
return defaultValue
|
||||
if (!(!this.isEmpty() && index < this.size)) {
|
||||
return defaultValue
|
||||
}
|
||||
if (this is List<T>) {
|
||||
return this[index]
|
||||
}
|
||||
var i = 0
|
||||
for (element in this) {
|
||||
if (i == index) {
|
||||
return element
|
||||
}
|
||||
i++
|
||||
}
|
||||
return defaultValue
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -183,7 +183,7 @@ inline fun <reified T> Collection<T>.getOrDefault(
|
||||
* @return 新创建的 ArrayList
|
||||
*/
|
||||
fun <T> newArrayList(): ArrayList<T> {
|
||||
return ArrayList()
|
||||
return ArrayList()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -194,7 +194,7 @@ fun <T> newArrayList(): ArrayList<T> {
|
||||
* @return 新创建的 ArrayList
|
||||
*/
|
||||
fun <T> newArrayList(size: Int): ArrayList<T> {
|
||||
return ArrayList()
|
||||
return ArrayList()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -205,7 +205,7 @@ fun <T> newArrayList(size: Int): ArrayList<T> {
|
||||
* @return 新创建的 ArrayList
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newLinkedList(): LinkedList<T> {
|
||||
return LinkedList()
|
||||
return LinkedList()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -280,9 +280,9 @@ fun <T> newLinkedList(): LinkedList<T> {
|
||||
* @return 新创建的 LinkedList
|
||||
*/
|
||||
fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
|
||||
val list = newLinkedList<T>()
|
||||
list.addAll(elements.asList())
|
||||
return list
|
||||
val list = newLinkedList<T>()
|
||||
list.addAll(elements.asList())
|
||||
return list
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -293,9 +293,9 @@ fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
|
||||
* @return 新创建的 LinkedList
|
||||
*/
|
||||
fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
|
||||
val list = newLinkedList<T>()
|
||||
list.addAll(elements)
|
||||
return list
|
||||
val list = newLinkedList<T>()
|
||||
list.addAll(elements)
|
||||
return list
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -306,11 +306,11 @@ fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
|
||||
* @return 新创建的 LinkedList
|
||||
*/
|
||||
fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
|
||||
val list = newLinkedList<T>()
|
||||
for (element in elements) {
|
||||
list.add(element)
|
||||
}
|
||||
return list
|
||||
val list = newLinkedList<T>()
|
||||
for (element in elements) {
|
||||
list.add(element)
|
||||
}
|
||||
return list
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -321,7 +321,7 @@ fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
|
||||
* @return 新创建的 LinkedList
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newVector(): Vector<T> {
|
||||
return Vector()
|
||||
return Vector()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -342,9 +342,9 @@ fun <T> newVector(): Vector<T> {
|
||||
* @return 新创建的 Vector
|
||||
*/
|
||||
fun <T> newVector(vararg elements: T): Vector<T> {
|
||||
val vector = newVector<T>()
|
||||
vector.addAll(elements.asList())
|
||||
return vector
|
||||
val vector = newVector<T>()
|
||||
vector.addAll(elements.asList())
|
||||
return vector
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -355,9 +355,9 @@ fun <T> newVector(vararg elements: T): Vector<T> {
|
||||
* @return 新创建的 Vector
|
||||
*/
|
||||
fun <T> newVector(elements: Collection<T>): Vector<T> {
|
||||
val vector = newVector<T>()
|
||||
vector.addAll(elements)
|
||||
return vector
|
||||
val vector = newVector<T>()
|
||||
vector.addAll(elements)
|
||||
return vector
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -368,11 +368,11 @@ fun <T> newVector(elements: Collection<T>): Vector<T> {
|
||||
* @return 新创建的 Vector
|
||||
*/
|
||||
fun <T> newVector(elements: Iterable<T>): Vector<T> {
|
||||
val vector = newVector<T>()
|
||||
for (element in elements) {
|
||||
vector.add(element)
|
||||
}
|
||||
return vector
|
||||
val vector = newVector<T>()
|
||||
for (element in elements) {
|
||||
vector.add(element)
|
||||
}
|
||||
return vector
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -383,7 +383,7 @@ fun <T> newVector(elements: Iterable<T>): Vector<T> {
|
||||
* @return 新创建的 Vector
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newHashSet(): HashSet<T> {
|
||||
return HashSet()
|
||||
return HashSet()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -405,7 +405,7 @@ fun <T> newHashSet(): HashSet<T> {
|
||||
* @return 新创建的 HashSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newHashSet(vararg elements: T): HashSet<T> {
|
||||
val set = newHashSet<T>()
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
val set = newHashSet<T>()
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -429,9 +429,9 @@ fun <T> newHashSet(vararg elements: T): HashSet<T> {
|
||||
* @return 新创建的 HashSet
|
||||
*/
|
||||
fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
|
||||
val set = newHashSet<T>()
|
||||
set.addAll(elements)
|
||||
return set
|
||||
val set = newHashSet<T>()
|
||||
set.addAll(elements)
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -442,11 +442,11 @@ fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
|
||||
* @return 新创建的 HashSet
|
||||
*/
|
||||
fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
|
||||
val set = newHashSet<T>()
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
val set = newHashSet<T>()
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -457,7 +457,7 @@ fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
|
||||
* @return 新创建的 HashSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newLinkedHashSet(): LinkedHashSet<T> {
|
||||
return LinkedHashSet()
|
||||
return LinkedHashSet()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -478,7 +478,7 @@ fun <T> newLinkedHashSet(): LinkedHashSet<T> {
|
||||
* @return 新创建的 LinkedHashSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
|
||||
val set = newLinkedHashSet<T>()
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
val set = newLinkedHashSet<T>()
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -502,9 +502,9 @@ fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
|
||||
* @return 新创建的 LinkedHashSet
|
||||
*/
|
||||
fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
|
||||
val set = newLinkedHashSet<T>()
|
||||
set.addAll(elements)
|
||||
return set
|
||||
val set = newLinkedHashSet<T>()
|
||||
set.addAll(elements)
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -515,11 +515,11 @@ fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
|
||||
* @return 新创建的 LinkedHashSet
|
||||
*/
|
||||
fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
|
||||
val set = newLinkedHashSet<T>()
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
val set = newLinkedHashSet<T>()
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -530,7 +530,7 @@ fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
|
||||
* @return 新创建的 LinkedHashSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
|
||||
return TreeSet()
|
||||
return TreeSet()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -551,9 +551,9 @@ fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
|
||||
val set = newTreeSet<T>()
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
val set = newTreeSet<T>()
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -564,9 +564,9 @@ fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
|
||||
val set = newTreeSet<T>()
|
||||
set.addAll(elements)
|
||||
return set
|
||||
val set = newTreeSet<T>()
|
||||
set.addAll(elements)
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -577,11 +577,11 @@ fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
|
||||
val set = newTreeSet<T>()
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
val set = newTreeSet<T>()
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -592,7 +592,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newStack(): Stack<T> {
|
||||
return Stack()
|
||||
return Stack()
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -726,9 +726,9 @@ fun <T> newStack(): Stack<T> {
|
||||
* @return 新创建的 Stack
|
||||
*/
|
||||
fun <T> newStack(vararg elements: T): Stack<T> {
|
||||
val stack = newStack<T>()
|
||||
stack.addAll(elements.asList())
|
||||
return stack
|
||||
val stack = newStack<T>()
|
||||
stack.addAll(elements.asList())
|
||||
return stack
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -739,9 +739,9 @@ fun <T> newStack(vararg elements: T): Stack<T> {
|
||||
* @return 新创建的 Stack
|
||||
*/
|
||||
fun <T> newStack(elements: Collection<T>): Stack<T> {
|
||||
val stack = newStack<T>()
|
||||
stack.addAll(elements)
|
||||
return stack
|
||||
val stack = newStack<T>()
|
||||
stack.addAll(elements)
|
||||
return stack
|
||||
|
||||
}
|
||||
|
||||
@@ -753,7 +753,7 @@ fun <T> newStack(elements: Collection<T>): Stack<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
|
||||
val set = newTreeSet(comparator)
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
val set = newTreeSet(comparator)
|
||||
set.addAll(elements.asList())
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -779,9 +779,9 @@ fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> {
|
||||
val set = newTreeSet(comparator)
|
||||
set.addAll(elements)
|
||||
return set
|
||||
val set = newTreeSet(comparator)
|
||||
set.addAll(elements)
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -793,11 +793,11 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> {
|
||||
val set = newTreeSet(comparator)
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
val set = newTreeSet(comparator)
|
||||
for (element in elements) {
|
||||
set.add(element)
|
||||
}
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -809,7 +809,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T>
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
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
|
||||
*/
|
||||
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
|
||||
*/
|
||||
fun <T> Collection<T>.newStacks(): Stack<T> {
|
||||
val stack = Stack<T>()
|
||||
stack.addAll(this)
|
||||
return stack
|
||||
val stack = Stack<T>()
|
||||
stack.addAll(this)
|
||||
return stack
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -841,9 +841,9 @@ fun <T> Collection<T>.newStacks(): Stack<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
|
||||
val set = TreeSet<T>()
|
||||
set.addAll(this)
|
||||
return set
|
||||
val set = TreeSet<T>()
|
||||
set.addAll(this)
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -854,9 +854,9 @@ fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
|
||||
* @return 新创建的 TreeSet
|
||||
*/
|
||||
fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
|
||||
val set = TreeSet(comparator)
|
||||
set.addAll(this)
|
||||
return set
|
||||
val set = TreeSet(comparator)
|
||||
set.addAll(this)
|
||||
return set
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -866,11 +866,11 @@ fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
|
||||
* @return 转换后的字节数组
|
||||
*/
|
||||
fun toArray(list: List<Byte>): ByteArray {
|
||||
val arr = ByteArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = ByteArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
|
||||
@@ -881,11 +881,11 @@ fun toArray(list: List<Byte>): ByteArray {
|
||||
* @return 转换后的短整型数组
|
||||
*/
|
||||
fun toArray(list: List<Short>): ShortArray {
|
||||
val arr = ShortArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = ShortArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -895,11 +895,11 @@ fun toArray(list: List<Short>): ShortArray {
|
||||
* @return 转换后的整型数组
|
||||
*/
|
||||
fun toArray(list: List<Int>): IntArray {
|
||||
val arr = IntArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = IntArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -909,11 +909,11 @@ fun toArray(list: List<Int>): IntArray {
|
||||
* @return 转换后的长整型数组
|
||||
*/
|
||||
fun toArray(list: List<Long>): LongArray {
|
||||
val arr = LongArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = LongArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -923,11 +923,11 @@ fun toArray(list: List<Long>): LongArray {
|
||||
* @return 转换后的浮点数组
|
||||
*/
|
||||
fun toArray(list: List<Float>): FloatArray {
|
||||
val arr = FloatArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = FloatArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -937,11 +937,11 @@ fun toArray(list: List<Float>): FloatArray {
|
||||
* @return 转换后的双精度浮点数组
|
||||
*/
|
||||
fun toArray(list: List<Double>): DoubleArray {
|
||||
val arr = DoubleArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = DoubleArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -951,11 +951,11 @@ fun toArray(list: List<Double>): DoubleArray {
|
||||
* @return 转换后的布尔数组
|
||||
*/
|
||||
fun toArray(list: List<Boolean>): BooleanArray {
|
||||
val arr = BooleanArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = BooleanArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -965,11 +965,11 @@ fun toArray(list: List<Boolean>): BooleanArray {
|
||||
* @return 转换后的字符数组
|
||||
*/
|
||||
fun toArray(list: List<Char>): CharArray {
|
||||
val arr = CharArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
val arr = CharArray(list.size)
|
||||
for (i in list.indices) {
|
||||
arr[i] = list[i]
|
||||
}
|
||||
return arr
|
||||
}
|
||||
|
||||
|
||||
@@ -981,13 +981,21 @@ fun toArray(list: List<Char>): CharArray {
|
||||
* @return 转换后的数组
|
||||
*/
|
||||
inline fun <reified T> toArray(list: List<T>): Array<T> {
|
||||
if (list.isEmpty())
|
||||
return arrayOf<T>()
|
||||
return SuperStream.of<T>(list)
|
||||
.toArray(T::class.java)
|
||||
if (list.isEmpty())
|
||||
return arrayOf<T>()
|
||||
return SuperStream.of<T>(list)
|
||||
.toArray(T::class.java)
|
||||
}
|
||||
|
||||
/**
|
||||
* 将任意类型的 List 转换为指定类型的数组。
|
||||
*
|
||||
* @param T 元素类型
|
||||
* @param list 输入的 List
|
||||
* @param clazz 数组元素类型对应的 Class 对象
|
||||
* @return 转换后的数组
|
||||
*/
|
||||
fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> {
|
||||
return SuperStream.of<T>(list)
|
||||
.toArray(clazz)
|
||||
return SuperStream.of<T>(list)
|
||||
.toArray(clazz)
|
||||
}
|
||||
|
||||
@@ -34,68 +34,71 @@ import java.util.concurrent.atomic.AtomicReference
|
||||
*/
|
||||
class IsChanged<T> {
|
||||
|
||||
/**
|
||||
* 使用 AtomicReference 来保证对数据的原子操作
|
||||
*/
|
||||
private val atomicReferenceData: AtomicReference<T> = AtomicReference()
|
||||
/**
|
||||
* 使用 AtomicReference 来保证对数据的原子操作
|
||||
*/
|
||||
private val atomicReferenceData: AtomicReference<T> = AtomicReference()
|
||||
|
||||
constructor()
|
||||
/**
|
||||
* 无参构造函数,初始数据为 null
|
||||
*/
|
||||
constructor()
|
||||
|
||||
/**
|
||||
* 带参数的构造函数,使用指定的初始值初始化
|
||||
*
|
||||
* @param data 初始数据值
|
||||
*/
|
||||
constructor(data: T) : super() {
|
||||
atomicReferenceData.set(data)
|
||||
}
|
||||
/**
|
||||
* 带参数的构造函数,使用指定的初始值初始化
|
||||
*
|
||||
* @param data 初始数据值
|
||||
*/
|
||||
constructor(data: T) : super() {
|
||||
atomicReferenceData.set(data)
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置新的数据值,不检查是否发生变化
|
||||
*
|
||||
* @param data 要设置的新数据值
|
||||
*/
|
||||
fun set(data: T) {
|
||||
atomicReferenceData.set(data)
|
||||
}
|
||||
/**
|
||||
* 设置新的数据值,不检查是否发生变化
|
||||
*
|
||||
* @param data 要设置的新数据值
|
||||
*/
|
||||
fun set(data: T) {
|
||||
atomicReferenceData.set(data)
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取当前数据值
|
||||
*
|
||||
* @return 当前数据值
|
||||
*/
|
||||
fun get(): T {
|
||||
return atomicReferenceData.get()
|
||||
}
|
||||
/**
|
||||
* 获取当前数据值
|
||||
*
|
||||
* @return 当前数据值
|
||||
*/
|
||||
fun get(): T {
|
||||
return atomicReferenceData.get()
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置新的数据值并返回旧的数据值
|
||||
*
|
||||
* @param data 要设置的新数据值
|
||||
* @return 设置前的旧数据值
|
||||
*/
|
||||
fun setAndGet(data: T): T {
|
||||
return atomicReferenceData.getAndSet(data)
|
||||
}
|
||||
/**
|
||||
* 设置新的数据值并返回旧的数据值
|
||||
*
|
||||
* @param data 要设置的新数据值
|
||||
* @return 设置前的旧数据值
|
||||
*/
|
||||
fun setAndGet(data: T): T {
|
||||
return atomicReferenceData.getAndSet(data)
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false
|
||||
* 使用 CAS(Compare-And-Swap) 操作确保线程安全
|
||||
*
|
||||
* @param data 要设置的新数据值
|
||||
* @return 如果值发生变化返回 true,否则返回 false
|
||||
*/
|
||||
fun setAndChanged(data: T): Boolean {
|
||||
var currentData: T
|
||||
do {
|
||||
currentData = get()
|
||||
// 如果新值与当前值相等,则认为没有变化,直接返回 false
|
||||
if (Objects.equals(data, currentData)) {
|
||||
return false
|
||||
}
|
||||
// 使用 CAS 操作尝试更新值,如果失败则重试
|
||||
} while (!atomicReferenceData.compareAndSet(currentData, data))
|
||||
// 成功更新值,返回 true 表示发生了变化
|
||||
return true
|
||||
}
|
||||
/**
|
||||
* 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false
|
||||
* 使用 CAS(Compare-And-Swap) 操作确保线程安全
|
||||
*
|
||||
* @param data 要设置的新数据值
|
||||
* @return 如果值发生变化返回 true,否则返回 false
|
||||
*/
|
||||
fun setAndChanged(data: T): Boolean {
|
||||
var currentData: T
|
||||
do {
|
||||
currentData = get()
|
||||
// 如果新值与当前值相等,则认为没有变化,直接返回 false
|
||||
if (Objects.equals(data, currentData)) {
|
||||
return false
|
||||
}
|
||||
// 使用 CAS 操作尝试更新值,如果失败则重试
|
||||
} while (!atomicReferenceData.compareAndSet(currentData, data))
|
||||
// 成功更新值,返回 true 表示发生了变化
|
||||
return true
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
* 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.
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ConfigurationProp.kt
|
||||
* LastUpdate 2025-09-19 11:30:04
|
||||
* LastUpdate 2026-07-01 12:37:05
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -31,10 +31,10 @@ package com.mingliqiye.utils.configuration
|
||||
*/
|
||||
@Retention(AnnotationRetention.RUNTIME)
|
||||
@Target(
|
||||
AnnotationTarget.TYPE_PARAMETER,
|
||||
AnnotationTarget.VALUE_PARAMETER,
|
||||
AnnotationTarget.FIELD, // 添加字段支持
|
||||
AnnotationTarget.PROPERTY // 添加属性支持
|
||||
AnnotationTarget.TYPE_PARAMETER,
|
||||
AnnotationTarget.VALUE_PARAMETER,
|
||||
AnnotationTarget.FIELD, // 添加字段支持
|
||||
AnnotationTarget.PROPERTY // 添加属性支持
|
||||
)
|
||||
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 方法名。
|
||||
*/
|
||||
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 方法名。
|
||||
*/
|
||||
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,220 @@ private fun getGetterName(fieldName: String): String {
|
||||
*/
|
||||
open class ConfigurationProps {
|
||||
|
||||
companion object {
|
||||
/**
|
||||
* 初始化配置类实例,并根据命令行参数填充其字段。
|
||||
*
|
||||
* @param clazz 配置类的 Class 对象。
|
||||
* @param args 命令行参数数组。
|
||||
* @return 初始化后的配置类实例。
|
||||
*/
|
||||
@JvmStatic
|
||||
fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
|
||||
val mapsArgs = parseArguments(args)
|
||||
val instance = clazz.getDeclaredConstructor().newInstance()
|
||||
/**
|
||||
* 伴生对象,提供根据命令行参数初始化配置类实例的静态方法。
|
||||
*/
|
||||
companion object {
|
||||
/**
|
||||
* 初始化配置类实例,并根据命令行参数填充其字段。
|
||||
*
|
||||
* @param clazz 配置类的 Class 对象。
|
||||
* @param args 命令行参数数组。
|
||||
* @return 初始化后的配置类实例。
|
||||
*/
|
||||
@JvmStatic
|
||||
fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
|
||||
val mapsArgs = parseArguments(args)
|
||||
val instance = clazz.getDeclaredConstructor().newInstance()
|
||||
|
||||
processFields(clazz, instance, mapsArgs)
|
||||
processFields(clazz, instance, mapsArgs)
|
||||
|
||||
return instance
|
||||
}
|
||||
return instance
|
||||
}
|
||||
|
||||
/**
|
||||
* 解析命令行参数,将其转换为键值对映射。
|
||||
*
|
||||
* 支持以下格式:
|
||||
* - `--key=value` 或 `-k=value`:键值对形式。
|
||||
* - `--key value` 或 `-k value`:键和值分开的形式。
|
||||
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
|
||||
*
|
||||
* @param args 命令行参数数组。
|
||||
* @return 解析后的键值对映射。
|
||||
*/
|
||||
private fun parseArguments(args: Array<String>): Map<String, List<String>> {
|
||||
val mapsArgs = mutableMapOf<String, MutableList<String>>()
|
||||
/**
|
||||
* 解析命令行参数,将其转换为键值对映射。
|
||||
*
|
||||
* 支持以下格式:
|
||||
* - `--key=value` 或 `-k=value`:键值对形式。
|
||||
* - `--key value` 或 `-k value`:键和值分开的形式。
|
||||
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
|
||||
*
|
||||
* @param args 命令行参数数组。
|
||||
* @return 解析后的键值对映射。
|
||||
*/
|
||||
private fun parseArguments(args: Array<String>): Map<String, List<String>> {
|
||||
val mapsArgs = mutableMapOf<String, MutableList<String>>()
|
||||
|
||||
var i = 0
|
||||
while (i < args.size) {
|
||||
val arg = args[i]
|
||||
var i = 0
|
||||
while (i < args.size) {
|
||||
val arg = args[i]
|
||||
|
||||
when {
|
||||
arg.startsWith("--") -> {
|
||||
// 处理 --key=value 格式
|
||||
if (arg.contains("=")) {
|
||||
val (key, value) = arg.substring(2).split("=", limit = 2)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
}
|
||||
// 处理 --key value 格式
|
||||
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||
val key = arg.substring(2)
|
||||
val value = args[i + 1]
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
i++ // 跳过下一个参数
|
||||
}
|
||||
// 处理 --flag 格式的布尔标志
|
||||
else {
|
||||
val key = arg.substring(2)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||
}
|
||||
}
|
||||
when {
|
||||
arg.startsWith("--") -> {
|
||||
// 处理 --key=value 格式
|
||||
if (arg.contains("=")) {
|
||||
val (key, value) = arg.substring(2).split("=", limit = 2)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
}
|
||||
// 处理 --key value 格式
|
||||
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||
val key = arg.substring(2)
|
||||
val value = args[i + 1]
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
i++ // 跳过下一个参数
|
||||
}
|
||||
// 处理 --flag 格式的布尔标志
|
||||
else {
|
||||
val key = arg.substring(2)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||
}
|
||||
}
|
||||
|
||||
arg.startsWith("-") -> {
|
||||
// 处理 -k=value 格式
|
||||
if (arg.contains("=")) {
|
||||
val (key, value) = arg.substring(1).split("=", limit = 2)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
}
|
||||
// 处理 -k value 格式
|
||||
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||
val key = arg.substring(1)
|
||||
val value = args[i + 1]
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
i++
|
||||
}
|
||||
// 处理 -f 格式的布尔标志
|
||||
else {
|
||||
val key = arg.substring(1)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||
}
|
||||
}
|
||||
}
|
||||
i++
|
||||
}
|
||||
arg.startsWith("-") -> {
|
||||
// 处理 -k=value 格式
|
||||
if (arg.contains("=")) {
|
||||
val (key, value) = arg.substring(1).split("=", limit = 2)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
}
|
||||
// 处理 -k value 格式
|
||||
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||
val key = arg.substring(1)
|
||||
val value = args[i + 1]
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||
i++
|
||||
}
|
||||
// 处理 -f 格式的布尔标志
|
||||
else {
|
||||
val key = arg.substring(1)
|
||||
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||
}
|
||||
}
|
||||
}
|
||||
i++
|
||||
}
|
||||
|
||||
return mapsArgs
|
||||
}
|
||||
return mapsArgs
|
||||
}
|
||||
|
||||
/**
|
||||
* 处理配置类中的字段,根据解析出的参数设置字段值。
|
||||
*
|
||||
* @param clazz 配置类的 Class 对象。
|
||||
* @param instance 配置类的实例。
|
||||
* @param mapsArgs 解析后的命令行参数映射。
|
||||
*/
|
||||
private fun <T : ConfigurationProps> processFields(
|
||||
clazz: Class<T>,
|
||||
instance: T,
|
||||
mapsArgs: Map<String, List<String>>
|
||||
) {
|
||||
val fields = clazz.declaredFields
|
||||
/**
|
||||
* 处理配置类中的字段,根据解析出的参数设置字段值。
|
||||
*
|
||||
* @param clazz 配置类的 Class 对象。
|
||||
* @param instance 配置类的实例。
|
||||
* @param mapsArgs 解析后的命令行参数映射。
|
||||
*/
|
||||
private fun <T : ConfigurationProps> processFields(
|
||||
clazz: Class<T>,
|
||||
instance: T,
|
||||
mapsArgs: Map<String, List<String>>,
|
||||
) {
|
||||
val fields = clazz.declaredFields
|
||||
|
||||
for (field in fields) {
|
||||
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||
if (configurationProp != null) {
|
||||
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||
val values = mapsArgs[fieldName]
|
||||
for (field in fields) {
|
||||
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||
if (configurationProp != null) {
|
||||
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||
val values = mapsArgs[fieldName]
|
||||
|
||||
if (values != null) {
|
||||
try {
|
||||
val setter = clazz.getDeclaredMethod(
|
||||
getSetterName(field.name),
|
||||
field.type
|
||||
)
|
||||
if (values != null) {
|
||||
try {
|
||||
val setter = clazz.getDeclaredMethod(
|
||||
getSetterName(field.name),
|
||||
field.type
|
||||
)
|
||||
|
||||
val value = convertValue(field.type, values, configurationProp)
|
||||
setter.invoke(instance, value)
|
||||
} catch (e: Exception) {
|
||||
println("Warning: Failed to set field ${field.name}: ${e.message}")
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
val value = convertValue(field.type, values, configurationProp)
|
||||
setter.invoke(instance, value)
|
||||
} catch (e: Exception) {
|
||||
println("Warning: Failed to set field ${field.name}: ${e.message}")
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 将字符串值转换为目标类型。
|
||||
*
|
||||
* @param type 目标类型。
|
||||
* @param values 字符串值列表。
|
||||
* @param annotation 配置属性注解。
|
||||
* @return 转换后的值。
|
||||
*/
|
||||
private fun convertValue(
|
||||
type: Class<*>,
|
||||
values: List<String>,
|
||||
annotation: ConfigurationProp
|
||||
): Any? {
|
||||
val lastValue = values.lastOrNull() ?: return null
|
||||
/**
|
||||
* 将字符串值转换为目标类型。
|
||||
*
|
||||
* @param type 目标类型。
|
||||
* @param values 字符串值列表。
|
||||
* @param annotation 配置属性注解。
|
||||
* @return 转换后的值。
|
||||
*/
|
||||
private fun convertValue(
|
||||
type: Class<*>,
|
||||
values: List<String>,
|
||||
annotation: ConfigurationProp,
|
||||
): Any? {
|
||||
val lastValue = values.lastOrNull() ?: return null
|
||||
|
||||
return when (type) {
|
||||
String::class.java -> lastValue
|
||||
return when (type) {
|
||||
String::class.java -> lastValue
|
||||
|
||||
Integer::class.java, Int::class.java -> try {
|
||||
lastValue.toInt()
|
||||
} catch (e: NumberFormatException) {
|
||||
println("Warning: Invalid integer value '$lastValue'")
|
||||
null
|
||||
}
|
||||
Integer::class.java, Int::class.java -> try {
|
||||
lastValue.toInt()
|
||||
} catch (e: NumberFormatException) {
|
||||
println("Warning: Invalid integer value '$lastValue'")
|
||||
null
|
||||
}
|
||||
|
||||
Long::class.java, java.lang.Long::class.java -> try {
|
||||
lastValue.toLong()
|
||||
} catch (e: NumberFormatException) {
|
||||
println("Warning: Invalid long value '$lastValue'")
|
||||
null
|
||||
}
|
||||
Long::class.java, java.lang.Long::class.java -> try {
|
||||
lastValue.toLong()
|
||||
} catch (e: NumberFormatException) {
|
||||
println("Warning: Invalid long value '$lastValue'")
|
||||
null
|
||||
}
|
||||
|
||||
Double::class.java, java.lang.Double::class.java -> try {
|
||||
lastValue.toDouble()
|
||||
} catch (e: NumberFormatException) {
|
||||
println("Warning: Invalid double value '$lastValue'")
|
||||
null
|
||||
}
|
||||
Double::class.java, java.lang.Double::class.java -> try {
|
||||
lastValue.toDouble()
|
||||
} catch (e: NumberFormatException) {
|
||||
println("Warning: Invalid double value '$lastValue'")
|
||||
null
|
||||
}
|
||||
|
||||
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
|
||||
"true", "1", "yes", "on" -> true
|
||||
"false", "0", "no", "off" -> false
|
||||
else -> {
|
||||
println("Warning: Invalid boolean value '$lastValue'")
|
||||
null
|
||||
}
|
||||
}
|
||||
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
|
||||
"true", "1", "yes", "on" -> true
|
||||
"false", "0", "no", "off" -> false
|
||||
else -> {
|
||||
println("Warning: Invalid boolean value '$lastValue'")
|
||||
null
|
||||
}
|
||||
}
|
||||
|
||||
List::class.java -> values
|
||||
List::class.java -> values
|
||||
|
||||
else -> {
|
||||
println("Warning: Unsupported type ${type.simpleName}")
|
||||
null
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
else -> {
|
||||
println("Warning: Unsupported type ${type.simpleName}")
|
||||
null
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
fun printHelp() {
|
||||
val fields = this::class.java.declaredFields
|
||||
val help = StringBuilder()
|
||||
for (field in fields) {
|
||||
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||
if (configurationProp != null && configurationProp.showHelper) {
|
||||
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||
help.append("$fieldName -> 类型: ${field.type.simpleName}")
|
||||
if (configurationProp.description.isNotEmpty()) {
|
||||
help.append(" 描述: ${configurationProp.description}")
|
||||
}
|
||||
help.append("\n")
|
||||
}
|
||||
}
|
||||
println(help)
|
||||
}
|
||||
/**
|
||||
* 打印配置项帮助信息,列出所有标注了 ConfigurationProp 且允许显示帮助的字段名称、类型和描述。
|
||||
*/
|
||||
fun printHelp() {
|
||||
val fields = this::class.java.declaredFields
|
||||
val help = StringBuilder()
|
||||
for (field in fields) {
|
||||
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||
if (configurationProp != null && configurationProp.showHelper) {
|
||||
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||
help.append("$fieldName -> Type: ${field.type.simpleName}")
|
||||
if (configurationProp.description.isNotEmpty()) {
|
||||
help.append(" Description: ${configurationProp.description}")
|
||||
}
|
||||
help.append("\n")
|
||||
}
|
||||
}
|
||||
println(help)
|
||||
}
|
||||
|
||||
val fields: Map<String, Any?>
|
||||
get() {
|
||||
val fields = this::class.java.declaredFields
|
||||
val fieldValues = mutableMapOf<String, Any?>()
|
||||
for (field in fields) {
|
||||
field.isAccessible = true
|
||||
val fieldName = field.name
|
||||
val fieldValue = field.get(this)
|
||||
fieldValues[fieldName] = fieldValue
|
||||
}
|
||||
return fieldValues
|
||||
}
|
||||
/**
|
||||
* 当前配置对象所有声明字段的名称与值的映射。
|
||||
*/
|
||||
val fields: Map<String, Any?>
|
||||
get() {
|
||||
val fields = this::class.java.declaredFields
|
||||
val fieldValues = mutableMapOf<String, Any?>()
|
||||
for (field in fields) {
|
||||
field.isAccessible = true
|
||||
val fieldName = field.name
|
||||
val fieldValue = field.get(this)
|
||||
fieldValues[fieldName] = fieldValue
|
||||
}
|
||||
return fieldValues
|
||||
}
|
||||
}
|
||||
|
||||
@@ -32,67 +32,67 @@ package com.mingliqiye.utils.data
|
||||
*/
|
||||
class ThreadLocalDataHolder<T> {
|
||||
|
||||
private val threadLocal: ThreadLocal<T?> = ThreadLocal()
|
||||
private val threadLocal: ThreadLocal<T?> = ThreadLocal()
|
||||
|
||||
/**
|
||||
* 获取当前线程存储的值
|
||||
*
|
||||
* @return 当前线程存储的值,如果没有则返回null
|
||||
*/
|
||||
fun get(): T? {
|
||||
return threadLocal.get()
|
||||
}
|
||||
/**
|
||||
* 获取当前线程存储的值
|
||||
*
|
||||
* @return 当前线程存储的值,如果没有则返回null
|
||||
*/
|
||||
fun get(): T? {
|
||||
return threadLocal.get()
|
||||
}
|
||||
|
||||
/**
|
||||
* 设置当前线程的值
|
||||
*
|
||||
* @param value 要存储的值
|
||||
*/
|
||||
fun set(value: T) {
|
||||
threadLocal.set(value)
|
||||
}
|
||||
/**
|
||||
* 设置当前线程的值
|
||||
*
|
||||
* @param value 要存储的值
|
||||
*/
|
||||
fun set(value: T) {
|
||||
threadLocal.set(value)
|
||||
}
|
||||
|
||||
/**
|
||||
* 移除当前线程存储的值
|
||||
*
|
||||
* 防止内存泄漏,使用完毕后应调用此方法清理资源。
|
||||
*/
|
||||
fun remove() {
|
||||
threadLocal.remove()
|
||||
}
|
||||
/**
|
||||
* 移除当前线程存储的值
|
||||
*
|
||||
* 防止内存泄漏,使用完毕后应调用此方法清理资源。
|
||||
*/
|
||||
fun remove() {
|
||||
threadLocal.remove()
|
||||
}
|
||||
|
||||
/**
|
||||
* 获取当前线程存储的值,如果不存在则返回默认值
|
||||
*
|
||||
* @param defaultValue 默认值
|
||||
* @return 当前线程存储的值或默认值
|
||||
*/
|
||||
fun getOrDefault(defaultValue: T): T {
|
||||
val value = threadLocal.get()
|
||||
return value ?: defaultValue
|
||||
}
|
||||
/**
|
||||
* 获取当前线程存储的值,如果不存在则返回默认值
|
||||
*
|
||||
* @param defaultValue 默认值
|
||||
* @return 当前线程存储的值或默认值
|
||||
*/
|
||||
fun getOrDefault(defaultValue: T): T {
|
||||
val value = threadLocal.get()
|
||||
return value ?: defaultValue
|
||||
}
|
||||
|
||||
/**
|
||||
* 安全获取值(避免NPE)
|
||||
*
|
||||
* 在某些异常情况下防止抛出异常,直接返回 null。
|
||||
*
|
||||
* @return 值或null
|
||||
*/
|
||||
fun safeGet(): T? {
|
||||
return try {
|
||||
threadLocal.get()
|
||||
} catch (e: Exception) {
|
||||
null
|
||||
}
|
||||
}
|
||||
/**
|
||||
* 安全获取值(避免NPE)
|
||||
*
|
||||
* 在某些异常情况下防止抛出异常,直接返回 null。
|
||||
*
|
||||
* @return 值或null
|
||||
*/
|
||||
fun safeGet(): T? {
|
||||
return try {
|
||||
threadLocal.get()
|
||||
} catch (e: Exception) {
|
||||
null
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 检查当前线程是否有值
|
||||
*
|
||||
* @return 是否有值
|
||||
*/
|
||||
fun isPresent(): Boolean {
|
||||
return threadLocal.get() != null
|
||||
}
|
||||
/**
|
||||
* 检查当前线程是否有值
|
||||
*
|
||||
* @return 是否有值
|
||||
*/
|
||||
fun isPresent(): Boolean {
|
||||
return threadLocal.get() != null
|
||||
}
|
||||
}
|
||||
|
||||
@@ -34,40 +34,40 @@ import java.lang.reflect.Field
|
||||
* @return 返回一个新的对象实例,其字段值与原对象一致。
|
||||
*/
|
||||
fun <T : Any> clone(obj: T): T {
|
||||
val clazz = obj.javaClass
|
||||
val constructor = clazz.getDeclaredConstructor().apply {
|
||||
isAccessible = true
|
||||
}
|
||||
val instance = constructor.newInstance()
|
||||
val clazz = obj.javaClass
|
||||
val constructor = clazz.getDeclaredConstructor().apply {
|
||||
isAccessible = true
|
||||
}
|
||||
val instance = constructor.newInstance()
|
||||
|
||||
// 遍历类及其父类的所有字段进行赋值
|
||||
var currentClass: Class<*>? = clazz
|
||||
while (currentClass != null) {
|
||||
currentClass.declaredFields.forEach { field ->
|
||||
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
|
||||
field.isAccessible = true
|
||||
field.set(instance, field.get(obj))
|
||||
}
|
||||
}
|
||||
currentClass = currentClass.superclass
|
||||
}
|
||||
// 遍历类及其父类的所有字段进行赋值
|
||||
var currentClass: Class<*>? = clazz
|
||||
while (currentClass != null) {
|
||||
currentClass.declaredFields.forEach { field ->
|
||||
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
|
||||
field.isAccessible = true
|
||||
field.set(instance, field.get(obj))
|
||||
}
|
||||
}
|
||||
currentClass = currentClass.superclass
|
||||
}
|
||||
|
||||
return instance
|
||||
return instance
|
||||
}
|
||||
|
||||
/**
|
||||
* 定义 DTO 拷贝行为的枚举类型。
|
||||
*/
|
||||
enum class DotCopyType {
|
||||
/**
|
||||
* 表示使用点拷贝(.copy)方式处理字段。
|
||||
*/
|
||||
DOT_COPY,
|
||||
/**
|
||||
* 表示使用点拷贝(.copy)方式处理字段。
|
||||
*/
|
||||
DOT_COPY,
|
||||
|
||||
/**
|
||||
* 表示普通拷贝方式处理字段。
|
||||
*/
|
||||
COPY
|
||||
/**
|
||||
* 表示普通拷贝方式处理字段。
|
||||
*/
|
||||
COPY
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -77,10 +77,10 @@ enum class DotCopyType {
|
||||
*/
|
||||
@Retention(AnnotationRetention.RUNTIME)
|
||||
@Target(
|
||||
AnnotationTarget.TYPE_PARAMETER,
|
||||
AnnotationTarget.VALUE_PARAMETER,
|
||||
AnnotationTarget.FIELD,
|
||||
AnnotationTarget.PROPERTY
|
||||
AnnotationTarget.TYPE_PARAMETER,
|
||||
AnnotationTarget.VALUE_PARAMETER,
|
||||
AnnotationTarget.FIELD,
|
||||
AnnotationTarget.PROPERTY
|
||||
)
|
||||
annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
|
||||
|
||||
@@ -92,40 +92,40 @@ annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
|
||||
* @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。
|
||||
*/
|
||||
fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
|
||||
val instance = dtoClass.getDeclaredConstructor().apply {
|
||||
isAccessible = true
|
||||
}.newInstance()
|
||||
val instance = dtoClass.getDeclaredConstructor().apply {
|
||||
isAccessible = true
|
||||
}.newInstance()
|
||||
|
||||
val sourceFields = getAllFields(obj.javaClass)
|
||||
val sourceFields = getAllFields(obj.javaClass)
|
||||
|
||||
for (sourceField in sourceFields) {
|
||||
sourceField.isAccessible = true
|
||||
val fieldName = sourceField.name
|
||||
val fieldValue = sourceField.get(obj)
|
||||
for (sourceField in sourceFields) {
|
||||
sourceField.isAccessible = true
|
||||
val fieldName = sourceField.name
|
||||
val fieldValue = sourceField.get(obj)
|
||||
|
||||
try {
|
||||
val targetField = dtoClass.getDeclaredField(fieldName).apply {
|
||||
isAccessible = true
|
||||
}
|
||||
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
|
||||
continue
|
||||
}
|
||||
val ta = targetField.getAnnotation(DtoCopy::class.java)
|
||||
if (ta != null) {
|
||||
if (ta.type == DotCopyType.DOT_COPY) {
|
||||
continue
|
||||
}
|
||||
}
|
||||
targetField.set(instance, fieldValue)
|
||||
try {
|
||||
val targetField = dtoClass.getDeclaredField(fieldName).apply {
|
||||
isAccessible = true
|
||||
}
|
||||
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
|
||||
continue
|
||||
}
|
||||
val ta = targetField.getAnnotation(DtoCopy::class.java)
|
||||
if (ta != null) {
|
||||
if (ta.type == DotCopyType.DOT_COPY) {
|
||||
continue
|
||||
}
|
||||
}
|
||||
targetField.set(instance, fieldValue)
|
||||
|
||||
} catch (e: NoSuchFieldException) {
|
||||
continue
|
||||
} catch (e: IllegalArgumentException) {
|
||||
continue
|
||||
}
|
||||
}
|
||||
} catch (e: NoSuchFieldException) {
|
||||
continue
|
||||
} catch (e: IllegalArgumentException) {
|
||||
continue
|
||||
}
|
||||
}
|
||||
|
||||
return instance
|
||||
return instance
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -135,12 +135,11 @@ fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
|
||||
* @return 包含所有字段的列表。
|
||||
*/
|
||||
private fun getAllFields(clazz: Class<*>): List<Field> {
|
||||
val fields = mutableListOf<Field>()
|
||||
var currentClass: Class<*>? = clazz
|
||||
while (currentClass != null && currentClass != Any::class.java) {
|
||||
fields.addAll(currentClass.declaredFields)
|
||||
currentClass = currentClass.superclass
|
||||
}
|
||||
return fields
|
||||
val fields = mutableListOf<Field>()
|
||||
var currentClass: Class<*>? = clazz
|
||||
while (currentClass != null && currentClass != Any::class.java) {
|
||||
fields.addAll(currentClass.declaredFields)
|
||||
currentClass = currentClass.superclass
|
||||
}
|
||||
return fields
|
||||
}
|
||||
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile BadGatewayException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:07:34
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Bad Gateway"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class BadGatewayException(
|
||||
override val message: String? = "Bad Gateway",
|
||||
override val cause: Throwable? = null,
|
||||
class BadGatewayException @JvmOverloads constructor(
|
||||
override val message: String? = "Bad Gateway",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(502, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile BadRequestException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Bad Request"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class BadRequestException(
|
||||
override val message: String? = "Bad Request",
|
||||
override val cause: Throwable? = null,
|
||||
class BadRequestException @JvmOverloads constructor(
|
||||
override val message: String? = "Bad Request",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(400, message, cause)
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
/*
|
||||
* 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
|
||||
|
||||
/**
|
||||
* 表示编码或解码过程中发生的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
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
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ConflictException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Conflict"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class ConflictException(
|
||||
override val message: String? = "Conflict",
|
||||
override val cause: Throwable? = null,
|
||||
class ConflictException @JvmOverloads constructor(
|
||||
override val message: String? = "Conflict",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(409, message, cause)
|
||||
|
||||
@@ -16,21 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile EmptyJsonException.kt
|
||||
* LastUpdate 2026-02-07 14:45:12
|
||||
* LastUpdate 2026-10-11 16:53:26
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
class EmptyJsonException : JsonException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 JSON 内容为空时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
class EmptyJsonException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ForbiddenException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Forbidden"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class ForbiddenException(
|
||||
override val message: String? = "Forbidden",
|
||||
override val cause: Throwable? = null,
|
||||
class ForbiddenException @JvmOverloads constructor(
|
||||
override val message: String? = "Forbidden",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(403, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile FoundException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Found"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class FoundException(
|
||||
override val message: String? = "Found",
|
||||
override val cause: Throwable? = null,
|
||||
class FoundException @JvmOverloads constructor(
|
||||
override val message: String? = "Found",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(302, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile GatewayTimeoutException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Gateway Timeout"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class GatewayTimeoutException(
|
||||
override val message: String? = "Gateway Timeout",
|
||||
override val cause: Throwable? = null,
|
||||
class GatewayTimeoutException @JvmOverloads constructor(
|
||||
override val message: String? = "Gateway Timeout",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(504, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile GoneException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Gone"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class GoneException(
|
||||
override val message: String? = "Gone",
|
||||
override val cause: Throwable? = null,
|
||||
class GoneException @JvmOverloads constructor(
|
||||
override val message: String? = "Gone",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(410, message, cause)
|
||||
|
||||
@@ -16,21 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile HttpException.kt
|
||||
* LastUpdate 2026-02-05 14:44:15
|
||||
* LastUpdate 2026-10-11 16:52:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
open class HttpException : MingLiUtilsBaseException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 HTTP 相关异常的基类,继承自 [MingLiUtilsBaseException]。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
open class HttpException @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
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile HttpStatusException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-11 17:02:06
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -29,8 +29,10 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
sealed class HttpStatusException(
|
||||
open val statusCode: Int,
|
||||
override val message: String? = null,
|
||||
override val cause: Throwable? = null
|
||||
) : MingLiUtilsBaseException(message, cause)
|
||||
open class HttpStatusException @JvmOverloads constructor(
|
||||
val statusCode: Int,
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,21 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile HttpUrlException.kt
|
||||
* LastUpdate 2026-02-05 15:21:48
|
||||
* LastUpdate 2026-10-11 16:53:00
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
open class HttpUrlException : HttpException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 HTTP URL 无效或处理失败时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
open class HttpUrlException @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
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile HttpVersionNotSupportedException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "HTTP Version Not Supported"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class HttpVersionNotSupportedException(
|
||||
override val message: String? = "HTTP Version Not Supported",
|
||||
override val cause: Throwable? = null,
|
||||
class HttpVersionNotSupportedException @JvmOverloads constructor(
|
||||
override val message: String? = "HTTP Version Not Supported",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(505, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile InternalServerErrorException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Internal Server Error"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class InternalServerErrorException(
|
||||
override val message: String? = "Internal Server Error",
|
||||
override val cause: Throwable? = null,
|
||||
class InternalServerErrorException @JvmOverloads constructor(
|
||||
override val message: String? = "Internal Server Error",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(500, message, cause)
|
||||
|
||||
@@ -16,21 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile InvalidJsonException.kt
|
||||
* LastUpdate 2026-02-07 13:18:32
|
||||
* LastUpdate 2026-10-11 16:53:31
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
class InvalidJsonException : JsonException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 JSON 内容无效或不合法时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
class InvalidJsonException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonException.kt
|
||||
* LastUpdate 2026-02-07 13:17:50
|
||||
* LastUpdate 2026-10-11 16:53:07
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -30,15 +30,9 @@ package com.mingliqiye.utils.exception
|
||||
* 2. 包含错误信息和原因(Throwable)的构造函数。
|
||||
* 3. 仅包含原因(Throwable)的构造函数。
|
||||
*/
|
||||
open class JsonException : MingLiUtilsBaseException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
open class JsonException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,21 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonObjectCastException.kt
|
||||
* LastUpdate 2026-02-07 15:11:42
|
||||
* LastUpdate 2026-10-11 16:53:36
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
class JsonObjectCastException : JsonException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 JSON 对象类型转换失败时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
class JsonObjectCastException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,21 +16,39 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonParserException.kt
|
||||
* LastUpdate 2026-02-07 14:45:12
|
||||
* LastUpdate 2026-11-17 16:22:52
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
class JsonParserException : JsonException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 JSON 解析过程中发生的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
class JsonParserException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
|
||||
/**
|
||||
* 表示 JSON 格式不正确时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
class JsonFormatException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,21 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile JsonTypeException.kt
|
||||
* LastUpdate 2026-02-07 13:28:02
|
||||
* LastUpdate 2026-10-11 16:53:45
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
class JsonTypeException : JsonException {
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* 表示 JSON 数据类型不匹配时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
class JsonTypeException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
throwable: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile LengthRequiredException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Length Required"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class LengthRequiredException(
|
||||
override val message: String? = "Length Required",
|
||||
override val cause: Throwable? = null,
|
||||
class LengthRequiredException @JvmOverloads constructor(
|
||||
override val message: String? = "Length Required",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(411, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile MethodNotAllowedException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Method Not Allowed"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class MethodNotAllowedException(
|
||||
override val message: String? = "Method Not Allowed",
|
||||
override val cause: Throwable? = null,
|
||||
class MethodNotAllowedException @JvmOverloads constructor(
|
||||
override val message: String? = "Method Not Allowed",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(405, message, cause)
|
||||
|
||||
@@ -16,22 +16,23 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile MingLiUtilsBaseException.kt
|
||||
* LastUpdate 2026-02-05 14:41:27
|
||||
* LastUpdate 2026-10-11 16:39:21
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.exception
|
||||
|
||||
open class MingLiUtilsBaseException : RuntimeException {
|
||||
|
||||
constructor()
|
||||
constructor(message: String) : super(message)
|
||||
constructor(throwable: Throwable) : super(throwable)
|
||||
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)
|
||||
}
|
||||
/**
|
||||
* mingli-utils 工具库所有异常的基类,继承自 [RuntimeException]。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param cause 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
open class MingLiUtilsBaseException @JvmOverloads constructor(
|
||||
message: String? = null,
|
||||
cause: Throwable? = null,
|
||||
enableSuppression: Boolean = false,
|
||||
writableStackTrace: Boolean = true,
|
||||
) : RuntimeException(message, cause, enableSuppression, writableStackTrace)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile MovedPermanentlyException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Moved Permanently"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class MovedPermanentlyException(
|
||||
override val message: String? = "Moved Permanently",
|
||||
override val cause: Throwable? = null,
|
||||
class MovedPermanentlyException @JvmOverloads constructor(
|
||||
override val message: String? = "Moved Permanently",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(301, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile MultipleChoicesException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Multiple Choices"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class MultipleChoicesException(
|
||||
override val message: String? = "Multiple Choices",
|
||||
override val cause: Throwable? = null,
|
||||
class MultipleChoicesException @JvmOverloads constructor(
|
||||
override val message: String? = "Multiple Choices",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(300, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile NotAcceptableException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Not Acceptable"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class NotAcceptableException(
|
||||
override val message: String? = "Not Acceptable",
|
||||
override val cause: Throwable? = null,
|
||||
class NotAcceptableException @JvmOverloads constructor(
|
||||
override val message: String? = "Not Acceptable",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(406, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile NotFoundException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Not Found"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class NotFoundException(
|
||||
override val message: String? = "Not Found",
|
||||
override val cause: Throwable? = null,
|
||||
class NotFoundException @JvmOverloads constructor(
|
||||
override val message: String? = "Not Found",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(404, message, cause)
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
/*
|
||||
* 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
|
||||
|
||||
/**
|
||||
* 表示请求的资源未找到时抛出的异常。
|
||||
*
|
||||
* @param message 异常信息,默认为 null
|
||||
* @param throwable 异常原因,默认为 null
|
||||
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||
*/
|
||||
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
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile NotImplementedException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Not Implemented"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class NotImplementedException(
|
||||
override val message: String? = "Not Implemented",
|
||||
override val cause: Throwable? = null,
|
||||
class NotImplementedException @JvmOverloads constructor(
|
||||
override val message: String? = "Not Implemented",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(501, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile NotModifiedException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Not Modified"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class NotModifiedException(
|
||||
override val message: String? = "Not Modified",
|
||||
override val cause: Throwable? = null,
|
||||
class NotModifiedException @JvmOverloads constructor(
|
||||
override val message: String? = "Not Modified",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(304, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile PaymentRequiredException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Payment Required"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class PaymentRequiredException(
|
||||
override val message: String? = "Payment Required",
|
||||
override val cause: Throwable? = null,
|
||||
class PaymentRequiredException @JvmOverloads constructor(
|
||||
override val message: String? = "Payment Required",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(402, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile PreconditionFailedException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Precondition Failed"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class PreconditionFailedException(
|
||||
override val message: String? = "Precondition Failed",
|
||||
override val cause: Throwable? = null,
|
||||
class PreconditionFailedException @JvmOverloads constructor(
|
||||
override val message: String? = "Precondition Failed",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(412, message, cause)
|
||||
|
||||
+4
-4
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ProxyAuthenticationRequiredException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Proxy Authentication Required"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class ProxyAuthenticationRequiredException(
|
||||
override val message: String? = "Proxy Authentication Required",
|
||||
override val cause: Throwable? = null,
|
||||
class ProxyAuthenticationRequiredException @JvmOverloads constructor(
|
||||
override val message: String? = "Proxy Authentication Required",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(407, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile RequestEntityTooLargeException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Request Entity Too Large"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class RequestEntityTooLargeException(
|
||||
override val message: String? = "Request Entity Too Large",
|
||||
override val cause: Throwable? = null,
|
||||
class RequestEntityTooLargeException @JvmOverloads constructor(
|
||||
override val message: String? = "Request Entity Too Large",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(413, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile RequestTimeoutException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Request Timeout"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class RequestTimeoutException(
|
||||
override val message: String? = "Request Timeout",
|
||||
override val cause: Throwable? = null,
|
||||
class RequestTimeoutException @JvmOverloads constructor(
|
||||
override val message: String? = "Request Timeout",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(408, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile RequestUriTooLargeException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Request URI Too Large"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class RequestUriTooLargeException(
|
||||
override val message: String? = "Request URI Too Large",
|
||||
override val cause: Throwable? = null,
|
||||
class RequestUriTooLargeException @JvmOverloads constructor(
|
||||
override val message: String? = "Request URI Too Large",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(414, message, cause)
|
||||
|
||||
+4
-4
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile RequestedRangeNotSatisfiableException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Requested Range Not Satisfiable"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class RequestedRangeNotSatisfiableException(
|
||||
override val message: String? = "Requested Range Not Satisfiable",
|
||||
override val cause: Throwable? = null,
|
||||
class RequestedRangeNotSatisfiableException @JvmOverloads constructor(
|
||||
override val message: String? = "Requested Range Not Satisfiable",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(416, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile SeeOtherException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "See Other"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class SeeOtherException(
|
||||
override val message: String? = "See Other",
|
||||
override val cause: Throwable? = null,
|
||||
class SeeOtherException @JvmOverloads constructor(
|
||||
override val message: String? = "See Other",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(303, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ServiceUnavailableException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Service Unavailable"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class ServiceUnavailableException(
|
||||
override val message: String? = "Service Unavailable",
|
||||
override val cause: Throwable? = null,
|
||||
class ServiceUnavailableException @JvmOverloads constructor(
|
||||
override val message: String? = "Service Unavailable",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(503, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile TemporaryRedirectException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Temporary Redirect"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class TemporaryRedirectException(
|
||||
override val message: String? = "Temporary Redirect",
|
||||
override val cause: Throwable? = null,
|
||||
class TemporaryRedirectException @JvmOverloads constructor(
|
||||
override val message: String? = "Temporary Redirect",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(307, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile UnauthorizedException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Unauthorized"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class UnauthorizedException(
|
||||
override val message: String? = "Unauthorized",
|
||||
override val cause: Throwable? = null,
|
||||
class UnauthorizedException @JvmOverloads constructor(
|
||||
override val message: String? = "Unauthorized",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(401, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile UnsupportedMediaTypeException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:19
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Unsupported Media Type"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class UnsupportedMediaTypeException(
|
||||
override val message: String? = "Unsupported Media Type",
|
||||
override val cause: Throwable? = null,
|
||||
class UnsupportedMediaTypeException @JvmOverloads constructor(
|
||||
override val message: String? = "Unsupported Media Type",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(415, message, cause)
|
||||
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile UseProxyException.kt
|
||||
* LastUpdate 2026-02-05 14:55:04
|
||||
* LastUpdate 2026-10-22 22:09:48
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
@@ -28,7 +28,7 @@ package com.mingliqiye.utils.exception
|
||||
* @param message 异常信息,默认为 "Use Proxy"
|
||||
* @param cause 异常原因,默认为 null
|
||||
*/
|
||||
class UseProxyException(
|
||||
override val message: String? = "Use Proxy",
|
||||
override val cause: Throwable? = null,
|
||||
class UseProxyException @JvmOverloads constructor(
|
||||
override val message: String? = "Use Proxy",
|
||||
override val cause: Throwable? = null,
|
||||
) : HttpStatusException(305, message, cause)
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2025 mingliqiye
|
||||
* 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.
|
||||
@@ -16,7 +16,7 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile ForEach.kt
|
||||
* LastUpdate 2025-09-15 12:44:46
|
||||
* LastUpdate 2026-02-27 12:45:39
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
@file:JvmName("ForEach")
|
||||
@@ -35,36 +35,34 @@ import com.mingliqiye.utils.functions.*
|
||||
* @param <T> 可迭代对象中元素的类型
|
||||
*/
|
||||
fun <T> forEach(
|
||||
iterable: Iterable<T>, action: P2Function<in T, in Int>
|
||||
iterable: Iterable<T>, action: P2Function<in T, in Int>,
|
||||
) {
|
||||
when (iterable) {
|
||||
is RandomAccess if iterable is MutableList<*> -> {
|
||||
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
action.call(list[i], i)
|
||||
}
|
||||
}
|
||||
when (iterable) {
|
||||
is RandomAccess if iterable is MutableList<*> -> {
|
||||
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
action.call(list[i], i)
|
||||
}
|
||||
}
|
||||
|
||||
is MutableList<*> -> {
|
||||
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
||||
var index = 0
|
||||
val it = iterable.iterator()
|
||||
while (it.hasNext()) {
|
||||
action.call(it.next(), index)
|
||||
index++
|
||||
}
|
||||
}
|
||||
is MutableList<*> -> {
|
||||
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
||||
var index = 0
|
||||
val it = iterable.iterator()
|
||||
while (it.hasNext()) {
|
||||
action.call(it.next(), index)
|
||||
index++
|
||||
}
|
||||
}
|
||||
|
||||
else -> {
|
||||
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
||||
var index = 0
|
||||
for (element in iterable) {
|
||||
action.call(element, index)
|
||||
index++
|
||||
}
|
||||
}
|
||||
}
|
||||
else -> {
|
||||
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
||||
for ((index, element) in iterable.withIndex()) {
|
||||
action.call(element, index)
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -76,20 +74,20 @@ fun <T> forEach(
|
||||
* @param <T> 可迭代对象中元素的类型
|
||||
*/
|
||||
fun <T> forEach(
|
||||
iterable: Iterable<T>, action: P1Function<in T>
|
||||
iterable: Iterable<T>, action: P1Function<in T>,
|
||||
) {
|
||||
if (iterable is RandomAccess) {
|
||||
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
action.call(list[i])
|
||||
}
|
||||
} else {
|
||||
// 否则使用增强 for 循环进行遍历
|
||||
for (element in iterable) {
|
||||
action.call(element)
|
||||
}
|
||||
}
|
||||
if (iterable is RandomAccess) {
|
||||
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
action.call(list[i])
|
||||
}
|
||||
} else {
|
||||
// 否则使用增强 for 循环进行遍历
|
||||
for (element in iterable) {
|
||||
action.call(element)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -102,36 +100,36 @@ fun <T> forEach(
|
||||
* @param <T> 可迭代对象中元素的类型
|
||||
*/
|
||||
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) {
|
||||
is RandomAccess if iterable is MutableList<*> -> {
|
||||
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
if (action.call(list[i], i)) return
|
||||
}
|
||||
}
|
||||
when (iterable) {
|
||||
is RandomAccess if iterable is MutableList<*> -> {
|
||||
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
if (action.call(list[i], i)) return
|
||||
}
|
||||
}
|
||||
|
||||
is MutableList<*> -> {
|
||||
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
||||
var index = 0
|
||||
val it = iterable.iterator()
|
||||
while (it.hasNext()) {
|
||||
if (action.call(it.next(), index)) return
|
||||
index++
|
||||
}
|
||||
}
|
||||
is MutableList<*> -> {
|
||||
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
||||
var index = 0
|
||||
val it = iterable.iterator()
|
||||
while (it.hasNext()) {
|
||||
if (action.call(it.next(), index)) return
|
||||
index++
|
||||
}
|
||||
}
|
||||
|
||||
else -> {
|
||||
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
||||
var index = 0
|
||||
for (element in iterable) {
|
||||
if (action.call(element, index)) return
|
||||
index++
|
||||
}
|
||||
}
|
||||
}
|
||||
else -> {
|
||||
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
||||
var index = 0
|
||||
for (element in iterable) {
|
||||
if (action.call(element, index)) return
|
||||
index++
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -144,20 +142,20 @@ fun <T> forEachB(
|
||||
* @param <T> 可迭代对象中元素的类型
|
||||
*/
|
||||
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) {
|
||||
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
if (action.call(list[i])) return
|
||||
}
|
||||
} else {
|
||||
// 否则使用增强 for 循环进行遍历
|
||||
for (element in iterable) {
|
||||
if (action.call(element)) return
|
||||
}
|
||||
}
|
||||
if (iterable is RandomAccess) {
|
||||
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
||||
val list = iterable as MutableList<T>
|
||||
for (i in list.indices) {
|
||||
if (action.call(list[i])) return
|
||||
}
|
||||
} else {
|
||||
// 否则使用增强 for 循环进行遍历
|
||||
for (element in iterable) {
|
||||
if (action.call(element)) return
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -168,9 +166,9 @@ fun <T> forEachB(
|
||||
* @param <T> 数组中元素的类型
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -181,9 +179,9 @@ fun <T> forEach(
|
||||
* @param <T> 数组中元素的类型
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -195,9 +193,9 @@ fun <T> forEach(
|
||||
* @param <T> 数组中元素的类型
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -209,9 +207,9 @@ fun <T> forEachB(
|
||||
* @param <T> 数组中元素的类型
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -221,9 +219,9 @@ fun <T> forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -233,9 +231,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: ByteArray, action: P1Function<in Byte>
|
||||
array: ByteArray, action: P1Function<in Byte>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -246,9 +244,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -259,9 +257,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -271,9 +269,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -283,9 +281,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: CharArray, action: P1Function<in Char>
|
||||
array: CharArray, action: P1Function<in Char>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -296,9 +294,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -309,9 +307,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -321,9 +319,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -333,9 +331,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: IntArray, action: P1Function<in Int>
|
||||
array: IntArray, action: P1Function<in Int>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -346,9 +344,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -359,9 +357,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -371,9 +369,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -383,9 +381,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: LongArray, action: P1Function<in Long>
|
||||
array: LongArray, action: P1Function<in Long>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -396,9 +394,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -409,9 +407,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -421,9 +419,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -433,9 +431,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: ShortArray, action: P1Function<in Short>
|
||||
array: ShortArray, action: P1Function<in Short>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -446,9 +444,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -459,9 +457,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -471,9 +469,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -483,9 +481,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: FloatArray, action: P1Function<in Float>
|
||||
array: FloatArray, action: P1Function<in Float>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -496,9 +494,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -509,9 +507,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -521,9 +519,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -533,9 +531,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: DoubleArray, action: P1Function<in Double>
|
||||
array: DoubleArray, action: P1Function<in Double>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -546,9 +544,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -559,9 +557,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -571,9 +569,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -583,9 +581,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||
*/
|
||||
fun forEach(
|
||||
array: BooleanArray, action: P1Function<in Boolean>
|
||||
array: BooleanArray, action: P1Function<in Boolean>,
|
||||
) {
|
||||
forEach(array.toList(), action)
|
||||
forEach(array.toList(), action)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -596,9 +594,9 @@ fun forEach(
|
||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -609,9 +607,9 @@ fun forEachB(
|
||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||
*/
|
||||
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)
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -625,9 +623,9 @@ fun forEachB(
|
||||
* @param <A> 集合的具体类型
|
||||
*/
|
||||
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) })
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -641,9 +639,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
|
||||
* @param <A> 映射的具体类型
|
||||
*/
|
||||
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) })
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -656,9 +654,9 @@ fun <K, V, A : Map<K, V>> forEachB(
|
||||
* @param <A> 集合的具体类型
|
||||
*/
|
||||
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) })
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -671,9 +669,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
|
||||
* @param <A> 映射的具体类型
|
||||
*/
|
||||
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) })
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -687,9 +685,9 @@ fun <K, V, A : Map<K, V>> forEachMap(
|
||||
* @param <A> 集合的具体类型
|
||||
*/
|
||||
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) })
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -703,7 +701,7 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
|
||||
* @param <A> 映射的具体类型
|
||||
*/
|
||||
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,12 +16,13 @@
|
||||
* ProjectName mingli-utils
|
||||
* ModuleName mingli-utils.main
|
||||
* CurrentFile Debouncer.kt
|
||||
* LastUpdate 2026-01-11 09:10:30
|
||||
* LastUpdate 2026-05-23 10:30:38
|
||||
* UpdateUser MingLiPro
|
||||
*/
|
||||
|
||||
package com.mingliqiye.utils.functions
|
||||
|
||||
import com.mingliqiye.utils.netty.NamedThreadFactory
|
||||
import java.util.concurrent.*
|
||||
|
||||
/**
|
||||
@@ -31,51 +32,53 @@ import java.util.concurrent.*
|
||||
*/
|
||||
class Debouncer(private val delay: Long, unit: TimeUnit) {
|
||||
|
||||
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor()
|
||||
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
|
||||
private val delayMillis: Long = unit.toMillis(delay)
|
||||
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor(
|
||||
NamedThreadFactory { clazz, poolNumber, threadNumber ->
|
||||
"Debouncer-$poolNumber-$threadNumber"
|
||||
}
|
||||
)
|
||||
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
|
||||
private val delayMillis: Long = unit.toMillis(delay)
|
||||
|
||||
/**
|
||||
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
|
||||
*
|
||||
* @param key 任务的唯一标识符,用于区分不同任务
|
||||
* @param task 要执行的任务
|
||||
*/
|
||||
fun debounce(key: Any, task: Runnable) {
|
||||
// 提交新任务并获取之前可能存在的任务
|
||||
val prev = delayedMap.put(
|
||||
key,
|
||||
scheduler.schedule(
|
||||
{
|
||||
try {
|
||||
task.run()
|
||||
} finally {
|
||||
// 任务执行完成后从映射中移除
|
||||
delayedMap.remove(key)
|
||||
}
|
||||
},
|
||||
delayMillis,
|
||||
TimeUnit.MILLISECONDS
|
||||
)
|
||||
)
|
||||
/**
|
||||
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
|
||||
*
|
||||
* @param key 任务的唯一标识符,用于区分不同任务
|
||||
* @param task 要执行的任务
|
||||
*/
|
||||
fun debounce(key: Any, task: Runnable) {
|
||||
// 提交新任务并获取之前可能存在的任务
|
||||
val prev = delayedMap.put(
|
||||
key,
|
||||
scheduler.schedule(
|
||||
{
|
||||
try {
|
||||
task.run()
|
||||
} finally {
|
||||
// 任务执行完成后从映射中移除
|
||||
delayedMap.remove(key)
|
||||
}
|
||||
},
|
||||
delayMillis,
|
||||
TimeUnit.MILLISECONDS
|
||||
)
|
||||
)
|
||||
|
||||
// 如果之前存在任务,则取消它
|
||||
if (prev != null) {
|
||||
prev.cancel(true)
|
||||
}
|
||||
}
|
||||
// 如果之前存在任务,则取消它
|
||||
prev?.cancel(true)
|
||||
}
|
||||
|
||||
/**
|
||||
* 关闭防抖器,取消所有待执行的任务并关闭调度器
|
||||
*/
|
||||
fun shutdown() {
|
||||
// 先取消所有延迟任务
|
||||
for (future in delayedMap.values) {
|
||||
future.cancel(true)
|
||||
}
|
||||
delayedMap.clear()
|
||||
/**
|
||||
* 关闭防抖器,取消所有待执行的任务并关闭调度器
|
||||
*/
|
||||
fun shutdown() {
|
||||
// 先取消所有延迟任务
|
||||
for (future in delayedMap.values) {
|
||||
future.cancel(true)
|
||||
}
|
||||
delayedMap.clear()
|
||||
|
||||
// 再关闭调度器
|
||||
scheduler.shutdownNow()
|
||||
}
|
||||
// 再关闭调度器
|
||||
scheduler.shutdownNow()
|
||||
}
|
||||
}
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user