Compare commits
11
Commits
eaf7ee7a31
...
5.5.1
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
51eb838a36
|
||
|
|
d0887ea1f7
|
||
|
|
16da482de7
|
||
|
|
aa83f575b1
|
||
|
|
510ff69e2c
|
||
|
|
184db461d7
|
||
|
|
535c03d14a
|
||
|
|
5714aef444
|
||
|
|
7a3bc01b11
|
||
|
|
792ddf0255
|
||
|
|
f4025cbad9 |
@@ -0,0 +1,44 @@
|
|||||||
|
# Changelog
|
||||||
|
|
||||||
|
本文件记录 mingli-utils 各版本的主要变更。
|
||||||
|
|
||||||
|
## [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 缩进并补全尾随逗号。
|
||||||
+186
-160
@@ -13,27 +13,52 @@
|
|||||||
* See the License for the specific language governing permissions and
|
* See the License for the specific language governing permissions and
|
||||||
* limitations under the License.
|
* limitations under the License.
|
||||||
*
|
*
|
||||||
* ProjectName FastBaseMapper.kt
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils
|
* ModuleName mingli-utils
|
||||||
* CurrentFile build.gradle.kts
|
* CurrentFile build.gradle.kts
|
||||||
* LastUpdate 2026-10-26 23:22:18
|
* LastUpdate 2026-11-17 10:19:02
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
import java.time.LocalDateTime
|
import java.time.LocalDateTime
|
||||||
import java.time.format.DateTimeFormatter
|
import java.time.format.DateTimeFormatter
|
||||||
|
import kotlin.math.sign
|
||||||
|
|
||||||
|
/*
|
||||||
|
* 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 {
|
plugins {
|
||||||
idea
|
idea
|
||||||
java
|
java
|
||||||
signing
|
signing
|
||||||
`java-library`
|
`java-library`
|
||||||
`maven-publish`
|
`maven-publish`
|
||||||
kotlin("jvm") version "2.2.20"
|
kotlin("jvm") version "2.2.20"
|
||||||
kotlin("kapt") version "2.2.20"
|
kotlin("kapt") version "2.2.20"
|
||||||
id("org.jetbrains.dokka") version "2.1.0"
|
id("org.jetbrains.dokka") version "2.1.0"
|
||||||
id("org.jetbrains.dokka-javadoc") version "2.1.0"
|
id("org.jetbrains.dokka-javadoc") version "2.1.0"
|
||||||
kotlin("plugin.spring") version "2.1.0"
|
kotlin("plugin.spring") version "2.1.0"
|
||||||
}
|
}
|
||||||
val GROUPSID = project.properties["GROUPSID"] as String
|
val GROUPSID = project.properties["GROUPSID"] as String
|
||||||
val VERSIONS = project.properties["VERSIONS"] as String
|
val VERSIONS = project.properties["VERSIONS"] as String
|
||||||
@@ -45,204 +70,205 @@ group = GROUPSID
|
|||||||
version = VERSIONS
|
version = VERSIONS
|
||||||
|
|
||||||
base {
|
base {
|
||||||
archivesName.set(ARTIFACTID)
|
archivesName.set(ARTIFACTID)
|
||||||
}
|
}
|
||||||
|
|
||||||
val buildDir: java.nio.file.Path = File("build").toPath()
|
val buildDir: java.nio.file.Path = File("build").toPath()
|
||||||
|
|
||||||
java {
|
java {
|
||||||
toolchain.languageVersion.set(JavaLanguageVersion.of(JDKVERSIONS))
|
toolchain.languageVersion.set(JavaLanguageVersion.of(JDKVERSIONS))
|
||||||
withSourcesJar()
|
withSourcesJar()
|
||||||
}
|
}
|
||||||
kotlin {
|
kotlin {
|
||||||
jvmToolchain(JDKVERSIONS)
|
jvmToolchain(JDKVERSIONS)
|
||||||
}
|
}
|
||||||
|
|
||||||
repositories {
|
repositories {
|
||||||
mavenLocal()
|
mavenLocal()
|
||||||
maven {
|
maven {
|
||||||
url = uri("https://maven.mingliqiye.com/")
|
name = "mingliqiye-public"
|
||||||
}
|
url = uri("https://repository.mingliqiye.com/repository/maven-public/")
|
||||||
mavenCentral()
|
}
|
||||||
|
mavenCentral()
|
||||||
}
|
}
|
||||||
dependencies {
|
dependencies {
|
||||||
implementation("org.slf4j:slf4j-api:2.0.17")
|
implementation("org.slf4j:slf4j-api:2.0.17")
|
||||||
implementation(kotlin("reflect"))
|
implementation(kotlin("reflect"))
|
||||||
api("com.mingliqiye.utils.aliasfor:alias-for:1.0.1")
|
api("com.mingliqiye.utils.aliasfor:alias-for:1.0.1")
|
||||||
compileOnly("org.mindrot:jbcrypt:0.4")
|
compileOnly("org.mindrot:jbcrypt:0.4")
|
||||||
compileOnly("com.squareup.okhttp3:okhttp:5.3.2")
|
compileOnly("com.squareup.okhttp3:okhttp:5.3.2")
|
||||||
compileOnly("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
compileOnly("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
||||||
compileOnly("com.fasterxml.jackson.module:jackson-module-kotlin: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:spring-context:5.3.0")
|
||||||
compileOnly("org.springframework.boot:spring-boot-autoconfigure:2.7.16")
|
compileOnly("org.springframework.boot:spring-boot-autoconfigure:2.7.16")
|
||||||
compileOnly("tools.jackson.core:jackson-databind:3.1.0")
|
compileOnly("tools.jackson.core:jackson-databind:3.1.0")
|
||||||
compileOnly(fileTree("libs"))
|
compileOnly(fileTree("libs"))
|
||||||
compileOnly("com.google.code.gson:gson:2.13.2")
|
compileOnly("com.google.code.gson:gson:2.13.2")
|
||||||
compileOnly("org.mybatis:mybatis:3.5.19")
|
compileOnly("org.mybatis:mybatis:3.5.19")
|
||||||
compileOnly("io.netty:netty-all:4.2.15.Final")
|
compileOnly("io.netty:netty-all:4.2.15.Final")
|
||||||
compileOnly("com.baomidou:mybatis-plus-core:3.5.15")
|
compileOnly("com.baomidou:mybatis-plus-core:3.5.15")
|
||||||
compileOnly("net.java.dev.jna:jna:5.17.0")
|
compileOnly("net.java.dev.jna:jna:5.17.0")
|
||||||
compileOnly("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8")
|
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-extension:3.5.15")
|
||||||
compileOnly("com.baomidou:mybatis-plus-jsqlparser:3.5.15")
|
compileOnly("com.baomidou:mybatis-plus-jsqlparser:3.5.15")
|
||||||
testImplementation("org.junit.jupiter:junit-jupiter:5.7.1")
|
compileOnly("com.baomidou:mybatis-plus-spring:3.5.9")
|
||||||
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
|
testImplementation("org.junit.jupiter:junit-jupiter:5.7.1")
|
||||||
testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.9")
|
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
|
||||||
testImplementation("com.google.code.gson:gson:2.13.2")
|
testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.9")
|
||||||
|
testImplementation("com.google.code.gson:gson:2.13.2")
|
||||||
|
|
||||||
testImplementation("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
testImplementation("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
||||||
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
|
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
|
||||||
|
|
||||||
testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0")
|
testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0")
|
||||||
testImplementation("tools.jackson.core:jackson-databind:3.1.0")
|
testImplementation("tools.jackson.core:jackson-databind:3.1.0")
|
||||||
testImplementation(kotlin("test"))
|
testImplementation(kotlin("test"))
|
||||||
}
|
}
|
||||||
|
|
||||||
repositories {
|
repositories {
|
||||||
mavenLocal()
|
mavenLocal()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
tasks.withType<JavaCompile>().configureEach {
|
tasks.withType<JavaCompile>().configureEach {
|
||||||
options.encoding = "UTF-8"
|
options.encoding = "UTF-8"
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.named<Test>("test") {
|
tasks.named<Test>("test") {
|
||||||
useJUnitPlatform()
|
useJUnitPlatform()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
tasks.withType<JavaExec> {
|
tasks.withType<JavaExec> {
|
||||||
jvmArgs(
|
jvmArgs(
|
||||||
"-Dfile.encoding=UTF-8", "-Dsun.stdout.encoding=UTF-8", "-Dsun.stderr.encoding=UTF-8"
|
"-Dfile.encoding=UTF-8", "-Dsun.stdout.encoding=UTF-8", "-Dsun.stderr.encoding=UTF-8"
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
kapt {
|
kapt {
|
||||||
arguments {
|
arguments {
|
||||||
arg(
|
arg(
|
||||||
"kapt.kotlin.generated",
|
"kapt.kotlin.generated",
|
||||||
project.layout.buildDirectory.dir("generated/source/kapt/main").get().asFile.absolutePath
|
project.layout.buildDirectory.dir("generated/source/kapt/main").get().asFile.absolutePath
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.withType<org.gradle.jvm.tasks.Jar> {
|
tasks.withType<org.gradle.jvm.tasks.Jar> {
|
||||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||||
from("LICENSE") { into("META-INF") }
|
from("LICENSE") { into("META-INF") }
|
||||||
from("NOTICE") { into("META-INF") }
|
from("NOTICE") { into("META-INF") }
|
||||||
manifest {
|
manifest {
|
||||||
attributes(
|
attributes(
|
||||||
mapOf(
|
mapOf(
|
||||||
"Main-Class" to "com.mingliqiye.utils.main.Main",
|
"Main-Class" to "com.mingliqiye.utils.main.Main",
|
||||||
"Specification-Title" to ARTIFACTID,
|
"Specification-Title" to ARTIFACTID,
|
||||||
"Specification-Version" to VERSIONS,
|
"Specification-Version" to VERSIONS,
|
||||||
"Specification-Vendor" to "minglipro",
|
"Specification-Vendor" to "minglipro",
|
||||||
"Specification-Build-Time" to LocalDateTime.now()
|
"Specification-Build-Time" to LocalDateTime.now()
|
||||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")),
|
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")),
|
||||||
"Specification-Package" to GROUPSID,
|
"Specification-Package" to GROUPSID,
|
||||||
"Specification-Build-Number" to "1",
|
"Specification-Build-Number" to "1",
|
||||||
"Specification-Build-OS" to System.getProperty("os.name"),
|
"Specification-Build-OS" to System.getProperty("os.name"),
|
||||||
"Specification-Build-Java" to System.getProperty("java.version"),
|
"Specification-Build-Java" to System.getProperty("java.version"),
|
||||||
"Specification-Build-Java-Vendor" to System.getProperty("java.vendor"),
|
"Specification-Build-Java-Vendor" to System.getProperty("java.vendor"),
|
||||||
"Specification-Build-Java-Vendor-URL" to System.getProperty("java.vendor.url"),
|
"Specification-Build-Java-Vendor-URL" to System.getProperty("java.vendor.url"),
|
||||||
"Implementation-Title" to ARTIFACTID,
|
"Implementation-Title" to ARTIFACTID,
|
||||||
"Implementation-Version" to VERSIONS,
|
"Implementation-Version" to VERSIONS,
|
||||||
"Implementation-Package" to GROUPSID,
|
"Implementation-Package" to GROUPSID,
|
||||||
"Implementation-Vendor" to "minglipro",
|
"Implementation-Vendor" to "minglipro",
|
||||||
"Implementation-Build-Time" to LocalDateTime.now()
|
"Implementation-Build-Time" to LocalDateTime.now()
|
||||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
|
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
|
||||||
|
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
val isJdk8Build = project.findProperty("buildForJdk8") == "true"
|
val isJdk8Build = project.findProperty("buildForJdk8") == "true"
|
||||||
|
|
||||||
tasks.register<Jar>("javaDocJar") {
|
|
||||||
group = "build"
|
dokka {
|
||||||
archiveClassifier.set("javadoc-dec")
|
pluginsConfiguration.html {
|
||||||
dependsOn("dokkaGeneratePublicationJavadoc")
|
customAssets.from("logo.png")
|
||||||
from(buildDir.resolve("dokka/javadoc"))
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
tasks.register<Jar>("javaDocJar") {
|
||||||
|
group = "build"
|
||||||
|
archiveClassifier.set("javadoc")
|
||||||
|
dependsOn("dokkaGenerateJavadoc")
|
||||||
|
from(buildDir.resolve("dokka/javadoc"))
|
||||||
|
}
|
||||||
|
|
||||||
tasks.register<Jar>("kotlinDocJar") {
|
tasks.register<Jar>("kotlinDocJar") {
|
||||||
group = "build"
|
group = "build"
|
||||||
archiveClassifier.set("javadoc")
|
archiveClassifier.set("kotlindoc")
|
||||||
dependsOn("dokkaGeneratePublicationHtml")
|
dependsOn("dokkaGeneratePublicationHtml")
|
||||||
from(buildDir.resolve("dokka/html"))
|
from(buildDir.resolve("dokka/html"))
|
||||||
}
|
}
|
||||||
publishing {
|
publishing {
|
||||||
repositories {
|
publications {
|
||||||
maven {
|
create<MavenPublication>("mavenJava") {
|
||||||
name = "mingliqiye"
|
from(components["java"])
|
||||||
url = uri("https://repository.mingliqiye.com/repository/maven")
|
artifact(tasks.named("javaDocJar"))
|
||||||
credentials {
|
artifact(tasks.named("kotlinDocJar"))
|
||||||
username = System.getenv("mingliqiye.username")
|
artifactId = ARTIFACTID
|
||||||
password = System.getenv("mingliqiye.password")
|
pom {
|
||||||
}
|
name = "mingli-utils"
|
||||||
}
|
url = "https://mingli-utils.mingliqiye.com"
|
||||||
}
|
description = "A Java/kotlin Utils"
|
||||||
publications {
|
licenses {
|
||||||
create<MavenPublication>("mavenJava") {
|
license {
|
||||||
from(components["java"])
|
name = "The Apache License, Version 2.0"
|
||||||
artifact(tasks.named("kotlinDocJar"))
|
url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
|
||||||
artifactId = ARTIFACTID
|
}
|
||||||
pom {
|
}
|
||||||
name = "mingli-utils"
|
developers {
|
||||||
url = "https://mingli-utils.mingliqiye.com"
|
developer {
|
||||||
description = "A Java/kotlin Utils"
|
id = "minglipro"
|
||||||
licenses {
|
name = "mingli"
|
||||||
license {
|
email = "minglipro@163.com"
|
||||||
name = "The Apache License, Version 2.0"
|
}
|
||||||
url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
|
}
|
||||||
}
|
scm {
|
||||||
}
|
connection = "scm:git:https://git.mingliqiye.com/minglipro/mingli-utils.git"
|
||||||
developers {
|
developerConnection = "scm:git:https://git.mingliqiye.com:minglipro/mingli-utils.git"
|
||||||
developer {
|
url = "https://git.mingliqiye.com/minglipro/mingli-utils"
|
||||||
id = "minglipro"
|
}
|
||||||
name = "mingli"
|
}
|
||||||
email = "minglipro@163.com"
|
}
|
||||||
}
|
}
|
||||||
}
|
signing {
|
||||||
scm {
|
sign(publishing.publications)
|
||||||
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 {
|
tasks.build {
|
||||||
dependsOn("javaDocJar", "kotlinDocJar")
|
dependsOn("javaDocJar", "kotlinDocJar")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
tasks.processResources {
|
tasks.processResources {
|
||||||
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
duplicatesStrategy = DuplicatesStrategy.EXCLUDE
|
||||||
outputs.upToDateWhen { false }
|
outputs.upToDateWhen { false }
|
||||||
filesMatching(listOf("META-INF/meta-data", "fabric.mod.json")) {
|
filesMatching(listOf("META-INF/meta-data", "fabric.mod.json")) {
|
||||||
expand(
|
expand(
|
||||||
project.properties + mapOf(
|
project.properties + mapOf(
|
||||||
"buildTime" to LocalDateTime.now().format(
|
"buildTime" to LocalDateTime.now().format(
|
||||||
DateTimeFormatter.ofPattern(
|
DateTimeFormatter.ofPattern(
|
||||||
"yyyy-MM-dd HH:mm:ss.SSSSSSS"
|
"yyyy-MM-dd HH:mm:ss.SSSSSSS"
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
signing {
|
signing {
|
||||||
val secretKeyRingFile = System.getenv("SIGNING_SECRET_KEY_RING_FILE")
|
val secretKeyRingFile = System.getenv("SIGNING_SECRET_KEY_RING_FILE")
|
||||||
val keyId = System.getenv("SIGNING_KEY_ID")
|
val keyId = System.getenv("SIGNING_KEY_ID")
|
||||||
useGpgCmd()
|
useGpgCmd()
|
||||||
project.ext.set("signing.secretKeyRingFile", secretKeyRingFile)
|
project.ext.set("signing.secretKeyRingFile", secretKeyRingFile)
|
||||||
project.ext.set("signing.keyId", keyId)
|
project.ext.set("signing.keyId", keyId)
|
||||||
project.ext.set("signing.password", "")
|
project.ext.set("signing.password", "")
|
||||||
}
|
}
|
||||||
|
|||||||
+3
-3
@@ -13,13 +13,13 @@
|
|||||||
# See the License for the specific language governing permissions and
|
# See the License for the specific language governing permissions and
|
||||||
# limitations under the License.
|
# limitations under the License.
|
||||||
#
|
#
|
||||||
# ProjectName FastBaseMapper.kt
|
# ProjectName mingli-utils
|
||||||
# ModuleName mingli-utils
|
# ModuleName mingli-utils
|
||||||
# CurrentFile gradle.properties
|
# CurrentFile gradle.properties
|
||||||
# LastUpdate 2026-10-26 23:22:18
|
# LastUpdate 2026-11-17 09:07:20
|
||||||
# UpdateUser MingLiPro
|
# UpdateUser MingLiPro
|
||||||
#
|
#
|
||||||
JDKVERSIONS=17
|
JDKVERSIONS=17
|
||||||
GROUPSID=com.mingliqiye.utils
|
GROUPSID=com.mingliqiye.utils
|
||||||
ARTIFACTID=mingli-utils
|
ARTIFACTID=mingli-utils
|
||||||
VERSIONS=5.3.6
|
VERSIONS=5.5.1
|
||||||
|
|||||||
Binary file not shown.
@@ -26,7 +26,16 @@ import tools.jackson.databind.ObjectMapper;
|
|||||||
import tools.jackson.databind.cfg.MapperBuilder;
|
import tools.jackson.databind.cfg.MapperBuilder;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Jackson 3 API 的 Java 辅助类,用于在 Java 侧调用 Kotlin 内联/受限 API。
|
||||||
|
*/
|
||||||
public class Jackson3ApiJavaHelper {
|
public class Jackson3ApiJavaHelper {
|
||||||
|
/**
|
||||||
|
* 基于现有 ObjectMapper 创建可重新配置的 MapperBuilder。
|
||||||
|
*
|
||||||
|
* @param objectMapper 需要重建的 ObjectMapper 实例
|
||||||
|
* @return 由该 ObjectMapper 派生的 MapperBuilder
|
||||||
|
*/
|
||||||
@SuppressWarnings("rawtypes")
|
@SuppressWarnings("rawtypes")
|
||||||
static MapperBuilder rebuild(ObjectMapper objectMapper) {
|
static MapperBuilder rebuild(ObjectMapper objectMapper) {
|
||||||
return objectMapper.rebuild();
|
return objectMapper.rebuild();
|
||||||
|
|||||||
@@ -29,7 +29,13 @@ import java.net.InetAddress;
|
|||||||
import java.time.LocalDateTime;
|
import java.time.LocalDateTime;
|
||||||
import java.time.format.DateTimeFormatter;
|
import java.time.format.DateTimeFormatter;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 工具库入口类,提供启动 Banner 打印以及进程、主机、用户等基础信息的获取方法。
|
||||||
|
*/
|
||||||
public class Main {
|
public class Main {
|
||||||
|
/**
|
||||||
|
* 启动时打印的 ASCII 艺术 Banner 文本
|
||||||
|
*/
|
||||||
public final static String BANNER =
|
public final static String BANNER =
|
||||||
"| $$\\ $$\\ $$\\ $$\\ $$\\ $$$$$$$$\\ $$$$$$\\ \n" +
|
"| $$\\ $$\\ $$\\ $$\\ $$\\ $$$$$$$$\\ $$$$$$\\ \n" +
|
||||||
"| $$$\\ $$$ |$$ | $$ | $$ |\\__$$ __|$$ __$$\\ \n" +
|
"| $$$\\ $$$ |$$ | $$ | $$ |\\__$$ __|$$ __$$\\ \n" +
|
||||||
@@ -40,6 +46,11 @@ public class Main {
|
|||||||
"| $$ | \\_/ $$ |$$$$$$$$\\\\$$$$$$ | $$ | \\$$$$$$ \n" +
|
"| $$ | \\_/ $$ |$$$$$$$$\\\\$$$$$$ | $$ | \\$$$$$$ \n" +
|
||||||
"| \\__| \\__|\\________|\\______/ \\__| \\______/ \n|\n";
|
"| \\__| \\__|\\________|\\______/ \\__| \\______/ \n|\n";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 程序入口,打印 Banner 与构建元数据信息,打印失败时静默忽略。
|
||||||
|
*
|
||||||
|
* @param args 命令行参数(未使用)
|
||||||
|
*/
|
||||||
public static void main(String[] args) {
|
public static void main(String[] args) {
|
||||||
try {
|
try {
|
||||||
printb();
|
printb();
|
||||||
@@ -47,6 +58,11 @@ public class Main {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前进程 PID 字符串。
|
||||||
|
*
|
||||||
|
* @return 当前进程 PID;获取失败时返回 "-1"
|
||||||
|
*/
|
||||||
public static String getPid() {
|
public static String getPid() {
|
||||||
try {
|
try {
|
||||||
var name = ManagementFactory.getRuntimeMXBean().getName();
|
var name = ManagementFactory.getRuntimeMXBean().getName();
|
||||||
@@ -61,6 +77,11 @@ public class Main {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取计算机名,依次尝试环境变量 COMPUTERNAME、HOSTNAME 与本机主机名。
|
||||||
|
*
|
||||||
|
* @return 计算机名;获取失败时返回 "unknown"
|
||||||
|
*/
|
||||||
public static String getComputerName() {
|
public static String getComputerName() {
|
||||||
try {
|
try {
|
||||||
var name = System.getenv("COMPUTERNAME");
|
var name = System.getenv("COMPUTERNAME");
|
||||||
@@ -76,6 +97,11 @@ public class Main {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前用户名,依次尝试环境变量 USERNAME、USER 与 user.name。
|
||||||
|
*
|
||||||
|
* @return 当前用户名;获取失败时返回 "unknown"
|
||||||
|
*/
|
||||||
public static String getUserName() {
|
public static String getUserName() {
|
||||||
try {
|
try {
|
||||||
String user = System.getenv("USERNAME");
|
String user = System.getenv("USERNAME");
|
||||||
@@ -96,6 +122,12 @@ public class Main {
|
|||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 打印 Banner 及构建元数据、JDK 版本、PID、计算机名、用户名与当前时间。
|
||||||
|
* 若元数据资源不存在则直接返回。
|
||||||
|
*
|
||||||
|
* @throws IOException 读取元数据资源失败时抛出
|
||||||
|
*/
|
||||||
public static void printb() throws IOException {
|
public static void printb() throws IOException {
|
||||||
InputStream inputStream = Main.class.getResourceAsStream("/META-INF/meta-data");
|
InputStream inputStream = Main.class.getResourceAsStream("/META-INF/meta-data");
|
||||||
if (inputStream == null) return;
|
if (inputStream == null) return;
|
||||||
|
|||||||
@@ -34,10 +34,15 @@ import javax.crypto.Cipher
|
|||||||
import javax.crypto.spec.GCMParameterSpec
|
import javax.crypto.spec.GCMParameterSpec
|
||||||
import javax.crypto.spec.SecretKeySpec
|
import javax.crypto.spec.SecretKeySpec
|
||||||
|
|
||||||
|
/** 加密算法名称:AES。 */
|
||||||
const val ALGORITHM = "AES"
|
const val ALGORITHM = "AES"
|
||||||
|
/** AES 加密变换模式:GCM 模式,无填充。 */
|
||||||
const val TRANSFORMATION = "AES/GCM/NoPadding"
|
const val TRANSFORMATION = "AES/GCM/NoPadding"
|
||||||
|
/** GCM 模式初始化向量(IV)长度,单位字节。 */
|
||||||
const val GCM_IV_LENGTH = 12
|
const val GCM_IV_LENGTH = 12
|
||||||
|
/** GCM 模式认证标签(Tag)长度,单位字节。 */
|
||||||
const val GCM_TAG_LENGTH = 16
|
const val GCM_TAG_LENGTH = 16
|
||||||
|
/** 全局安全随机数生成器,用于生成加密安全的随机 IV。 */
|
||||||
val SECURE_RANDOM = SecureRandom()
|
val SECURE_RANDOM = SecureRandom()
|
||||||
|
|
||||||
|
|
||||||
@@ -50,30 +55,30 @@ val SECURE_RANDOM = SecureRandom()
|
|||||||
*/
|
*/
|
||||||
@Throws(GeneralSecurityException::class)
|
@Throws(GeneralSecurityException::class)
|
||||||
fun encrypt(sSrc: String, sKey: String?): String? {
|
fun encrypt(sSrc: String, sKey: String?): String? {
|
||||||
if (sKey == null) {
|
if (sKey == null) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
|
|
||||||
// 生成密钥
|
// 生成密钥
|
||||||
val secretKeySpec = createSecretKey(sKey)
|
val secretKeySpec = createSecretKey(sKey)
|
||||||
|
|
||||||
// 生成安全随机IV
|
// 生成安全随机IV
|
||||||
val iv = ByteArray(GCM_IV_LENGTH)
|
val iv = ByteArray(GCM_IV_LENGTH)
|
||||||
SECURE_RANDOM.nextBytes(iv)
|
SECURE_RANDOM.nextBytes(iv)
|
||||||
|
|
||||||
// 初始化加密器
|
// 初始化加密器
|
||||||
val cipher = Cipher.getInstance(TRANSFORMATION)
|
val cipher = Cipher.getInstance(TRANSFORMATION)
|
||||||
val gcmParameterSpec = GCMParameterSpec(
|
val gcmParameterSpec = GCMParameterSpec(
|
||||||
GCM_TAG_LENGTH * 8, iv
|
GCM_TAG_LENGTH * 8, iv
|
||||||
)
|
)
|
||||||
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
cipher.init(Cipher.ENCRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
||||||
|
|
||||||
val encrypted = cipher.doFinal(
|
val encrypted = cipher.doFinal(
|
||||||
sSrc.toByteArray(StandardCharsets.UTF_8)
|
sSrc.toByteArray(StandardCharsets.UTF_8)
|
||||||
)
|
)
|
||||||
return BaseType.BASE64.encode(
|
return BaseType.BASE64.encode(
|
||||||
"${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray()
|
"${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray()
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -83,29 +88,29 @@ fun encrypt(sSrc: String, sKey: String?): String? {
|
|||||||
* @return 解密后的原始字符串
|
* @return 解密后的原始字符串
|
||||||
*/
|
*/
|
||||||
fun decrypt(sSrc: String, sKey: String): String? {
|
fun decrypt(sSrc: String, sKey: String): String? {
|
||||||
try {
|
try {
|
||||||
// 分割IV和加密数据
|
// 分割IV和加密数据
|
||||||
val sSrcs = String(BaseType.BASE64.decode(sSrc))
|
val sSrcs = String(BaseType.BASE64.decode(sSrc))
|
||||||
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
|
val parts: Array<String?> = sSrcs.split(":".toRegex(), limit = 2).toTypedArray()
|
||||||
if (parts.size != 2) {
|
if (parts.size != 2) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
val iv = BaseType.BASE64.decode(parts[0]!!)
|
val iv = BaseType.BASE64.decode(parts[0]!!)
|
||||||
val encryptedData = BaseType.BASE64.decode(parts[1]!!)
|
val encryptedData = BaseType.BASE64.decode(parts[1]!!)
|
||||||
if (iv.size != GCM_IV_LENGTH) {
|
if (iv.size != GCM_IV_LENGTH) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
val secretKeySpec = createSecretKey(sKey)
|
val secretKeySpec = createSecretKey(sKey)
|
||||||
val cipher = Cipher.getInstance(TRANSFORMATION)
|
val cipher = Cipher.getInstance(TRANSFORMATION)
|
||||||
val gcmParameterSpec = GCMParameterSpec(
|
val gcmParameterSpec = GCMParameterSpec(
|
||||||
GCM_TAG_LENGTH * 8, iv
|
GCM_TAG_LENGTH * 8, iv
|
||||||
)
|
)
|
||||||
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
cipher.init(Cipher.DECRYPT_MODE, secretKeySpec, gcmParameterSpec)
|
||||||
val original = cipher.doFinal(encryptedData)
|
val original = cipher.doFinal(encryptedData)
|
||||||
return String(original, StandardCharsets.UTF_8)
|
return String(original, StandardCharsets.UTF_8)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -116,8 +121,8 @@ fun decrypt(sSrc: String, sKey: String): String? {
|
|||||||
*/
|
*/
|
||||||
@Throws(Exception::class)
|
@Throws(Exception::class)
|
||||||
private fun createSecretKey(sKey: String): SecretKeySpec {
|
private fun createSecretKey(sKey: String): SecretKeySpec {
|
||||||
val key = sKey.toByteArray(StandardCharsets.UTF_8)
|
val key = sKey.toByteArray(StandardCharsets.UTF_8)
|
||||||
val md = MessageDigest.getInstance("MD5")
|
val md = MessageDigest.getInstance("MD5")
|
||||||
val digest = md.digest(key)
|
val digest = md.digest(key)
|
||||||
return SecretKeySpec(digest, ALGORITHM)
|
return SecretKeySpec(digest, ALGORITHM)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -37,5 +37,5 @@ import kotlin.reflect.KClass
|
|||||||
@Target(AnnotationTarget.CLASS)
|
@Target(AnnotationTarget.CLASS)
|
||||||
@Retention(AnnotationRetention.SOURCE)
|
@Retention(AnnotationRetention.SOURCE)
|
||||||
annotation class AutoService(
|
annotation class AutoService(
|
||||||
val value: Array<KClass<*>> = []
|
val value: Array<KClass<*>> = [],
|
||||||
)
|
)
|
||||||
|
|||||||
@@ -33,7 +33,7 @@ import com.mingliqiye.utils.time.Formatter
|
|||||||
*/
|
*/
|
||||||
@Target(AnnotationTarget.FIELD)
|
@Target(AnnotationTarget.FIELD)
|
||||||
annotation class DateTimeJsonFormat(
|
annotation class DateTimeJsonFormat(
|
||||||
val value: Formatter = Formatter.NONE,
|
val value: Formatter = Formatter.NONE,
|
||||||
val formatter: String = "",
|
val formatter: String = "",
|
||||||
val repcZero: Boolean = true,
|
val repcZero: Boolean = true,
|
||||||
)
|
)
|
||||||
|
|||||||
@@ -33,6 +33,6 @@ import com.mingliqiye.utils.uuid.UUIDFormatType
|
|||||||
*/
|
*/
|
||||||
@Target(AnnotationTarget.FIELD)
|
@Target(AnnotationTarget.FIELD)
|
||||||
annotation class UUIDJsonFormat(
|
annotation class UUIDJsonFormat(
|
||||||
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
|
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
|
||||||
val base: BaseType = BaseType.BASE16
|
val base: BaseType = BaseType.BASE16,
|
||||||
)
|
)
|
||||||
|
|||||||
@@ -33,72 +33,92 @@ import javax.lang.model.type.TypeMirror
|
|||||||
import javax.tools.StandardLocation
|
import javax.tools.StandardLocation
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* [AutoService] 注解的编译期处理器。
|
||||||
|
*
|
||||||
|
* 扫描标注了 [AutoService] 的类,收集服务接口与实现类的映射关系,
|
||||||
|
* 并在编译输出目录的 META-INF/services 下生成对应的服务注册文件。
|
||||||
|
*/
|
||||||
@SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService")
|
@SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService")
|
||||||
class AutoServiceProcessor : AbstractProcessor() {
|
class AutoServiceProcessor : AbstractProcessor() {
|
||||||
override fun init(processingEnv: ProcessingEnvironment) {
|
override fun init(processingEnv: ProcessingEnvironment) {
|
||||||
super.init(processingEnv)
|
super.init(processingEnv)
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun process(
|
/**
|
||||||
annotations: Set<TypeElement>,
|
* 处理标注了 [AutoService] 的元素,收集服务接口与实现类的映射并生成服务注册文件。
|
||||||
roundEnv: RoundEnvironment,
|
* 若注解未显式指定服务接口,则默认使用该类直接实现的接口。
|
||||||
): Boolean {
|
*
|
||||||
|
* @param annotations 本轮处理的注解类型集合
|
||||||
|
* @param roundEnv 当前轮次的处理环境
|
||||||
|
* @return 是否已处理该注解,存在标注元素时返回 true,否则返回 false
|
||||||
|
*/
|
||||||
|
override fun process(
|
||||||
|
annotations: Set<TypeElement>,
|
||||||
|
roundEnv: RoundEnvironment,
|
||||||
|
): Boolean {
|
||||||
|
|
||||||
val service = mutableMapOf<String, MutableList<String>>()
|
val service = mutableMapOf<String, MutableList<String>>()
|
||||||
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
|
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
|
||||||
if (elements.isEmpty()) return false
|
if (elements.isEmpty()) return false
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
|
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
|
||||||
var asd = (try {
|
var asd = (try {
|
||||||
autoServiceAnnotation!!.value.map { it.java.name }
|
autoServiceAnnotation!!.value.map { it.java.name }
|
||||||
} catch (e: MirroredTypesException) {
|
} catch (e: MirroredTypesException) {
|
||||||
e.typeMirrors.map(TypeMirror::toString)
|
e.typeMirrors.map(TypeMirror::toString)
|
||||||
})
|
})
|
||||||
|
|
||||||
if (asd.isEmpty()) {
|
if (asd.isEmpty()) {
|
||||||
if (element is TypeElement) {
|
if (element is TypeElement) {
|
||||||
asd = element.interfaces.map { it.toString() }
|
asd = element.interfaces.map { it.toString() }
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
for (data in asd) {
|
for (data in asd) {
|
||||||
var ldata: MutableList<String>? = service[data]
|
var ldata: MutableList<String>? = service[data]
|
||||||
if (ldata == null) {
|
if (ldata == null) {
|
||||||
ldata = mutableListOf()
|
ldata = mutableListOf()
|
||||||
service[data] = ldata
|
service[data] = ldata
|
||||||
}
|
}
|
||||||
ldata.add(element.toString())
|
ldata.add(element.toString())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
processClassAnnotation(service)
|
processClassAnnotation(service)
|
||||||
return true
|
return true
|
||||||
}
|
}
|
||||||
|
|
||||||
fun processClassAnnotation(map: Map<String, MutableList<String>>) {
|
/**
|
||||||
map.forEach { (interfaceName, implementations) ->
|
* 根据服务接口与实现类的映射,在 META-INF/services 目录下生成服务注册文件。
|
||||||
if (implementations.isEmpty()) {
|
* 实现列表为空或文件创建失败时打印提示信息并跳过。
|
||||||
println("警告: $interfaceName 的实现列表为空!")
|
*
|
||||||
return@forEach
|
* @param map 服务接口全限定名到实现类全限定名列表的映射
|
||||||
}
|
*/
|
||||||
try {
|
fun processClassAnnotation(map: Map<String, MutableList<String>>) {
|
||||||
val serviceFile = processingEnv.filer.createResource(
|
map.forEach { (interfaceName, implementations) ->
|
||||||
StandardLocation.CLASS_OUTPUT,
|
if (implementations.isEmpty()) {
|
||||||
"",
|
println("警告: $interfaceName 的实现列表为空!")
|
||||||
"META-INF/services/$interfaceName"
|
return@forEach
|
||||||
)
|
}
|
||||||
val content = StringBuilder()
|
try {
|
||||||
serviceFile.openWriter().use { writer ->
|
val serviceFile = processingEnv.filer.createResource(
|
||||||
implementations.forEach { impl ->
|
StandardLocation.CLASS_OUTPUT,
|
||||||
val line = "$impl\n"
|
"",
|
||||||
content.append(line)
|
"META-INF/services/$interfaceName"
|
||||||
writer.write(line)
|
)
|
||||||
}
|
val content = StringBuilder()
|
||||||
writer.flush()
|
serviceFile.openWriter().use { writer ->
|
||||||
}
|
implementations.forEach { impl ->
|
||||||
|
val line = "$impl\n"
|
||||||
|
content.append(line)
|
||||||
|
writer.write(line)
|
||||||
|
}
|
||||||
|
writer.flush()
|
||||||
|
}
|
||||||
|
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
println("文件创建失败: ${e.javaClass.name} - ${e.message}")
|
println("文件创建失败: ${e.javaClass.name} - ${e.message}")
|
||||||
e.printStackTrace()
|
e.printStackTrace()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -61,7 +61,7 @@ fun String.toHexByteArray(): ByteArray = BaseType.BASE16.decode(this.lowercase()
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
|
fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -76,12 +76,12 @@ fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Ar
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
|
fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
|
||||||
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
|
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
|
||||||
System.arraycopy(this, srcPos, it, distPos, len)
|
System.arraycopy(this, srcPos, it, distPos, len)
|
||||||
}.let {
|
}.let {
|
||||||
@Suppress("UNCHECKED_CAST")
|
@Suppress("UNCHECKED_CAST")
|
||||||
it as Array<T>
|
it as Array<T>
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将源数组的指定范围复制到当前数组
|
* 将源数组的指定范围复制到当前数组
|
||||||
@@ -96,7 +96,7 @@ fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
|
fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== BooleanArray 扩展 ==================== */
|
/* ==================== BooleanArray 扩展 ==================== */
|
||||||
@@ -107,7 +107,7 @@ fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): A
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
|
fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -116,9 +116,9 @@ fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int)
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
|
fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
|
||||||
BooleanArray(len).also { newArray ->
|
BooleanArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -126,7 +126,7 @@ fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
|
fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== ByteArray 扩展 ==================== */
|
/* ==================== ByteArray 扩展 ==================== */
|
||||||
@@ -137,7 +137,7 @@ fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
|
fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -146,9 +146,9 @@ fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): Byte
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
|
fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
|
||||||
ByteArray(len).also { newArray ->
|
ByteArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -156,7 +156,7 @@ fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
|
fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== CharArray 扩展 ==================== */
|
/* ==================== CharArray 扩展 ==================== */
|
||||||
@@ -167,7 +167,7 @@ fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): Byt
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
|
fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -176,9 +176,9 @@ fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): Char
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
|
fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
|
||||||
CharArray(len).also { newArray ->
|
CharArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -186,7 +186,7 @@ fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
|
fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== DoubleArray 扩展 ==================== */
|
/* ==================== DoubleArray 扩展 ==================== */
|
||||||
@@ -197,7 +197,7 @@ fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): Cha
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
|
fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -206,9 +206,9 @@ fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int):
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
|
fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
|
||||||
DoubleArray(len).also { newArray ->
|
DoubleArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -216,7 +216,7 @@ fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
|
fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== FloatArray 扩展 ==================== */
|
/* ==================== FloatArray 扩展 ==================== */
|
||||||
@@ -227,7 +227,7 @@ fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int):
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
|
fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -236,9 +236,9 @@ fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): Fl
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
|
fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
|
||||||
FloatArray(len).also { newArray ->
|
FloatArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -246,7 +246,7 @@ fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
|
fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== IntArray 扩展 ==================== */
|
/* ==================== IntArray 扩展 ==================== */
|
||||||
@@ -257,7 +257,7 @@ fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): F
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
|
fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -266,9 +266,9 @@ fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArr
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
|
fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
|
||||||
IntArray(len).also { newArray ->
|
IntArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -276,7 +276,7 @@ fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
|
fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== LongArray 扩展 ==================== */
|
/* ==================== LongArray 扩展 ==================== */
|
||||||
@@ -287,7 +287,7 @@ fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntAr
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
|
fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -296,9 +296,9 @@ fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): Long
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
|
fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
|
||||||
LongArray(len).also { newArray ->
|
LongArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -306,7 +306,7 @@ fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
|
fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/* ==================== ShortArray 扩展 ==================== */
|
/* ==================== ShortArray 扩展 ==================== */
|
||||||
@@ -317,7 +317,7 @@ fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): Lon
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
|
fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
|
||||||
System.arraycopy(this, srcPos, dest, distPos, len)
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -326,9 +326,9 @@ fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): Sh
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopy")
|
@JvmName("arrayCopy")
|
||||||
fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
|
fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
|
||||||
ShortArray(len).also { newArray ->
|
ShortArray(len).also { newArray ->
|
||||||
System.arraycopy(this, srcPos, newArray, distPos, len)
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @see Array.copyFrom
|
* @see Array.copyFrom
|
||||||
@@ -336,5 +336,5 @@ fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
|
|||||||
*/
|
*/
|
||||||
@JvmName("arrayCopyFrom")
|
@JvmName("arrayCopyFrom")
|
||||||
fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
|
fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
|
||||||
System.arraycopy(src, srcPos, this, distPos, len)
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -24,45 +24,50 @@ package com.mingliqiye.utils.base
|
|||||||
|
|
||||||
import java.math.BigInteger
|
import java.math.BigInteger
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base10 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 提供字节数组与十进制字符串之间的相互转换功能,基于 [BigInteger] 实现。
|
||||||
|
*/
|
||||||
internal class Base10Codec : BaseCodec {
|
internal class Base10Codec : BaseCodec {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字节数组编码为Base10字符串(十进制)
|
* 将字节数组编码为Base10字符串(十进制)
|
||||||
*
|
*
|
||||||
* @param bytes 需要编码的字节数组
|
* @param bytes 需要编码的字节数组
|
||||||
* @return 编码后的Base10字符串(十进制数字)
|
* @return 编码后的Base10字符串(十进制数字)
|
||||||
*/
|
*/
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
if (bytes.isEmpty()) return "0"
|
if (bytes.isEmpty()) return "0"
|
||||||
|
|
||||||
// 将字节数组转换为正的大整数
|
// 将字节数组转换为正的大整数
|
||||||
val bigInt = BigInteger(1, bytes) // 参数1表示正数
|
val bigInt = BigInteger(1, bytes) // 参数1表示正数
|
||||||
return bigInt.toString(10) // 转换为10进制字符串
|
return bigInt.toString(10) // 转换为10进制字符串
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将Base10字符串解码为字节数组
|
* 将Base10字符串解码为字节数组
|
||||||
*
|
*
|
||||||
* @param string 需要解码的Base10字符串(十进制数字)
|
* @param string 需要解码的Base10字符串(十进制数字)
|
||||||
* @return 解码后的字节数组
|
* @return 解码后的字节数组
|
||||||
*/
|
*/
|
||||||
override fun decode(string: String): ByteArray {
|
override fun decode(string: String): ByteArray {
|
||||||
// 验证输入是否为有效的十进制数字
|
// 验证输入是否为有效的十进制数字
|
||||||
if (!string.matches(Regex("\\d+"))) {
|
if (!string.matches(Regex("\\d+"))) {
|
||||||
throw IllegalArgumentException("Base10字符串只能包含数字0-9")
|
throw IllegalArgumentException("Base10字符串只能包含数字0-9")
|
||||||
}
|
}
|
||||||
|
|
||||||
val bigInt = BigInteger(string, 10) // 从10进制解析
|
val bigInt = BigInteger(string, 10) // 从10进制解析
|
||||||
|
|
||||||
// 转换为字节数组,并确保保留前导零
|
// 转换为字节数组,并确保保留前导零
|
||||||
var byteArray = bigInt.toByteArray()
|
var byteArray = bigInt.toByteArray()
|
||||||
|
|
||||||
// BigInteger.toByteArray() 可能会添加一个符号字节
|
// BigInteger.toByteArray() 可能会添加一个符号字节
|
||||||
// 对于正数,如果第一个字节是0,需要移除它
|
// 对于正数,如果第一个字节是0,需要移除它
|
||||||
if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) {
|
if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) {
|
||||||
byteArray = byteArray.copyOfRange(1, byteArray.size)
|
byteArray = byteArray.copyOfRange(1, byteArray.size)
|
||||||
}
|
}
|
||||||
|
|
||||||
return byteArray
|
return byteArray
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -27,28 +27,28 @@ package com.mingliqiye.utils.base
|
|||||||
* 提供字节数组与十六进制字符串之间的相互转换功能
|
* 提供字节数组与十六进制字符串之间的相互转换功能
|
||||||
*/
|
*/
|
||||||
internal class Base16Codec : BaseCodec {
|
internal class Base16Codec : BaseCodec {
|
||||||
/**
|
/**
|
||||||
* 将字节数组编码为十六进制字符串
|
* 将字节数组编码为十六进制字符串
|
||||||
* @param bytes 待编码的字节数组
|
* @param bytes 待编码的字节数组
|
||||||
* @return 编码后的十六进制字符串,每个字节对应两位十六进制字符
|
* @return 编码后的十六进制字符串,每个字节对应两位十六进制字符
|
||||||
*/
|
*/
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
// 将每个字节转换为两位十六进制字符串并拼接
|
// 将每个字节转换为两位十六进制字符串并拼接
|
||||||
return bytes.joinToString("") {
|
return bytes.joinToString("") {
|
||||||
it.toInt().and(0xff).toString(16).padStart(2, '0')
|
it.toInt().and(0xff).toString(16).padStart(2, '0')
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将十六进制字符串解码为字节数组
|
* 将十六进制字符串解码为字节数组
|
||||||
* @param string 待解码的十六进制字符串
|
* @param string 待解码的十六进制字符串
|
||||||
* @return 解码后的字节数组
|
* @return 解码后的字节数组
|
||||||
*/
|
*/
|
||||||
override fun decode(string: String): ByteArray {
|
override fun decode(string: String): ByteArray {
|
||||||
// 按每两个字符分组,转换为字节
|
// 按每两个字符分组,转换为字节
|
||||||
return string.chunked(2).map {
|
return string.chunked(2).map {
|
||||||
it.toInt(16).toByte()
|
it.toInt(16).toByte()
|
||||||
}.toByteArray()
|
}.toByteArray()
|
||||||
}
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -32,282 +32,298 @@ package com.mingliqiye.utils.base
|
|||||||
*/
|
*/
|
||||||
internal class Base256Codec : BaseCodec {
|
internal class Base256Codec : BaseCodec {
|
||||||
|
|
||||||
companion object {
|
/**
|
||||||
val code = arrayOf(
|
* 伴生对象,持有 Base256 的编码字符集及其反向索引表。
|
||||||
'!',
|
*/
|
||||||
'#',
|
companion object {
|
||||||
'$',
|
/**
|
||||||
'%',
|
* Base256 编码字符集,共 256 个字符,数组索引即对应的字节值(0~255)。
|
||||||
'&',
|
*/
|
||||||
'(',
|
val code = arrayOf(
|
||||||
')',
|
'!',
|
||||||
'*',
|
'#',
|
||||||
'+',
|
'$',
|
||||||
',',
|
'%',
|
||||||
'-',
|
'&',
|
||||||
'.',
|
'(',
|
||||||
'/',
|
')',
|
||||||
'0',
|
'*',
|
||||||
'1',
|
'+',
|
||||||
'2',
|
',',
|
||||||
'3',
|
'-',
|
||||||
'4',
|
'.',
|
||||||
'5',
|
'/',
|
||||||
'6',
|
'0',
|
||||||
'7',
|
'1',
|
||||||
'8',
|
'2',
|
||||||
'9',
|
'3',
|
||||||
':',
|
'4',
|
||||||
';',
|
'5',
|
||||||
'<',
|
'6',
|
||||||
'=',
|
'7',
|
||||||
'>',
|
'8',
|
||||||
'?',
|
'9',
|
||||||
'@',
|
':',
|
||||||
'A',
|
';',
|
||||||
'B',
|
'<',
|
||||||
'C',
|
'=',
|
||||||
'D',
|
'>',
|
||||||
'E',
|
'?',
|
||||||
'F',
|
'@',
|
||||||
'G',
|
'A',
|
||||||
'H',
|
'B',
|
||||||
'I',
|
'C',
|
||||||
'J',
|
'D',
|
||||||
'K',
|
'E',
|
||||||
'L',
|
'F',
|
||||||
'M',
|
'G',
|
||||||
'N',
|
'H',
|
||||||
'O',
|
'I',
|
||||||
'P',
|
'J',
|
||||||
'Q',
|
'K',
|
||||||
'R',
|
'L',
|
||||||
'S',
|
'M',
|
||||||
'T',
|
'N',
|
||||||
'U',
|
'O',
|
||||||
'V',
|
'P',
|
||||||
'W',
|
'Q',
|
||||||
'X',
|
'R',
|
||||||
'Y',
|
'S',
|
||||||
'Z',
|
'T',
|
||||||
'[',
|
'U',
|
||||||
']',
|
'V',
|
||||||
'^',
|
'W',
|
||||||
'_',
|
'X',
|
||||||
'`',
|
'Y',
|
||||||
'a',
|
'Z',
|
||||||
'b',
|
'[',
|
||||||
'c',
|
']',
|
||||||
'd',
|
'^',
|
||||||
'e',
|
'_',
|
||||||
'f',
|
'`',
|
||||||
'g',
|
'a',
|
||||||
'h',
|
'b',
|
||||||
'i',
|
'c',
|
||||||
'j',
|
'd',
|
||||||
'k',
|
'e',
|
||||||
'l',
|
'f',
|
||||||
'm',
|
'g',
|
||||||
'n',
|
'h',
|
||||||
'o',
|
'i',
|
||||||
'p',
|
'j',
|
||||||
'q',
|
'k',
|
||||||
'r',
|
'l',
|
||||||
's',
|
'm',
|
||||||
't',
|
'n',
|
||||||
'u',
|
'o',
|
||||||
'v',
|
'p',
|
||||||
'w',
|
'q',
|
||||||
'x',
|
'r',
|
||||||
'y',
|
's',
|
||||||
'z',
|
't',
|
||||||
'{',
|
'u',
|
||||||
'|',
|
'v',
|
||||||
'}',
|
'w',
|
||||||
'~',
|
'x',
|
||||||
'§',
|
'y',
|
||||||
'±',
|
'z',
|
||||||
'×',
|
'{',
|
||||||
'÷',
|
'|',
|
||||||
'←',
|
'}',
|
||||||
'↑',
|
'~',
|
||||||
'→',
|
'§',
|
||||||
'↓',
|
'±',
|
||||||
'⇒',
|
'×',
|
||||||
'⇔',
|
'÷',
|
||||||
'∀',
|
'←',
|
||||||
'∃',
|
'↑',
|
||||||
'∅',
|
'→',
|
||||||
'∆',
|
'↓',
|
||||||
'∇',
|
'⇒',
|
||||||
'∈',
|
'⇔',
|
||||||
'∉',
|
'∀',
|
||||||
'∋',
|
'∃',
|
||||||
'∌',
|
'∅',
|
||||||
'∏',
|
'∆',
|
||||||
'∑',
|
'∇',
|
||||||
'−',
|
'∈',
|
||||||
'∓',
|
'∉',
|
||||||
'∕',
|
'∋',
|
||||||
'∗',
|
'∌',
|
||||||
'∘',
|
'∏',
|
||||||
'∙',
|
'∑',
|
||||||
'√',
|
'−',
|
||||||
'∛',
|
'∓',
|
||||||
'∜',
|
'∕',
|
||||||
'∞',
|
'∗',
|
||||||
'∟',
|
'∘',
|
||||||
'∠',
|
'∙',
|
||||||
'∣',
|
'√',
|
||||||
'∥',
|
'∛',
|
||||||
'∧',
|
'∜',
|
||||||
'∨',
|
'∞',
|
||||||
'∩',
|
'∟',
|
||||||
'∪',
|
'∠',
|
||||||
'∫',
|
'∣',
|
||||||
'∬',
|
'∥',
|
||||||
'∭',
|
'∧',
|
||||||
'∮',
|
'∨',
|
||||||
'∯',
|
'∩',
|
||||||
'∰',
|
'∪',
|
||||||
'∱',
|
'∫',
|
||||||
'∲',
|
'∬',
|
||||||
'∳',
|
'∭',
|
||||||
'∴',
|
'∮',
|
||||||
'∵',
|
'∯',
|
||||||
'∶',
|
'∰',
|
||||||
'∷',
|
'∱',
|
||||||
'≈',
|
'∲',
|
||||||
'≠',
|
'∳',
|
||||||
'≡',
|
'∴',
|
||||||
'≤',
|
'∵',
|
||||||
'≥',
|
'∶',
|
||||||
'≦',
|
'∷',
|
||||||
'≧',
|
'≈',
|
||||||
'≪',
|
'≠',
|
||||||
'≫',
|
'≡',
|
||||||
'≺',
|
'≤',
|
||||||
'≻',
|
'≥',
|
||||||
'⊂',
|
'≦',
|
||||||
'⊃',
|
'≧',
|
||||||
'⊆',
|
'≪',
|
||||||
'⊇',
|
'≫',
|
||||||
'⊈',
|
'≺',
|
||||||
'⊉',
|
'≻',
|
||||||
'⊊',
|
'⊂',
|
||||||
'⊋',
|
'⊃',
|
||||||
'⊕',
|
'⊆',
|
||||||
'⊖',
|
'⊇',
|
||||||
'⊗',
|
'⊈',
|
||||||
'⊘',
|
'⊉',
|
||||||
'⊙',
|
'⊊',
|
||||||
'⊚',
|
'⊋',
|
||||||
'⊛',
|
'⊕',
|
||||||
'⊜',
|
'⊖',
|
||||||
'⊝',
|
'⊗',
|
||||||
'⊞',
|
'⊘',
|
||||||
'⊟',
|
'⊙',
|
||||||
'⊠',
|
'⊚',
|
||||||
'⊡',
|
'⊛',
|
||||||
'⊢',
|
'⊜',
|
||||||
'⊣',
|
'⊝',
|
||||||
'⊤',
|
'⊞',
|
||||||
'⊥',
|
'⊟',
|
||||||
'⊦',
|
'⊠',
|
||||||
'⊧',
|
'⊡',
|
||||||
'⊨',
|
'⊢',
|
||||||
'⊩',
|
'⊣',
|
||||||
'⊪',
|
'⊤',
|
||||||
'⊫',
|
'⊥',
|
||||||
'⊬',
|
'⊦',
|
||||||
'⊭',
|
'⊧',
|
||||||
'⊮',
|
'⊨',
|
||||||
'⊯',
|
'⊩',
|
||||||
'⋀',
|
'⊪',
|
||||||
'⋁',
|
'⊫',
|
||||||
'⋂',
|
'⊬',
|
||||||
'⋃',
|
'⊭',
|
||||||
'⋄',
|
'⊮',
|
||||||
'⋅',
|
'⊯',
|
||||||
'⋆',
|
'⋀',
|
||||||
'⋇',
|
'⋁',
|
||||||
'⋈',
|
'⋂',
|
||||||
'⋉',
|
'⋃',
|
||||||
'⋊',
|
'⋄',
|
||||||
'⋋',
|
'⋅',
|
||||||
'⋌',
|
'⋆',
|
||||||
'⋍',
|
'⋇',
|
||||||
'⋎',
|
'⋈',
|
||||||
'⋏',
|
'⋉',
|
||||||
'⋐',
|
'⋊',
|
||||||
'⋑',
|
'⋋',
|
||||||
'⋒',
|
'⋌',
|
||||||
'⋓',
|
'⋍',
|
||||||
'⋔',
|
'⋎',
|
||||||
'⋕',
|
'⋏',
|
||||||
'⋖',
|
'⋐',
|
||||||
'⋗',
|
'⋑',
|
||||||
'⋘',
|
'⋒',
|
||||||
'⋙',
|
'⋓',
|
||||||
'⋚',
|
'⋔',
|
||||||
'⋛',
|
'⋕',
|
||||||
'⋜',
|
'⋖',
|
||||||
'⋝',
|
'⋗',
|
||||||
'⋞',
|
'⋘',
|
||||||
'⋟',
|
'⋙',
|
||||||
'⋠',
|
'⋚',
|
||||||
'⋡',
|
'⋛',
|
||||||
'⋢',
|
'⋜',
|
||||||
'⋣',
|
'⋝',
|
||||||
'⋤',
|
'⋞',
|
||||||
'⋥',
|
'⋟',
|
||||||
'⋦',
|
'⋠',
|
||||||
'⋧',
|
'⋡',
|
||||||
'⋨',
|
'⋢',
|
||||||
'⋩',
|
'⋣',
|
||||||
'▁',
|
'⋤',
|
||||||
'▂',
|
'⋥',
|
||||||
'▃',
|
'⋦',
|
||||||
'▄',
|
'⋧',
|
||||||
'▅',
|
'⋨',
|
||||||
'▆',
|
'⋩',
|
||||||
'▇',
|
'▁',
|
||||||
'█',
|
'▂',
|
||||||
'▉',
|
'▃',
|
||||||
'▊',
|
'▄',
|
||||||
'▋',
|
'▅',
|
||||||
'▌',
|
'▆',
|
||||||
'▍',
|
'▇',
|
||||||
'▎',
|
'█',
|
||||||
'▏',
|
'▉',
|
||||||
'▐',
|
'▊',
|
||||||
'░',
|
'▋',
|
||||||
'▒',
|
'▌',
|
||||||
'▓',
|
'▍',
|
||||||
'▔',
|
'▎',
|
||||||
'▕',
|
'▏',
|
||||||
'▖',
|
'▐',
|
||||||
'▗',
|
'░',
|
||||||
'▘',
|
'▒',
|
||||||
'▙'
|
'▓',
|
||||||
)
|
'▔',
|
||||||
val codeMap = code.mapIndexed { index, c -> c to index }.toMap()
|
'▕',
|
||||||
}
|
'▖',
|
||||||
|
'▗',
|
||||||
|
'▘',
|
||||||
|
'▙'
|
||||||
|
)
|
||||||
|
/**
|
||||||
|
* 字符到字节值的反向映射表,用于解码时快速查找字符对应的索引。
|
||||||
|
*/
|
||||||
|
val codeMap = code.mapIndexed { index, c -> c to index }.toMap()
|
||||||
|
}
|
||||||
|
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
val result = CharArray(bytes.size)
|
val result = CharArray(bytes.size)
|
||||||
for (i in bytes.indices) {
|
for (i in bytes.indices) {
|
||||||
val unsignedByte = bytes[i].toInt() and 0xFF
|
val unsignedByte = bytes[i].toInt() and 0xFF
|
||||||
result[i] = code[unsignedByte]
|
result[i] = code[unsignedByte]
|
||||||
}
|
}
|
||||||
return String(result)
|
return String(result)
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun decode(string: String): ByteArray {
|
/**
|
||||||
val result = ByteArray(string.length)
|
* 将 Base256 字符串解码为字节数组。
|
||||||
for (i in string.indices) {
|
*
|
||||||
result[i] = codeMap[string[i]]!!.toByte()
|
* @param string 待解码的字符串,所有字符必须属于编码字符集
|
||||||
}
|
* @return 解码后的字节数组
|
||||||
return result
|
* @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
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -22,38 +22,50 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.base
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base2 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 提供字节数组与二进制字符串(每字节 8 位,高位在前)之间的相互转换功能。
|
||||||
|
*/
|
||||||
internal class Base2Codec : BaseCodec {
|
internal class Base2Codec : BaseCodec {
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
if (bytes.isEmpty()) return ""
|
if (bytes.isEmpty()) return ""
|
||||||
val result = StringBuilder()
|
val result = StringBuilder()
|
||||||
for ((index, byte) in bytes.withIndex()) {
|
for ((index, byte) in bytes.withIndex()) {
|
||||||
val unsignedByte = byte.toInt() and 0xFF
|
val unsignedByte = byte.toInt() and 0xFF
|
||||||
val binary = unsignedByte.toString(2).padStart(8, '0')
|
val binary = unsignedByte.toString(2).padStart(8, '0')
|
||||||
result.append(binary)
|
result.append(binary)
|
||||||
}
|
}
|
||||||
return result.toString()
|
return result.toString()
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun decode(string: String): ByteArray {
|
/**
|
||||||
if (string.length % 8 != 0) {
|
* 将二进制字符串解码为字节数组。
|
||||||
throw IllegalArgumentException(
|
*
|
||||||
"BASE1字符串长度必须是8的倍数,当前长度: ${string.length}"
|
* @param string 待解码的二进制字符串,长度必须为 8 的倍数且仅包含字符 '0' 和 '1'
|
||||||
)
|
* @return 解码后的字节数组
|
||||||
}
|
* @throws IllegalArgumentException 如果字符串长度不是 8 的倍数或包含非法字符
|
||||||
if (!string.matches(Regex("[01]+"))) {
|
*/
|
||||||
throw IllegalArgumentException(
|
override fun decode(string: String): ByteArray {
|
||||||
"BASE1字符串只能包含字符'0'和'1'"
|
if (string.length % 8 != 0) {
|
||||||
)
|
throw IllegalArgumentException(
|
||||||
}
|
"BASE1字符串长度必须是8的倍数,当前长度: ${string.length}"
|
||||||
val byteCount = string.length / 8
|
)
|
||||||
val result = ByteArray(byteCount)
|
}
|
||||||
for (i in 0 until byteCount) {
|
if (!string.matches(Regex("[01]+"))) {
|
||||||
val startIndex = i * 8
|
throw IllegalArgumentException(
|
||||||
val endIndex = startIndex + 8
|
"BASE1字符串只能包含字符'0'和'1'"
|
||||||
val binaryStr = string.substring(startIndex, endIndex)
|
)
|
||||||
val byteValue = binaryStr.toInt(2)
|
}
|
||||||
result[i] = byteValue.toByte()
|
val byteCount = string.length / 8
|
||||||
}
|
val result = ByteArray(byteCount)
|
||||||
return result
|
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
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -24,41 +24,41 @@ package com.mingliqiye.utils.base
|
|||||||
|
|
||||||
import java.util.*
|
import java.util.*
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* Base64编解码工具类
|
* Base64编解码工具类
|
||||||
* 提供Base64编码和解码功能的实现
|
* 提供Base64编码和解码功能的实现
|
||||||
*/
|
*/
|
||||||
internal class Base64Codec : BaseCodec {
|
internal class Base64Codec : BaseCodec {
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* Base64编码器实例
|
* Base64编码器实例
|
||||||
* 用于执行字节数组到Base64字符串的编码操作
|
* 用于执行字节数组到Base64字符串的编码操作
|
||||||
*/
|
*/
|
||||||
val encoder: Base64.Encoder = Base64.getEncoder()
|
val encoder: Base64.Encoder = Base64.getEncoder()
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* Base64解码器实例
|
* Base64解码器实例
|
||||||
* 用于执行Base64字符串到字节数组的解码操作
|
* 用于执行Base64字符串到字节数组的解码操作
|
||||||
*/
|
*/
|
||||||
val decoder: Base64.Decoder = Base64.getDecoder()
|
val decoder: Base64.Decoder = Base64.getDecoder()
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* 将字节数组编码为Base64字符串
|
* 将字节数组编码为Base64字符串
|
||||||
*
|
*
|
||||||
* @param bytes 待编码的字节数组
|
* @param bytes 待编码的字节数组
|
||||||
* @return 编码后的Base64字符串
|
* @return 编码后的Base64字符串
|
||||||
*/
|
*/
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
return encoder.encodeToString(bytes)
|
return encoder.encodeToString(bytes)
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* 将Base64字符串解码为字节数组
|
* 将Base64字符串解码为字节数组
|
||||||
*
|
*
|
||||||
* @param string 待解码的Base64字符串
|
* @param string 待解码的Base64字符串
|
||||||
* @return 解码后的字节数组
|
* @return 解码后的字节数组
|
||||||
*/
|
*/
|
||||||
override fun decode(string: String): ByteArray {
|
override fun decode(string: String): ByteArray {
|
||||||
return decoder.decode(string)
|
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)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile Base64UrlCodec.kt
|
* CurrentFile Base64UrlCodec.kt
|
||||||
* LastUpdate 2026-03-12 10:34:36
|
* LastUpdate 2026-11-16 14:24:59
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -24,37 +24,42 @@ package com.mingliqiye.utils.base
|
|||||||
|
|
||||||
import java.util.*
|
import java.util.*
|
||||||
|
|
||||||
|
/**
|
||||||
|
* URL 安全 Base64 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 使用 '-' 和 '_' 替代标准 Base64 中的 '+' 和 '/',适用于 URL 与文件名场景。
|
||||||
|
*/
|
||||||
internal class Base64UrlCodec : BaseCodec {
|
internal class Base64UrlCodec : BaseCodec {
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* Base64编码器实例
|
* Base64编码器实例
|
||||||
* 用于执行字节数组到Base64字符串的编码操作
|
* 用于执行字节数组到Base64字符串的编码操作
|
||||||
*/
|
*/
|
||||||
val encoder: Base64.Encoder = Base64.getUrlEncoder()
|
val encoder: Base64.Encoder = Base64.getUrlEncoder()
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* Base64解码器实例
|
* Base64解码器实例
|
||||||
* 用于执行Base64字符串到字节数组的解码操作
|
* 用于执行Base64字符串到字节数组的解码操作
|
||||||
*/
|
*/
|
||||||
val decoder: Base64.Decoder = Base64.getUrlDecoder()
|
val decoder: Base64.Decoder = Base64.getUrlDecoder()
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* 将字节数组编码为Base64字符串
|
* 将字节数组编码为Base64字符串
|
||||||
*
|
*
|
||||||
* @param bytes 待编码的字节数组
|
* @param bytes 待编码的字节数组
|
||||||
* @return 编码后的Base64字符串
|
* @return 编码后的Base64字符串
|
||||||
*/
|
*/
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
return encoder.encodeToString(bytes)
|
return encoder.encodeToString(bytes)
|
||||||
}
|
}
|
||||||
|
|
||||||
/*
|
/**
|
||||||
* 将Base64字符串解码为字节数组
|
* 将Base64字符串解码为字节数组
|
||||||
*
|
*
|
||||||
* @param string 待解码的Base64字符串
|
* @param string 待解码的Base64字符串
|
||||||
* @return 解码后的字节数组
|
* @return 解码后的字节数组
|
||||||
*/
|
*/
|
||||||
override fun decode(string: String): ByteArray {
|
override fun decode(string: String): ByteArray {
|
||||||
return decoder.decode(string)
|
return decoder.decode(string)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -29,376 +29,379 @@ package com.mingliqiye.utils.base
|
|||||||
*/
|
*/
|
||||||
internal class Base91Codec : BaseCodec {
|
internal class Base91Codec : BaseCodec {
|
||||||
|
|
||||||
companion object {
|
/**
|
||||||
/**
|
* 伴生对象,持有 Base91 的编码表与解码表。
|
||||||
* Base91 编码表,共 91 个可打印 ASCII 字符。
|
*/
|
||||||
*/
|
companion object {
|
||||||
val ENCODING_TABLE: CharArray = charArrayOf(
|
/**
|
||||||
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
|
* Base91 编码表,共 91 个可打印 ASCII 字符。
|
||||||
'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',
|
val ENCODING_TABLE: CharArray = charArrayOf(
|
||||||
'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',
|
||||||
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '!', '#', '$',
|
'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,用于快速查找字符对应的数值。
|
* Base91 解码表,大小为 256,用于快速查找字符对应的数值。
|
||||||
* 初始化时将所有元素设为 -1,表示无效字符;然后根据 ENCODING_TABLE 填充有效字符的索引。
|
* 初始化时将所有元素设为 -1,表示无效字符;然后根据 ENCODING_TABLE 填充有效字符的索引。
|
||||||
*/
|
*/
|
||||||
val DECODING_TABLE: Array<Int> = arrayOf(
|
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,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-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,
|
62,
|
||||||
90,
|
90,
|
||||||
63,
|
63,
|
||||||
64,
|
64,
|
||||||
65,
|
65,
|
||||||
66,
|
66,
|
||||||
-1,
|
-1,
|
||||||
67,
|
67,
|
||||||
68,
|
68,
|
||||||
69,
|
69,
|
||||||
70,
|
70,
|
||||||
71,
|
71,
|
||||||
-1,
|
-1,
|
||||||
72,
|
72,
|
||||||
73,
|
73,
|
||||||
52,
|
52,
|
||||||
53,
|
53,
|
||||||
54,
|
54,
|
||||||
55,
|
55,
|
||||||
56,
|
56,
|
||||||
57,
|
57,
|
||||||
58,
|
58,
|
||||||
59,
|
59,
|
||||||
60,
|
60,
|
||||||
61,
|
61,
|
||||||
74,
|
74,
|
||||||
75,
|
75,
|
||||||
76,
|
76,
|
||||||
77,
|
77,
|
||||||
78,
|
78,
|
||||||
79,
|
79,
|
||||||
80,
|
80,
|
||||||
0,
|
0,
|
||||||
1,
|
1,
|
||||||
2,
|
2,
|
||||||
3,
|
3,
|
||||||
4,
|
4,
|
||||||
5,
|
5,
|
||||||
6,
|
6,
|
||||||
7,
|
7,
|
||||||
8,
|
8,
|
||||||
9,
|
9,
|
||||||
10,
|
10,
|
||||||
11,
|
11,
|
||||||
12,
|
12,
|
||||||
13,
|
13,
|
||||||
14,
|
14,
|
||||||
15,
|
15,
|
||||||
16,
|
16,
|
||||||
17,
|
17,
|
||||||
18,
|
18,
|
||||||
19,
|
19,
|
||||||
20,
|
20,
|
||||||
21,
|
21,
|
||||||
22,
|
22,
|
||||||
23,
|
23,
|
||||||
24,
|
24,
|
||||||
25,
|
25,
|
||||||
81,
|
81,
|
||||||
-1,
|
-1,
|
||||||
82,
|
82,
|
||||||
83,
|
83,
|
||||||
84,
|
84,
|
||||||
85,
|
85,
|
||||||
26,
|
26,
|
||||||
27,
|
27,
|
||||||
28,
|
28,
|
||||||
29,
|
29,
|
||||||
30,
|
30,
|
||||||
31,
|
31,
|
||||||
32,
|
32,
|
||||||
33,
|
33,
|
||||||
34,
|
34,
|
||||||
35,
|
35,
|
||||||
36,
|
36,
|
||||||
37,
|
37,
|
||||||
38,
|
38,
|
||||||
39,
|
39,
|
||||||
40,
|
40,
|
||||||
41,
|
41,
|
||||||
42,
|
42,
|
||||||
43,
|
43,
|
||||||
44,
|
44,
|
||||||
45,
|
45,
|
||||||
46,
|
46,
|
||||||
47,
|
47,
|
||||||
48,
|
48,
|
||||||
49,
|
49,
|
||||||
50,
|
50,
|
||||||
51,
|
51,
|
||||||
86,
|
86,
|
||||||
87,
|
87,
|
||||||
88,
|
88,
|
||||||
89,
|
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,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-1,
|
-1,
|
||||||
-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 字符串。
|
* 将字节数组编码为 Base91 字符串。
|
||||||
*
|
*
|
||||||
* @param bytes 待编码的字节数组
|
* @param bytes 待编码的字节数组
|
||||||
* @return 编码后的 Base91 字符串
|
* @return 编码后的 Base91 字符串
|
||||||
*/
|
*/
|
||||||
override fun encode(bytes: ByteArray): String {
|
override fun encode(bytes: ByteArray): String {
|
||||||
if (bytes.isEmpty()) return ""
|
if (bytes.isEmpty()) return ""
|
||||||
val sb = StringBuilder()
|
val sb = StringBuilder()
|
||||||
var ebq = 0 // 编码缓冲区,用于暂存待处理的位数据
|
var ebq = 0 // 编码缓冲区,用于暂存待处理的位数据
|
||||||
var en = 0 // 当前缓冲区中的有效位数
|
var en = 0 // 当前缓冲区中的有效位数
|
||||||
|
|
||||||
for (b in bytes) {
|
for (b in bytes) {
|
||||||
// 将当前字节加入缓冲区
|
// 将当前字节加入缓冲区
|
||||||
ebq = ebq or ((b.toInt() and 0xFF) shl en)
|
ebq = ebq or ((b.toInt() and 0xFF) shl en)
|
||||||
en += 8
|
en += 8
|
||||||
|
|
||||||
// 每当缓冲区中有超过 13 位的数据时,尝试进行编码
|
// 每当缓冲区中有超过 13 位的数据时,尝试进行编码
|
||||||
if (en > 13) {
|
if (en > 13) {
|
||||||
var ev = ebq and 0x1FFF // 取出低 13 位作为候选值
|
var ev = ebq and 0x1FFF // 取出低 13 位作为候选值
|
||||||
if (ev > 88) {
|
if (ev > 88) {
|
||||||
// 如果候选值大于 88,则使用 13 位编码
|
// 如果候选值大于 88,则使用 13 位编码
|
||||||
ebq = ebq shr 13
|
ebq = ebq shr 13
|
||||||
en -= 13
|
en -= 13
|
||||||
} else {
|
} else {
|
||||||
// 否则使用 14 位编码
|
// 否则使用 14 位编码
|
||||||
ev = ebq and 0x3FFF
|
ev = ebq and 0x3FFF
|
||||||
ebq = ebq shr 14
|
ebq = ebq shr 14
|
||||||
en -= 14
|
en -= 14
|
||||||
}
|
}
|
||||||
// 将两个字符追加到结果中
|
// 将两个字符追加到结果中
|
||||||
sb.append(ENCODING_TABLE[ev % 91])
|
sb.append(ENCODING_TABLE[ev % 91])
|
||||||
sb.append(ENCODING_TABLE[ev / 91])
|
sb.append(ENCODING_TABLE[ev / 91])
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 处理剩余未编码的数据
|
// 处理剩余未编码的数据
|
||||||
if (en > 0) {
|
if (en > 0) {
|
||||||
sb.append(ENCODING_TABLE[ebq % 91])
|
sb.append(ENCODING_TABLE[ebq % 91])
|
||||||
if (en > 7 || ebq > 90) {
|
if (en > 7 || ebq > 90) {
|
||||||
sb.append(ENCODING_TABLE[ebq / 91])
|
sb.append(ENCODING_TABLE[ebq / 91])
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return sb.toString()
|
return sb.toString()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将 Base91 字符串解码为原始字节数组。
|
* 将 Base91 字符串解码为原始字节数组。
|
||||||
*
|
*
|
||||||
* @param string 待解码的 Base91 字符串
|
* @param string 待解码的 Base91 字符串
|
||||||
* @return 解码后的字节数组
|
* @return 解码后的字节数组
|
||||||
*/
|
*/
|
||||||
override fun decode(string: String): ByteArray {
|
override fun decode(string: String): ByteArray {
|
||||||
if (string.isEmpty()) return ByteArray(0)
|
if (string.isEmpty()) return ByteArray(0)
|
||||||
var dbq = 0 // 解码缓冲区,用于暂存待处理的位数据
|
var dbq = 0 // 解码缓冲区,用于暂存待处理的位数据
|
||||||
var dn = 0 // 当前缓冲区中的有效位数
|
var dn = 0 // 当前缓冲区中的有效位数
|
||||||
var dv = -1 // 当前读取到的 Base91 值
|
var dv = -1 // 当前读取到的 Base91 值
|
||||||
val buffer = ByteArray(string.length * 13 / 8) // 预分配输出缓冲区
|
val buffer = ByteArray(string.length * 13 / 8) // 预分配输出缓冲区
|
||||||
var index = 0 // 输出缓冲区写入位置
|
var index = 0 // 输出缓冲区写入位置
|
||||||
|
|
||||||
for (c in string.toCharArray()) {
|
for (c in string.toCharArray()) {
|
||||||
// 忽略不在编码表中的字符
|
// 忽略不在编码表中的字符
|
||||||
if (DECODING_TABLE[c.code] == -1) continue
|
if (DECODING_TABLE[c.code] == -1) continue
|
||||||
|
|
||||||
if (dv == -1) {
|
if (dv == -1) {
|
||||||
// 第一次读取字符,保存为 dv
|
// 第一次读取字符,保存为 dv
|
||||||
dv = DECODING_TABLE[c.code]
|
dv = DECODING_TABLE[c.code]
|
||||||
} else {
|
} else {
|
||||||
// 第二次读取字符,组合成完整的 Base91 值
|
// 第二次读取字符,组合成完整的 Base91 值
|
||||||
dv += DECODING_TABLE[c.code] * 91
|
dv += DECODING_TABLE[c.code] * 91
|
||||||
dbq = dbq or (dv shl dn)
|
dbq = dbq or (dv shl dn)
|
||||||
// 根据值大小判断是 13 位还是 14 位编码
|
// 根据值大小判断是 13 位还是 14 位编码
|
||||||
dn += if ((dv and 0x1FFF) > 88) 13 else 14
|
dn += if ((dv and 0x1FFF) > 88) 13 else 14
|
||||||
|
|
||||||
// 将缓冲区中完整的字节写入输出数组
|
// 将缓冲区中完整的字节写入输出数组
|
||||||
do {
|
do {
|
||||||
buffer[index++] = (dbq and 0xFF).toByte()
|
buffer[index++] = (dbq and 0xFF).toByte()
|
||||||
dbq = dbq shr 8
|
dbq = dbq shr 8
|
||||||
dn -= 8
|
dn -= 8
|
||||||
} while (dn > 7)
|
} while (dn > 7)
|
||||||
|
|
||||||
dv = -1 // 重置 dv,准备下一轮读取
|
dv = -1 // 重置 dv,准备下一轮读取
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 处理最后剩余的一个字符(如果存在)
|
// 处理最后剩余的一个字符(如果存在)
|
||||||
if (dv != -1) {
|
if (dv != -1) {
|
||||||
buffer[index++] = ((dbq or (dv shl dn)) and 0xFF).toByte()
|
buffer[index++] = ((dbq or (dv shl dn)) and 0xFF).toByte()
|
||||||
}
|
}
|
||||||
|
|
||||||
// 返回实际使用的部分
|
// 返回实际使用的部分
|
||||||
return buffer.copyOf(index)
|
return buffer.copyOf(index)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -33,146 +33,146 @@ import java.nio.file.Path
|
|||||||
*/
|
*/
|
||||||
interface BaseCodec {
|
interface BaseCodec {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对字节数组进行编码,并捕获可能发生的异常。
|
* 对字节数组进行编码,并捕获可能发生的异常。
|
||||||
*
|
*
|
||||||
* @param bytes 需要编码的字节数组
|
* @param bytes 需要编码的字节数组
|
||||||
* @return 编码后的字符串结果
|
* @return 编码后的字符串结果
|
||||||
* @throws CodecException 如果编码过程中发生异常
|
* @throws CodecException 如果编码过程中发生异常
|
||||||
*/
|
*/
|
||||||
fun catchEncode(bytes: ByteArray) = try {
|
fun catchEncode(bytes: ByteArray) = try {
|
||||||
encode(bytes)
|
encode(bytes)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw CodecException(throwable = e)
|
throw CodecException(throwable = e)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对字符串进行解码,并捕获可能发生的异常。
|
* 对字符串进行解码,并捕获可能发生的异常。
|
||||||
*
|
*
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
* @return 解码后的字节数组结果
|
* @return 解码后的字节数组结果
|
||||||
* @throws CodecException 如果解码过程中发生异常
|
* @throws CodecException 如果解码过程中发生异常
|
||||||
*/
|
*/
|
||||||
fun catchDecode(string: String) = try {
|
fun catchDecode(string: String) = try {
|
||||||
decode(string)
|
decode(string)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw CodecException(throwable = e)
|
throw CodecException(throwable = e)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字节数组编码为字符串。
|
* 将字节数组编码为字符串。
|
||||||
*
|
*
|
||||||
* @param bytes 需要编码的字节数组
|
* @param bytes 需要编码的字节数组
|
||||||
* @return 编码后的字符串结果
|
* @return 编码后的字符串结果
|
||||||
*/
|
*/
|
||||||
fun encode(bytes: ByteArray): String
|
fun encode(bytes: ByteArray): String
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字符串解码为字节数组。
|
* 将字符串解码为字节数组。
|
||||||
*
|
*
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
* @return 解码后的字节数组结果
|
* @return 解码后的字节数组结果
|
||||||
*/
|
*/
|
||||||
fun decode(string: String): ByteArray
|
fun decode(string: String): ByteArray
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对文件内容进行编码。
|
* 对文件内容进行编码。
|
||||||
*
|
*
|
||||||
* @param file 需要编码的文件对象
|
* @param file 需要编码的文件对象
|
||||||
* @return 文件内容编码后的字符串结果
|
* @return 文件内容编码后的字符串结果
|
||||||
*/
|
*/
|
||||||
fun encode(file: File) = catchEncode(file.readBytes())
|
fun encode(file: File) = catchEncode(file.readBytes())
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字符串解码后写入指定文件。
|
* 将字符串解码后写入指定文件。
|
||||||
*
|
*
|
||||||
* @param file 目标文件对象
|
* @param file 目标文件对象
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
*/
|
*/
|
||||||
fun decode(file: File, string: String) =
|
fun decode(file: File, string: String) =
|
||||||
file.writeBytes(catchDecode(string))
|
file.writeBytes(catchDecode(string))
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 安全地对文件内容进行编码,如果发生异常则返回 null。
|
* 安全地对文件内容进行编码,如果发生异常则返回 null。
|
||||||
*
|
*
|
||||||
* @param file 需要编码的文件对象
|
* @param file 需要编码的文件对象
|
||||||
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
||||||
*/
|
*/
|
||||||
fun encodeSafe(file: File) = try {
|
fun encodeSafe(file: File) = try {
|
||||||
encode(file)
|
encode(file)
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。
|
* 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。
|
||||||
*
|
*
|
||||||
* @param file 目标文件对象
|
* @param file 目标文件对象
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
* @return 操作是否成功的布尔值
|
* @return 操作是否成功的布尔值
|
||||||
*/
|
*/
|
||||||
fun decodeSafe(file: File, string: String) = try {
|
fun decodeSafe(file: File, string: String) = try {
|
||||||
decode(file, string)
|
decode(file, string)
|
||||||
true
|
true
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
false
|
false
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对路径指向的文件内容进行编码。
|
* 对路径指向的文件内容进行编码。
|
||||||
*
|
*
|
||||||
* @param path 需要编码的文件路径
|
* @param path 需要编码的文件路径
|
||||||
* @return 文件内容编码后的字符串结果
|
* @return 文件内容编码后的字符串结果
|
||||||
*/
|
*/
|
||||||
fun encode(path: Path) = catchEncode(path.toFile().readBytes())
|
fun encode(path: Path) = catchEncode(path.toFile().readBytes())
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字符串解码后写入指定路径的文件。
|
* 将字符串解码后写入指定路径的文件。
|
||||||
*
|
*
|
||||||
* @param path 目标文件路径
|
* @param path 目标文件路径
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
*/
|
*/
|
||||||
fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string))
|
fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string))
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。
|
* 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。
|
||||||
*
|
*
|
||||||
* @param path 需要编码的文件路径
|
* @param path 需要编码的文件路径
|
||||||
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
||||||
*/
|
*/
|
||||||
fun encodeSafe(path: Path) = try {
|
fun encodeSafe(path: Path) = try {
|
||||||
encode(path)
|
encode(path)
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 安全地将字符串解码并写入指定路径的文件,如果成功则返回 true,否则返回 false。
|
* 安全地将字符串解码并写入指定路径的文件,如果成功则返回 true,否则返回 false。
|
||||||
*
|
*
|
||||||
* @param path 目标文件路径
|
* @param path 目标文件路径
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
* @return 操作是否成功的布尔值
|
* @return 操作是否成功的布尔值
|
||||||
*/
|
*/
|
||||||
fun decodeSafe(path: Path, string: String) = try {
|
fun decodeSafe(path: Path, string: String) = try {
|
||||||
decode(path, string)
|
decode(path, string)
|
||||||
true
|
true
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
false
|
false
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对字符串进行编码。
|
* 对字符串进行编码。
|
||||||
*
|
*
|
||||||
* @param string 需要编码的字符串
|
* @param string 需要编码的字符串
|
||||||
* @return 编码后的字符串结果
|
* @return 编码后的字符串结果
|
||||||
*/
|
*/
|
||||||
fun encode(string: String) = catchEncode(string.toByteArray())
|
fun encode(string: String) = catchEncode(string.toByteArray())
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字符串解码为 UTF-8 格式的字符串。
|
* 将字符串解码为 UTF-8 格式的字符串。
|
||||||
*
|
*
|
||||||
* @param string 需要解码的字符串
|
* @param string 需要解码的字符串
|
||||||
* @return 解码后的 UTF-8 字符串结果
|
* @return 解码后的 UTF-8 字符串结果
|
||||||
*/
|
*/
|
||||||
fun decodetoString(string: String) = catchDecode(string).toString(Charsets.UTF_8)
|
fun decodetoString(string: String) = catchDecode(string).toString(Charsets.UTF_8)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,23 +16,55 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile BaseType.kt
|
* CurrentFile BaseType.kt
|
||||||
* LastUpdate 2026-03-12 10:08:42
|
* LastUpdate 2026-11-16 14:21:51
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
package com.mingliqiye.utils.base
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
enum class BaseType(val baseCodec: BaseCodec) : BaseCodec {
|
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
|
||||||
|
|
||||||
BASE2(com.mingliqiye.utils.base.code.BASE2),
|
/**
|
||||||
BASE10(com.mingliqiye.utils.base.code.BASE10),
|
* Base 编码类型枚举。
|
||||||
BASE16(com.mingliqiye.utils.base.code.BASE16),
|
*
|
||||||
BASE64(com.mingliqiye.utils.base.code.BASE64),
|
* 每个枚举项持有一个编解码器的工厂函数,枚举本身实现了 [BaseCodec],
|
||||||
BASE64URL(com.mingliqiye.utils.base.code.BASE64URL),
|
* 可直接作为编解码器使用,编码与解码操作委托给对应的编解码器实例。
|
||||||
BASE91(com.mingliqiye.utils.base.code.BASE91),
|
*
|
||||||
BASE256(com.mingliqiye.utils.base.code.BASE256);
|
* @param baseCodec 编解码器的工厂函数,每次访问 [codec] 时调用以创建实例
|
||||||
|
*/
|
||||||
|
enum class BaseType(private val baseCodec: () -> BaseCodec) : BaseCodec {
|
||||||
|
|
||||||
override fun encode(bytes: ByteArray) = baseCodec.encode(bytes)
|
/** 二进制(Base2)编解码。 */
|
||||||
override fun decode(string: String) = baseCodec.decode(string)
|
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)
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile BaseCodes.kt
|
* CurrentFile BaseCodes.kt
|
||||||
* LastUpdate 2026-03-12 10:03:32
|
* LastUpdate 2026-11-16 14:10:57
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -32,7 +32,7 @@ import com.mingliqiye.utils.base.*
|
|||||||
*/
|
*/
|
||||||
@get:JvmName("base2")
|
@get:JvmName("base2")
|
||||||
val BASE2: BaseCodec by lazy {
|
val BASE2: BaseCodec by lazy {
|
||||||
Base2Codec()
|
Base2Codec()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -41,7 +41,7 @@ val BASE2: BaseCodec by lazy {
|
|||||||
*/
|
*/
|
||||||
@get:JvmName("base10")
|
@get:JvmName("base10")
|
||||||
val BASE10: BaseCodec by lazy {
|
val BASE10: BaseCodec by lazy {
|
||||||
Base10Codec()
|
Base10Codec()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -50,7 +50,7 @@ val BASE10: BaseCodec by lazy {
|
|||||||
*/
|
*/
|
||||||
@get:JvmName("base16")
|
@get:JvmName("base16")
|
||||||
val BASE16: BaseCodec by lazy {
|
val BASE16: BaseCodec by lazy {
|
||||||
Base16Codec()
|
Base16Codec()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -59,21 +59,35 @@ val BASE16: BaseCodec by lazy {
|
|||||||
*/
|
*/
|
||||||
@get:JvmName("base64")
|
@get:JvmName("base64")
|
||||||
val BASE64: BaseCodec by lazy {
|
val BASE64: BaseCodec by lazy {
|
||||||
Base64Codec()
|
Base64Codec()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base64 URL编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为URL安全的Base64格式。
|
||||||
|
*/
|
||||||
@get:JvmName("base64Url")
|
@get:JvmName("base64Url")
|
||||||
val BASE64URL: BaseCodec by lazy {
|
val BASE64_URL: BaseCodec by lazy {
|
||||||
Base64UrlCodec()
|
Base64UrlCodec()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供无填充Base64 URL编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为URL安全的Base64格式,且结果不带末尾的'='填充字符。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base64NoPadding")
|
||||||
|
val BASE64_NO_PADDING: BaseCodec by lazy {
|
||||||
|
Base64NoPaddingCodec()
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 提供Base91编码器的懒加载实例。
|
* 提供Base91编码器的懒加载实例。
|
||||||
* 该编码器用于将数据编码为Base91格式,具有较高的压缩效率。
|
* 该编码器用于将数据编码为Base91格式,具有较高的压缩效率。
|
||||||
*/
|
*/
|
||||||
@get:JvmName("base91")
|
@get:JvmName("base91")
|
||||||
val BASE91: BaseCodec by lazy {
|
val BASE91: BaseCodec by lazy {
|
||||||
Base91Codec()
|
Base91Codec()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -82,5 +96,5 @@ val BASE91: BaseCodec by lazy {
|
|||||||
*/
|
*/
|
||||||
@get:JvmName("base256")
|
@get:JvmName("base256")
|
||||||
val BASE256: BaseCodec by lazy {
|
val BASE256: BaseCodec by lazy {
|
||||||
Base256Codec()
|
Base256Codec()
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -29,31 +29,69 @@ import java.security.SecureRandom
|
|||||||
import org.mindrot.jbcrypt.BCrypt as JBCrypt
|
import org.mindrot.jbcrypt.BCrypt as JBCrypt
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用随机生成的盐对字符串进行 BCrypt 哈希。
|
||||||
|
*
|
||||||
|
* @param string 需要哈希的明文字符串
|
||||||
|
* @return BCrypt 哈希字符串
|
||||||
|
*/
|
||||||
fun hashpw(string: String): String {
|
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 {
|
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 {
|
fun checkpw(string: String, bcrypted: String): Boolean {
|
||||||
return JBCrypt.checkpw(string, bcrypted)
|
return JBCrypt.checkpw(string, bcrypted)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 生成默认工作因子(10)的 BCrypt 盐。
|
||||||
|
*
|
||||||
|
* @return BCrypt 盐字符串
|
||||||
|
*/
|
||||||
fun gensalt(): String {
|
fun gensalt(): String {
|
||||||
return JBCrypt.gensalt()
|
return JBCrypt.gensalt()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 生成指定工作因子的 BCrypt 盐。
|
||||||
|
*
|
||||||
|
* @param long 工作因子(log2 迭代次数),值越大计算越慢
|
||||||
|
* @return BCrypt 盐字符串
|
||||||
|
*/
|
||||||
fun gensalt(long: Int): String {
|
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 {
|
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
+251
-144
@@ -33,244 +33,351 @@ import java.util.*
|
|||||||
import java.util.concurrent.ConcurrentHashMap
|
import java.util.concurrent.ConcurrentHashMap
|
||||||
import java.util.UUID as JUUID
|
import java.util.UUID as JUUID
|
||||||
|
|
||||||
|
/**
|
||||||
|
* ByteBufferWrapper 类型转换器接口。
|
||||||
|
*
|
||||||
|
* 定义某种类型与 [ByteBufferWrapper] 之间的读写规则。
|
||||||
|
*
|
||||||
|
* @param T 该转换器处理的数据类型
|
||||||
|
*/
|
||||||
interface ByteBufferWrapperConvertorInterface<T : Any> {
|
interface ByteBufferWrapperConvertorInterface<T : Any> {
|
||||||
fun write(obj: T, byteBufferWrapper: ByteBufferWrapper)
|
/**
|
||||||
fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T
|
* 将对象写入缓冲区。
|
||||||
fun getType(): Class<T>
|
*
|
||||||
|
* @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> {
|
abstract class ByteBufferWrapperConvertor<T : Any> : ByteBufferWrapperConvertorInterface<T> {
|
||||||
override fun toString(): String {
|
/**
|
||||||
return "ByteBufferWrapperConvertor(type=${getType()})"
|
* 返回包含所处理类型信息的字符串表示。
|
||||||
}
|
*/
|
||||||
|
override fun toString(): String {
|
||||||
|
return "ByteBufferWrapperConvertor(type=${getType()})"
|
||||||
|
}
|
||||||
|
|
||||||
companion object {
|
/**
|
||||||
private val _instantiations =
|
* 伴生对象,管理转换器实例缓存并提供默认转换器安装方法。
|
||||||
ConcurrentHashMap<Class<ByteBufferWrapperConvertor<*>>, ByteBufferWrapperConvertor<*>>()
|
*/
|
||||||
|
companion object {
|
||||||
|
private val _instantiations =
|
||||||
|
ConcurrentHashMap<Class<ByteBufferWrapperConvertor<*>>, ByteBufferWrapperConvertor<*>>()
|
||||||
|
|
||||||
@JvmStatic
|
/**
|
||||||
fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> {
|
* 获取指定转换器类的实例,不存在时通过无参构造函数创建并缓存。
|
||||||
return _instantiations.getOrPut(clazz) {
|
*
|
||||||
clazz.getConstructor().newInstance()
|
* @param clazz 转换器类对应的 Class 对象
|
||||||
}
|
* @return 缓存的或新创建的转换器实例
|
||||||
}
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> {
|
||||||
|
return _instantiations.getOrPut(clazz) {
|
||||||
|
clazz.getConstructor().newInstance()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
@JvmStatic
|
/**
|
||||||
@Suppress("UNCHECKED_CAST")
|
* 获取具体化类型 T 对应的转换器实例,不存在时创建并缓存。
|
||||||
inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> {
|
*
|
||||||
return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>)
|
* @param T 转换器类型,必须提供无参构造函数
|
||||||
}
|
* @return 缓存的或新创建的转换器实例
|
||||||
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
@Suppress("UNCHECKED_CAST")
|
||||||
|
inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> {
|
||||||
|
return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>)
|
||||||
|
}
|
||||||
|
|
||||||
fun defaultConvertorInstall() {
|
/**
|
||||||
ByteBufferWrapper.addConvertor<BigDecimalBufferWrapperConvertor>()
|
* 安装所有默认转换器。
|
||||||
ByteBufferWrapper.addConvertor<BigIntegerBufferWrapperConvertor>()
|
*
|
||||||
ByteBufferWrapper.addConvertor<BooleanBufferWrapperConvertor>()
|
* 将基础类型、大数、字符串、时间、UUID 及各类数组的转换器注册到 [ByteBufferWrapper]。
|
||||||
ByteBufferWrapper.addConvertor<BytedBufferWrapperConvertor>()
|
*/
|
||||||
ByteBufferWrapper.addConvertor<ByteFlagsBufferWrapperConvertor>()
|
fun defaultConvertorInstall() {
|
||||||
ByteBufferWrapper.addConvertor<CharBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<BigDecimalBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<DateBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<BigIntegerBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<DateTimeFlagsBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<BooleanBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<DoubleBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<BytedBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<FloatBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<ByteFlagsBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<IntBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<CharBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<JUUIDBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<DateBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<LocalDateTimeBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<DateTimeFlagsBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<LongBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<DoubleBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<ShortBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<FloatBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<StringBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<IntBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<UUIDBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<JUUIDBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<ByteArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<LocalDateTimeBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<CharArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<LongBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<ShortArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<ShortBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<IntArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<StringBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<LongArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<UUIDBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<FloatArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<ByteArrayBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<DoubleArrayBufferWrapperConvertor>()
|
ByteBufferWrapper.addConvertor<CharArrayBufferWrapperConvertor>()
|
||||||
ByteBufferWrapper.addConvertor<BooleanArrayBufferWrapperConvertor>()
|
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>(
|
abstract class ObjectBufferWrapperConvertor<T : Any>(
|
||||||
val write: ByteBufferWrapper.(obj: T) -> Unit,
|
val write: ByteBufferWrapper.(obj: T) -> Unit,
|
||||||
val read: ByteBufferWrapper.() -> T,
|
val read: ByteBufferWrapper.() -> T,
|
||||||
val typer: Class<T>,
|
val typer: Class<T>,
|
||||||
) : ByteBufferWrapperConvertor<T>() {
|
) : ByteBufferWrapperConvertor<T>() {
|
||||||
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
|
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
|
||||||
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T =
|
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T =
|
||||||
read.invoke(byteBufferWrapper)
|
read.invoke(byteBufferWrapper)
|
||||||
|
|
||||||
override fun getType(): Class<T> = typer
|
override fun getType(): Class<T> = typer
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/** [Byte] 类型转换器,使用 putByte/getByte 读写。 */
|
||||||
class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>(
|
class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>(
|
||||||
ByteBufferWrapper::putByte,
|
ByteBufferWrapper::putByte,
|
||||||
ByteBufferWrapper::getByte,
|
ByteBufferWrapper::getByte,
|
||||||
Byte::class.java,
|
Byte::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Char] 类型转换器,使用 putChar/getChar 读写。 */
|
||||||
class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>(
|
class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>(
|
||||||
ByteBufferWrapper::putChar,
|
ByteBufferWrapper::putChar,
|
||||||
ByteBufferWrapper::getChar,
|
ByteBufferWrapper::getChar,
|
||||||
Char::class.java,
|
Char::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Short] 类型转换器,使用 putShort/getShort 读写。 */
|
||||||
class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>(
|
class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>(
|
||||||
ByteBufferWrapper::putShort,
|
ByteBufferWrapper::putShort,
|
||||||
ByteBufferWrapper::getShort,
|
ByteBufferWrapper::getShort,
|
||||||
Short::class.java,
|
Short::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Int] 类型转换器,使用 putInt/getInt 读写。 */
|
||||||
class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>(
|
class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>(
|
||||||
ByteBufferWrapper::putInt,
|
ByteBufferWrapper::putInt,
|
||||||
ByteBufferWrapper::getInt,
|
ByteBufferWrapper::getInt,
|
||||||
Int::class.java,
|
Int::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Long] 类型转换器,使用 putLong/getLong 读写。 */
|
||||||
class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>(
|
class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>(
|
||||||
ByteBufferWrapper::putLong,
|
ByteBufferWrapper::putLong,
|
||||||
ByteBufferWrapper::getLong,
|
ByteBufferWrapper::getLong,
|
||||||
Long::class.java,
|
Long::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Double] 类型转换器,使用 putDouble/getDouble 读写。 */
|
||||||
class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>(
|
class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>(
|
||||||
ByteBufferWrapper::putDouble,
|
ByteBufferWrapper::putDouble,
|
||||||
ByteBufferWrapper::getDouble,
|
ByteBufferWrapper::getDouble,
|
||||||
Double::class.java,
|
Double::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Float] 类型转换器,使用 putFloat/getFloat 读写。 */
|
||||||
class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>(
|
class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>(
|
||||||
ByteBufferWrapper::putFloat,
|
ByteBufferWrapper::putFloat,
|
||||||
ByteBufferWrapper::getFloat,
|
ByteBufferWrapper::getFloat,
|
||||||
Float::class.java,
|
Float::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [BigInteger] 类型转换器,使用 putBigInteger/getBigInteger 读写。 */
|
||||||
class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>(
|
class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>(
|
||||||
ByteBufferWrapper::putBigInteger,
|
ByteBufferWrapper::putBigInteger,
|
||||||
ByteBufferWrapper::getBigInteger,
|
ByteBufferWrapper::getBigInteger,
|
||||||
BigInteger::class.java,
|
BigInteger::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [BigDecimal] 类型转换器,使用 putBigDecimal/getBigDecimal 读写。 */
|
||||||
class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>(
|
class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>(
|
||||||
ByteBufferWrapper::putBigDecimal,
|
ByteBufferWrapper::putBigDecimal,
|
||||||
ByteBufferWrapper::getBigDecimal,
|
ByteBufferWrapper::getBigDecimal,
|
||||||
BigDecimal::class.java,
|
BigDecimal::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Boolean] 类型转换器,使用 putBoolean/getBoolean 读写。 */
|
||||||
class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>(
|
class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>(
|
||||||
ByteBufferWrapper::putBoolean,
|
ByteBufferWrapper::putBoolean,
|
||||||
ByteBufferWrapper::getBoolean,
|
ByteBufferWrapper::getBoolean,
|
||||||
Boolean::class.java,
|
Boolean::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [String] 类型转换器,使用 putString/getString 读写。 */
|
||||||
class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>(
|
class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>(
|
||||||
ByteBufferWrapper::putString,
|
ByteBufferWrapper::putString,
|
||||||
ByteBufferWrapper::getString,
|
ByteBufferWrapper::getString,
|
||||||
String::class.java,
|
String::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [ByteFlags] 类型转换器,使用 putFlag/getFlag 读写。 */
|
||||||
class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>(
|
class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>(
|
||||||
ByteBufferWrapper::putFlag,
|
ByteBufferWrapper::putFlag,
|
||||||
ByteBufferWrapper::getFlag,
|
ByteBufferWrapper::getFlag,
|
||||||
ByteFlags::class.java,
|
ByteFlags::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
|
/** Java [JUUID] 类型转换器,使用 putUUID/getJUUID 读写。 */
|
||||||
class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>(
|
class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>(
|
||||||
ByteBufferWrapper::putUUID,
|
ByteBufferWrapper::putUUID,
|
||||||
ByteBufferWrapper::getJUUID,
|
ByteBufferWrapper::getJUUID,
|
||||||
JUUID::class.java,
|
JUUID::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** 自定义 [UUID] 类型转换器,使用 putUUID/getUUID 读写。 */
|
||||||
class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>(
|
class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>(
|
||||||
ByteBufferWrapper::putUUID,
|
ByteBufferWrapper::putUUID,
|
||||||
ByteBufferWrapper::getUUID,
|
ByteBufferWrapper::getUUID,
|
||||||
UUID::class.java,
|
UUID::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [DateTime] 类型转换器,使用 putDateTime/getDateTime 读写。 */
|
||||||
class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>(
|
class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>(
|
||||||
ByteBufferWrapper::putDateTime,
|
ByteBufferWrapper::putDateTime,
|
||||||
ByteBufferWrapper::getDateTime,
|
ByteBufferWrapper::getDateTime,
|
||||||
DateTime::class.java,
|
DateTime::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [LocalDateTime] 类型转换器,使用 putLocalDateTime/getLocalDateTime 读写。 */
|
||||||
class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>(
|
class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>(
|
||||||
ByteBufferWrapper::putLocalDateTime,
|
ByteBufferWrapper::putLocalDateTime,
|
||||||
ByteBufferWrapper::getLocalDateTime,
|
ByteBufferWrapper::getLocalDateTime,
|
||||||
LocalDateTime::class.java,
|
LocalDateTime::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [Date] 类型转换器,使用 putDate/getDate 读写。 */
|
||||||
class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>(
|
class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>(
|
||||||
ByteBufferWrapper::putDate,
|
ByteBufferWrapper::putDate,
|
||||||
ByteBufferWrapper::getDate,
|
ByteBufferWrapper::getDate,
|
||||||
Date::class.java,
|
Date::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于读写函数构造的通用数组转换器。
|
||||||
|
*
|
||||||
|
* 读取时要求额外参数的第一个元素为 Int 类型的数组长度。
|
||||||
|
*
|
||||||
|
* @param T 该转换器处理的数组类型
|
||||||
|
* @param write 写入函数,将数组写入缓冲区
|
||||||
|
* @param read 读取函数,按指定长度从缓冲区读取数组
|
||||||
|
* @param typer 该转换器处理的数组类型对应的 Class 对象
|
||||||
|
*/
|
||||||
abstract class ArrayBufferWrapperConvertor<T : Any>(
|
abstract class ArrayBufferWrapperConvertor<T : Any>(
|
||||||
val write: ByteBufferWrapper.(obj: T) -> Unit,
|
val write: ByteBufferWrapper.(obj: T) -> Unit,
|
||||||
val read: ByteBufferWrapper.(size: Int) -> T,
|
val read: ByteBufferWrapper.(size: Int) -> T,
|
||||||
val typer: Class<T>,
|
val typer: Class<T>,
|
||||||
) : ByteBufferWrapperConvertor<T>() {
|
) : ByteBufferWrapperConvertor<T>() {
|
||||||
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
|
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
|
||||||
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T {
|
/**
|
||||||
if (parameters.isEmpty()) {
|
* 从缓冲区读取数组,要求 parameters[0] 为 Int 类型的长度。
|
||||||
throw IllegalArgumentException("parameters cannot be empty, must has a Int")
|
*
|
||||||
}
|
* @throws IllegalArgumentException 如果参数为空或第一个参数不是 Int
|
||||||
val size = parameters[0]
|
*/
|
||||||
if (size !is Int)
|
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T {
|
||||||
throw IllegalArgumentException("parameters[0] cannot be Int, must has a Int")
|
if (parameters.isEmpty()) {
|
||||||
return read.invoke(byteBufferWrapper, size)
|
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
|
override fun getType(): Class<T> = typer
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** [ByteArray] 类型转换器,使用 putByteArray/getByteArray 读写。 */
|
||||||
class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>(
|
class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>(
|
||||||
ByteBufferWrapper::putByteArray,
|
ByteBufferWrapper::putByteArray,
|
||||||
ByteBufferWrapper::getByteArray,
|
ByteBufferWrapper::getByteArray,
|
||||||
ByteArray::class.java,
|
ByteArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [CharArray] 类型转换器,使用 putCharArray/getCharArray 读写。 */
|
||||||
class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>(
|
class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>(
|
||||||
ByteBufferWrapper::putCharArray,
|
ByteBufferWrapper::putCharArray,
|
||||||
ByteBufferWrapper::getCharArray,
|
ByteBufferWrapper::getCharArray,
|
||||||
CharArray::class.java,
|
CharArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [ShortArray] 类型转换器,使用 putShortArray/getShortArray 读写。 */
|
||||||
class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>(
|
class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>(
|
||||||
ByteBufferWrapper::putShortArray,
|
ByteBufferWrapper::putShortArray,
|
||||||
ByteBufferWrapper::getShortArray,
|
ByteBufferWrapper::getShortArray,
|
||||||
ShortArray::class.java,
|
ShortArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [IntArray] 类型转换器,使用 putIntArray/getIntArray 读写。 */
|
||||||
class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>(
|
class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>(
|
||||||
ByteBufferWrapper::putIntArray,
|
ByteBufferWrapper::putIntArray,
|
||||||
ByteBufferWrapper::getIntArray,
|
ByteBufferWrapper::getIntArray,
|
||||||
IntArray::class.java,
|
IntArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [LongArray] 类型转换器,使用 putLongArray/getLongArray 读写。 */
|
||||||
class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>(
|
class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>(
|
||||||
ByteBufferWrapper::putLongArray,
|
ByteBufferWrapper::putLongArray,
|
||||||
ByteBufferWrapper::getLongArray,
|
ByteBufferWrapper::getLongArray,
|
||||||
LongArray::class.java,
|
LongArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [FloatArray] 类型转换器,使用 putFloatArray/getFloatArray 读写。 */
|
||||||
class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>(
|
class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>(
|
||||||
ByteBufferWrapper::putFloatArray,
|
ByteBufferWrapper::putFloatArray,
|
||||||
ByteBufferWrapper::getFloatArray,
|
ByteBufferWrapper::getFloatArray,
|
||||||
FloatArray::class.java,
|
FloatArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
/** [DoubleArray] 类型转换器,使用 putDoubleArray/getDoubleArray 读写。 */
|
||||||
class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>(
|
class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>(
|
||||||
ByteBufferWrapper::putDoubleArray,
|
ByteBufferWrapper::putDoubleArray,
|
||||||
ByteBufferWrapper::getDoubleArray,
|
ByteBufferWrapper::getDoubleArray,
|
||||||
DoubleArray::class.java,
|
DoubleArray::class.java,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
|
/** [BooleanArray] 类型转换器,使用 putBooleanArray/getBooleanArray 读写。 */
|
||||||
class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>(
|
class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>(
|
||||||
ByteBufferWrapper::putBooleanArray,
|
ByteBufferWrapper::putBooleanArray,
|
||||||
ByteBufferWrapper::getBooleanArray,
|
ByteBufferWrapper::getBooleanArray,
|
||||||
BooleanArray::class.java,
|
BooleanArray::class.java,
|
||||||
)
|
)
|
||||||
|
|||||||
@@ -40,7 +40,7 @@ import java.nio.charset.Charset
|
|||||||
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer =
|
fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer =
|
||||||
this.put(string.toByteArray(charset)).put(0x00)
|
this.put(string.toByteArray(charset)).put(0x00)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。
|
* 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。
|
||||||
@@ -53,15 +53,15 @@ fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): Byt
|
|||||||
* @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符)
|
* @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符)
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
|
fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
|
||||||
val data = ArrayList<Byte>()
|
val data = ArrayList<Byte>()
|
||||||
while (true) {
|
while (true) {
|
||||||
val byte = this.get()
|
val byte = this.get()
|
||||||
if (byte == 0x00.toByte()) {
|
if (byte == 0x00.toByte()) {
|
||||||
break
|
break
|
||||||
}
|
}
|
||||||
data.add(byte)
|
data.add(byte)
|
||||||
}
|
}
|
||||||
return String(data.toByteArray(), charset)
|
return String(data.toByteArray(), charset)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -72,9 +72,9 @@ fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
|
|||||||
* @return 包含剩余字节的新字节数组
|
* @return 包含剩余字节的新字节数组
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.toByteArray(): ByteArray {
|
fun ByteBuffer.toByteArray(): ByteArray {
|
||||||
val ba = ByteArray(this.remaining())
|
val ba = ByteArray(this.remaining())
|
||||||
this.get(ba)
|
this.get(ba)
|
||||||
return ba
|
return ba
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -87,18 +87,18 @@ fun ByteBuffer.toByteArray(): ByteArray {
|
|||||||
* @throws IndexOutOfBoundsException 如果列表长度不足 8
|
* @throws IndexOutOfBoundsException 如果列表长度不足 8
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.putByteFlags(
|
fun ByteBuffer.putByteFlags(
|
||||||
bit: List<Boolean> = List(8) { false },
|
bit: List<Boolean> = List(8) { false },
|
||||||
): ByteBuffer = this.putByteFlags(
|
): ByteBuffer = this.putByteFlags(
|
||||||
ByteFlags(
|
ByteFlags(
|
||||||
bit[0],
|
bit[0],
|
||||||
bit[1],
|
bit[1],
|
||||||
bit[2],
|
bit[2],
|
||||||
bit[3],
|
bit[3],
|
||||||
bit[4],
|
bit[4],
|
||||||
bit[5],
|
bit[5],
|
||||||
bit[6],
|
bit[6],
|
||||||
bit[7],
|
bit[7],
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -111,18 +111,18 @@ fun ByteBuffer.putByteFlags(
|
|||||||
* @throws IndexOutOfBoundsException 如果数组长度不足 8
|
* @throws IndexOutOfBoundsException 如果数组长度不足 8
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.putByteFlags(
|
fun ByteBuffer.putByteFlags(
|
||||||
bit: BooleanArray = BooleanArray(8),
|
bit: BooleanArray = BooleanArray(8),
|
||||||
): ByteBuffer = this.putByteFlags(
|
): ByteBuffer = this.putByteFlags(
|
||||||
ByteFlags(
|
ByteFlags(
|
||||||
bit[0],
|
bit[0],
|
||||||
bit[1],
|
bit[1],
|
||||||
bit[2],
|
bit[2],
|
||||||
bit[3],
|
bit[3],
|
||||||
bit[4],
|
bit[4],
|
||||||
bit[5],
|
bit[5],
|
||||||
bit[6],
|
bit[6],
|
||||||
bit[7],
|
bit[7],
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -149,25 +149,25 @@ fun ByteBuffer.putByteFlags(byteFlags: ByteFlags): ByteBuffer = this.put(byteFla
|
|||||||
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.putByteFlags(
|
fun ByteBuffer.putByteFlags(
|
||||||
bit0: Boolean = false,
|
bit0: Boolean = false,
|
||||||
bit1: Boolean = false,
|
bit1: Boolean = false,
|
||||||
bit2: Boolean = false,
|
bit2: Boolean = false,
|
||||||
bit3: Boolean = false,
|
bit3: Boolean = false,
|
||||||
bit4: Boolean = false,
|
bit4: Boolean = false,
|
||||||
bit5: Boolean = false,
|
bit5: Boolean = false,
|
||||||
bit6: Boolean = false,
|
bit6: Boolean = false,
|
||||||
bit7: Boolean = false,
|
bit7: Boolean = false,
|
||||||
): ByteBuffer = this.putByteFlags(
|
): ByteBuffer = this.putByteFlags(
|
||||||
ByteFlags(
|
ByteFlags(
|
||||||
bit0,
|
bit0,
|
||||||
bit1,
|
bit1,
|
||||||
bit2,
|
bit2,
|
||||||
bit3,
|
bit3,
|
||||||
bit4,
|
bit4,
|
||||||
bit5,
|
bit5,
|
||||||
bit6,
|
bit6,
|
||||||
bit7,
|
bit7,
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -204,7 +204,7 @@ fun ByteBuffer.putBoolean(boolean: Boolean): ByteBuffer = this.put(if (boolean)
|
|||||||
* @return 包装后的 [ByteBuffer] 实例
|
* @return 包装后的 [ByteBuffer] 实例
|
||||||
*/
|
*/
|
||||||
fun ByteArray.toByteBuffer(): ByteBuffer {
|
fun ByteArray.toByteBuffer(): ByteBuffer {
|
||||||
return ByteBuffer.wrap(this)
|
return ByteBuffer.wrap(this)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -219,19 +219,19 @@ fun ByteArray.toByteBuffer(): ByteBuffer {
|
|||||||
* @throws IOException 当读取过程中发生IO异常时抛出。
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.getVarLong(size: Int = 8): Long {
|
fun ByteBuffer.getVarLong(size: Int = 8): Long {
|
||||||
var numRead = 0
|
var numRead = 0
|
||||||
var result: Long = 0
|
var result: Long = 0
|
||||||
var read: Byte
|
var read: Byte
|
||||||
do {
|
do {
|
||||||
read = this.get()
|
read = this.get()
|
||||||
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
|
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
|
||||||
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||||
numRead++
|
numRead++
|
||||||
if (numRead > size) {
|
if (numRead > size) {
|
||||||
throw IOException("VarNumber is too big")
|
throw IOException("VarNumber is too big")
|
||||||
}
|
}
|
||||||
} while ((read.toLong() and 128) != 0L)
|
} while ((read.toLong() and 128) != 0L)
|
||||||
return result
|
return result
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -269,13 +269,13 @@ fun ByteBuffer.getVarLong(): Long = this.getVarLong(8)
|
|||||||
* @return 当前ByteBuffer实例(支持链式调用)
|
* @return 当前ByteBuffer实例(支持链式调用)
|
||||||
*/
|
*/
|
||||||
fun ByteBuffer.putVarLong(value: Long): ByteBuffer {
|
fun ByteBuffer.putVarLong(value: Long): ByteBuffer {
|
||||||
var v = value
|
var v = value
|
||||||
while (v >= 0x80) {
|
while (v >= 0x80) {
|
||||||
this.put((v and 0x7F or 0x80).toByte())
|
this.put((v and 0x7F or 0x80).toByte())
|
||||||
v = v shr 7
|
v = v shr 7
|
||||||
}
|
}
|
||||||
this.put(v.toByte())
|
this.put(v.toByte())
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -295,4 +295,12 @@ fun ByteBuffer.putVarInt(value: Int): ByteBuffer = this.putVarLong(value.toLong(
|
|||||||
fun ByteBuffer.putVarShort(value: Short): 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())
|
fun ByteBuffer.writeStream(outputStream: OutputStream) = outputStream.write(this.toByteArray())
|
||||||
|
|||||||
@@ -26,25 +26,58 @@ import java.io.OutputStream
|
|||||||
import java.io.Serializable
|
import java.io.Serializable
|
||||||
import java.nio.ByteBuffer
|
import java.nio.ByteBuffer
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 可转换为字节数组的对象接口。
|
||||||
|
*
|
||||||
|
* 实现该接口的对象可以将自身序列化为字节数组,并支持写入输出流或 [ByteBuffer]。
|
||||||
|
*/
|
||||||
interface ByteConvertible : Serializable {
|
interface ByteConvertible : Serializable {
|
||||||
|
|
||||||
fun toBytes(): ByteArray
|
/**
|
||||||
|
* 将当前对象转换为字节数组。
|
||||||
|
*
|
||||||
|
* @return 表示当前对象的字节数组
|
||||||
|
*/
|
||||||
|
fun toBytes(): ByteArray
|
||||||
|
|
||||||
fun writeToStream(outputStream: OutputStream) {
|
/**
|
||||||
outputStream.write(toBytes())
|
* 将当前对象转换后的字节数组写入指定的输出流。
|
||||||
}
|
*
|
||||||
|
* @param outputStream 目标输出流
|
||||||
|
*/
|
||||||
|
fun writeToStream(outputStream: OutputStream) {
|
||||||
|
outputStream.write(toBytes())
|
||||||
|
}
|
||||||
|
|
||||||
fun putToByteBuffer(byteBuffer: ByteBuffer) {
|
/**
|
||||||
byteBuffer.put(toBytes())
|
* 将当前对象转换后的字节数组写入指定的 [ByteBuffer]。
|
||||||
}
|
*
|
||||||
|
* @param byteBuffer 目标缓冲区
|
||||||
|
*/
|
||||||
|
fun putToByteBuffer(byteBuffer: ByteBuffer) {
|
||||||
|
byteBuffer.put(toBytes())
|
||||||
|
}
|
||||||
|
|
||||||
companion object {
|
/**
|
||||||
fun OutputStream.write(byteConvertible: ByteConvertible) {
|
* 伴生对象,提供面向输出流和缓冲区的便捷扩展函数。
|
||||||
byteConvertible.writeToStream(this)
|
*/
|
||||||
}
|
companion object {
|
||||||
|
/**
|
||||||
|
* 将 [ByteConvertible] 对象写入当前输出流。
|
||||||
|
*
|
||||||
|
* @param byteConvertible 要写入的可转换对象
|
||||||
|
*/
|
||||||
|
fun OutputStream.write(byteConvertible: ByteConvertible) {
|
||||||
|
byteConvertible.writeToStream(this)
|
||||||
|
}
|
||||||
|
|
||||||
fun ByteBuffer.put(byteConvertible: ByteConvertible) {
|
/**
|
||||||
byteConvertible.putToByteBuffer(this)
|
* 将 [ByteConvertible] 对象写入当前 [ByteBuffer]。
|
||||||
}
|
*
|
||||||
}
|
* @param byteConvertible 要写入的可转换对象
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.put(byteConvertible: ByteConvertible) {
|
||||||
|
byteConvertible.putToByteBuffer(this)
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile ByteFlags.kt
|
* CurrentFile ByteFlags.kt
|
||||||
* LastUpdate 2026-06-21 10:40:58
|
* LastUpdate 2026-11-16 21:35:04
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -32,429 +32,454 @@ package com.mingliqiye.utils.bytes
|
|||||||
* 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。
|
* 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。
|
||||||
*/
|
*/
|
||||||
data class ByteFlags(
|
data class ByteFlags(
|
||||||
/** 第 0 位(最低位,0x01) */
|
/** 第 0 位(最低位,0x01) */
|
||||||
var b0: Boolean = false,
|
var b0: Boolean = false,
|
||||||
/** 第 1 位(0x02) */
|
/** 第 1 位(0x02) */
|
||||||
var b1: Boolean = false,
|
var b1: Boolean = false,
|
||||||
/** 第 2 位(0x04) */
|
/** 第 2 位(0x04) */
|
||||||
var b2: Boolean = false,
|
var b2: Boolean = false,
|
||||||
/** 第 3 位(0x08) */
|
/** 第 3 位(0x08) */
|
||||||
var b3: Boolean = false,
|
var b3: Boolean = false,
|
||||||
/** 第 4 位(0x10) */
|
/** 第 4 位(0x10) */
|
||||||
var b4: Boolean = false,
|
var b4: Boolean = false,
|
||||||
/** 第 5 位(0x20) */
|
/** 第 5 位(0x20) */
|
||||||
var b5: Boolean = false,
|
var b5: Boolean = false,
|
||||||
/** 第 6 位(0x40) */
|
/** 第 6 位(0x40) */
|
||||||
var b6: Boolean = false,
|
var b6: Boolean = false,
|
||||||
/** 第 7 位(最高位,0x80) */
|
/** 第 7 位(最高位,0x80) */
|
||||||
var b7: Boolean = false,
|
var b7: Boolean = false,
|
||||||
) {
|
) {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。
|
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。
|
||||||
*
|
*
|
||||||
* @param byte 用于初始化的字节值(仅使用低 8 位)
|
* @param byte 用于初始化的字节值(仅使用低 8 位)
|
||||||
*/
|
*/
|
||||||
constructor(byte: Byte) : this() {
|
constructor(byte: Byte) : this() {
|
||||||
fromByte(byte)
|
fromByte(byte)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 从给定的 [Byte] 值解析并设置各个位标志。
|
* 从给定的 [Byte] 值解析并设置各个位标志。
|
||||||
*
|
*
|
||||||
* @param byte 要解析的字节
|
* @param byte 要解析的字节
|
||||||
*/
|
*/
|
||||||
fun fromByte(byte: Byte) {
|
fun fromByte(byte: Byte): ByteFlags {
|
||||||
val value = byte.toInt() and 0xFF
|
val value = byte.toInt() and 0xFF
|
||||||
b0 = (value and 0x01) != 0
|
b0 = (value and 0x01) != 0
|
||||||
b1 = (value and 0x02) != 0
|
b1 = (value and 0x02) != 0
|
||||||
b2 = (value and 0x04) != 0
|
b2 = (value and 0x04) != 0
|
||||||
b3 = (value and 0x08) != 0
|
b3 = (value and 0x08) != 0
|
||||||
b4 = (value and 0x10) != 0
|
b4 = (value and 0x10) != 0
|
||||||
b5 = (value and 0x20) != 0
|
b5 = (value and 0x20) != 0
|
||||||
b6 = (value and 0x40) != 0
|
b6 = (value and 0x40) != 0
|
||||||
b7 = (value and 0x80) != 0
|
b7 = (value and 0x80) != 0
|
||||||
}
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前标志状态转换为一个 [Byte] 值。
|
* 将当前标志状态转换为一个 [Byte] 值。
|
||||||
*
|
*
|
||||||
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
|
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
|
||||||
*/
|
*/
|
||||||
fun toByte(): Byte {
|
fun toByte(): Byte {
|
||||||
var result = 0
|
var result = 0
|
||||||
if (b0) result = result or 0x01
|
if (b0) result = result or 0x01
|
||||||
if (b1) result = result or 0x02
|
if (b1) result = result or 0x02
|
||||||
if (b2) result = result or 0x04
|
if (b2) result = result or 0x04
|
||||||
if (b3) result = result or 0x08
|
if (b3) result = result or 0x08
|
||||||
if (b4) result = result or 0x10
|
if (b4) result = result or 0x10
|
||||||
if (b5) result = result or 0x20
|
if (b5) result = result or 0x20
|
||||||
if (b6) result = result or 0x40
|
if (b6) result = result or 0x40
|
||||||
if (b7) result = result or 0x80
|
if (b7) result = result or 0x80
|
||||||
return result.toByte()
|
return result.toByte()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 通过索引(0~7)获取对应位的布尔值。
|
* 通过索引(0~7)获取对应位的布尔值。
|
||||||
*
|
*
|
||||||
* @param index 位索引(0 = LSB, 7 = MSB)
|
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||||
* @return 该位是否为 true
|
* @return 该位是否为 true
|
||||||
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||||
*/
|
*/
|
||||||
operator fun get(index: Int): Boolean {
|
operator fun get(index: Int): Boolean {
|
||||||
return when (index) {
|
return when (index) {
|
||||||
0 -> b0
|
0 -> b0
|
||||||
1 -> b1
|
1 -> b1
|
||||||
2 -> b2
|
2 -> b2
|
||||||
3 -> b3
|
3 -> b3
|
||||||
4 -> b4
|
4 -> b4
|
||||||
5 -> b5
|
5 -> b5
|
||||||
6 -> b6
|
6 -> b6
|
||||||
7 -> b7
|
7 -> b7
|
||||||
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 通过索引(0~7)设置对应位的布尔值。
|
* 通过索引(0~7)设置对应位的布尔值。
|
||||||
*
|
*
|
||||||
* @param index 位索引(0 = LSB, 7 = MSB)
|
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||||
* @param value 要设置的布尔值
|
* @param value 要设置的布尔值
|
||||||
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||||
*/
|
*/
|
||||||
operator fun set(index: Int, value: Boolean) {
|
operator fun set(index: Int, value: Boolean): ByteFlags {
|
||||||
when (index) {
|
when (index) {
|
||||||
0 -> b0 = value
|
0 -> b0 = value
|
||||||
1 -> b1 = value
|
1 -> b1 = value
|
||||||
2 -> b2 = value
|
2 -> b2 = value
|
||||||
3 -> b3 = value
|
3 -> b3 = value
|
||||||
4 -> b4 = value
|
4 -> b4 = value
|
||||||
5 -> b5 = value
|
5 -> b5 = value
|
||||||
6 -> b6 = value
|
6 -> b6 = value
|
||||||
7 -> b7 = value
|
7 -> b7 = value
|
||||||
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||||
}
|
}
|
||||||
}
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将所有 8 个位设置为 `true`。
|
* 将所有 8 个位设置为 `true`。
|
||||||
*/
|
*/
|
||||||
fun setAll() {
|
fun setAll(): ByteFlags {
|
||||||
b0 = true
|
b0 = true
|
||||||
b1 = true
|
b1 = true
|
||||||
b2 = true
|
b2 = true
|
||||||
b3 = true
|
b3 = true
|
||||||
b4 = true
|
b4 = true
|
||||||
b5 = true
|
b5 = true
|
||||||
b6 = true
|
b6 = true
|
||||||
b7 = true
|
b7 = true
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
return this
|
||||||
* 将所有 8 个位设置为 `false`。
|
}
|
||||||
*/
|
|
||||||
fun clearAll() {
|
|
||||||
b0 = false
|
|
||||||
b1 = false
|
|
||||||
b2 = false
|
|
||||||
b3 = false
|
|
||||||
b4 = false
|
|
||||||
b5 = false
|
|
||||||
b6 = false
|
|
||||||
b7 = false
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对所有位执行逻辑取反(true ↔ false)。
|
* 将所有 8 个位设置为 `false`。
|
||||||
*/
|
*/
|
||||||
fun toggleAll() {
|
fun clearAll(): ByteFlags {
|
||||||
b0 = !b0
|
b0 = false
|
||||||
b1 = !b1
|
b1 = false
|
||||||
b2 = !b2
|
b2 = false
|
||||||
b3 = !b3
|
b3 = false
|
||||||
b4 = !b4
|
b4 = false
|
||||||
b5 = !b5
|
b5 = false
|
||||||
b6 = !b6
|
b6 = false
|
||||||
b7 = !b7
|
b7 = false
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
return this
|
||||||
* 切换指定索引位的状态(true 变 false,反之亦然)。
|
}
|
||||||
*
|
|
||||||
* @param index 要切换的位索引(0~7)
|
|
||||||
* @throws IndexOutOfBoundsException 如果索引无效
|
|
||||||
*/
|
|
||||||
fun toggle(index: Int) {
|
|
||||||
this[index] = !this[index]
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 检查是否所有位都为 `true`。
|
* 对所有位执行逻辑取反(true ↔ false)。
|
||||||
*
|
*/
|
||||||
* @return 若全部为 true 则返回 true,否则 false
|
fun toggleAll(): ByteFlags {
|
||||||
*/
|
b0 = !b0
|
||||||
fun allTrue(): Boolean {
|
b1 = !b1
|
||||||
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
|
b2 = !b2
|
||||||
}
|
b3 = !b3
|
||||||
|
b4 = !b4
|
||||||
|
b5 = !b5
|
||||||
|
b6 = !b6
|
||||||
|
b7 = !b7
|
||||||
|
|
||||||
/**
|
return this
|
||||||
* 检查是否所有位都为 `false`。
|
}
|
||||||
*
|
|
||||||
* @return 若全部为 false 则返回 true,否则 false
|
|
||||||
*/
|
|
||||||
fun allFalse(): Boolean {
|
|
||||||
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 统计值为 `true` 的位数量。
|
* 切换指定索引位的状态(true 变 false,反之亦然)。
|
||||||
*
|
*
|
||||||
* @return true 位的个数(0~8)
|
* @param index 要切换的位索引(0~7)
|
||||||
*/
|
* @throws IndexOutOfBoundsException 如果索引无效
|
||||||
fun countTrue(): Int {
|
*/
|
||||||
var count = 0
|
fun toggle(index: Int): ByteFlags {
|
||||||
if (b0) count++
|
this[index] = !this[index]
|
||||||
if (b1) count++
|
return this
|
||||||
if (b2) count++
|
}
|
||||||
if (b3) count++
|
|
||||||
if (b4) count++
|
|
||||||
if (b5) count++
|
|
||||||
if (b6) count++
|
|
||||||
if (b7) count++
|
|
||||||
return count
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 统计值为 `false` 的位数量。
|
* 检查是否所有位都为 `true`。
|
||||||
*
|
*
|
||||||
* @return false 位的个数(0~8)
|
* @return 若全部为 true 则返回 true,否则 false
|
||||||
*/
|
*/
|
||||||
fun countFalse(): Int = 8 - countTrue()
|
fun allTrue(): Boolean {
|
||||||
|
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
|
* 检查是否所有位都为 `false`。
|
||||||
*
|
*
|
||||||
* 支持别名:`bN` 或 `bitN`(不区分大小写)。
|
* @return 若全部为 false 则返回 true,否则 false
|
||||||
*
|
*/
|
||||||
* @param name 位的名称(例如 "b0", "BIT5")
|
fun allFalse(): Boolean {
|
||||||
* @return 对应位的布尔值
|
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
|
||||||
* @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")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前状态转换为标准二进制字符串(MSB 在前)。
|
* 统计值为 `true` 的位数量。
|
||||||
*
|
*
|
||||||
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
|
* @return true 位的个数(0~8)
|
||||||
*
|
*/
|
||||||
* @return 8 位二进制字符串(高位在左)
|
fun countTrue(): Int {
|
||||||
*/
|
var count = 0
|
||||||
fun toBinaryString(): String {
|
if (b0) count++
|
||||||
return buildString {
|
if (b1) count++
|
||||||
if (b7) append('1') else append('0')
|
if (b2) count++
|
||||||
if (b6) append('1') else append('0')
|
if (b3) count++
|
||||||
if (b5) append('1') else append('0')
|
if (b4) count++
|
||||||
if (b4) append('1') else append('0')
|
if (b5) count++
|
||||||
if (b3) append('1') else append('0')
|
if (b6) count++
|
||||||
if (b2) append('1') else append('0')
|
if (b7) count++
|
||||||
if (b1) append('1') else append('0')
|
return count
|
||||||
if (b0) append('1') else append('0')
|
}
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
|
* 统计值为 `false` 的位数量。
|
||||||
*
|
*
|
||||||
* 例如:若值为 10,则返回 "0x0A"
|
* @return false 位的个数(0~8)
|
||||||
*
|
*/
|
||||||
* @return 格式如 "0xXX" 的十六进制字符串
|
fun countFalse(): Int = 8 - countTrue()
|
||||||
*/
|
|
||||||
fun toHexString(): String {
|
|
||||||
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前位状态转换为布尔数组。
|
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
|
||||||
*
|
*
|
||||||
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
|
* 支持别名:`bN` 或 `bitN`(不区分大小写)。
|
||||||
*
|
*
|
||||||
* @return 长度为 8 的布尔数组
|
* @param name 位的名称(例如 "b0", "BIT5")
|
||||||
*/
|
* @return 对应位的布尔值
|
||||||
fun toBooleanArray(): BooleanArray {
|
* @throws IllegalArgumentException 如果名称无效
|
||||||
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
|
*/
|
||||||
}
|
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")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 从布尔数组初始化位状态。
|
* 将当前状态转换为标准二进制字符串(MSB 在前)。
|
||||||
*
|
*
|
||||||
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
|
||||||
*
|
*
|
||||||
* @param array 布尔数组(长度至少为 8)
|
* @return 8 位二进制字符串(高位在左)
|
||||||
* @throws IllegalArgumentException 如果数组长度不足 8
|
*/
|
||||||
*/
|
fun toBinaryString(): String {
|
||||||
fun fromBooleanArray(array: BooleanArray) {
|
return buildString {
|
||||||
require(array.size >= 8) { "数组长度至少为8" }
|
if (b7) append('1') else append('0')
|
||||||
b0 = array[0]
|
if (b6) append('1') else append('0')
|
||||||
b1 = array[1]
|
if (b5) append('1') else append('0')
|
||||||
b2 = array[2]
|
if (b4) append('1') else append('0')
|
||||||
b3 = array[3]
|
if (b3) append('1') else append('0')
|
||||||
b4 = array[4]
|
if (b2) append('1') else append('0')
|
||||||
b5 = array[5]
|
if (b1) append('1') else append('0')
|
||||||
b6 = array[6]
|
if (b0) append('1') else append('0')
|
||||||
b7 = array[7]
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。
|
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
|
||||||
*
|
*
|
||||||
* 结果的每一位 = this位 && other位
|
* 例如:若值为 10,则返回 "0x0A"
|
||||||
*
|
*
|
||||||
* @param other 另一个 ByteFlags 实例
|
* @return 格式如 "0xXX" 的十六进制字符串
|
||||||
* @return 新的 ByteFlags 实例,表示 AND 结果
|
*/
|
||||||
*/
|
fun toHexString(): String {
|
||||||
infix fun and(other: ByteFlags): ByteFlags {
|
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
|
||||||
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] 执行按位“或”操作(OR)。
|
* 将当前位状态转换为布尔数组。
|
||||||
*
|
*
|
||||||
* 结果的每一位 = this位 || other位
|
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
|
||||||
*
|
*
|
||||||
* @param other 另一个 ByteFlags 实例
|
* @return 长度为 8 的布尔数组
|
||||||
* @return 新的 ByteFlags 实例,表示 OR 结果
|
*/
|
||||||
*/
|
fun toBooleanArray(): BooleanArray {
|
||||||
infix fun or(other: ByteFlags): ByteFlags {
|
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
|
||||||
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] 执行按位“异或”操作(XOR)。
|
* 从布尔数组初始化位状态。
|
||||||
*
|
*
|
||||||
* 结果的每一位 = this位 != other位
|
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
||||||
*
|
*
|
||||||
* @param other 另一个 ByteFlags 实例
|
* @param array 布尔数组(长度至少为 8)
|
||||||
* @return 新的 ByteFlags 实例,表示 XOR 结果
|
* @throws IllegalArgumentException 如果数组长度不足 8
|
||||||
*/
|
*/
|
||||||
infix fun xor(other: ByteFlags): ByteFlags {
|
fun fromBooleanArray(array: BooleanArray): ByteFlags {
|
||||||
return ByteFlags(
|
require(array.size >= 8) { "数组长度至少为8" }
|
||||||
this.b0 != other.b0,
|
b0 = array[0]
|
||||||
this.b1 != other.b1,
|
b1 = array[1]
|
||||||
this.b2 != other.b2,
|
b2 = array[2]
|
||||||
this.b3 != other.b3,
|
b3 = array[3]
|
||||||
this.b4 != other.b4,
|
b4 = array[4]
|
||||||
this.b5 != other.b5,
|
b5 = array[5]
|
||||||
this.b6 != other.b6,
|
b6 = array[6]
|
||||||
this.b7 != other.b7
|
b7 = array[7]
|
||||||
)
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
|
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。
|
||||||
*
|
*
|
||||||
* 每一位取反。
|
* 结果的每一位 = this位 && other位
|
||||||
*
|
*
|
||||||
* @return 新的 ByteFlags 实例,所有位取反
|
* @param other 另一个 ByteFlags 实例
|
||||||
*/
|
* @return 新的 ByteFlags 实例,表示 AND 结果
|
||||||
operator fun not(): ByteFlags {
|
*/
|
||||||
return ByteFlags(
|
infix fun and(other: ByteFlags): ByteFlags {
|
||||||
!b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7
|
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] 执行按位“或”操作(OR)。
|
||||||
*
|
*
|
||||||
* 示例:`ByteFlags(10100001 = 0xA1)`
|
* 结果的每一位 = this位 || other位
|
||||||
*
|
*
|
||||||
* @return 字符串描述
|
* @param other 另一个 ByteFlags 实例
|
||||||
*/
|
* @return 新的 ByteFlags 实例,表示 OR 结果
|
||||||
override fun toString(): String {
|
*/
|
||||||
return "ByteFlags(${toBinaryString()} = ${toHexString()})"
|
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 {
|
/**
|
||||||
/**
|
* 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。
|
||||||
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
|
*
|
||||||
*
|
* 结果的每一位 = this位 != other位
|
||||||
* @return 全 1 的 ByteFlags(值为 0xFF)
|
*
|
||||||
*/
|
* @param other 另一个 ByteFlags 实例
|
||||||
fun allTrue(): ByteFlags {
|
* @return 新的 ByteFlags 实例,表示 XOR 结果
|
||||||
return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true)
|
*/
|
||||||
}
|
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] 实例。
|
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
|
||||||
*
|
*
|
||||||
* @return 全 0 的 ByteFlags(值为 0x00)
|
* 每一位取反。
|
||||||
*/
|
*
|
||||||
fun allFalse(): ByteFlags {
|
* @return 新的 ByteFlags 实例,所有位取反
|
||||||
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。
|
* 示例:`ByteFlags(10100001 = 0xA1)`
|
||||||
*
|
*
|
||||||
* @param binary 8 位二进制字符串(仅含 '0' 和 '1')
|
* @return 字符串描述
|
||||||
* @return 对应的 ByteFlags 实例
|
*/
|
||||||
* @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符
|
override fun toString(): String {
|
||||||
*/
|
return "ByteFlags(${toBinaryString()} = ${toHexString()})"
|
||||||
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 是最低位(对应字符串最后一位)
|
* 伴生对象,提供 [ByteFlags] 的多种静态工厂方法。
|
||||||
binary[6] == '1',
|
*/
|
||||||
binary[5] == '1',
|
companion object {
|
||||||
binary[4] == '1',
|
/**
|
||||||
binary[3] == '1',
|
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
|
||||||
binary[2] == '1',
|
*
|
||||||
binary[1] == '1',
|
* @return 全 1 的 ByteFlags(值为 0xFF)
|
||||||
binary[0] == '1' // b7 是最高位(对应字符串第一位)
|
*/
|
||||||
)
|
fun allTrue(): ByteFlags {
|
||||||
}
|
return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true)
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。
|
* 创建一个所有位均为 `false` 的 [ByteFlags] 实例。
|
||||||
*
|
*
|
||||||
* @param value 输入整数
|
* @return 全 0 的 ByteFlags(值为 0x00)
|
||||||
* @return 对应的 ByteFlags 实例
|
*/
|
||||||
*/
|
fun allFalse(): ByteFlags {
|
||||||
fun fromInt(value: Int): ByteFlags {
|
return ByteFlags()
|
||||||
return ByteFlags((value and 0xFF).toByte())
|
}
|
||||||
}
|
|
||||||
}
|
/**
|
||||||
|
* 从 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())
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -87,8 +87,8 @@ const val ESC_RESERVED: Byte = 0x06
|
|||||||
* @return 包含每个字节对应十六进制字符串的列表
|
* @return 包含每个字节对应十六进制字符串的列表
|
||||||
*/
|
*/
|
||||||
fun ByteArray.getByteArrayString(): MutableList<String> {
|
fun ByteArray.getByteArrayString(): MutableList<String> {
|
||||||
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
|
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
|
||||||
.collect(SuperStream.toListCollector()) as MutableList<String>
|
.collect(SuperStream.toListCollector()) as MutableList<String>
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -99,12 +99,12 @@ fun ByteArray.getByteArrayString(): MutableList<String> {
|
|||||||
* @throws NumberFormatException 当字符不是有效的十六进制字符时抛出
|
* @throws NumberFormatException 当字符不是有效的十六进制字符时抛出
|
||||||
*/
|
*/
|
||||||
fun Char.hexDigitToValue(): Int {
|
fun Char.hexDigitToValue(): Int {
|
||||||
return when (this) {
|
return when (this) {
|
||||||
in '0'..'9' -> this - '0'
|
in '0'..'9' -> this - '0'
|
||||||
in 'A'..'F' -> this - 'A' + 10
|
in 'A'..'F' -> this - 'A' + 10
|
||||||
in 'a'..'f' -> this - 'a' + 10
|
in 'a'..'f' -> this - 'a' + 10
|
||||||
else -> throw NumberFormatException("Invalid hex character: $this")
|
else -> throw NumberFormatException("Invalid hex character: $this")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -114,7 +114,7 @@ fun Char.hexDigitToValue(): Int {
|
|||||||
* @return 转换后的字节数组
|
* @return 转换后的字节数组
|
||||||
*/
|
*/
|
||||||
fun hexStringToByteArray(string: String): ByteArray {
|
fun hexStringToByteArray(string: String): ByteArray {
|
||||||
return string.hexToByteArray()
|
return string.hexToByteArray()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -125,5 +125,5 @@ fun hexStringToByteArray(string: String): ByteArray {
|
|||||||
* @return 对应的十六进制字符串
|
* @return 对应的十六进制字符串
|
||||||
*/
|
*/
|
||||||
fun bytesToHex(bytes: ByteArray): String {
|
fun bytesToHex(bytes: ByteArray): String {
|
||||||
return BaseType.BASE16.encode(bytes)
|
return BaseType.BASE16.encode(bytes)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -41,23 +41,23 @@ import java.io.OutputStream
|
|||||||
*/
|
*/
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun InputStream.readVarNumber(size: Int = 8): Long {
|
fun InputStream.readVarNumber(size: Int = 8): Long {
|
||||||
var numRead = 0
|
var numRead = 0
|
||||||
var result: Long = 0
|
var result: Long = 0
|
||||||
var read: Byte
|
var read: Byte
|
||||||
do {
|
do {
|
||||||
read = this.read().let {
|
read = this.read().let {
|
||||||
if (it == -1) {
|
if (it == -1) {
|
||||||
throw IOException("Reached end of stream")
|
throw IOException("Reached end of stream")
|
||||||
}
|
}
|
||||||
it.toByte()
|
it.toByte()
|
||||||
}
|
}
|
||||||
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||||
numRead++
|
numRead++
|
||||||
if (numRead > size) {
|
if (numRead > size) {
|
||||||
throw IOException("VarNumber is too big")
|
throw IOException("VarNumber is too big")
|
||||||
}
|
}
|
||||||
} while ((read.toLong() and 128) != 0L)
|
} while ((read.toLong() and 128) != 0L)
|
||||||
return result
|
return result
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -102,20 +102,20 @@ fun InputStream.readVarLong(): Long = this.readVarNumber()
|
|||||||
*/
|
*/
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
|
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
|
||||||
var v = value
|
var v = value
|
||||||
var numWritten = 0
|
var numWritten = 0
|
||||||
|
|
||||||
while (v >= 0x80 && numWritten < size - 1) {
|
while (v >= 0x80 && numWritten < size - 1) {
|
||||||
this.write((v and 0x7F or 0x80).toInt())
|
this.write((v and 0x7F or 0x80).toInt())
|
||||||
v = v ushr 7
|
v = v ushr 7
|
||||||
numWritten++
|
numWritten++
|
||||||
}
|
}
|
||||||
|
|
||||||
if (numWritten >= size) {
|
if (numWritten >= size) {
|
||||||
throw IOException("VarNumber is too big")
|
throw IOException("VarNumber is too big")
|
||||||
}
|
}
|
||||||
|
|
||||||
this.write(v.toInt())
|
this.write(v.toInt())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -28,35 +28,58 @@ import com.mingliqiye.utils.json.api.JSONA
|
|||||||
import java.io.*
|
import java.io.*
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过 Java 序列化机制对当前对象进行深克隆。
|
||||||
|
*
|
||||||
|
* @param T 对象类型,必须实现 [Serializable]
|
||||||
|
* @return 深克隆后的新对象
|
||||||
|
*/
|
||||||
@JvmName("_inline_deepClone")
|
@JvmName("_inline_deepClone")
|
||||||
inline fun <reified T : Serializable> T.deepClone(): T {
|
inline fun <reified T : Serializable> T.deepClone(): T {
|
||||||
return deepClone(this)
|
return deepClone(this)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过 JSON 序列化与反序列化对当前对象进行深克隆。
|
||||||
|
*
|
||||||
|
* @param T 对象类型
|
||||||
|
* @return 深克隆后的新对象
|
||||||
|
* @throws JsonException 如果 JSON 转换过程中发生异常
|
||||||
|
*/
|
||||||
inline fun <reified T> T.deepJsonClone(): T {
|
inline fun <reified T> T.deepJsonClone(): T {
|
||||||
try {
|
try {
|
||||||
return JSONA.convert(this as Any, this!!.javaClass) as T
|
return JSONA.convert(this as Any, this!!.javaClass) as T
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException(
|
throw JsonException(
|
||||||
"Failed to deep clone object using JSON", e
|
"Failed to deep clone object using JSON", e
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过 Java 序列化机制对对象进行深克隆。
|
||||||
|
*
|
||||||
|
* 将对象序列化到内存后再反序列化,得到一个全新的对象副本。
|
||||||
|
*
|
||||||
|
* @param T 对象类型,必须实现 [Serializable]
|
||||||
|
* @param obj 要克隆的对象
|
||||||
|
* @return 深克隆后的新对象
|
||||||
|
* @throws RuntimeException 如果序列化或反序列化过程中发生 I/O 异常或类找不到
|
||||||
|
*/
|
||||||
@Suppress("UNCHECKED_CAST")
|
@Suppress("UNCHECKED_CAST")
|
||||||
fun <T : Serializable?> deepClone(obj: T): T {
|
fun <T : Serializable?> deepClone(obj: T): T {
|
||||||
try {
|
try {
|
||||||
val bao = ByteArrayOutputStream()
|
val bao = ByteArrayOutputStream()
|
||||||
val oos = ObjectOutputStream(bao)
|
val oos = ObjectOutputStream(bao)
|
||||||
oos.writeObject(obj)
|
oos.writeObject(obj)
|
||||||
val bis = ByteArrayInputStream(
|
val bis = ByteArrayInputStream(
|
||||||
bao.toByteArray()
|
bao.toByteArray()
|
||||||
)
|
)
|
||||||
val ois = ObjectInputStream(bis)
|
val ois = ObjectInputStream(bis)
|
||||||
return ois.readObject() as T
|
return ois.readObject() as T
|
||||||
} catch (e: IOException) {
|
} catch (e: IOException) {
|
||||||
throw RuntimeException(e)
|
throw RuntimeException(e)
|
||||||
} catch (e: ClassNotFoundException) {
|
} catch (e: ClassNotFoundException) {
|
||||||
throw RuntimeException(e)
|
throw RuntimeException(e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -36,7 +36,7 @@ import java.util.stream.Collectors
|
|||||||
* @return 转换后的数组
|
* @return 转换后的数组
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> Collection<T>.toArray(): Array<T> {
|
inline fun <reified T> Collection<T>.toArray(): Array<T> {
|
||||||
return arrayOf(*this.toTypedArray())
|
return arrayOf(*this.toTypedArray())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -49,11 +49,11 @@ inline fun <reified T> Collection<T>.toArray(): Array<T> {
|
|||||||
*/
|
*/
|
||||||
@Suppress("UNCHECKED_CAST")
|
@Suppress("UNCHECKED_CAST")
|
||||||
inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
|
inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
|
||||||
return this.stream().collect(
|
return this.stream().collect(
|
||||||
SuperStream.toMap(
|
SuperStream.toMap(
|
||||||
v
|
v
|
||||||
)
|
)
|
||||||
) as Map<T, V>
|
) as Map<T, V>
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -67,11 +67,11 @@ inline fun <reified T, V> Collection<T>.toMap(noinline v: (T) -> V): Map<T, V> {
|
|||||||
* @return 转换后的 Map
|
* @return 转换后的 Map
|
||||||
*/
|
*/
|
||||||
inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> {
|
inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline v: (T) -> V): Map<K, V> {
|
||||||
return this.stream().collect(
|
return this.stream().collect(
|
||||||
Collectors.toMap(
|
Collectors.toMap(
|
||||||
k, v
|
k, v
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -82,7 +82,7 @@ inline fun <reified T, V, K> Collection<T>.toMap(noinline k: (T) -> K, noinline
|
|||||||
* @return 转换后的 Set
|
* @return 转换后的 Set
|
||||||
*/
|
*/
|
||||||
fun <T> toSet(array: Array<T>): Set<T> {
|
fun <T> toSet(array: Array<T>): Set<T> {
|
||||||
return array.toSet()
|
return array.toSet()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -93,13 +93,13 @@ fun <T> toSet(array: Array<T>): Set<T> {
|
|||||||
* @return 第一个元素或 null
|
* @return 第一个元素或 null
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> Collection<T>.getFirst(): T? {
|
inline fun <reified T> Collection<T>.getFirst(): T? {
|
||||||
if (this.isEmpty()) {
|
if (this.isEmpty()) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
if (this is MutableList<T>) {
|
if (this is MutableList<T>) {
|
||||||
return this.first()
|
return this.first()
|
||||||
}
|
}
|
||||||
return this.iterator().next()
|
return this.iterator().next()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -109,10 +109,10 @@ inline fun <reified T> Collection<T>.getFirst(): T? {
|
|||||||
* @return 第一个元素或 null
|
* @return 第一个元素或 null
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> Array<T>.getFirst(): T? {
|
inline fun <reified T> Array<T>.getFirst(): T? {
|
||||||
if (this.isEmpty()) {
|
if (this.isEmpty()) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
return this.first()
|
return this.first()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -122,17 +122,17 @@ inline fun <reified T> Array<T>.getFirst(): T? {
|
|||||||
* @return 最后一个元素或 null
|
* @return 最后一个元素或 null
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> Collection<T>.getLast(): T? {
|
inline fun <reified T> Collection<T>.getLast(): T? {
|
||||||
if (this.isEmpty()) {
|
if (this.isEmpty()) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
if (this is MutableList<T>) {
|
if (this is MutableList<T>) {
|
||||||
return this.last()
|
return this.last()
|
||||||
}
|
}
|
||||||
var lastElement: T? = null
|
var lastElement: T? = null
|
||||||
for (element in this) {
|
for (element in this) {
|
||||||
lastElement = element
|
lastElement = element
|
||||||
}
|
}
|
||||||
return lastElement
|
return lastElement
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -142,10 +142,10 @@ inline fun <reified T> Collection<T>.getLast(): T? {
|
|||||||
* @return 最后一个元素或 null
|
* @return 最后一个元素或 null
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> Array<T>.getLast(): T? {
|
inline fun <reified T> Array<T>.getLast(): T? {
|
||||||
if (this.isEmpty()) {
|
if (this.isEmpty()) {
|
||||||
return null
|
return null
|
||||||
}
|
}
|
||||||
return this.last()
|
return this.last()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -158,22 +158,22 @@ inline fun <reified T> Array<T>.getLast(): T? {
|
|||||||
* @return 指定索引处的元素或默认值
|
* @return 指定索引处的元素或默认值
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> Collection<T>.getOrDefault(
|
inline fun <reified T> Collection<T>.getOrDefault(
|
||||||
index: Int, defaultValue: T
|
index: Int, defaultValue: T,
|
||||||
): T {
|
): T {
|
||||||
if (!(!this.isEmpty() && index < this.size)) {
|
if (!(!this.isEmpty() && index < this.size)) {
|
||||||
return defaultValue
|
return defaultValue
|
||||||
}
|
}
|
||||||
if (this is List<T>) {
|
if (this is List<T>) {
|
||||||
return this[index]
|
return this[index]
|
||||||
}
|
}
|
||||||
var i = 0
|
var i = 0
|
||||||
for (element in this) {
|
for (element in this) {
|
||||||
if (i == index) {
|
if (i == index) {
|
||||||
return element
|
return element
|
||||||
}
|
}
|
||||||
i++
|
i++
|
||||||
}
|
}
|
||||||
return defaultValue
|
return defaultValue
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -183,7 +183,7 @@ inline fun <reified T> Collection<T>.getOrDefault(
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayList(): ArrayList<T> {
|
fun <T> newArrayList(): ArrayList<T> {
|
||||||
return ArrayList()
|
return ArrayList()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -194,7 +194,7 @@ fun <T> newArrayList(): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayList(size: Int): ArrayList<T> {
|
fun <T> newArrayList(size: Int): ArrayList<T> {
|
||||||
return ArrayList()
|
return ArrayList()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -205,7 +205,7 @@ fun <T> newArrayList(size: Int): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayList(vararg elements: T): ArrayList<T> {
|
fun <T> newArrayList(vararg elements: T): ArrayList<T> {
|
||||||
return newArrayList(elements.asList())
|
return newArrayList(elements.asList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -215,7 +215,7 @@ fun <T> newArrayList(vararg elements: T): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
|
fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
|
||||||
return newArrayList(this)
|
return newArrayList(this)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -226,7 +226,7 @@ fun <T> Collection<T>.newArrayLists(): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
|
fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
|
||||||
return newArrayList(elements.asList())
|
return newArrayList(elements.asList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -237,7 +237,7 @@ fun <T> newArrayLists(elements: Array<T>): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
|
fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -248,7 +248,7 @@ fun <T> newArrayList(elements: Collection<T>): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
|
fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
|
||||||
return newArrayList(elements.toList())
|
return newArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -259,7 +259,7 @@ fun <T> newArrayList(elements: Iterable<T>): ArrayList<T> {
|
|||||||
* @return 新创建的 ArrayList
|
* @return 新创建的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
|
fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
|
||||||
return newArrayList(elements.toList())
|
return newArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -269,7 +269,7 @@ fun <T> newArrayList(elements: Sequence<T>): ArrayList<T> {
|
|||||||
* @return 新创建的 LinkedList
|
* @return 新创建的 LinkedList
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedList(): LinkedList<T> {
|
fun <T> newLinkedList(): LinkedList<T> {
|
||||||
return LinkedList()
|
return LinkedList()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -280,9 +280,9 @@ fun <T> newLinkedList(): LinkedList<T> {
|
|||||||
* @return 新创建的 LinkedList
|
* @return 新创建的 LinkedList
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
|
fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
|
||||||
val list = newLinkedList<T>()
|
val list = newLinkedList<T>()
|
||||||
list.addAll(elements.asList())
|
list.addAll(elements.asList())
|
||||||
return list
|
return list
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -293,9 +293,9 @@ fun <T> newLinkedList(vararg elements: T): LinkedList<T> {
|
|||||||
* @return 新创建的 LinkedList
|
* @return 新创建的 LinkedList
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
|
fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
|
||||||
val list = newLinkedList<T>()
|
val list = newLinkedList<T>()
|
||||||
list.addAll(elements)
|
list.addAll(elements)
|
||||||
return list
|
return list
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -306,11 +306,11 @@ fun <T> newLinkedList(elements: Collection<T>): LinkedList<T> {
|
|||||||
* @return 新创建的 LinkedList
|
* @return 新创建的 LinkedList
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
|
fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
|
||||||
val list = newLinkedList<T>()
|
val list = newLinkedList<T>()
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
list.add(element)
|
list.add(element)
|
||||||
}
|
}
|
||||||
return list
|
return list
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -321,7 +321,7 @@ fun <T> newLinkedList(elements: Iterable<T>): LinkedList<T> {
|
|||||||
* @return 新创建的 LinkedList
|
* @return 新创建的 LinkedList
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
|
fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
|
||||||
return newLinkedList(elements.toList())
|
return newLinkedList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -331,7 +331,7 @@ fun <T> newLinkedList(elements: Sequence<T>): LinkedList<T> {
|
|||||||
* @return 新创建的 Vector
|
* @return 新创建的 Vector
|
||||||
*/
|
*/
|
||||||
fun <T> newVector(): Vector<T> {
|
fun <T> newVector(): Vector<T> {
|
||||||
return Vector()
|
return Vector()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -342,9 +342,9 @@ fun <T> newVector(): Vector<T> {
|
|||||||
* @return 新创建的 Vector
|
* @return 新创建的 Vector
|
||||||
*/
|
*/
|
||||||
fun <T> newVector(vararg elements: T): Vector<T> {
|
fun <T> newVector(vararg elements: T): Vector<T> {
|
||||||
val vector = newVector<T>()
|
val vector = newVector<T>()
|
||||||
vector.addAll(elements.asList())
|
vector.addAll(elements.asList())
|
||||||
return vector
|
return vector
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -355,9 +355,9 @@ fun <T> newVector(vararg elements: T): Vector<T> {
|
|||||||
* @return 新创建的 Vector
|
* @return 新创建的 Vector
|
||||||
*/
|
*/
|
||||||
fun <T> newVector(elements: Collection<T>): Vector<T> {
|
fun <T> newVector(elements: Collection<T>): Vector<T> {
|
||||||
val vector = newVector<T>()
|
val vector = newVector<T>()
|
||||||
vector.addAll(elements)
|
vector.addAll(elements)
|
||||||
return vector
|
return vector
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -368,11 +368,11 @@ fun <T> newVector(elements: Collection<T>): Vector<T> {
|
|||||||
* @return 新创建的 Vector
|
* @return 新创建的 Vector
|
||||||
*/
|
*/
|
||||||
fun <T> newVector(elements: Iterable<T>): Vector<T> {
|
fun <T> newVector(elements: Iterable<T>): Vector<T> {
|
||||||
val vector = newVector<T>()
|
val vector = newVector<T>()
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
vector.add(element)
|
vector.add(element)
|
||||||
}
|
}
|
||||||
return vector
|
return vector
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -383,7 +383,7 @@ fun <T> newVector(elements: Iterable<T>): Vector<T> {
|
|||||||
* @return 新创建的 Vector
|
* @return 新创建的 Vector
|
||||||
*/
|
*/
|
||||||
fun <T> newVector(elements: Sequence<T>): Vector<T> {
|
fun <T> newVector(elements: Sequence<T>): Vector<T> {
|
||||||
return newVector(elements.toList())
|
return newVector(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -394,7 +394,7 @@ fun <T> newVector(elements: Sequence<T>): Vector<T> {
|
|||||||
* @return 新创建的 HashSet
|
* @return 新创建的 HashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newHashSet(): HashSet<T> {
|
fun <T> newHashSet(): HashSet<T> {
|
||||||
return HashSet()
|
return HashSet()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -405,7 +405,7 @@ fun <T> newHashSet(): HashSet<T> {
|
|||||||
* @return 新创建的 HashSet
|
* @return 新创建的 HashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newHashSet(size: Int): HashSet<T> {
|
fun <T> newHashSet(size: Int): HashSet<T> {
|
||||||
return HashSet(size)
|
return HashSet(size)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -416,9 +416,9 @@ fun <T> newHashSet(size: Int): HashSet<T> {
|
|||||||
* @return 新创建的 HashSet
|
* @return 新创建的 HashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newHashSet(vararg elements: T): HashSet<T> {
|
fun <T> newHashSet(vararg elements: T): HashSet<T> {
|
||||||
val set = newHashSet<T>()
|
val set = newHashSet<T>()
|
||||||
set.addAll(elements.asList())
|
set.addAll(elements.asList())
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -429,9 +429,9 @@ fun <T> newHashSet(vararg elements: T): HashSet<T> {
|
|||||||
* @return 新创建的 HashSet
|
* @return 新创建的 HashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
|
fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
|
||||||
val set = newHashSet<T>()
|
val set = newHashSet<T>()
|
||||||
set.addAll(elements)
|
set.addAll(elements)
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -442,11 +442,11 @@ fun <T> newHashSet(elements: Collection<T>): HashSet<T> {
|
|||||||
* @return 新创建的 HashSet
|
* @return 新创建的 HashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
|
fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
|
||||||
val set = newHashSet<T>()
|
val set = newHashSet<T>()
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
set.add(element)
|
set.add(element)
|
||||||
}
|
}
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -457,7 +457,7 @@ fun <T> newHashSet(elements: Iterable<T>): HashSet<T> {
|
|||||||
* @return 新创建的 HashSet
|
* @return 新创建的 HashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
|
fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
|
||||||
return newHashSet(elements.toSet())
|
return newHashSet(elements.toSet())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -467,7 +467,7 @@ fun <T> newHashSet(elements: Sequence<T>): HashSet<T> {
|
|||||||
* @return 新创建的 LinkedHashSet
|
* @return 新创建的 LinkedHashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedHashSet(): LinkedHashSet<T> {
|
fun <T> newLinkedHashSet(): LinkedHashSet<T> {
|
||||||
return LinkedHashSet()
|
return LinkedHashSet()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -478,7 +478,7 @@ fun <T> newLinkedHashSet(): LinkedHashSet<T> {
|
|||||||
* @return 新创建的 LinkedHashSet
|
* @return 新创建的 LinkedHashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
|
fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
|
||||||
return LinkedHashSet(size)
|
return LinkedHashSet(size)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -489,9 +489,9 @@ fun <T> newLinkedHashSet(size: Int): LinkedHashSet<T> {
|
|||||||
* @return 新创建的 LinkedHashSet
|
* @return 新创建的 LinkedHashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
|
fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
|
||||||
val set = newLinkedHashSet<T>()
|
val set = newLinkedHashSet<T>()
|
||||||
set.addAll(elements.asList())
|
set.addAll(elements.asList())
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -502,9 +502,9 @@ fun <T> newLinkedHashSet(vararg elements: T): LinkedHashSet<T> {
|
|||||||
* @return 新创建的 LinkedHashSet
|
* @return 新创建的 LinkedHashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
|
fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
|
||||||
val set = newLinkedHashSet<T>()
|
val set = newLinkedHashSet<T>()
|
||||||
set.addAll(elements)
|
set.addAll(elements)
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -515,11 +515,11 @@ fun <T> newLinkedHashSet(elements: Collection<T>): LinkedHashSet<T> {
|
|||||||
* @return 新创建的 LinkedHashSet
|
* @return 新创建的 LinkedHashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
|
fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
|
||||||
val set = newLinkedHashSet<T>()
|
val set = newLinkedHashSet<T>()
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
set.add(element)
|
set.add(element)
|
||||||
}
|
}
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -530,7 +530,7 @@ fun <T> newLinkedHashSet(elements: Iterable<T>): LinkedHashSet<T> {
|
|||||||
* @return 新创建的 LinkedHashSet
|
* @return 新创建的 LinkedHashSet
|
||||||
*/
|
*/
|
||||||
fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
|
fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
|
||||||
return newLinkedHashSet(elements.toSet())
|
return newLinkedHashSet(elements.toSet())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -540,7 +540,7 @@ fun <T> newLinkedHashSet(elements: Sequence<T>): LinkedHashSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
|
fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
|
||||||
return TreeSet()
|
return TreeSet()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -551,9 +551,9 @@ fun <T : Comparable<T>> newTreeSet(): TreeSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
|
fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
|
||||||
val set = newTreeSet<T>()
|
val set = newTreeSet<T>()
|
||||||
set.addAll(elements.asList())
|
set.addAll(elements.asList())
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -564,9 +564,9 @@ fun <T : Comparable<T>> newTreeSet(vararg elements: T): TreeSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
|
fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
|
||||||
val set = newTreeSet<T>()
|
val set = newTreeSet<T>()
|
||||||
set.addAll(elements)
|
set.addAll(elements)
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -577,11 +577,11 @@ fun <T : Comparable<T>> newTreeSet(elements: Collection<T>): TreeSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
|
fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
|
||||||
val set = newTreeSet<T>()
|
val set = newTreeSet<T>()
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
set.add(element)
|
set.add(element)
|
||||||
}
|
}
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -592,7 +592,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Iterable<T>): TreeSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
|
fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
|
||||||
return newTreeSet(elements.toSet())
|
return newTreeSet(elements.toSet())
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -603,7 +603,7 @@ fun <T : Comparable<T>> newTreeSet(elements: Sequence<T>): TreeSet<T> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
|
fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -613,7 +613,7 @@ fun newArrayLists(elements: ByteArray): ArrayList<Byte> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: ShortArray): ArrayList<Short> {
|
fun newArrayLists(elements: ShortArray): ArrayList<Short> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -623,7 +623,7 @@ fun newArrayLists(elements: ShortArray): ArrayList<Short> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: IntArray): ArrayList<Int> {
|
fun newArrayLists(elements: IntArray): ArrayList<Int> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -633,7 +633,7 @@ fun newArrayLists(elements: IntArray): ArrayList<Int> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: LongArray): ArrayList<Long> {
|
fun newArrayLists(elements: LongArray): ArrayList<Long> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -643,7 +643,7 @@ fun newArrayLists(elements: LongArray): ArrayList<Long> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: FloatArray): ArrayList<Float> {
|
fun newArrayLists(elements: FloatArray): ArrayList<Float> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -653,7 +653,7 @@ fun newArrayLists(elements: FloatArray): ArrayList<Float> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
|
fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -663,7 +663,7 @@ fun newArrayLists(elements: DoubleArray): ArrayList<Double> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
|
fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -673,7 +673,7 @@ fun newArrayLists(elements: BooleanArray): ArrayList<Boolean> {
|
|||||||
* @return 转换后的 ArrayList
|
* @return 转换后的 ArrayList
|
||||||
*/
|
*/
|
||||||
fun newArrayLists(elements: CharArray): ArrayList<Char> {
|
fun newArrayLists(elements: CharArray): ArrayList<Char> {
|
||||||
return ArrayList(elements.toList())
|
return ArrayList(elements.toList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -683,7 +683,7 @@ fun newArrayLists(elements: CharArray): ArrayList<Char> {
|
|||||||
* @return 新创建的 CopyOnWriteArrayList
|
* @return 新创建的 CopyOnWriteArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> {
|
fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T> {
|
||||||
return java.util.concurrent.CopyOnWriteArrayList()
|
return java.util.concurrent.CopyOnWriteArrayList()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -694,7 +694,7 @@ fun <T> newCopyOnWriteArrayList(): java.util.concurrent.CopyOnWriteArrayList<T>
|
|||||||
* @return 新创建的 CopyOnWriteArrayList
|
* @return 新创建的 CopyOnWriteArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> {
|
fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOnWriteArrayList<T> {
|
||||||
return java.util.concurrent.CopyOnWriteArrayList(elements.asList())
|
return java.util.concurrent.CopyOnWriteArrayList(elements.asList())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -705,7 +705,7 @@ fun <T> newCopyOnWriteArrayList(vararg elements: T): java.util.concurrent.CopyOn
|
|||||||
* @return 新创建的 CopyOnWriteArrayList
|
* @return 新创建的 CopyOnWriteArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> {
|
fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.CopyOnWriteArrayList<T> {
|
||||||
return java.util.concurrent.CopyOnWriteArrayList(elements)
|
return java.util.concurrent.CopyOnWriteArrayList(elements)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -715,7 +715,7 @@ fun <T> newCopyOnWriteArrayList(elements: Collection<T>): java.util.concurrent.C
|
|||||||
* @return 新创建的 Stack
|
* @return 新创建的 Stack
|
||||||
*/
|
*/
|
||||||
fun <T> newStack(): Stack<T> {
|
fun <T> newStack(): Stack<T> {
|
||||||
return Stack()
|
return Stack()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -726,9 +726,9 @@ fun <T> newStack(): Stack<T> {
|
|||||||
* @return 新创建的 Stack
|
* @return 新创建的 Stack
|
||||||
*/
|
*/
|
||||||
fun <T> newStack(vararg elements: T): Stack<T> {
|
fun <T> newStack(vararg elements: T): Stack<T> {
|
||||||
val stack = newStack<T>()
|
val stack = newStack<T>()
|
||||||
stack.addAll(elements.asList())
|
stack.addAll(elements.asList())
|
||||||
return stack
|
return stack
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -739,9 +739,9 @@ fun <T> newStack(vararg elements: T): Stack<T> {
|
|||||||
* @return 新创建的 Stack
|
* @return 新创建的 Stack
|
||||||
*/
|
*/
|
||||||
fun <T> newStack(elements: Collection<T>): Stack<T> {
|
fun <T> newStack(elements: Collection<T>): Stack<T> {
|
||||||
val stack = newStack<T>()
|
val stack = newStack<T>()
|
||||||
stack.addAll(elements)
|
stack.addAll(elements)
|
||||||
return stack
|
return stack
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -753,7 +753,7 @@ fun <T> newStack(elements: Collection<T>): Stack<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
|
fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
|
||||||
return TreeSet(comparator)
|
return TreeSet(comparator)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -765,9 +765,9 @@ fun <T> newTreeSet(comparator: Comparator<T>): TreeSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
|
fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
|
||||||
val set = newTreeSet(comparator)
|
val set = newTreeSet(comparator)
|
||||||
set.addAll(elements.asList())
|
set.addAll(elements.asList())
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -779,9 +779,9 @@ fun <T> newTreeSet(comparator: Comparator<T>, vararg elements: T): TreeSet<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> {
|
fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<T> {
|
||||||
val set = newTreeSet(comparator)
|
val set = newTreeSet(comparator)
|
||||||
set.addAll(elements)
|
set.addAll(elements)
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -793,11 +793,11 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Collection<T>): TreeSet<
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> {
|
fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T> {
|
||||||
val set = newTreeSet(comparator)
|
val set = newTreeSet(comparator)
|
||||||
for (element in elements) {
|
for (element in elements) {
|
||||||
set.add(element)
|
set.add(element)
|
||||||
}
|
}
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -809,7 +809,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Iterable<T>): TreeSet<T>
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> {
|
fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T> {
|
||||||
return newTreeSet(comparator, elements.toSet())
|
return newTreeSet(comparator, elements.toSet())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -819,7 +819,7 @@ fun <T> newTreeSet(comparator: Comparator<T>, elements: Sequence<T>): TreeSet<T>
|
|||||||
* @return 新创建的 CopyOnWriteArrayList
|
* @return 新创建的 CopyOnWriteArrayList
|
||||||
*/
|
*/
|
||||||
fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> {
|
fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWriteArrayList<T> {
|
||||||
return java.util.concurrent.CopyOnWriteArrayList(this)
|
return java.util.concurrent.CopyOnWriteArrayList(this)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -829,9 +829,9 @@ fun <T> Collection<T>.newCopyOnWriteArrayLists(): java.util.concurrent.CopyOnWri
|
|||||||
* @return 新创建的 Stack
|
* @return 新创建的 Stack
|
||||||
*/
|
*/
|
||||||
fun <T> Collection<T>.newStacks(): Stack<T> {
|
fun <T> Collection<T>.newStacks(): Stack<T> {
|
||||||
val stack = Stack<T>()
|
val stack = Stack<T>()
|
||||||
stack.addAll(this)
|
stack.addAll(this)
|
||||||
return stack
|
return stack
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -841,9 +841,9 @@ fun <T> Collection<T>.newStacks(): Stack<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
|
fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
|
||||||
val set = TreeSet<T>()
|
val set = TreeSet<T>()
|
||||||
set.addAll(this)
|
set.addAll(this)
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -854,9 +854,9 @@ fun <T> Collection<T>.newTreeSets(): TreeSet<T> where T : Comparable<T> {
|
|||||||
* @return 新创建的 TreeSet
|
* @return 新创建的 TreeSet
|
||||||
*/
|
*/
|
||||||
fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
|
fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
|
||||||
val set = TreeSet(comparator)
|
val set = TreeSet(comparator)
|
||||||
set.addAll(this)
|
set.addAll(this)
|
||||||
return set
|
return set
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -866,11 +866,11 @@ fun <T> Collection<T>.newTreeSets(comparator: Comparator<T>): TreeSet<T> {
|
|||||||
* @return 转换后的字节数组
|
* @return 转换后的字节数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Byte>): ByteArray {
|
fun toArray(list: List<Byte>): ByteArray {
|
||||||
val arr = ByteArray(list.size)
|
val arr = ByteArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -881,11 +881,11 @@ fun toArray(list: List<Byte>): ByteArray {
|
|||||||
* @return 转换后的短整型数组
|
* @return 转换后的短整型数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Short>): ShortArray {
|
fun toArray(list: List<Short>): ShortArray {
|
||||||
val arr = ShortArray(list.size)
|
val arr = ShortArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -895,11 +895,11 @@ fun toArray(list: List<Short>): ShortArray {
|
|||||||
* @return 转换后的整型数组
|
* @return 转换后的整型数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Int>): IntArray {
|
fun toArray(list: List<Int>): IntArray {
|
||||||
val arr = IntArray(list.size)
|
val arr = IntArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -909,11 +909,11 @@ fun toArray(list: List<Int>): IntArray {
|
|||||||
* @return 转换后的长整型数组
|
* @return 转换后的长整型数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Long>): LongArray {
|
fun toArray(list: List<Long>): LongArray {
|
||||||
val arr = LongArray(list.size)
|
val arr = LongArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -923,11 +923,11 @@ fun toArray(list: List<Long>): LongArray {
|
|||||||
* @return 转换后的浮点数组
|
* @return 转换后的浮点数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Float>): FloatArray {
|
fun toArray(list: List<Float>): FloatArray {
|
||||||
val arr = FloatArray(list.size)
|
val arr = FloatArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -937,11 +937,11 @@ fun toArray(list: List<Float>): FloatArray {
|
|||||||
* @return 转换后的双精度浮点数组
|
* @return 转换后的双精度浮点数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Double>): DoubleArray {
|
fun toArray(list: List<Double>): DoubleArray {
|
||||||
val arr = DoubleArray(list.size)
|
val arr = DoubleArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -951,11 +951,11 @@ fun toArray(list: List<Double>): DoubleArray {
|
|||||||
* @return 转换后的布尔数组
|
* @return 转换后的布尔数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Boolean>): BooleanArray {
|
fun toArray(list: List<Boolean>): BooleanArray {
|
||||||
val arr = BooleanArray(list.size)
|
val arr = BooleanArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -965,11 +965,11 @@ fun toArray(list: List<Boolean>): BooleanArray {
|
|||||||
* @return 转换后的字符数组
|
* @return 转换后的字符数组
|
||||||
*/
|
*/
|
||||||
fun toArray(list: List<Char>): CharArray {
|
fun toArray(list: List<Char>): CharArray {
|
||||||
val arr = CharArray(list.size)
|
val arr = CharArray(list.size)
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
arr[i] = list[i]
|
arr[i] = list[i]
|
||||||
}
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
@@ -981,13 +981,21 @@ fun toArray(list: List<Char>): CharArray {
|
|||||||
* @return 转换后的数组
|
* @return 转换后的数组
|
||||||
*/
|
*/
|
||||||
inline fun <reified T> toArray(list: List<T>): Array<T> {
|
inline fun <reified T> toArray(list: List<T>): Array<T> {
|
||||||
if (list.isEmpty())
|
if (list.isEmpty())
|
||||||
return arrayOf<T>()
|
return arrayOf<T>()
|
||||||
return SuperStream.of<T>(list)
|
return SuperStream.of<T>(list)
|
||||||
.toArray(T::class.java)
|
.toArray(T::class.java)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将任意类型的 List 转换为指定类型的数组。
|
||||||
|
*
|
||||||
|
* @param T 元素类型
|
||||||
|
* @param list 输入的 List
|
||||||
|
* @param clazz 数组元素类型对应的 Class 对象
|
||||||
|
* @return 转换后的数组
|
||||||
|
*/
|
||||||
fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> {
|
fun <T> toArray(list: List<T>, clazz: Class<T>): Array<T> {
|
||||||
return SuperStream.of<T>(list)
|
return SuperStream.of<T>(list)
|
||||||
.toArray(clazz)
|
.toArray(clazz)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -34,68 +34,71 @@ import java.util.concurrent.atomic.AtomicReference
|
|||||||
*/
|
*/
|
||||||
class IsChanged<T> {
|
class IsChanged<T> {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用 AtomicReference 来保证对数据的原子操作
|
* 使用 AtomicReference 来保证对数据的原子操作
|
||||||
*/
|
*/
|
||||||
private val atomicReferenceData: AtomicReference<T> = AtomicReference()
|
private val atomicReferenceData: AtomicReference<T> = AtomicReference()
|
||||||
|
|
||||||
constructor()
|
/**
|
||||||
|
* 无参构造函数,初始数据为 null
|
||||||
|
*/
|
||||||
|
constructor()
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 带参数的构造函数,使用指定的初始值初始化
|
* 带参数的构造函数,使用指定的初始值初始化
|
||||||
*
|
*
|
||||||
* @param data 初始数据值
|
* @param data 初始数据值
|
||||||
*/
|
*/
|
||||||
constructor(data: T) : super() {
|
constructor(data: T) : super() {
|
||||||
atomicReferenceData.set(data)
|
atomicReferenceData.set(data)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 设置新的数据值,不检查是否发生变化
|
* 设置新的数据值,不检查是否发生变化
|
||||||
*
|
*
|
||||||
* @param data 要设置的新数据值
|
* @param data 要设置的新数据值
|
||||||
*/
|
*/
|
||||||
fun set(data: T) {
|
fun set(data: T) {
|
||||||
atomicReferenceData.set(data)
|
atomicReferenceData.set(data)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取当前数据值
|
* 获取当前数据值
|
||||||
*
|
*
|
||||||
* @return 当前数据值
|
* @return 当前数据值
|
||||||
*/
|
*/
|
||||||
fun get(): T {
|
fun get(): T {
|
||||||
return atomicReferenceData.get()
|
return atomicReferenceData.get()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 设置新的数据值并返回旧的数据值
|
* 设置新的数据值并返回旧的数据值
|
||||||
*
|
*
|
||||||
* @param data 要设置的新数据值
|
* @param data 要设置的新数据值
|
||||||
* @return 设置前的旧数据值
|
* @return 设置前的旧数据值
|
||||||
*/
|
*/
|
||||||
fun setAndGet(data: T): T {
|
fun setAndGet(data: T): T {
|
||||||
return atomicReferenceData.getAndSet(data)
|
return atomicReferenceData.getAndSet(data)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false
|
* 设置新的数据值,如果新值与当前值不同则更新并返回 true,否则返回 false
|
||||||
* 使用 CAS(Compare-And-Swap) 操作确保线程安全
|
* 使用 CAS(Compare-And-Swap) 操作确保线程安全
|
||||||
*
|
*
|
||||||
* @param data 要设置的新数据值
|
* @param data 要设置的新数据值
|
||||||
* @return 如果值发生变化返回 true,否则返回 false
|
* @return 如果值发生变化返回 true,否则返回 false
|
||||||
*/
|
*/
|
||||||
fun setAndChanged(data: T): Boolean {
|
fun setAndChanged(data: T): Boolean {
|
||||||
var currentData: T
|
var currentData: T
|
||||||
do {
|
do {
|
||||||
currentData = get()
|
currentData = get()
|
||||||
// 如果新值与当前值相等,则认为没有变化,直接返回 false
|
// 如果新值与当前值相等,则认为没有变化,直接返回 false
|
||||||
if (Objects.equals(data, currentData)) {
|
if (Objects.equals(data, currentData)) {
|
||||||
return false
|
return false
|
||||||
}
|
}
|
||||||
// 使用 CAS 操作尝试更新值,如果失败则重试
|
// 使用 CAS 操作尝试更新值,如果失败则重试
|
||||||
} while (!atomicReferenceData.compareAndSet(currentData, data))
|
} while (!atomicReferenceData.compareAndSet(currentData, data))
|
||||||
// 成功更新值,返回 true 表示发生了变化
|
// 成功更新值,返回 true 表示发生了变化
|
||||||
return true
|
return true
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -31,10 +31,10 @@ package com.mingliqiye.utils.configuration
|
|||||||
*/
|
*/
|
||||||
@Retention(AnnotationRetention.RUNTIME)
|
@Retention(AnnotationRetention.RUNTIME)
|
||||||
@Target(
|
@Target(
|
||||||
AnnotationTarget.TYPE_PARAMETER,
|
AnnotationTarget.TYPE_PARAMETER,
|
||||||
AnnotationTarget.VALUE_PARAMETER,
|
AnnotationTarget.VALUE_PARAMETER,
|
||||||
AnnotationTarget.FIELD, // 添加字段支持
|
AnnotationTarget.FIELD, // 添加字段支持
|
||||||
AnnotationTarget.PROPERTY // 添加属性支持
|
AnnotationTarget.PROPERTY // 添加属性支持
|
||||||
)
|
)
|
||||||
annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true)
|
annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true)
|
||||||
|
|
||||||
@@ -45,7 +45,7 @@ annotation class ConfigurationProp(val name: String = "", val description: Strin
|
|||||||
* @return 对应的 setter 方法名。
|
* @return 对应的 setter 方法名。
|
||||||
*/
|
*/
|
||||||
private fun getSetterName(fieldName: String): String {
|
private fun getSetterName(fieldName: String): String {
|
||||||
return "set" + fieldName.take(1).uppercase() + fieldName.substring(1)
|
return "set" + fieldName.take(1).uppercase() + fieldName.substring(1)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -55,7 +55,7 @@ private fun getSetterName(fieldName: String): String {
|
|||||||
* @return 对应的 getter 方法名。
|
* @return 对应的 getter 方法名。
|
||||||
*/
|
*/
|
||||||
private fun getGetterName(fieldName: String): String {
|
private fun getGetterName(fieldName: String): String {
|
||||||
return "get" + fieldName.take(1).uppercase() + fieldName.substring(1)
|
return "get" + fieldName.take(1).uppercase() + fieldName.substring(1)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -63,211 +63,220 @@ private fun getGetterName(fieldName: String): String {
|
|||||||
*/
|
*/
|
||||||
open class ConfigurationProps {
|
open class ConfigurationProps {
|
||||||
|
|
||||||
companion object {
|
/**
|
||||||
/**
|
* 伴生对象,提供根据命令行参数初始化配置类实例的静态方法。
|
||||||
* 初始化配置类实例,并根据命令行参数填充其字段。
|
*/
|
||||||
*
|
companion object {
|
||||||
* @param clazz 配置类的 Class 对象。
|
/**
|
||||||
* @param args 命令行参数数组。
|
* 初始化配置类实例,并根据命令行参数填充其字段。
|
||||||
* @return 初始化后的配置类实例。
|
*
|
||||||
*/
|
* @param clazz 配置类的 Class 对象。
|
||||||
@JvmStatic
|
* @param args 命令行参数数组。
|
||||||
fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
|
* @return 初始化后的配置类实例。
|
||||||
val mapsArgs = parseArguments(args)
|
*/
|
||||||
val instance = clazz.getDeclaredConstructor().newInstance()
|
@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`:键值对形式。
|
||||||
* - `--key value` 或 `-k value`:键和值分开的形式。
|
* - `--key value` 或 `-k value`:键和值分开的形式。
|
||||||
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
|
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
|
||||||
*
|
*
|
||||||
* @param args 命令行参数数组。
|
* @param args 命令行参数数组。
|
||||||
* @return 解析后的键值对映射。
|
* @return 解析后的键值对映射。
|
||||||
*/
|
*/
|
||||||
private fun parseArguments(args: Array<String>): Map<String, List<String>> {
|
private fun parseArguments(args: Array<String>): Map<String, List<String>> {
|
||||||
val mapsArgs = mutableMapOf<String, MutableList<String>>()
|
val mapsArgs = mutableMapOf<String, MutableList<String>>()
|
||||||
|
|
||||||
var i = 0
|
var i = 0
|
||||||
while (i < args.size) {
|
while (i < args.size) {
|
||||||
val arg = args[i]
|
val arg = args[i]
|
||||||
|
|
||||||
when {
|
when {
|
||||||
arg.startsWith("--") -> {
|
arg.startsWith("--") -> {
|
||||||
// 处理 --key=value 格式
|
// 处理 --key=value 格式
|
||||||
if (arg.contains("=")) {
|
if (arg.contains("=")) {
|
||||||
val (key, value) = arg.substring(2).split("=", limit = 2)
|
val (key, value) = arg.substring(2).split("=", limit = 2)
|
||||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
}
|
}
|
||||||
// 处理 --key value 格式
|
// 处理 --key value 格式
|
||||||
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||||
val key = arg.substring(2)
|
val key = arg.substring(2)
|
||||||
val value = args[i + 1]
|
val value = args[i + 1]
|
||||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
i++ // 跳过下一个参数
|
i++ // 跳过下一个参数
|
||||||
}
|
}
|
||||||
// 处理 --flag 格式的布尔标志
|
// 处理 --flag 格式的布尔标志
|
||||||
else {
|
else {
|
||||||
val key = arg.substring(2)
|
val key = arg.substring(2)
|
||||||
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
arg.startsWith("-") -> {
|
arg.startsWith("-") -> {
|
||||||
// 处理 -k=value 格式
|
// 处理 -k=value 格式
|
||||||
if (arg.contains("=")) {
|
if (arg.contains("=")) {
|
||||||
val (key, value) = arg.substring(1).split("=", limit = 2)
|
val (key, value) = arg.substring(1).split("=", limit = 2)
|
||||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
}
|
}
|
||||||
// 处理 -k value 格式
|
// 处理 -k value 格式
|
||||||
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||||
val key = arg.substring(1)
|
val key = arg.substring(1)
|
||||||
val value = args[i + 1]
|
val value = args[i + 1]
|
||||||
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
i++
|
i++
|
||||||
}
|
}
|
||||||
// 处理 -f 格式的布尔标志
|
// 处理 -f 格式的布尔标志
|
||||||
else {
|
else {
|
||||||
val key = arg.substring(1)
|
val key = arg.substring(1)
|
||||||
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
i++
|
i++
|
||||||
}
|
}
|
||||||
|
|
||||||
return mapsArgs
|
return mapsArgs
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 处理配置类中的字段,根据解析出的参数设置字段值。
|
* 处理配置类中的字段,根据解析出的参数设置字段值。
|
||||||
*
|
*
|
||||||
* @param clazz 配置类的 Class 对象。
|
* @param clazz 配置类的 Class 对象。
|
||||||
* @param instance 配置类的实例。
|
* @param instance 配置类的实例。
|
||||||
* @param mapsArgs 解析后的命令行参数映射。
|
* @param mapsArgs 解析后的命令行参数映射。
|
||||||
*/
|
*/
|
||||||
private fun <T : ConfigurationProps> processFields(
|
private fun <T : ConfigurationProps> processFields(
|
||||||
clazz: Class<T>,
|
clazz: Class<T>,
|
||||||
instance: T,
|
instance: T,
|
||||||
mapsArgs: Map<String, List<String>>,
|
mapsArgs: Map<String, List<String>>,
|
||||||
) {
|
) {
|
||||||
val fields = clazz.declaredFields
|
val fields = clazz.declaredFields
|
||||||
|
|
||||||
for (field in fields) {
|
for (field in fields) {
|
||||||
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||||
if (configurationProp != null) {
|
if (configurationProp != null) {
|
||||||
val fieldName = configurationProp.name.ifEmpty { field.name }
|
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||||
val values = mapsArgs[fieldName]
|
val values = mapsArgs[fieldName]
|
||||||
|
|
||||||
if (values != null) {
|
if (values != null) {
|
||||||
try {
|
try {
|
||||||
val setter = clazz.getDeclaredMethod(
|
val setter = clazz.getDeclaredMethod(
|
||||||
getSetterName(field.name),
|
getSetterName(field.name),
|
||||||
field.type
|
field.type
|
||||||
)
|
)
|
||||||
|
|
||||||
val value = convertValue(field.type, values, configurationProp)
|
val value = convertValue(field.type, values, configurationProp)
|
||||||
setter.invoke(instance, value)
|
setter.invoke(instance, value)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
println("Warning: Failed to set field ${field.name}: ${e.message}")
|
println("Warning: Failed to set field ${field.name}: ${e.message}")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字符串值转换为目标类型。
|
* 将字符串值转换为目标类型。
|
||||||
*
|
*
|
||||||
* @param type 目标类型。
|
* @param type 目标类型。
|
||||||
* @param values 字符串值列表。
|
* @param values 字符串值列表。
|
||||||
* @param annotation 配置属性注解。
|
* @param annotation 配置属性注解。
|
||||||
* @return 转换后的值。
|
* @return 转换后的值。
|
||||||
*/
|
*/
|
||||||
private fun convertValue(
|
private fun convertValue(
|
||||||
type: Class<*>,
|
type: Class<*>,
|
||||||
values: List<String>,
|
values: List<String>,
|
||||||
annotation: ConfigurationProp,
|
annotation: ConfigurationProp,
|
||||||
): Any? {
|
): Any? {
|
||||||
val lastValue = values.lastOrNull() ?: return null
|
val lastValue = values.lastOrNull() ?: return null
|
||||||
|
|
||||||
return when (type) {
|
return when (type) {
|
||||||
String::class.java -> lastValue
|
String::class.java -> lastValue
|
||||||
|
|
||||||
Integer::class.java, Int::class.java -> try {
|
Integer::class.java, Int::class.java -> try {
|
||||||
lastValue.toInt()
|
lastValue.toInt()
|
||||||
} catch (e: NumberFormatException) {
|
} catch (e: NumberFormatException) {
|
||||||
println("Warning: Invalid integer value '$lastValue'")
|
println("Warning: Invalid integer value '$lastValue'")
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
|
|
||||||
Long::class.java, java.lang.Long::class.java -> try {
|
Long::class.java, java.lang.Long::class.java -> try {
|
||||||
lastValue.toLong()
|
lastValue.toLong()
|
||||||
} catch (e: NumberFormatException) {
|
} catch (e: NumberFormatException) {
|
||||||
println("Warning: Invalid long value '$lastValue'")
|
println("Warning: Invalid long value '$lastValue'")
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
|
|
||||||
Double::class.java, java.lang.Double::class.java -> try {
|
Double::class.java, java.lang.Double::class.java -> try {
|
||||||
lastValue.toDouble()
|
lastValue.toDouble()
|
||||||
} catch (e: NumberFormatException) {
|
} catch (e: NumberFormatException) {
|
||||||
println("Warning: Invalid double value '$lastValue'")
|
println("Warning: Invalid double value '$lastValue'")
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
|
|
||||||
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
|
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
|
||||||
"true", "1", "yes", "on" -> true
|
"true", "1", "yes", "on" -> true
|
||||||
"false", "0", "no", "off" -> false
|
"false", "0", "no", "off" -> false
|
||||||
else -> {
|
else -> {
|
||||||
println("Warning: Invalid boolean value '$lastValue'")
|
println("Warning: Invalid boolean value '$lastValue'")
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
List::class.java -> values
|
List::class.java -> values
|
||||||
|
|
||||||
else -> {
|
else -> {
|
||||||
println("Warning: Unsupported type ${type.simpleName}")
|
println("Warning: Unsupported type ${type.simpleName}")
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fun printHelp() {
|
/**
|
||||||
val fields = this::class.java.declaredFields
|
* 打印配置项帮助信息,列出所有标注了 ConfigurationProp 且允许显示帮助的字段名称、类型和描述。
|
||||||
val help = StringBuilder()
|
*/
|
||||||
for (field in fields) {
|
fun printHelp() {
|
||||||
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
val fields = this::class.java.declaredFields
|
||||||
if (configurationProp != null && configurationProp.showHelper) {
|
val help = StringBuilder()
|
||||||
val fieldName = configurationProp.name.ifEmpty { field.name }
|
for (field in fields) {
|
||||||
help.append("$fieldName -> Type: ${field.type.simpleName}")
|
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||||
if (configurationProp.description.isNotEmpty()) {
|
if (configurationProp != null && configurationProp.showHelper) {
|
||||||
help.append(" Description: ${configurationProp.description}")
|
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||||
}
|
help.append("$fieldName -> Type: ${field.type.simpleName}")
|
||||||
help.append("\n")
|
if (configurationProp.description.isNotEmpty()) {
|
||||||
}
|
help.append(" Description: ${configurationProp.description}")
|
||||||
}
|
}
|
||||||
println(help)
|
help.append("\n")
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
println(help)
|
||||||
|
}
|
||||||
|
|
||||||
val fields: Map<String, Any?>
|
/**
|
||||||
get() {
|
* 当前配置对象所有声明字段的名称与值的映射。
|
||||||
val fields = this::class.java.declaredFields
|
*/
|
||||||
val fieldValues = mutableMapOf<String, Any?>()
|
val fields: Map<String, Any?>
|
||||||
for (field in fields) {
|
get() {
|
||||||
field.isAccessible = true
|
val fields = this::class.java.declaredFields
|
||||||
val fieldName = field.name
|
val fieldValues = mutableMapOf<String, Any?>()
|
||||||
val fieldValue = field.get(this)
|
for (field in fields) {
|
||||||
fieldValues[fieldName] = fieldValue
|
field.isAccessible = true
|
||||||
}
|
val fieldName = field.name
|
||||||
return fieldValues
|
val fieldValue = field.get(this)
|
||||||
}
|
fieldValues[fieldName] = fieldValue
|
||||||
|
}
|
||||||
|
return fieldValues
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -32,67 +32,67 @@ package com.mingliqiye.utils.data
|
|||||||
*/
|
*/
|
||||||
class ThreadLocalDataHolder<T> {
|
class ThreadLocalDataHolder<T> {
|
||||||
|
|
||||||
private val threadLocal: ThreadLocal<T?> = ThreadLocal()
|
private val threadLocal: ThreadLocal<T?> = ThreadLocal()
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取当前线程存储的值
|
* 获取当前线程存储的值
|
||||||
*
|
*
|
||||||
* @return 当前线程存储的值,如果没有则返回null
|
* @return 当前线程存储的值,如果没有则返回null
|
||||||
*/
|
*/
|
||||||
fun get(): T? {
|
fun get(): T? {
|
||||||
return threadLocal.get()
|
return threadLocal.get()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 设置当前线程的值
|
* 设置当前线程的值
|
||||||
*
|
*
|
||||||
* @param value 要存储的值
|
* @param value 要存储的值
|
||||||
*/
|
*/
|
||||||
fun set(value: T) {
|
fun set(value: T) {
|
||||||
threadLocal.set(value)
|
threadLocal.set(value)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 移除当前线程存储的值
|
* 移除当前线程存储的值
|
||||||
*
|
*
|
||||||
* 防止内存泄漏,使用完毕后应调用此方法清理资源。
|
* 防止内存泄漏,使用完毕后应调用此方法清理资源。
|
||||||
*/
|
*/
|
||||||
fun remove() {
|
fun remove() {
|
||||||
threadLocal.remove()
|
threadLocal.remove()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取当前线程存储的值,如果不存在则返回默认值
|
* 获取当前线程存储的值,如果不存在则返回默认值
|
||||||
*
|
*
|
||||||
* @param defaultValue 默认值
|
* @param defaultValue 默认值
|
||||||
* @return 当前线程存储的值或默认值
|
* @return 当前线程存储的值或默认值
|
||||||
*/
|
*/
|
||||||
fun getOrDefault(defaultValue: T): T {
|
fun getOrDefault(defaultValue: T): T {
|
||||||
val value = threadLocal.get()
|
val value = threadLocal.get()
|
||||||
return value ?: defaultValue
|
return value ?: defaultValue
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 安全获取值(避免NPE)
|
* 安全获取值(避免NPE)
|
||||||
*
|
*
|
||||||
* 在某些异常情况下防止抛出异常,直接返回 null。
|
* 在某些异常情况下防止抛出异常,直接返回 null。
|
||||||
*
|
*
|
||||||
* @return 值或null
|
* @return 值或null
|
||||||
*/
|
*/
|
||||||
fun safeGet(): T? {
|
fun safeGet(): T? {
|
||||||
return try {
|
return try {
|
||||||
threadLocal.get()
|
threadLocal.get()
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
null
|
null
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 检查当前线程是否有值
|
* 检查当前线程是否有值
|
||||||
*
|
*
|
||||||
* @return 是否有值
|
* @return 是否有值
|
||||||
*/
|
*/
|
||||||
fun isPresent(): Boolean {
|
fun isPresent(): Boolean {
|
||||||
return threadLocal.get() != null
|
return threadLocal.get() != null
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -34,40 +34,40 @@ import java.lang.reflect.Field
|
|||||||
* @return 返回一个新的对象实例,其字段值与原对象一致。
|
* @return 返回一个新的对象实例,其字段值与原对象一致。
|
||||||
*/
|
*/
|
||||||
fun <T : Any> clone(obj: T): T {
|
fun <T : Any> clone(obj: T): T {
|
||||||
val clazz = obj.javaClass
|
val clazz = obj.javaClass
|
||||||
val constructor = clazz.getDeclaredConstructor().apply {
|
val constructor = clazz.getDeclaredConstructor().apply {
|
||||||
isAccessible = true
|
isAccessible = true
|
||||||
}
|
}
|
||||||
val instance = constructor.newInstance()
|
val instance = constructor.newInstance()
|
||||||
|
|
||||||
// 遍历类及其父类的所有字段进行赋值
|
// 遍历类及其父类的所有字段进行赋值
|
||||||
var currentClass: Class<*>? = clazz
|
var currentClass: Class<*>? = clazz
|
||||||
while (currentClass != null) {
|
while (currentClass != null) {
|
||||||
currentClass.declaredFields.forEach { field ->
|
currentClass.declaredFields.forEach { field ->
|
||||||
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
|
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
|
||||||
field.isAccessible = true
|
field.isAccessible = true
|
||||||
field.set(instance, field.get(obj))
|
field.set(instance, field.get(obj))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
currentClass = currentClass.superclass
|
currentClass = currentClass.superclass
|
||||||
}
|
}
|
||||||
|
|
||||||
return instance
|
return instance
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 定义 DTO 拷贝行为的枚举类型。
|
* 定义 DTO 拷贝行为的枚举类型。
|
||||||
*/
|
*/
|
||||||
enum class DotCopyType {
|
enum class DotCopyType {
|
||||||
/**
|
/**
|
||||||
* 表示使用点拷贝(.copy)方式处理字段。
|
* 表示使用点拷贝(.copy)方式处理字段。
|
||||||
*/
|
*/
|
||||||
DOT_COPY,
|
DOT_COPY,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 表示普通拷贝方式处理字段。
|
* 表示普通拷贝方式处理字段。
|
||||||
*/
|
*/
|
||||||
COPY
|
COPY
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -77,10 +77,10 @@ enum class DotCopyType {
|
|||||||
*/
|
*/
|
||||||
@Retention(AnnotationRetention.RUNTIME)
|
@Retention(AnnotationRetention.RUNTIME)
|
||||||
@Target(
|
@Target(
|
||||||
AnnotationTarget.TYPE_PARAMETER,
|
AnnotationTarget.TYPE_PARAMETER,
|
||||||
AnnotationTarget.VALUE_PARAMETER,
|
AnnotationTarget.VALUE_PARAMETER,
|
||||||
AnnotationTarget.FIELD,
|
AnnotationTarget.FIELD,
|
||||||
AnnotationTarget.PROPERTY
|
AnnotationTarget.PROPERTY
|
||||||
)
|
)
|
||||||
annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
|
annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
|
||||||
|
|
||||||
@@ -92,40 +92,40 @@ annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
|
|||||||
* @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。
|
* @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。
|
||||||
*/
|
*/
|
||||||
fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
|
fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
|
||||||
val instance = dtoClass.getDeclaredConstructor().apply {
|
val instance = dtoClass.getDeclaredConstructor().apply {
|
||||||
isAccessible = true
|
isAccessible = true
|
||||||
}.newInstance()
|
}.newInstance()
|
||||||
|
|
||||||
val sourceFields = getAllFields(obj.javaClass)
|
val sourceFields = getAllFields(obj.javaClass)
|
||||||
|
|
||||||
for (sourceField in sourceFields) {
|
for (sourceField in sourceFields) {
|
||||||
sourceField.isAccessible = true
|
sourceField.isAccessible = true
|
||||||
val fieldName = sourceField.name
|
val fieldName = sourceField.name
|
||||||
val fieldValue = sourceField.get(obj)
|
val fieldValue = sourceField.get(obj)
|
||||||
|
|
||||||
try {
|
try {
|
||||||
val targetField = dtoClass.getDeclaredField(fieldName).apply {
|
val targetField = dtoClass.getDeclaredField(fieldName).apply {
|
||||||
isAccessible = true
|
isAccessible = true
|
||||||
}
|
}
|
||||||
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
|
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
val ta = targetField.getAnnotation(DtoCopy::class.java)
|
val ta = targetField.getAnnotation(DtoCopy::class.java)
|
||||||
if (ta != null) {
|
if (ta != null) {
|
||||||
if (ta.type == DotCopyType.DOT_COPY) {
|
if (ta.type == DotCopyType.DOT_COPY) {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
targetField.set(instance, fieldValue)
|
targetField.set(instance, fieldValue)
|
||||||
|
|
||||||
} catch (e: NoSuchFieldException) {
|
} catch (e: NoSuchFieldException) {
|
||||||
continue
|
continue
|
||||||
} catch (e: IllegalArgumentException) {
|
} catch (e: IllegalArgumentException) {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return instance
|
return instance
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -135,12 +135,11 @@ fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
|
|||||||
* @return 包含所有字段的列表。
|
* @return 包含所有字段的列表。
|
||||||
*/
|
*/
|
||||||
private fun getAllFields(clazz: Class<*>): List<Field> {
|
private fun getAllFields(clazz: Class<*>): List<Field> {
|
||||||
val fields = mutableListOf<Field>()
|
val fields = mutableListOf<Field>()
|
||||||
var currentClass: Class<*>? = clazz
|
var currentClass: Class<*>? = clazz
|
||||||
while (currentClass != null && currentClass != Any::class.java) {
|
while (currentClass != null && currentClass != Any::class.java) {
|
||||||
fields.addAll(currentClass.declaredFields)
|
fields.addAll(currentClass.declaredFields)
|
||||||
currentClass = currentClass.superclass
|
currentClass = currentClass.superclass
|
||||||
}
|
}
|
||||||
return fields
|
return fields
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class BadGatewayException @JvmOverloads constructor(
|
class BadGatewayException @JvmOverloads constructor(
|
||||||
override val message: String? = "Bad Gateway",
|
override val message: String? = "Bad Gateway",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(502, message, cause)
|
) : HttpStatusException(502, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class BadRequestException @JvmOverloads constructor(
|
class BadRequestException @JvmOverloads constructor(
|
||||||
override val message: String? = "Bad Request",
|
override val message: String? = "Bad Request",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(400, message, cause)
|
) : HttpStatusException(400, message, cause)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示编码或解码过程中发生的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class CodecException @JvmOverloads constructor(
|
class CodecException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class ConflictException @JvmOverloads constructor(
|
class ConflictException @JvmOverloads constructor(
|
||||||
override val message: String? = "Conflict",
|
override val message: String? = "Conflict",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(409, message, cause)
|
) : HttpStatusException(409, message, cause)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 内容为空时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class EmptyJsonException @JvmOverloads constructor(
|
class EmptyJsonException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class ForbiddenException @JvmOverloads constructor(
|
class ForbiddenException @JvmOverloads constructor(
|
||||||
override val message: String? = "Forbidden",
|
override val message: String? = "Forbidden",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(403, message, cause)
|
) : HttpStatusException(403, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class FoundException @JvmOverloads constructor(
|
class FoundException @JvmOverloads constructor(
|
||||||
override val message: String? = "Found",
|
override val message: String? = "Found",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(302, message, cause)
|
) : HttpStatusException(302, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class GatewayTimeoutException @JvmOverloads constructor(
|
class GatewayTimeoutException @JvmOverloads constructor(
|
||||||
override val message: String? = "Gateway Timeout",
|
override val message: String? = "Gateway Timeout",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(504, message, cause)
|
) : HttpStatusException(504, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class GoneException @JvmOverloads constructor(
|
class GoneException @JvmOverloads constructor(
|
||||||
override val message: String? = "Gone",
|
override val message: String? = "Gone",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(410, message, cause)
|
) : HttpStatusException(410, message, cause)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 相关异常的基类,继承自 [MingLiUtilsBaseException]。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
open class HttpException @JvmOverloads constructor(
|
open class HttpException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -30,9 +30,9 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
open class HttpStatusException @JvmOverloads constructor(
|
open class HttpStatusException @JvmOverloads constructor(
|
||||||
val statusCode: Int,
|
val statusCode: Int,
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP URL 无效或处理失败时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
open class HttpUrlException @JvmOverloads constructor(
|
open class HttpUrlException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class HttpVersionNotSupportedException @JvmOverloads constructor(
|
class HttpVersionNotSupportedException @JvmOverloads constructor(
|
||||||
override val message: String? = "HTTP Version Not Supported",
|
override val message: String? = "HTTP Version Not Supported",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(505, message, cause)
|
) : HttpStatusException(505, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class InternalServerErrorException @JvmOverloads constructor(
|
class InternalServerErrorException @JvmOverloads constructor(
|
||||||
override val message: String? = "Internal Server Error",
|
override val message: String? = "Internal Server Error",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(500, message, cause)
|
) : HttpStatusException(500, message, cause)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 内容无效或不合法时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class InvalidJsonException @JvmOverloads constructor(
|
class InvalidJsonException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -31,8 +31,8 @@ package com.mingliqiye.utils.exception
|
|||||||
* 3. 仅包含原因(Throwable)的构造函数。
|
* 3. 仅包含原因(Throwable)的构造函数。
|
||||||
*/
|
*/
|
||||||
open class JsonException @JvmOverloads constructor(
|
open class JsonException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 对象类型转换失败时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class JsonObjectCastException @JvmOverloads constructor(
|
class JsonObjectCastException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -16,15 +16,39 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile JsonParserException.kt
|
* CurrentFile JsonParserException.kt
|
||||||
* LastUpdate 2026-10-11 16:53:41
|
* LastUpdate 2026-11-17 16:22:52
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 解析过程中发生的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class JsonParserException @JvmOverloads constructor(
|
class JsonParserException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
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)
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 数据类型不匹配时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class JsonTypeException @JvmOverloads constructor(
|
class JsonTypeException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class LengthRequiredException @JvmOverloads constructor(
|
class LengthRequiredException @JvmOverloads constructor(
|
||||||
override val message: String? = "Length Required",
|
override val message: String? = "Length Required",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(411, message, cause)
|
) : HttpStatusException(411, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class MethodNotAllowedException @JvmOverloads constructor(
|
class MethodNotAllowedException @JvmOverloads constructor(
|
||||||
override val message: String? = "Method Not Allowed",
|
override val message: String? = "Method Not Allowed",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(405, message, cause)
|
) : HttpStatusException(405, message, cause)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* mingli-utils 工具库所有异常的基类,继承自 [RuntimeException]。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
open class MingLiUtilsBaseException @JvmOverloads constructor(
|
open class MingLiUtilsBaseException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
cause: Throwable? = null,
|
cause: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : RuntimeException(message, cause, enableSuppression, writableStackTrace)
|
) : RuntimeException(message, cause, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class MovedPermanentlyException @JvmOverloads constructor(
|
class MovedPermanentlyException @JvmOverloads constructor(
|
||||||
override val message: String? = "Moved Permanently",
|
override val message: String? = "Moved Permanently",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(301, message, cause)
|
) : HttpStatusException(301, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class MultipleChoicesException @JvmOverloads constructor(
|
class MultipleChoicesException @JvmOverloads constructor(
|
||||||
override val message: String? = "Multiple Choices",
|
override val message: String? = "Multiple Choices",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(300, message, cause)
|
) : HttpStatusException(300, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class NotAcceptableException @JvmOverloads constructor(
|
class NotAcceptableException @JvmOverloads constructor(
|
||||||
override val message: String? = "Not Acceptable",
|
override val message: String? = "Not Acceptable",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(406, message, cause)
|
) : HttpStatusException(406, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class NotFoundException @JvmOverloads constructor(
|
class NotFoundException @JvmOverloads constructor(
|
||||||
override val message: String? = "Not Found",
|
override val message: String? = "Not Found",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(404, message, cause)
|
) : HttpStatusException(404, message, cause)
|
||||||
|
|||||||
@@ -22,9 +22,17 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.exception
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示请求的资源未找到时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
class NotFoundResourceException @JvmOverloads constructor(
|
class NotFoundResourceException @JvmOverloads constructor(
|
||||||
message: String? = null,
|
message: String? = null,
|
||||||
throwable: Throwable? = null,
|
throwable: Throwable? = null,
|
||||||
enableSuppression: Boolean = false,
|
enableSuppression: Boolean = false,
|
||||||
writableStackTrace: Boolean = true,
|
writableStackTrace: Boolean = true,
|
||||||
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class NotImplementedException @JvmOverloads constructor(
|
class NotImplementedException @JvmOverloads constructor(
|
||||||
override val message: String? = "Not Implemented",
|
override val message: String? = "Not Implemented",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(501, message, cause)
|
) : HttpStatusException(501, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class NotModifiedException @JvmOverloads constructor(
|
class NotModifiedException @JvmOverloads constructor(
|
||||||
override val message: String? = "Not Modified",
|
override val message: String? = "Not Modified",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(304, message, cause)
|
) : HttpStatusException(304, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class PaymentRequiredException @JvmOverloads constructor(
|
class PaymentRequiredException @JvmOverloads constructor(
|
||||||
override val message: String? = "Payment Required",
|
override val message: String? = "Payment Required",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(402, message, cause)
|
) : HttpStatusException(402, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class PreconditionFailedException @JvmOverloads constructor(
|
class PreconditionFailedException @JvmOverloads constructor(
|
||||||
override val message: String? = "Precondition Failed",
|
override val message: String? = "Precondition Failed",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(412, message, cause)
|
) : HttpStatusException(412, message, cause)
|
||||||
|
|||||||
+2
-2
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class ProxyAuthenticationRequiredException @JvmOverloads constructor(
|
class ProxyAuthenticationRequiredException @JvmOverloads constructor(
|
||||||
override val message: String? = "Proxy Authentication Required",
|
override val message: String? = "Proxy Authentication Required",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(407, message, cause)
|
) : HttpStatusException(407, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class RequestEntityTooLargeException @JvmOverloads constructor(
|
class RequestEntityTooLargeException @JvmOverloads constructor(
|
||||||
override val message: String? = "Request Entity Too Large",
|
override val message: String? = "Request Entity Too Large",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(413, message, cause)
|
) : HttpStatusException(413, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class RequestTimeoutException @JvmOverloads constructor(
|
class RequestTimeoutException @JvmOverloads constructor(
|
||||||
override val message: String? = "Request Timeout",
|
override val message: String? = "Request Timeout",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(408, message, cause)
|
) : HttpStatusException(408, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class RequestUriTooLargeException @JvmOverloads constructor(
|
class RequestUriTooLargeException @JvmOverloads constructor(
|
||||||
override val message: String? = "Request URI Too Large",
|
override val message: String? = "Request URI Too Large",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(414, message, cause)
|
) : HttpStatusException(414, message, cause)
|
||||||
|
|||||||
+2
-2
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class RequestedRangeNotSatisfiableException @JvmOverloads constructor(
|
class RequestedRangeNotSatisfiableException @JvmOverloads constructor(
|
||||||
override val message: String? = "Requested Range Not Satisfiable",
|
override val message: String? = "Requested Range Not Satisfiable",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(416, message, cause)
|
) : HttpStatusException(416, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class SeeOtherException @JvmOverloads constructor(
|
class SeeOtherException @JvmOverloads constructor(
|
||||||
override val message: String? = "See Other",
|
override val message: String? = "See Other",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(303, message, cause)
|
) : HttpStatusException(303, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class ServiceUnavailableException @JvmOverloads constructor(
|
class ServiceUnavailableException @JvmOverloads constructor(
|
||||||
override val message: String? = "Service Unavailable",
|
override val message: String? = "Service Unavailable",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(503, message, cause)
|
) : HttpStatusException(503, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class TemporaryRedirectException @JvmOverloads constructor(
|
class TemporaryRedirectException @JvmOverloads constructor(
|
||||||
override val message: String? = "Temporary Redirect",
|
override val message: String? = "Temporary Redirect",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(307, message, cause)
|
) : HttpStatusException(307, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class UnauthorizedException @JvmOverloads constructor(
|
class UnauthorizedException @JvmOverloads constructor(
|
||||||
override val message: String? = "Unauthorized",
|
override val message: String? = "Unauthorized",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(401, message, cause)
|
) : HttpStatusException(401, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class UnsupportedMediaTypeException @JvmOverloads constructor(
|
class UnsupportedMediaTypeException @JvmOverloads constructor(
|
||||||
override val message: String? = "Unsupported Media Type",
|
override val message: String? = "Unsupported Media Type",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(415, message, cause)
|
) : HttpStatusException(415, message, cause)
|
||||||
|
|||||||
@@ -29,6 +29,6 @@ package com.mingliqiye.utils.exception
|
|||||||
* @param cause 异常原因,默认为 null
|
* @param cause 异常原因,默认为 null
|
||||||
*/
|
*/
|
||||||
class UseProxyException @JvmOverloads constructor(
|
class UseProxyException @JvmOverloads constructor(
|
||||||
override val message: String? = "Use Proxy",
|
override val message: String? = "Use Proxy",
|
||||||
override val cause: Throwable? = null,
|
override val cause: Throwable? = null,
|
||||||
) : HttpStatusException(305, message, cause)
|
) : HttpStatusException(305, message, cause)
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -35,34 +35,34 @@ import com.mingliqiye.utils.functions.*
|
|||||||
* @param <T> 可迭代对象中元素的类型
|
* @param <T> 可迭代对象中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEach(
|
fun <T> forEach(
|
||||||
iterable: Iterable<T>, action: P2Function<in T, in Int>
|
iterable: Iterable<T>, action: P2Function<in T, in Int>,
|
||||||
) {
|
) {
|
||||||
when (iterable) {
|
when (iterable) {
|
||||||
is RandomAccess if iterable is MutableList<*> -> {
|
is RandomAccess if iterable is MutableList<*> -> {
|
||||||
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
||||||
val list = iterable as MutableList<T>
|
val list = iterable as MutableList<T>
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
action.call(list[i], i)
|
action.call(list[i], i)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
is MutableList<*> -> {
|
is MutableList<*> -> {
|
||||||
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
||||||
var index = 0
|
var index = 0
|
||||||
val it = iterable.iterator()
|
val it = iterable.iterator()
|
||||||
while (it.hasNext()) {
|
while (it.hasNext()) {
|
||||||
action.call(it.next(), index)
|
action.call(it.next(), index)
|
||||||
index++
|
index++
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
else -> {
|
else -> {
|
||||||
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
||||||
for ((index, element) in iterable.withIndex()) {
|
for ((index, element) in iterable.withIndex()) {
|
||||||
action.call(element, index)
|
action.call(element, index)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -74,20 +74,20 @@ fun <T> forEach(
|
|||||||
* @param <T> 可迭代对象中元素的类型
|
* @param <T> 可迭代对象中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEach(
|
fun <T> forEach(
|
||||||
iterable: Iterable<T>, action: P1Function<in T>
|
iterable: Iterable<T>, action: P1Function<in T>,
|
||||||
) {
|
) {
|
||||||
if (iterable is RandomAccess) {
|
if (iterable is RandomAccess) {
|
||||||
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
||||||
val list = iterable as MutableList<T>
|
val list = iterable as MutableList<T>
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
action.call(list[i])
|
action.call(list[i])
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
// 否则使用增强 for 循环进行遍历
|
// 否则使用增强 for 循环进行遍历
|
||||||
for (element in iterable) {
|
for (element in iterable) {
|
||||||
action.call(element)
|
action.call(element)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -100,36 +100,36 @@ fun <T> forEach(
|
|||||||
* @param <T> 可迭代对象中元素的类型
|
* @param <T> 可迭代对象中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEachB(
|
fun <T> forEachB(
|
||||||
iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean>
|
iterable: Iterable<T>, action: P2RFunction<in T, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
when (iterable) {
|
when (iterable) {
|
||||||
is RandomAccess if iterable is MutableList<*> -> {
|
is RandomAccess if iterable is MutableList<*> -> {
|
||||||
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
// 如果是支持随机访问的可变列表,则使用索引遍历以提高性能
|
||||||
val list = iterable as MutableList<T>
|
val list = iterable as MutableList<T>
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
if (action.call(list[i], i)) return
|
if (action.call(list[i], i)) return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
is MutableList<*> -> {
|
is MutableList<*> -> {
|
||||||
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
// 对于普通可变列表,使用迭代器进行遍历,并手动维护索引
|
||||||
var index = 0
|
var index = 0
|
||||||
val it = iterable.iterator()
|
val it = iterable.iterator()
|
||||||
while (it.hasNext()) {
|
while (it.hasNext()) {
|
||||||
if (action.call(it.next(), index)) return
|
if (action.call(it.next(), index)) return
|
||||||
index++
|
index++
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
else -> {
|
else -> {
|
||||||
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
// 对于其他类型的可迭代对象,使用增强 for 循环并手动维护索引
|
||||||
var index = 0
|
var index = 0
|
||||||
for (element in iterable) {
|
for (element in iterable) {
|
||||||
if (action.call(element, index)) return
|
if (action.call(element, index)) return
|
||||||
index++
|
index++
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -142,20 +142,20 @@ fun <T> forEachB(
|
|||||||
* @param <T> 可迭代对象中元素的类型
|
* @param <T> 可迭代对象中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEachB(
|
fun <T> forEachB(
|
||||||
iterable: Iterable<T>, action: P1RFunction<in T, out Boolean>
|
iterable: Iterable<T>, action: P1RFunction<in T, out Boolean>,
|
||||||
) {
|
) {
|
||||||
if (iterable is RandomAccess) {
|
if (iterable is RandomAccess) {
|
||||||
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
// 如果是支持随机访问的列表,则使用索引遍历以提高性能
|
||||||
val list = iterable as MutableList<T>
|
val list = iterable as MutableList<T>
|
||||||
for (i in list.indices) {
|
for (i in list.indices) {
|
||||||
if (action.call(list[i])) return
|
if (action.call(list[i])) return
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
// 否则使用增强 for 循环进行遍历
|
// 否则使用增强 for 循环进行遍历
|
||||||
for (element in iterable) {
|
for (element in iterable) {
|
||||||
if (action.call(element)) return
|
if (action.call(element)) return
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -166,9 +166,9 @@ fun <T> forEachB(
|
|||||||
* @param <T> 数组中元素的类型
|
* @param <T> 数组中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEach(
|
fun <T> forEach(
|
||||||
array: Array<T>, action: P2Function<in T, in Int>
|
array: Array<T>, action: P2Function<in T, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -179,9 +179,9 @@ fun <T> forEach(
|
|||||||
* @param <T> 数组中元素的类型
|
* @param <T> 数组中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEach(
|
fun <T> forEach(
|
||||||
array: Array<T>, action: P1Function<in T>
|
array: Array<T>, action: P1Function<in T>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -193,9 +193,9 @@ fun <T> forEach(
|
|||||||
* @param <T> 数组中元素的类型
|
* @param <T> 数组中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEachB(
|
fun <T> forEachB(
|
||||||
array: Array<T>, action: P2RFunction<in T, in Int, out Boolean>
|
array: Array<T>, action: P2RFunction<in T, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -207,9 +207,9 @@ fun <T> forEachB(
|
|||||||
* @param <T> 数组中元素的类型
|
* @param <T> 数组中元素的类型
|
||||||
*/
|
*/
|
||||||
fun <T> forEachB(
|
fun <T> forEachB(
|
||||||
array: Array<T>, action: P1RFunction<in T, out Boolean>
|
array: Array<T>, action: P1RFunction<in T, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -219,9 +219,9 @@ fun <T> forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: ByteArray, action: P2Function<in Byte, in Int>
|
array: ByteArray, action: P2Function<in Byte, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -231,9 +231,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: ByteArray, action: P1Function<in Byte>
|
array: ByteArray, action: P1Function<in Byte>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -244,9 +244,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean>
|
array: ByteArray, action: P2RFunction<in Byte, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -257,9 +257,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: ByteArray, action: P1RFunction<in Byte, out Boolean>
|
array: ByteArray, action: P1RFunction<in Byte, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -269,9 +269,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: CharArray, action: P2Function<in Char, in Int>
|
array: CharArray, action: P2Function<in Char, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -281,9 +281,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: CharArray, action: P1Function<in Char>
|
array: CharArray, action: P1Function<in Char>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -294,9 +294,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: CharArray, action: P2RFunction<in Char, in Int, out Boolean>
|
array: CharArray, action: P2RFunction<in Char, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -307,9 +307,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: CharArray, action: P1RFunction<in Char, out Boolean>
|
array: CharArray, action: P1RFunction<in Char, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -319,9 +319,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: IntArray, action: P2Function<in Int, in Int>
|
array: IntArray, action: P2Function<in Int, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -331,9 +331,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: IntArray, action: P1Function<in Int>
|
array: IntArray, action: P1Function<in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -344,9 +344,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: IntArray, action: P2RFunction<in Int, in Int, out Boolean>
|
array: IntArray, action: P2RFunction<in Int, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -357,9 +357,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: IntArray, action: P1RFunction<in Int, out Boolean>
|
array: IntArray, action: P1RFunction<in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -369,9 +369,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: LongArray, action: P2Function<in Long, in Int>
|
array: LongArray, action: P2Function<in Long, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -381,9 +381,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: LongArray, action: P1Function<in Long>
|
array: LongArray, action: P1Function<in Long>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -394,9 +394,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: LongArray, action: P2RFunction<in Long, in Int, out Boolean>
|
array: LongArray, action: P2RFunction<in Long, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -407,9 +407,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: LongArray, action: P1RFunction<in Long, out Boolean>
|
array: LongArray, action: P1RFunction<in Long, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -419,9 +419,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: ShortArray, action: P2Function<in Short, in Int>
|
array: ShortArray, action: P2Function<in Short, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -431,9 +431,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: ShortArray, action: P1Function<in Short>
|
array: ShortArray, action: P1Function<in Short>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -444,9 +444,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean>
|
array: ShortArray, action: P2RFunction<in Short, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -457,9 +457,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: ShortArray, action: P1RFunction<in Short, out Boolean>
|
array: ShortArray, action: P1RFunction<in Short, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -469,9 +469,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: FloatArray, action: P2Function<in Float, in Int>
|
array: FloatArray, action: P2Function<in Float, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -481,9 +481,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: FloatArray, action: P1Function<in Float>
|
array: FloatArray, action: P1Function<in Float>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -494,9 +494,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean>
|
array: FloatArray, action: P2RFunction<in Float, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -507,9 +507,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: FloatArray, action: P1RFunction<in Float, out Boolean>
|
array: FloatArray, action: P1RFunction<in Float, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -519,9 +519,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: DoubleArray, action: P2Function<in Double, in Int>
|
array: DoubleArray, action: P2Function<in Double, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -531,9 +531,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: DoubleArray, action: P1Function<in Double>
|
array: DoubleArray, action: P1Function<in Double>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -544,9 +544,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean>
|
array: DoubleArray, action: P2RFunction<in Double, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -557,9 +557,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: DoubleArray, action: P1RFunction<in Double, out Boolean>
|
array: DoubleArray, action: P1RFunction<in Double, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -569,9 +569,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: BooleanArray, action: P2Function<in Boolean, in Int>
|
array: BooleanArray, action: P2Function<in Boolean, in Int>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -581,9 +581,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数
|
||||||
*/
|
*/
|
||||||
fun forEach(
|
fun forEach(
|
||||||
array: BooleanArray, action: P1Function<in Boolean>
|
array: BooleanArray, action: P1Function<in Boolean>,
|
||||||
) {
|
) {
|
||||||
forEach(array.toList(), action)
|
forEach(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -594,9 +594,9 @@ fun forEach(
|
|||||||
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,接收元素值和索引作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean>
|
array: BooleanArray, action: P2RFunction<in Boolean, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -607,9 +607,9 @@ fun forEachB(
|
|||||||
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
* @param action 要对每个元素执行的操作,只接收元素值作为参数,返回 Boolean 表示是否提前终止
|
||||||
*/
|
*/
|
||||||
fun forEachB(
|
fun forEachB(
|
||||||
array: BooleanArray, action: P1RFunction<in Boolean, out Boolean>
|
array: BooleanArray, action: P1RFunction<in Boolean, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array.toList(), action)
|
forEachB(array.toList(), action)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -623,9 +623,9 @@ fun forEachB(
|
|||||||
* @param <A> 集合的具体类型
|
* @param <A> 集合的具体类型
|
||||||
*/
|
*/
|
||||||
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
|
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
|
||||||
array: A, action: P3RFunction<in K, in V, in Int, out Boolean>
|
array: A, action: P3RFunction<in K, in V, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
|
forEachB(array, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -639,9 +639,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachB(
|
|||||||
* @param <A> 映射的具体类型
|
* @param <A> 映射的具体类型
|
||||||
*/
|
*/
|
||||||
fun <K, V, A : Map<K, V>> forEachB(
|
fun <K, V, A : Map<K, V>> forEachB(
|
||||||
map: A, action: P3RFunction<in K, in V, in Int, out Boolean>
|
map: A, action: P3RFunction<in K, in V, in Int, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(map.entries, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
|
forEachB(map.entries, P2RFunction<Map.Entry<K, V>, Int, Boolean> { p1, p2 -> action.call(p1.key, p1.value, p2) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -654,9 +654,9 @@ fun <K, V, A : Map<K, V>> forEachB(
|
|||||||
* @param <A> 集合的具体类型
|
* @param <A> 集合的具体类型
|
||||||
*/
|
*/
|
||||||
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
|
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
|
||||||
array: A, action: P2Function<in K, in V>
|
array: A, action: P2Function<in K, in V>,
|
||||||
) {
|
) {
|
||||||
forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
|
forEach(array, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -669,9 +669,9 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMap(
|
|||||||
* @param <A> 映射的具体类型
|
* @param <A> 映射的具体类型
|
||||||
*/
|
*/
|
||||||
fun <K, V, A : Map<K, V>> forEachMap(
|
fun <K, V, A : Map<K, V>> forEachMap(
|
||||||
map: A, action: P2Function<in K, in V>
|
map: A, action: P2Function<in K, in V>,
|
||||||
) {
|
) {
|
||||||
forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
|
forEach(map.entries, P1Function<Map.Entry<K, V>> { p1 -> action.call(p1.key, p1.value) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -685,9 +685,9 @@ fun <K, V, A : Map<K, V>> forEachMap(
|
|||||||
* @param <A> 集合的具体类型
|
* @param <A> 集合的具体类型
|
||||||
*/
|
*/
|
||||||
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
|
fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
|
||||||
array: A, action: P2RFunction<in K, in V, out Boolean>
|
array: A, action: P2RFunction<in K, in V, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(array, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
|
forEachB(array, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -701,7 +701,7 @@ fun <K, V, A : Collection<Map.Entry<K, V>>> forEachMapB(
|
|||||||
* @param <A> 映射的具体类型
|
* @param <A> 映射的具体类型
|
||||||
*/
|
*/
|
||||||
fun <K, V, A : Map<K, V>> forEachMapB(
|
fun <K, V, A : Map<K, V>> forEachMapB(
|
||||||
map: A, action: P2RFunction<in K, in V, out Boolean>
|
map: A, action: P2RFunction<in K, in V, out Boolean>,
|
||||||
) {
|
) {
|
||||||
forEachB(map.entries, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
|
forEachB(map.entries, P1RFunction<Map.Entry<K, V>, Boolean> { p1 -> action.call(p1.key, p1.value) })
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -32,53 +32,53 @@ import java.util.concurrent.*
|
|||||||
*/
|
*/
|
||||||
class Debouncer(private val delay: Long, unit: TimeUnit) {
|
class Debouncer(private val delay: Long, unit: TimeUnit) {
|
||||||
|
|
||||||
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor(
|
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor(
|
||||||
NamedThreadFactory { clazz, poolNumber, threadNumber ->
|
NamedThreadFactory { clazz, poolNumber, threadNumber ->
|
||||||
"Debouncer-$poolNumber-$threadNumber"
|
"Debouncer-$poolNumber-$threadNumber"
|
||||||
}
|
}
|
||||||
)
|
)
|
||||||
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
|
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
|
||||||
private val delayMillis: Long = unit.toMillis(delay)
|
private val delayMillis: Long = unit.toMillis(delay)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
|
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
|
||||||
*
|
*
|
||||||
* @param key 任务的唯一标识符,用于区分不同任务
|
* @param key 任务的唯一标识符,用于区分不同任务
|
||||||
* @param task 要执行的任务
|
* @param task 要执行的任务
|
||||||
*/
|
*/
|
||||||
fun debounce(key: Any, task: Runnable) {
|
fun debounce(key: Any, task: Runnable) {
|
||||||
// 提交新任务并获取之前可能存在的任务
|
// 提交新任务并获取之前可能存在的任务
|
||||||
val prev = delayedMap.put(
|
val prev = delayedMap.put(
|
||||||
key,
|
key,
|
||||||
scheduler.schedule(
|
scheduler.schedule(
|
||||||
{
|
{
|
||||||
try {
|
try {
|
||||||
task.run()
|
task.run()
|
||||||
} finally {
|
} finally {
|
||||||
// 任务执行完成后从映射中移除
|
// 任务执行完成后从映射中移除
|
||||||
delayedMap.remove(key)
|
delayedMap.remove(key)
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
delayMillis,
|
delayMillis,
|
||||||
TimeUnit.MILLISECONDS
|
TimeUnit.MILLISECONDS
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
|
|
||||||
// 如果之前存在任务,则取消它
|
// 如果之前存在任务,则取消它
|
||||||
prev?.cancel(true)
|
prev?.cancel(true)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 关闭防抖器,取消所有待执行的任务并关闭调度器
|
* 关闭防抖器,取消所有待执行的任务并关闭调度器
|
||||||
*/
|
*/
|
||||||
fun shutdown() {
|
fun shutdown() {
|
||||||
// 先取消所有延迟任务
|
// 先取消所有延迟任务
|
||||||
for (future in delayedMap.values) {
|
for (future in delayedMap.values) {
|
||||||
future.cancel(true)
|
future.cancel(true)
|
||||||
}
|
}
|
||||||
delayedMap.clear()
|
delayedMap.clear()
|
||||||
|
|
||||||
// 再关闭调度器
|
// 再关闭调度器
|
||||||
scheduler.shutdownNow()
|
scheduler.shutdownNow()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -31,275 +31,275 @@ import kotlin.reflect.KClass
|
|||||||
*/
|
*/
|
||||||
class Pipeline<T>(private val value: T) {
|
class Pipeline<T>(private val value: T) {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对当前值进行转换操作,并返回新的Pipeline实例
|
* 对当前值进行转换操作,并返回新的Pipeline实例
|
||||||
* @param transformer 转换函数,接收当前值并返回转换后的结果
|
* @param transformer 转换函数,接收当前值并返回转换后的结果
|
||||||
* @return 包含转换后结果的新Pipeline实例
|
* @return 包含转换后结果的新Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value))
|
fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value))
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择
|
* 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择
|
||||||
* @param transformer 转换函数,接收当前值并返回转换后的结果
|
* @param transformer 转换函数,接收当前值并返回转换后的结果
|
||||||
* @return 包含转换后结果的新Pipeline实例
|
* @return 包含转换后结果的新Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer)
|
fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer)
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 消费当前值但不改变流水线状态,用于执行副作用操作
|
* 消费当前值但不改变流水线状态,用于执行副作用操作
|
||||||
* @param consumer 消费函数,接收当前值进行消费操作
|
* @param consumer 消费函数,接收当前值进行消费操作
|
||||||
* @return 当前Pipeline实例,支持链式调用
|
* @return 当前Pipeline实例,支持链式调用
|
||||||
*/
|
*/
|
||||||
fun consume(consumer: P1Function<T>): Pipeline<T> {
|
fun consume(consumer: P1Function<T>): Pipeline<T> {
|
||||||
consumer.call(value)
|
consumer.call(value)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 判断当前值是否为null
|
* 判断当前值是否为null
|
||||||
* @return true表示当前值为null,false表示不为null
|
* @return true表示当前值为null,false表示不为null
|
||||||
*/
|
*/
|
||||||
fun isNull(): Boolean = (value == null)
|
fun isNull(): Boolean = (value == null)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 判断当前值是否不为null
|
* 判断当前值是否不为null
|
||||||
* @return true表示当前值不为null,false表示为null
|
* @return true表示当前值不为null,false表示为null
|
||||||
*/
|
*/
|
||||||
fun isNotNull(): Boolean = (value != null)
|
fun isNotNull(): Boolean = (value != null)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null
|
* 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null
|
||||||
* @param predicate 过滤条件函数,接收当前值并返回布尔值
|
* @param predicate 过滤条件函数,接收当前值并返回布尔值
|
||||||
* @return 包含过滤后结果的Pipeline实例
|
* @return 包含过滤后结果的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
|
fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
|
||||||
if (predicate.call(value)) Pipeline(value) else Pipeline(null)
|
if (predicate.call(value)) Pipeline(value) else Pipeline(null)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取当前流水线中的值
|
* 获取当前流水线中的值
|
||||||
* @return 当前流水线中存储的值
|
* @return 当前流水线中存储的值
|
||||||
*/
|
*/
|
||||||
fun getValue(): T = value
|
fun getValue(): T = value
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 安全地转换当前值,允许转换结果为null
|
* 安全地转换当前值,允许转换结果为null
|
||||||
* @param transformer 转换函数,可能返回null
|
* @param transformer 转换函数,可能返回null
|
||||||
* @return 包含转换后结果(可能为null)的Pipeline实例
|
* @return 包含转换后结果(可能为null)的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value))
|
fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value))
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前值映射为另一个Pipeline实例
|
* 将当前值映射为另一个Pipeline实例
|
||||||
* @param mapper 映射函数,接收当前值并返回Pipeline实例
|
* @param mapper 映射函数,接收当前值并返回Pipeline实例
|
||||||
* @return 映射后的Pipeline实例
|
* @return 映射后的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value)
|
fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前值映射为非null结果,如果当前值为null则直接返回null
|
* 将当前值映射为非null结果,如果当前值为null则直接返回null
|
||||||
* @param mapper 映射函数,可能返回null
|
* @param mapper 映射函数,可能返回null
|
||||||
* @return 包含映射后结果的Pipeline实例
|
* @return 包含映射后结果的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> =
|
fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> =
|
||||||
if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null)
|
if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null)
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将当前值强制转换为指定类型
|
* 将当前值强制转换为指定类型
|
||||||
* @param type 目标类型Class对象
|
* @param type 目标类型Class对象
|
||||||
* @return 包含转换后类型的Pipeline实例
|
* @return 包含转换后类型的Pipeline实例
|
||||||
* @throws ClassCastException 当类型转换失败时抛出异常
|
* @throws ClassCastException 当类型转换失败时抛出异常
|
||||||
*/
|
*/
|
||||||
@Throws(ClassCastException::class)
|
@Throws(ClassCastException::class)
|
||||||
@Suppress("UNCHECKED_CAST")
|
@Suppress("UNCHECKED_CAST")
|
||||||
fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E)
|
fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 根据条件判断是否保留当前值,条件满足时保留,否则返回null
|
* 根据条件判断是否保留当前值,条件满足时保留,否则返回null
|
||||||
* @param predicate 条件判断函数
|
* @param predicate 条件判断函数
|
||||||
* @return 包含条件判断结果的Pipeline实例
|
* @return 包含条件判断结果的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null)
|
fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 根据条件判断是否保留当前值,条件不满足时保留,否则返回null
|
* 根据条件判断是否保留当前值,条件不满足时保留,否则返回null
|
||||||
* @param predicate 条件判断函数
|
* @param predicate 条件判断函数
|
||||||
* @return 包含条件判断结果的Pipeline实例
|
* @return 包含条件判断结果的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
|
fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
|
||||||
Pipeline(if (!predicate.call(value)) value else null)
|
Pipeline(if (!predicate.call(value)) value else null)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 在当前值上执行指定操作并返回操作结果
|
* 在当前值上执行指定操作并返回操作结果
|
||||||
* @param block 执行函数,接收当前值并返回结果
|
* @param block 执行函数,接收当前值并返回结果
|
||||||
* @return 包含执行结果的Pipeline实例
|
* @return 包含执行结果的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value))
|
fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value))
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例
|
* 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例
|
||||||
* @param defaultValue 默认值
|
* @param defaultValue 默认值
|
||||||
* @return 当前值或默认值的Pipeline实例
|
* @return 当前值或默认值的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue)
|
fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 如果当前值不为null则返回自身,否则通过供应商函数获取默认值
|
* 如果当前值不为null则返回自身,否则通过供应商函数获取默认值
|
||||||
* @param supplier 默认值供应商函数
|
* @param supplier 默认值供应商函数
|
||||||
* @return 当前值或供应商提供的值的Pipeline实例
|
* @return 当前值或供应商提供的值的Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call())
|
fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call())
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 验证当前值是否等于指定值,如果不相等则抛出异常
|
* 验证当前值是否等于指定值,如果不相等则抛出异常
|
||||||
* @param any 比较的目标值
|
* @param any 比较的目标值
|
||||||
* @param message 错误消息
|
* @param message 错误消息
|
||||||
* @param exception 异常类型,默认为IllegalArgumentException
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java,
|
any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java,
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
requireTrue(any == value, exception, message)
|
requireTrue(any == value, exception, message)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常
|
* 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常
|
||||||
* @param any 比较的目标值
|
* @param any 比较的目标值
|
||||||
* @param message 错误消息
|
* @param message 错误消息
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
any: Any, message: String,
|
any: Any, message: String,
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
requireTrue(any == value, message)
|
requireTrue(any == value, message)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
|
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
|
||||||
* @param must 验证条件函数
|
* @param must 验证条件函数
|
||||||
* @param message 错误消息
|
* @param message 错误消息
|
||||||
* @param exception 异常类型,默认为IllegalArgumentException
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
must: P1RFunction<T, Boolean>,
|
must: P1RFunction<T, Boolean>,
|
||||||
message: String,
|
message: String,
|
||||||
exception: Class<out Throwable> = IllegalArgumentException::class.java,
|
exception: Class<out Throwable> = IllegalArgumentException::class.java,
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
requireTrue(must.call(value), exception, message)
|
requireTrue(must.call(value), exception, message)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 验证当前值是否等于指定值,如果不相等则抛出异常
|
* 验证当前值是否等于指定值,如果不相等则抛出异常
|
||||||
* @param any 比较的目标值
|
* @param any 比较的目标值
|
||||||
* @param message 错误消息
|
* @param message 错误消息
|
||||||
* @param exception 异常类型,默认为IllegalArgumentException
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
any: Any,
|
any: Any,
|
||||||
message: String,
|
message: String,
|
||||||
exception: KClass<out Throwable> = IllegalArgumentException::class,
|
exception: KClass<out Throwable> = IllegalArgumentException::class,
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
requireTrue(any == value, exception.java, message)
|
requireTrue(any == value, exception.java, message)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
|
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
|
||||||
* @param must 验证条件函数
|
* @param must 验证条件函数
|
||||||
* @param message 错误消息
|
* @param message 错误消息
|
||||||
* @param exception 异常类型,默认为IllegalArgumentException
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
must: (T) -> Boolean,
|
must: (T) -> Boolean,
|
||||||
message: String,
|
message: String,
|
||||||
exception: KClass<out Throwable> = IllegalArgumentException::class,
|
exception: KClass<out Throwable> = IllegalArgumentException::class,
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
requireTrue(must(value), exception.java, message)
|
requireTrue(must(value), exception.java, message)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常
|
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常
|
||||||
* @param must 验证条件函数
|
* @param must 验证条件函数
|
||||||
* @param message 错误消息
|
* @param message 错误消息
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
must: P1RFunction<T, Boolean>, message: String,
|
must: P1RFunction<T, Boolean>, message: String,
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
requireTrue(must.call(value), message)
|
requireTrue(must.call(value), message)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 对当前值执行指定操作但不改变流水线状态
|
* 对当前值执行指定操作但不改变流水线状态
|
||||||
* @param block 执行函数,接收当前值
|
* @param block 执行函数,接收当前值
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun also(block: P1Function<T>): Pipeline<T> {
|
fun also(block: P1Function<T>): Pipeline<T> {
|
||||||
block.call(value)
|
block.call(value)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常
|
* 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常
|
||||||
* @param predicate 验证条件函数
|
* @param predicate 验证条件函数
|
||||||
* @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed"
|
* @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed"
|
||||||
* @return 当前Pipeline实例
|
* @return 当前Pipeline实例
|
||||||
*/
|
*/
|
||||||
fun require(
|
fun require(
|
||||||
predicate: P1RFunction<T, Boolean>,
|
predicate: P1RFunction<T, Boolean>,
|
||||||
lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" },
|
lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" },
|
||||||
): Pipeline<T> {
|
): Pipeline<T> {
|
||||||
if (!predicate.call(value)) {
|
if (!predicate.call(value)) {
|
||||||
throw IllegalArgumentException(lazyMessage.call(value).toString())
|
throw IllegalArgumentException(lazyMessage.call(value).toString())
|
||||||
}
|
}
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用比较器比较当前值与另一个值
|
* 使用比较器比较当前值与另一个值
|
||||||
* @param other 另一个比较值
|
* @param other 另一个比较值
|
||||||
* @param comparator 比较器
|
* @param comparator 比较器
|
||||||
* @return 比较结果,负数表示小于,0表示相等,正数表示大于
|
* @return 比较结果,负数表示小于,0表示相等,正数表示大于
|
||||||
*/
|
*/
|
||||||
fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other)
|
fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用选择器将当前值转换为可比较类型后与另一个值比较
|
* 使用选择器将当前值转换为可比较类型后与另一个值比较
|
||||||
* @param other 另一个比较值
|
* @param other 另一个比较值
|
||||||
* @param selector 选择器函数,将当前值转换为可比较类型
|
* @param selector 选择器函数,将当前值转换为可比较类型
|
||||||
* @return 比较结果
|
* @return 比较结果
|
||||||
*/
|
*/
|
||||||
fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int =
|
fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int =
|
||||||
selector.call(value).compareTo(other)
|
selector.call(value).compareTo(other)
|
||||||
|
|
||||||
|
|
||||||
companion object {
|
companion object {
|
||||||
/**
|
/**
|
||||||
* 创建包含指定值的Pipeline实例
|
* 创建包含指定值的Pipeline实例
|
||||||
* @param value 要包装的值
|
* @param value 要包装的值
|
||||||
* @return 新的Pipeline实例
|
* @return 新的Pipeline实例
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> of(value: T): Pipeline<T> = Pipeline(value)
|
fun <T> of(value: T): Pipeline<T> = Pipeline(value)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 通过供应商函数创建Pipeline实例
|
* 通过供应商函数创建Pipeline实例
|
||||||
* @param transformer 值供应商函数
|
* @param transformer 值供应商函数
|
||||||
* @return 新的Pipeline实例
|
* @return 新的Pipeline实例
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call())
|
fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -44,24 +44,24 @@ import java.security.NoSuchAlgorithmException
|
|||||||
*/
|
*/
|
||||||
@Throws(IOException::class, NoSuchAlgorithmException::class)
|
@Throws(IOException::class, NoSuchAlgorithmException::class)
|
||||||
fun calculateFileHash(file: File, algorithm: String): String {
|
fun calculateFileHash(file: File, algorithm: String): String {
|
||||||
// 检查文件是否存在
|
// 检查文件是否存在
|
||||||
if (!file.exists()) {
|
if (!file.exists()) {
|
||||||
throw IOException("File not found: " + file.absolutePath)
|
throw IOException("File not found: " + file.absolutePath)
|
||||||
}
|
}
|
||||||
|
|
||||||
val digest = MessageDigest.getInstance(algorithm)
|
val digest = MessageDigest.getInstance(algorithm)
|
||||||
|
|
||||||
FileInputStream(file).use { fis ->
|
FileInputStream(file).use { fis ->
|
||||||
val buffer = ByteArray(8192)
|
val buffer = ByteArray(8192)
|
||||||
var bytesRead: Int
|
var bytesRead: Int
|
||||||
|
|
||||||
// 分块读取文件内容并更新摘要
|
// 分块读取文件内容并更新摘要
|
||||||
while (fis.read(buffer).also { bytesRead = it } != -1) {
|
while (fis.read(buffer).also { bytesRead = it } != -1) {
|
||||||
digest.update(buffer, 0, bytesRead)
|
digest.update(buffer, 0, bytesRead)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return bytesToHex(digest.digest())
|
return bytesToHex(digest.digest())
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -71,7 +71,7 @@ fun calculateFileHash(file: File, algorithm: String): String {
|
|||||||
* @return 加密后的 BCrypt 哈希字符串
|
* @return 加密后的 BCrypt 哈希字符串
|
||||||
*/
|
*/
|
||||||
fun bcrypt(string: String): String {
|
fun bcrypt(string: String): String {
|
||||||
return hashpw(string)
|
return hashpw(string)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -82,5 +82,5 @@ fun bcrypt(string: String): String {
|
|||||||
* @return 如果匹配返回 true,否则返回 false
|
* @return 如果匹配返回 true,否则返回 false
|
||||||
*/
|
*/
|
||||||
fun checkBcrypt(string: String, bcrypted: String): Boolean {
|
fun checkBcrypt(string: String, bcrypted: String): Boolean {
|
||||||
return checkpw(string, bcrypted)
|
return checkpw(string, bcrypted)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -22,21 +22,33 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.http
|
package com.mingliqiye.utils.http
|
||||||
|
|
||||||
|
/**
|
||||||
|
* HTTP 响应基类,封装时间、消息、数据和状态码等通用响应字段。
|
||||||
|
*
|
||||||
|
* 除 [time] 外字段均可变,本身非线程安全;
|
||||||
|
* 如需不可变更新语义,请使用子类的 with* 系列方法。
|
||||||
|
*
|
||||||
|
* @param T 响应数据的类型
|
||||||
|
*/
|
||||||
open class BaseResponse<T>(
|
open class BaseResponse<T>(
|
||||||
open val time: String,
|
/** 响应时间(格式化的字符串),创建后不可修改 */
|
||||||
open var message: String,
|
open val time: String,
|
||||||
open var data: T,
|
/** 响应消息,可通过 setter 修改 */
|
||||||
open var statusCode: Int,
|
open var message: String,
|
||||||
|
/** 响应数据,可通过 setter 修改 */
|
||||||
|
open var data: T,
|
||||||
|
/** HTTP 状态码,可通过 setter 修改 */
|
||||||
|
open var statusCode: Int,
|
||||||
|
|
||||||
) {
|
) {
|
||||||
/**
|
/**
|
||||||
* 返回响应对象的字符串表示
|
* 返回响应对象的字符串表示
|
||||||
*
|
*
|
||||||
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
|
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
|
||||||
* 显示时间、消息、数据类型和值以及状态码。
|
* 显示时间、消息、数据类型和值以及状态码。
|
||||||
*
|
*
|
||||||
* @return 格式化的字符串表示
|
* @return 格式化的字符串表示
|
||||||
*/
|
*/
|
||||||
override fun toString(): String =
|
override fun toString(): String =
|
||||||
"${javaClass.simpleName}(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
|
"${javaClass.simpleName}(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
|
||||||
}
|
}
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -26,4 +26,9 @@ package com.mingliqiye.utils.http
|
|||||||
import okhttp3.MediaType.Companion.toMediaType
|
import okhttp3.MediaType.Companion.toMediaType
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将本枚举转换为 OkHttp 的 [okhttp3.MediaType]。
|
||||||
|
*
|
||||||
|
* @return 与 [MediaType.value] 对应的 OkHttp 媒体类型
|
||||||
|
*/
|
||||||
fun MediaType.okhttp(): okhttp3.MediaType = this.value.toMediaType()
|
fun MediaType.okhttp(): okhttp3.MediaType = this.value.toMediaType()
|
||||||
|
|||||||
@@ -28,38 +28,46 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page
|
|||||||
* 分页数据类
|
* 分页数据类
|
||||||
*/
|
*/
|
||||||
data class PageData<T>(
|
data class PageData<T>(
|
||||||
/**
|
/**
|
||||||
* 当前页的数据列表
|
* 当前页的数据列表
|
||||||
*/
|
*/
|
||||||
val records: Collection<T> = emptyList(),
|
val records: Collection<T> = emptyList(),
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 总条数(总记录数)
|
* 总条数(总记录数)
|
||||||
*/
|
*/
|
||||||
val totalCount: Long = 0,
|
val totalCount: Long = 0,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 总页数
|
* 总页数
|
||||||
*/
|
*/
|
||||||
val totalPages: Long = 0,
|
val totalPages: Long = 0,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 每页大小
|
* 每页大小
|
||||||
*/
|
*/
|
||||||
val pageSize: Long = 0,
|
val pageSize: Long = 0,
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 当前页码(从 1 开始)
|
* 当前页码(从 1 开始)
|
||||||
*/
|
*/
|
||||||
val pageIndex: Long = 0,
|
val pageIndex: Long = 0,
|
||||||
) {
|
) {
|
||||||
companion object {
|
/** 伴生对象,提供工厂方法 */
|
||||||
fun <T> of(page: Page<T>): PageData<T> = PageData(
|
companion object {
|
||||||
records = page.records,
|
/**
|
||||||
totalCount = page.total,
|
* 从 MyBatis-Plus 的分页对象构建分页数据
|
||||||
totalPages = page.pages,
|
*
|
||||||
pageSize = page.size,
|
* @param T 记录类型
|
||||||
pageIndex = page.current,
|
* @param page MyBatis-Plus 分页对象
|
||||||
)
|
* @return 转换后的分页数据
|
||||||
}
|
*/
|
||||||
|
fun <T> of(page: Page<T>): PageData<T> = PageData(
|
||||||
|
records = page.records,
|
||||||
|
totalCount = page.total,
|
||||||
|
totalPages = page.pages,
|
||||||
|
pageSize = page.size,
|
||||||
|
pageIndex = page.current,
|
||||||
|
)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -25,192 +25,205 @@ package com.mingliqiye.utils.http
|
|||||||
import com.baomidou.mybatisplus.extension.plugins.pagination.Page
|
import com.baomidou.mybatisplus.extension.plugins.pagination.Page
|
||||||
import com.mingliqiye.utils.time.DateTime
|
import com.mingliqiye.utils.time.DateTime
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 分页 HTTP 响应数据类,数据部分为 [PageData] 分页结构。
|
||||||
|
*
|
||||||
|
* 继承 [BaseResponse],支持链式调用与 with* 不可变更新,
|
||||||
|
* 并提供多种工厂方法创建成功/错误响应。
|
||||||
|
*
|
||||||
|
* @param T 分页记录的类型
|
||||||
|
* @property time 响应时间(格式化的字符串)
|
||||||
|
* @property message 响应消息
|
||||||
|
* @property data 分页响应数据
|
||||||
|
* @property statusCode HTTP 状态码
|
||||||
|
*/
|
||||||
data class PagedResponse<T>(
|
data class PagedResponse<T>(
|
||||||
override val time: String, // 响应时间,一旦创建不可修改
|
override val time: String, // 响应时间,一旦创建不可修改
|
||||||
override var message: String, // 响应消息,可通过setter修改
|
override var message: String, // 响应消息,可通过setter修改
|
||||||
override var data: PageData<T>, // 响应数据,可通过setter修改
|
override var data: PageData<T>, // 响应数据,可通过setter修改
|
||||||
override var statusCode: Int, // HTTP状态码,可通过setter修改
|
override var statusCode: Int, // HTTP状态码,可通过setter修改
|
||||||
) : BaseResponse<PageData<T>>(
|
) : BaseResponse<PageData<T>>(
|
||||||
time,
|
time,
|
||||||
message,
|
message,
|
||||||
data,
|
data,
|
||||||
statusCode
|
statusCode
|
||||||
) {
|
) {
|
||||||
companion object {
|
/** 伴生对象,提供各类分页响应的工厂方法 */
|
||||||
/**
|
companion object {
|
||||||
* 创建一个默认的成功响应对象
|
/**
|
||||||
* 使用默认消息"操作成功",无数据,状态码200
|
* 创建一个默认的成功响应对象
|
||||||
*
|
* 使用默认消息"操作成功",无数据,状态码200
|
||||||
* @return Response<Nothing> 默认的成功响应对象
|
*
|
||||||
*/
|
* @return Response<Nothing> 默认的成功响应对象
|
||||||
fun ok() = ok("操作成功")
|
*/
|
||||||
|
fun ok() = ok("操作成功")
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个默认的错误响应对象
|
* 创建一个默认的错误响应对象
|
||||||
* 使用默认消息"服务器错误",无数据,状态码500
|
* 使用默认消息"服务器错误",无数据,状态码500
|
||||||
*
|
*
|
||||||
* @return Response<Nothing> 默认的成功响应对象
|
* @return Response<Nothing> 默认的成功响应对象
|
||||||
*/
|
*/
|
||||||
fun error() = error("服务器错误")
|
fun error() = error("服务器错误")
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个成功的响应对象(仅包含消息)
|
* 创建一个成功的响应对象(仅包含消息)
|
||||||
*
|
*
|
||||||
* @param message 响应消息
|
* @param message 响应消息
|
||||||
* @return Response<Any> 成功的响应对象,数据为null
|
* @return Response<Any> 成功的响应对象,数据为null
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun ok(message: String) = PagedResponse(
|
fun ok(message: String) = PagedResponse(
|
||||||
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = 200
|
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = 200
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个错误的响应对象
|
* 创建一个错误的响应对象
|
||||||
*
|
*
|
||||||
* @param message 错误消息,默认为"服务器错误"
|
* @param message 错误消息,默认为"服务器错误"
|
||||||
* @param statusCode HTTP状态码,默认为500
|
* @param statusCode HTTP状态码,默认为500
|
||||||
* @return Response<Any> 错误的响应对象
|
* @return Response<Any> 错误的响应对象
|
||||||
*/
|
*/
|
||||||
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
|
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个成功的响应对象(仅包含数据)
|
* 创建一个成功的响应对象(仅包含数据)
|
||||||
* 使用默认消息"操作成功"
|
* 使用默认消息"操作成功"
|
||||||
*
|
*
|
||||||
* @param T 响应数据的类型
|
* @param T 响应数据的类型
|
||||||
* @param data 响应数据
|
* @param data 响应数据
|
||||||
* @return Response<T> 成功的响应对象,包含数据
|
* @return Response<T> 成功的响应对象,包含数据
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> okData(data: PageData<T>) = PagedResponse(
|
fun <T> okData(data: PageData<T>) = PagedResponse(
|
||||||
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
|
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 从mybatisplus的page构建
|
* 从mybatisplus的page构建
|
||||||
*/
|
*/
|
||||||
@JvmOverloads
|
@JvmOverloads
|
||||||
fun <T> okPgae(
|
fun <T> okPgae(
|
||||||
page: Page<T>,
|
page: Page<T>,
|
||||||
time: String = DateTime.now().format(),
|
time: String = DateTime.now().format(),
|
||||||
message: String = "操作成功",
|
message: String = "操作成功",
|
||||||
statusCode: Int = 200,
|
statusCode: Int = 200,
|
||||||
): PagedResponse<T> {
|
): PagedResponse<T> {
|
||||||
|
|
||||||
return PagedResponse(
|
return PagedResponse(
|
||||||
time = time, message = message, data = PageData.of(page), statusCode = statusCode
|
time = time, message = message, data = PageData.of(page), statusCode = statusCode
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个成功的响应对象(包含数据和消息)
|
* 创建一个成功的响应对象(包含数据和消息)
|
||||||
*
|
*
|
||||||
* @param T 响应数据的类型
|
* @param T 响应数据的类型
|
||||||
* @param data 响应数据
|
* @param data 响应数据
|
||||||
* @param message 响应消息
|
* @param message 响应消息
|
||||||
* @return Response<T> 成功的响应对象,包含数据和消息
|
* @return Response<T> 成功的响应对象,包含数据和消息
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> okData(data: PageData<T>, message: String) = PagedResponse(
|
fun <T> okData(data: PageData<T>, message: String) = PagedResponse(
|
||||||
time = DateTime.now().format(), message = message, data = data, statusCode = 200
|
time = DateTime.now().format(), message = message, data = data, statusCode = 200
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个指定状态码的响应对象(仅包含状态码)
|
* 创建一个指定状态码的响应对象(仅包含状态码)
|
||||||
* 使用默认消息"操作成功",无数据
|
* 使用默认消息"操作成功",无数据
|
||||||
*
|
*
|
||||||
* @param statusCode HTTP状态码
|
* @param statusCode HTTP状态码
|
||||||
* @return Response<Any> 指定状态码的响应对象
|
* @return Response<Any> 指定状态码的响应对象
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun code(statusCode: Int) = PagedResponse(
|
fun code(statusCode: Int) = PagedResponse(
|
||||||
time = DateTime.now().format(), message = "操作成功", data = PageData<Nothing>(), statusCode = statusCode
|
time = DateTime.now().format(), message = "操作成功", data = PageData<Nothing>(), statusCode = statusCode
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个指定状态码的响应对象(包含状态码和消息)
|
* 创建一个指定状态码的响应对象(包含状态码和消息)
|
||||||
* 无数据
|
* 无数据
|
||||||
*
|
*
|
||||||
* @param statusCode HTTP状态码
|
* @param statusCode HTTP状态码
|
||||||
* @param message 响应消息
|
* @param message 响应消息
|
||||||
* @return Response<Any> 指定状态码和消息的响应对象
|
* @return Response<Any> 指定状态码和消息的响应对象
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun code(statusCode: Int, message: String) = PagedResponse(
|
fun code(statusCode: Int, message: String) = PagedResponse(
|
||||||
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = statusCode
|
time = DateTime.now().format(), message = message, data = PageData<Nothing>(), statusCode = statusCode
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 默认构造函数,创建一个默认的成功响应对象
|
* 默认构造函数,创建一个默认的成功响应对象
|
||||||
* 使用当前时间、默认消息"操作成功"、状态码200、无数据
|
* 使用当前时间、默认消息"操作成功"、状态码200、无数据
|
||||||
*/
|
*/
|
||||||
constructor() : this(
|
constructor() : this(
|
||||||
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = PageData()
|
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = PageData()
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 设置响应数据
|
* 设置响应数据
|
||||||
*
|
*
|
||||||
* 该方法允许修改响应数据,并返回当前对象以支持链式调用。
|
* 该方法允许修改响应数据,并返回当前对象以支持链式调用。
|
||||||
*
|
*
|
||||||
* @param data 新的响应数据
|
* @param data 新的响应数据
|
||||||
* @return Response<T> 当前响应对象(支持链式调用)
|
* @return Response<T> 当前响应对象(支持链式调用)
|
||||||
*/
|
*/
|
||||||
fun setData(data: PageData<T>): PagedResponse<T> {
|
fun setData(data: PageData<T>): PagedResponse<T> {
|
||||||
this.data = data
|
this.data = data
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的时间
|
* 创建一个新的Response对象,使用指定的时间
|
||||||
*
|
*
|
||||||
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
|
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
|
||||||
* 如果时间相同,则返回原对象避免不必要的对象创建。
|
* 如果时间相同,则返回原对象避免不必要的对象创建。
|
||||||
*
|
*
|
||||||
* @param time 新的响应时间
|
* @param time 新的响应时间
|
||||||
* @return Response<T> 新的响应对象(如果时间相同则返回原对象)
|
* @return Response<T> 新的响应对象(如果时间相同则返回原对象)
|
||||||
*/
|
*/
|
||||||
fun withTime(time: String): PagedResponse<T> =
|
fun withTime(time: String): PagedResponse<T> =
|
||||||
if (this.time == time) this else PagedResponse(time, message, data, statusCode)
|
if (this.time == time) this else PagedResponse(time, message, data, statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的数据
|
* 创建一个新的Response对象,使用指定的数据
|
||||||
*
|
*
|
||||||
* 该方法允许改变响应数据的类型,创建一个新的响应对象。
|
* 该方法允许改变响应数据的类型,创建一个新的响应对象。
|
||||||
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
|
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
|
||||||
*
|
*
|
||||||
* @param D 新的数据类型
|
* @param D 新的数据类型
|
||||||
* @param data 新的响应数据
|
* @param data 新的响应数据
|
||||||
* @return Response<D> 新的响应对象,数据类型为D
|
* @return Response<D> 新的响应对象,数据类型为D
|
||||||
*/
|
*/
|
||||||
fun <D> withData(data: PageData<D>): PagedResponse<D> =
|
fun <D> withData(data: PageData<D>): PagedResponse<D> =
|
||||||
PagedResponse(this.time, this.message, data, this.statusCode)
|
PagedResponse(this.time, this.message, data, this.statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的消息
|
* 创建一个新的Response对象,使用指定的消息
|
||||||
*
|
*
|
||||||
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
|
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
|
||||||
* 如果消息相同,则返回原对象避免不必要的对象创建。
|
* 如果消息相同,则返回原对象避免不必要的对象创建。
|
||||||
*
|
*
|
||||||
* @param message 新的响应消息
|
* @param message 新的响应消息
|
||||||
* @return Response<T> 新的响应对象(如果消息相同则返回原对象)
|
* @return Response<T> 新的响应对象(如果消息相同则返回原对象)
|
||||||
*/
|
*/
|
||||||
fun withMessage(message: String): PagedResponse<T> =
|
fun withMessage(message: String): PagedResponse<T> =
|
||||||
if (this.message == message) this else PagedResponse(time, message, data, statusCode)
|
if (this.message == message) this else PagedResponse(time, message, data, statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的状态码
|
* 创建一个新的Response对象,使用指定的状态码
|
||||||
*
|
*
|
||||||
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
|
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
|
||||||
* 如果状态码相同,则返回原对象避免不必要的对象创建。
|
* 如果状态码相同,则返回原对象避免不必要的对象创建。
|
||||||
*
|
*
|
||||||
* @param statusCode 新的状态码
|
* @param statusCode 新的状态码
|
||||||
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
|
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
|
||||||
*/
|
*/
|
||||||
fun withStatusCode(statusCode: Int): PagedResponse<T> =
|
fun withStatusCode(statusCode: Int): PagedResponse<T> =
|
||||||
if (this.statusCode == statusCode) this else PagedResponse(time, message, data, statusCode)
|
if (this.statusCode == statusCode) this else PagedResponse(time, message, data, statusCode)
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -38,171 +38,172 @@ import com.mingliqiye.utils.time.DateTime
|
|||||||
* @property statusCode HTTP状态码
|
* @property statusCode HTTP状态码
|
||||||
*/
|
*/
|
||||||
data class Response<T>(
|
data class Response<T>(
|
||||||
override val time: String, // 响应时间,一旦创建不可修改
|
override val time: String, // 响应时间,一旦创建不可修改
|
||||||
override var message: String, // 响应消息,可通过setter修改
|
override var message: String, // 响应消息,可通过setter修改
|
||||||
override var data: T?, // 响应数据,可通过setter修改
|
override var data: T?, // 响应数据,可通过setter修改
|
||||||
override var statusCode: Int, // HTTP状态码,可通过setter修改
|
override var statusCode: Int, // HTTP状态码,可通过setter修改
|
||||||
) : BaseResponse<T?>(
|
) : BaseResponse<T?>(
|
||||||
time,
|
time,
|
||||||
message,
|
message,
|
||||||
data,
|
data,
|
||||||
statusCode,
|
statusCode,
|
||||||
) {
|
) {
|
||||||
|
|
||||||
companion object {
|
/** 伴生对象,提供各类响应的工厂方法 */
|
||||||
/**
|
companion object {
|
||||||
* 创建一个默认的成功响应对象
|
/**
|
||||||
* 使用默认消息"操作成功",无数据,状态码200
|
* 创建一个默认的成功响应对象
|
||||||
*
|
* 使用默认消息"操作成功",无数据,状态码200
|
||||||
* @return Response<Nothing> 默认的成功响应对象
|
*
|
||||||
*/
|
* @return Response<Nothing> 默认的成功响应对象
|
||||||
fun ok() = ok("操作成功")
|
*/
|
||||||
|
fun ok() = ok("操作成功")
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个默认的错误响应对象
|
* 创建一个默认的错误响应对象
|
||||||
* 使用默认消息"服务器错误",无数据,状态码500
|
* 使用默认消息"服务器错误",无数据,状态码500
|
||||||
*
|
*
|
||||||
* @return Response<Nothing> 默认的成功响应对象
|
* @return Response<Nothing> 默认的成功响应对象
|
||||||
*/
|
*/
|
||||||
fun error() = error("服务器错误")
|
fun error() = error("服务器错误")
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个成功的响应对象(仅包含消息)
|
* 创建一个成功的响应对象(仅包含消息)
|
||||||
*
|
*
|
||||||
* @param message 响应消息
|
* @param message 响应消息
|
||||||
* @return Response<Any> 成功的响应对象,数据为null
|
* @return Response<Any> 成功的响应对象,数据为null
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun ok(message: String) = Response(
|
fun ok(message: String) = Response(
|
||||||
time = DateTime.now().format(), message = message, data = null, statusCode = 200
|
time = DateTime.now().format(), message = message, data = null, statusCode = 200
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个错误的响应对象
|
* 创建一个错误的响应对象
|
||||||
*
|
*
|
||||||
* @param message 错误消息,默认为"服务器错误"
|
* @param message 错误消息,默认为"服务器错误"
|
||||||
* @param statusCode HTTP状态码,默认为500
|
* @param statusCode HTTP状态码,默认为500
|
||||||
* @return Response<Any> 错误的响应对象
|
* @return Response<Any> 错误的响应对象
|
||||||
*/
|
*/
|
||||||
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
|
fun error(message: String = "服务器错误", statusCode: Int = 500) = ok(message).withStatusCode(statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个成功的响应对象(仅包含数据)
|
* 创建一个成功的响应对象(仅包含数据)
|
||||||
* 使用默认消息"操作成功"
|
* 使用默认消息"操作成功"
|
||||||
*
|
*
|
||||||
* @param T 响应数据的类型
|
* @param T 响应数据的类型
|
||||||
* @param data 响应数据
|
* @param data 响应数据
|
||||||
* @return Response<T> 成功的响应对象,包含数据
|
* @return Response<T> 成功的响应对象,包含数据
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> okData(data: T) = Response(
|
fun <T> okData(data: T) = Response(
|
||||||
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
|
time = DateTime.now().format(), message = "操作成功", data = data, statusCode = 200
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个成功的响应对象(包含数据和消息)
|
* 创建一个成功的响应对象(包含数据和消息)
|
||||||
*
|
*
|
||||||
* @param T 响应数据的类型
|
* @param T 响应数据的类型
|
||||||
* @param data 响应数据
|
* @param data 响应数据
|
||||||
* @param message 响应消息
|
* @param message 响应消息
|
||||||
* @return Response<T> 成功的响应对象,包含数据和消息
|
* @return Response<T> 成功的响应对象,包含数据和消息
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> okData(data: T, message: String) = Response(
|
fun <T> okData(data: T, message: String) = Response(
|
||||||
time = DateTime.now().format(), message = message, data = data, statusCode = 200
|
time = DateTime.now().format(), message = message, data = data, statusCode = 200
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个指定状态码的响应对象(仅包含状态码)
|
* 创建一个指定状态码的响应对象(仅包含状态码)
|
||||||
* 使用默认消息"操作成功",无数据
|
* 使用默认消息"操作成功",无数据
|
||||||
*
|
*
|
||||||
* @param statusCode HTTP状态码
|
* @param statusCode HTTP状态码
|
||||||
* @return Response<Any> 指定状态码的响应对象
|
* @return Response<Any> 指定状态码的响应对象
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun code(statusCode: Int) = Response(
|
fun code(statusCode: Int) = Response(
|
||||||
time = DateTime.now().format(), message = "操作成功", data = null, statusCode = statusCode
|
time = DateTime.now().format(), message = "操作成功", data = null, statusCode = statusCode
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个指定状态码的响应对象(包含状态码和消息)
|
* 创建一个指定状态码的响应对象(包含状态码和消息)
|
||||||
* 无数据
|
* 无数据
|
||||||
*
|
*
|
||||||
* @param statusCode HTTP状态码
|
* @param statusCode HTTP状态码
|
||||||
* @param message 响应消息
|
* @param message 响应消息
|
||||||
* @return Response<Any> 指定状态码和消息的响应对象
|
* @return Response<Any> 指定状态码和消息的响应对象
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun code(statusCode: Int, message: String) = Response(
|
fun code(statusCode: Int, message: String) = Response(
|
||||||
time = DateTime.now().format(), message = message, data = null, statusCode = statusCode
|
time = DateTime.now().format(), message = message, data = null, statusCode = statusCode
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 默认构造函数,创建一个默认的成功响应对象
|
* 默认构造函数,创建一个默认的成功响应对象
|
||||||
* 使用当前时间、默认消息"操作成功"、状态码200、无数据
|
* 使用当前时间、默认消息"操作成功"、状态码200、无数据
|
||||||
*/
|
*/
|
||||||
constructor() : this(
|
constructor() : this(
|
||||||
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = null
|
time = DateTime.now().format(), message = "操作成功", statusCode = 200, data = null
|
||||||
)
|
)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的时间
|
* 创建一个新的Response对象,使用指定的时间
|
||||||
*
|
*
|
||||||
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
|
* 该方法用于创建具有新时间的响应对象,遵循不可变对象的设计模式。
|
||||||
* 如果时间相同,则返回原对象避免不必要的对象创建。
|
* 如果时间相同,则返回原对象避免不必要的对象创建。
|
||||||
*
|
*
|
||||||
* @param time 新的响应时间
|
* @param time 新的响应时间
|
||||||
* @return Response<T> 新的响应对象(如果时间相同则返回原对象)
|
* @return Response<T> 新的响应对象(如果时间相同则返回原对象)
|
||||||
*/
|
*/
|
||||||
fun withTime(time: String): Response<T> = if (this.time == time) this else Response(time, message, data, statusCode)
|
fun withTime(time: String): Response<T> = if (this.time == time) this else Response(time, message, data, statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的数据
|
* 创建一个新的Response对象,使用指定的数据
|
||||||
*
|
*
|
||||||
* 该方法允许改变响应数据的类型,创建一个新的响应对象。
|
* 该方法允许改变响应数据的类型,创建一个新的响应对象。
|
||||||
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
|
* 适用于需要在保持其他字段不变的情况下更新数据类型的场景。
|
||||||
*
|
*
|
||||||
* @param D 新的数据类型
|
* @param D 新的数据类型
|
||||||
* @param data 新的响应数据
|
* @param data 新的响应数据
|
||||||
* @return Response<D> 新的响应对象,数据类型为D
|
* @return Response<D> 新的响应对象,数据类型为D
|
||||||
*/
|
*/
|
||||||
fun <D> withData(data: D): Response<D> = Response(this.time, this.message, data, this.statusCode)
|
fun <D> withData(data: D): Response<D> = Response(this.time, this.message, data, this.statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的消息
|
* 创建一个新的Response对象,使用指定的消息
|
||||||
*
|
*
|
||||||
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
|
* 该方法用于创建具有新消息的响应对象,遵循不可变对象的设计模式。
|
||||||
* 如果消息相同,则返回原对象避免不必要的对象创建。
|
* 如果消息相同,则返回原对象避免不必要的对象创建。
|
||||||
*
|
*
|
||||||
* @param message 新的响应消息
|
* @param message 新的响应消息
|
||||||
* @return Response<T> 新的响应对象(如果消息相同则返回原对象)
|
* @return Response<T> 新的响应对象(如果消息相同则返回原对象)
|
||||||
*/
|
*/
|
||||||
fun withMessage(message: String): Response<T> =
|
fun withMessage(message: String): Response<T> =
|
||||||
if (this.message == message) this else Response(time, message, data, statusCode)
|
if (this.message == message) this else Response(time, message, data, statusCode)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 创建一个新的Response对象,使用指定的状态码
|
* 创建一个新的Response对象,使用指定的状态码
|
||||||
*
|
*
|
||||||
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
|
* 该方法用于创建具有新状态码的响应对象,遵循不可变对象的设计模式。
|
||||||
* 如果状态码相同,则返回原对象避免不必要的对象创建。
|
* 如果状态码相同,则返回原对象避免不必要的对象创建。
|
||||||
*
|
*
|
||||||
* @param statusCode 新的状态码
|
* @param statusCode 新的状态码
|
||||||
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
|
* @return Response<T> 新的响应对象(如果状态码相同则返回原对象)
|
||||||
*/
|
*/
|
||||||
fun withStatusCode(statusCode: Int): Response<T> =
|
fun withStatusCode(statusCode: Int): Response<T> =
|
||||||
if (this.statusCode == statusCode) this else Response(time, message, data, statusCode)
|
if (this.statusCode == statusCode) this else Response(time, message, data, statusCode)
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 返回响应对象的字符串表示
|
* 返回响应对象的字符串表示
|
||||||
*
|
*
|
||||||
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
|
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
|
||||||
* 显示时间、消息、数据类型和值以及状态码。
|
* 显示时间、消息、数据类型和值以及状态码。
|
||||||
*
|
*
|
||||||
* @return 格式化的字符串表示
|
* @return 格式化的字符串表示
|
||||||
*/
|
*/
|
||||||
override fun toString(): String =
|
override fun toString(): String =
|
||||||
"Response<${data?.javaClass?.simpleName ?: "Nothing"}>(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
|
"Response<${data?.javaClass?.simpleName ?: "Nothing"}>(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,45 +16,307 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile OkHttpUtils.kt
|
* CurrentFile OkHttpUtils.kt
|
||||||
* LastUpdate 2026-10-22 20:20:42
|
* LastUpdate 2026-11-09 19:18:03
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
@file:JvmName("OkHttpUtils")
|
@file:JvmName("OkHttpUtils")
|
||||||
|
|
||||||
package com.mingliqiye.utils.http.okhttp
|
package com.mingliqiye.utils.http.okhttp
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.http.MediaType
|
||||||
|
import com.mingliqiye.utils.http.okhttp
|
||||||
import com.mingliqiye.utils.json.api.JSONA
|
import com.mingliqiye.utils.json.api.JSONA
|
||||||
import com.mingliqiye.utils.json.api.base.JsonApi
|
import com.mingliqiye.utils.json.api.base.JsonApi
|
||||||
import com.mingliqiye.utils.json.api.base.JsonApi.Companion.parse
|
import com.mingliqiye.utils.json.api.base.JsonApi.Companion.parse
|
||||||
import okhttp3.Call
|
import okhttp3.*
|
||||||
import okhttp3.OkHttpClient
|
import okhttp3.HttpUrl.Companion.toHttpUrl
|
||||||
import okhttp3.Request
|
import okhttp3.RequestBody.Companion.toRequestBody
|
||||||
import okhttp3.Response
|
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 OkHttp 的 [Response] 响应体解析为指定泛型类型的对象。
|
||||||
|
*
|
||||||
|
* 会读取并关闭响应体。未显式传入 [jsonApi] 时使用 [JSONA.jsonApi]。
|
||||||
|
*
|
||||||
|
* @param T 目标对象类型,由调用方通过 reified 推断
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 解析后的对象实例
|
||||||
|
* @throws NullPointerException 未传入 [jsonApi] 且 [JSONA] 尚未注入实例时抛出
|
||||||
|
*/
|
||||||
inline fun <reified T> Response.json(jsonApi: JsonApi? = null): T = body.use {
|
inline fun <reified T> Response.json(jsonApi: JsonApi? = null): T = body.use {
|
||||||
if (jsonApi != null) {
|
(jsonApi ?: JSONA.jsonApi).parse<T>(it.bytes())
|
||||||
return jsonApi.parse<T>(it.bytes())
|
|
||||||
} else {
|
|
||||||
JSONA.parse<T>(it.bytes())
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
fun Response.text() = body.use {
|
/**
|
||||||
String(it.bytes())
|
* 读取 [Response] 响应体为字符串,并关闭响应体。
|
||||||
}
|
*
|
||||||
|
* 按响应 `Content-Type` 的 `charset` 解码,缺省 UTF-8;读取后响应体被关闭。
|
||||||
|
*
|
||||||
|
* @return 响应体内容字符串
|
||||||
|
*/
|
||||||
|
fun Response.text() = this.body.string()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 创建一个 [Request],通过 [calld] 配置 [Request.Builder]。
|
||||||
|
*
|
||||||
|
* @param calld 在 [Request.Builder] 上执行的配置块
|
||||||
|
* @return 构建完成的 [Request]
|
||||||
|
*/
|
||||||
|
fun newRequest(calld: Request.Builder.() -> Unit): Request =
|
||||||
|
Request.Builder().apply(calld).build()
|
||||||
|
|
||||||
fun newRequest(calld: Request.Builder.() -> Unit): Request {
|
/**
|
||||||
val request = Request.Builder()
|
* 使用当前 [OkHttpClient] 创建一个 [Call],请求通过 [calld] 配置。
|
||||||
calld(request)
|
*
|
||||||
return request.build()
|
* 调用返回的 [Call] 的 `execute()` 或 `enqueue()` 才会真正发起请求。
|
||||||
}
|
*
|
||||||
|
* @param calld 在 [Request.Builder] 上执行的配置块
|
||||||
|
* @return 未执行的 [Call]
|
||||||
|
*/
|
||||||
fun OkHttpClient.newCall(calld: Request.Builder.() -> Unit): Call {
|
fun OkHttpClient.newCall(calld: Request.Builder.() -> Unit): Call {
|
||||||
return this.newCall(newRequest(calld))
|
return this.newCall(newRequest(calld))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用当前 [OkHttpClient] 同步执行一次请求,请求通过 [calld] 配置。
|
||||||
|
*
|
||||||
|
* 注意:在 Android 主线程调用会抛出 `NetworkOnMainThreadException`。
|
||||||
|
*
|
||||||
|
* @param calld 在 [Request.Builder] 上执行的配置块
|
||||||
|
* @return 同步执行得到的 [Response]
|
||||||
|
* @throws java.io.IOException 网络或 I/O 失败时抛出
|
||||||
|
*/
|
||||||
fun OkHttpClient.newExecute(calld: Request.Builder.() -> Unit): Response {
|
fun OkHttpClient.newExecute(calld: Request.Builder.() -> Unit): Response {
|
||||||
return this.newCall(newRequest(calld)).execute()
|
return this.newCall(newRequest(calld)).execute()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 URL,并通过 [calld] 配置查询参数。
|
||||||
|
*
|
||||||
|
* 示例:
|
||||||
|
* ```
|
||||||
|
* Request.Builder().url("https://example.com/api") {
|
||||||
|
* addQueryParameter("page", "1")
|
||||||
|
* }
|
||||||
|
* ```
|
||||||
|
*
|
||||||
|
* @param url 基础 URL 字符串
|
||||||
|
* @param calld 可选的 [HttpUrl.Builder] 配置块(如添加查询参数);为 `null` 时直接使用 [url]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.url(
|
||||||
|
url: String,
|
||||||
|
calld: (HttpUrl.Builder.() -> Unit)? = null,
|
||||||
|
): Request.Builder {
|
||||||
|
return if (calld != null) {
|
||||||
|
this.url(url.toHttpUrl().newBuilder().apply { calld() }.build())
|
||||||
|
} else {
|
||||||
|
this.url(url.toHttpUrl())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置请求方法和字节数组请求体。
|
||||||
|
*
|
||||||
|
* @param method 请求方法
|
||||||
|
* @param body 请求体字节数组
|
||||||
|
* @param mediaType 可选的媒体类型;为 `null` 时不设置 Content-Type
|
||||||
|
* @param offset 起始偏移量,默认 0
|
||||||
|
* @param length 读取长度,默认从 [offset] 到 [body] 末尾
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.methodBody(
|
||||||
|
method: Method,
|
||||||
|
body: ByteArray,
|
||||||
|
mediaType: MediaType? = null,
|
||||||
|
offset: Int = 0,
|
||||||
|
length: Int = body.size - offset,
|
||||||
|
): Request.Builder {
|
||||||
|
require(offset >= 0 && length >= 0 && offset + length <= body.size) {
|
||||||
|
"offset/length 越界: offset=$offset, length=$length, size=${body.size}"
|
||||||
|
}
|
||||||
|
return method(method.name, body.toRequestBody(mediaType?.okhttp(), offset, length))
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置请求方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* @param method 请求方法
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.methodJsonBody(
|
||||||
|
method: Method,
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
): Request.Builder = methodBody(
|
||||||
|
method,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 GET 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* 注意:GET 请求携带请求体在 HTTP 语义中不常见,部分服务端可能忽略或拒绝。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.getJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.GET,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 POST 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.postJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.POST,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 PUT 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.putJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.PUT,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 DELETE 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.deleteJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.DELETE,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 HEAD 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* 注意:HEAD 请求通常不应携带请求体,部分服务端可能忽略或拒绝。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.headJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.HEAD,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 OPTIONS 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.optionsJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.OPTIONS,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 QUERY 方法,并将对象序列化为 JSON 作为请求体。
|
||||||
|
*
|
||||||
|
* QUERY 是 HTTP 扩展方法,需服务端支持。
|
||||||
|
*
|
||||||
|
* @param body 待序列化的对象
|
||||||
|
* @param jsonApi 可选的 [JsonApi] 实例;为 `null` 时使用 [JSONA.jsonApi]
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.queryJsonBody(
|
||||||
|
body: Any,
|
||||||
|
jsonApi: JsonApi? = null,
|
||||||
|
) = methodBody(
|
||||||
|
Method.QUERY,
|
||||||
|
(jsonApi ?: JSONA.jsonApi).formatBytes(body),
|
||||||
|
MediaType.APPLICATION_JSON,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* HTTP 请求方法枚举,供 [Request.Builder.methodBody] 等扩展使用。
|
||||||
|
*/
|
||||||
|
enum class Method {
|
||||||
|
/** GET 方法。 */
|
||||||
|
GET,
|
||||||
|
|
||||||
|
/** POST 方法。 */
|
||||||
|
POST,
|
||||||
|
|
||||||
|
/** PUT 方法。 */
|
||||||
|
PUT,
|
||||||
|
|
||||||
|
/** DELETE 方法。 */
|
||||||
|
DELETE,
|
||||||
|
|
||||||
|
/** HEAD 方法。 */
|
||||||
|
HEAD,
|
||||||
|
|
||||||
|
/** OPTIONS 方法。 */
|
||||||
|
OPTIONS,
|
||||||
|
|
||||||
|
/** QUERY 方法(HTTP 扩展方法,需服务端支持)。 */
|
||||||
|
QUERY,
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 POST 方法,使用空请求体。
|
||||||
|
*
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.post() = post(RequestBody.EMPTY)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 PUT 方法,使用空请求体。
|
||||||
|
*
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.put() = put(RequestBody.EMPTY)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在 [Request.Builder] 上设置 PATCH 方法,使用空请求体。
|
||||||
|
*
|
||||||
|
* @return 当前 [Request.Builder],便于链式调用
|
||||||
|
*/
|
||||||
|
fun Request.Builder.patch() = patch(RequestBody.EMPTY)
|
||||||
|
|||||||
@@ -28,16 +28,37 @@ import java.io.OutputStream
|
|||||||
import java.nio.charset.Charset
|
import java.nio.charset.Charset
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 读取输入流中的全部字节并按指定字符集解码为字符串。
|
||||||
|
*
|
||||||
|
* @param charset 字符编码,默认为 [Charsets.UTF_8]
|
||||||
|
* @return 解码后的字符串
|
||||||
|
*/
|
||||||
fun InputStream.readAllText(charset: Charset = Charsets.UTF_8) = this.readAllBytes().toString(charset)
|
fun InputStream.readAllText(charset: Charset = Charsets.UTF_8) = this.readAllBytes().toString(charset)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将输入流中的全部字节导出到指定输出流,并刷新输出流。
|
||||||
|
*
|
||||||
|
* @param out 目标输出流
|
||||||
|
*/
|
||||||
fun InputStream.exportBytes(out: OutputStream) {
|
fun InputStream.exportBytes(out: OutputStream) {
|
||||||
out.write(this.readAllBytes())
|
out.write(this.readAllBytes())
|
||||||
out.flush()
|
out.flush()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 读取输入流中的全部字节并转换为字节列表。
|
||||||
|
*
|
||||||
|
* @return 包含全部字节的列表
|
||||||
|
*/
|
||||||
fun InputStream.readToList(): List<Byte> = this.readBytes().toList()
|
fun InputStream.readToList(): List<Byte> = this.readBytes().toList()
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 读取输入流中的全部字节。
|
||||||
|
*
|
||||||
|
* @return 包含全部字节的字节数组
|
||||||
|
*/
|
||||||
@Suppress("EXTENSION_SHADOWED_BY_MEMBER")
|
@Suppress("EXTENSION_SHADOWED_BY_MEMBER")
|
||||||
@JvmName("readInputStreamAllBytes")
|
@JvmName("readInputStreamAllBytes")
|
||||||
fun InputStream.readAllBytes(): ByteArray = this.readBytes()
|
fun InputStream.readAllBytes(): ByteArray = this.readBytes()
|
||||||
|
|||||||
@@ -34,244 +34,258 @@ import java.io.PrintStream
|
|||||||
*/
|
*/
|
||||||
object SIO {
|
object SIO {
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 扩展函数:将字节数组以十六进制格式打印,每两个字符用空格分隔
|
* 扩展函数:将字节数组以十六进制格式打印,每两个字符用空格分隔
|
||||||
* @return 原始字节数组
|
* @return 原始字节数组
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun ByteArray.println(): ByteArray {
|
fun ByteArray.println(): ByteArray {
|
||||||
this.toHexString().chunked(2).println()
|
this.toHexString().chunked(2).println()
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
fun <T> T.ifOr(boolean: Boolean, pd: T.() -> T): T = if (boolean) {
|
/**
|
||||||
this
|
* 扩展函数:条件不满足时对当前对象执行给定变换函数
|
||||||
} else pd(this)
|
*
|
||||||
|
* @param boolean 条件值,为 true 时直接返回原对象
|
||||||
|
* @param pd 条件为 false 时执行的变换函数
|
||||||
|
* @return 原对象或变换后的对象
|
||||||
|
*/
|
||||||
|
fun <T> T.ifOr(boolean: Boolean, pd: T.() -> T): T = if (boolean) {
|
||||||
|
this
|
||||||
|
} else pd(this)
|
||||||
|
|
||||||
fun <T> T.ifOrElse(boolean: Boolean, pd: T.() -> T): T = if (!boolean) {
|
/**
|
||||||
this
|
* 扩展函数:条件满足时对当前对象执行给定变换函数
|
||||||
} else pd(this)
|
*
|
||||||
|
* @param boolean 条件值,为 false 时直接返回原对象
|
||||||
|
* @param pd 条件为 true 时执行的变换函数
|
||||||
|
* @return 原对象或变换后的对象
|
||||||
|
*/
|
||||||
|
fun <T> T.ifOrElse(boolean: Boolean, pd: T.() -> T): T = if (!boolean) {
|
||||||
|
this
|
||||||
|
} else pd(this)
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 扩展函数:将列表以花括号格式打印,元素间用逗号分隔
|
* 扩展函数:将列表以花括号格式打印,元素间用逗号分隔
|
||||||
* @return 原始列表
|
* @return 原始列表
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> List<T>.println(): List<T> {
|
fun <T> List<T>.println(): List<T> {
|
||||||
println("{" + ",".join(this) + "}")
|
println("{" + ",".join(this) + "}")
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 扩展函数:将数组以花括号格式打印,元素间用逗号分隔
|
* 扩展函数:将数组以花括号格式打印,元素间用逗号分隔
|
||||||
* @return 原始数组
|
* @return 原始数组
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> Array<T>.println(): Array<T> {
|
fun <T> Array<T>.println(): Array<T> {
|
||||||
println("{" + ",".join(this) + "}")
|
println("{" + ",".join(this) + "}")
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 扩展函数:打印任意对象并返回该对象
|
* 扩展函数:打印任意对象并返回该对象
|
||||||
* @return 原始对象
|
* @return 原始对象
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun <T> T.println(): T {
|
fun <T> T.println(): T {
|
||||||
println(this)
|
println(this)
|
||||||
return this
|
return this
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 原始标准输出流的备份
|
* 原始标准输出流的备份
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
val originalOut: PrintStream = System.out
|
val originalOut: PrintStream = System.out
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 原始错误输出流的备份
|
* 原始错误输出流的备份
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
val originalErr: PrintStream = System.err
|
val originalErr: PrintStream = System.err
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 用于记录标准输出的日志记录器
|
* 用于记录标准输出的日志记录器
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
val outLog: Logger = MingLiLoggerFactory.getLogger("out")
|
val outLog: Logger = MingLiLoggerFactory.getLogger("out")
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 用于记录错误输出的日志记录器
|
* 用于记录错误输出的日志记录器
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
val errLog: Logger = MingLiLoggerFactory.getLogger("err")
|
val errLog: Logger = MingLiLoggerFactory.getLogger("err")
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 打印多个参数,使用空格分隔
|
* 打印多个参数,使用空格分隔
|
||||||
* @param args 要打印的参数数组
|
* @param args 要打印的参数数组
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun print(vararg args: Any?) {
|
fun print(vararg args: Any?) {
|
||||||
printA(" ", *args)
|
printA(" ", *args)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 打印多个参数并换行,使用空格分隔
|
* 打印多个参数并换行,使用空格分隔
|
||||||
* @param args 要打印的参数数组
|
* @param args 要打印的参数数组
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun println(vararg args: Any?) {
|
fun println(vararg args: Any?) {
|
||||||
printlnA(" ", *args)
|
printlnA(" ", *args)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 打印多个参数并换行,指定分隔符
|
* 打印多个参数并换行,指定分隔符
|
||||||
* @param sp 分隔符
|
* @param sp 分隔符
|
||||||
* @param args 要打印的参数数组
|
* @param args 要打印的参数数组
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun printlnA(sp: String, vararg args: Any?) {
|
fun printlnA(sp: String, vararg args: Any?) {
|
||||||
printA(" ", *args)
|
printA(" ", *args)
|
||||||
kotlin.io.println()
|
kotlin.io.println()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 打印多个参数,指定分隔符
|
* 打印多个参数,指定分隔符
|
||||||
* @param sp 分隔符,默认为空字符串
|
* @param sp 分隔符,默认为空字符串
|
||||||
* @param args 要打印的参数数组
|
* @param args 要打印的参数数组
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun printA(sp: String = "", vararg args: Any?) {
|
fun printA(sp: String = "", vararg args: Any?) {
|
||||||
if (args.isEmpty()) {
|
if (args.isEmpty()) {
|
||||||
kotlin.io.println()
|
kotlin.io.println()
|
||||||
}
|
}
|
||||||
val sb = StringBuilder()
|
val sb = StringBuilder()
|
||||||
for (i in args.indices) {
|
for (i in args.indices) {
|
||||||
sb.append(args[i])
|
sb.append(args[i])
|
||||||
if (i < args.size - 1) sb.append(sp)
|
if (i < args.size - 1) sb.append(sp)
|
||||||
}
|
}
|
||||||
kotlin.io.print(sb)
|
kotlin.io.print(sb)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 重定向 System.out 到 INFO 级别日志
|
* 重定向 System.out 到 INFO 级别日志
|
||||||
* 创建自定义PrintStream,将输出内容缓冲并记录到INFO级别日志中
|
* 创建自定义PrintStream,将输出内容缓冲并记录到INFO级别日志中
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun redirectOutToInfo() {
|
fun redirectOutToInfo() {
|
||||||
val outLogger = PrintStream(object : OutputStream() {
|
val outLogger = PrintStream(object : OutputStream() {
|
||||||
private val buffer = StringBuilder()
|
private val buffer = StringBuilder()
|
||||||
|
|
||||||
override fun write(b: Int) {
|
override fun write(b: Int) {
|
||||||
if (b == '\n'.code) {
|
if (b == '\n'.code) {
|
||||||
flushBuffer()
|
flushBuffer()
|
||||||
} else {
|
} else {
|
||||||
buffer.append(b.toChar())
|
buffer.append(b.toChar())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun write(b: ByteArray, off: Int, len: Int) {
|
override fun write(b: ByteArray, off: Int, len: Int) {
|
||||||
val str = String(b, off, len)
|
val str = String(b, off, len)
|
||||||
if (str.contains("\n")) {
|
if (str.contains("\n")) {
|
||||||
val lines = str.split("\n")
|
val lines = str.split("\n")
|
||||||
lines.forEachIndexed { index, line ->
|
lines.forEachIndexed { index, line ->
|
||||||
if (index == lines.size - 1 && !str.endsWith("\n")) {
|
if (index == lines.size - 1 && !str.endsWith("\n")) {
|
||||||
buffer.append(line)
|
buffer.append(line)
|
||||||
} else {
|
} else {
|
||||||
buffer.append(line)
|
buffer.append(line)
|
||||||
flushBuffer()
|
flushBuffer()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
buffer.append(str)
|
buffer.append(str)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun flushBuffer() {
|
private fun flushBuffer() {
|
||||||
val message = buffer.toString().trim()
|
val message = buffer.toString().trim()
|
||||||
if (message.isNotBlank()) {
|
if (message.isNotBlank()) {
|
||||||
outLog.info(message)
|
outLog.info(message)
|
||||||
}
|
}
|
||||||
buffer.clear()
|
buffer.clear()
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun flush() {
|
override fun flush() {
|
||||||
flushBuffer()
|
flushBuffer()
|
||||||
super.flush()
|
super.flush()
|
||||||
}
|
}
|
||||||
}, true)
|
}, true)
|
||||||
|
|
||||||
System.setOut(outLogger)
|
System.setOut(outLogger)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 重定向 System.err 到 ERROR 级别
|
* 重定向 System.err 到 ERROR 级别
|
||||||
* 创建自定义PrintStream,将错误输出内容缓冲并记录到ERROR级别日志中
|
* 创建自定义PrintStream,将错误输出内容缓冲并记录到ERROR级别日志中
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun redirectErrToError() {
|
fun redirectErrToError() {
|
||||||
val errLogger = PrintStream(object : OutputStream() {
|
val errLogger = PrintStream(object : OutputStream() {
|
||||||
private val buffer = StringBuilder()
|
private val buffer = StringBuilder()
|
||||||
|
|
||||||
override fun write(b: Int) {
|
override fun write(b: Int) {
|
||||||
if (b == '\n'.code) {
|
if (b == '\n'.code) {
|
||||||
flushBuffer()
|
flushBuffer()
|
||||||
} else {
|
} else {
|
||||||
buffer.append(b.toChar())
|
buffer.append(b.toChar())
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun write(b: ByteArray, off: Int, len: Int) {
|
override fun write(b: ByteArray, off: Int, len: Int) {
|
||||||
val str = String(b, off, len)
|
val str = String(b, off, len)
|
||||||
if (str.contains("\n")) {
|
if (str.contains("\n")) {
|
||||||
val lines = str.split("\n")
|
val lines = str.split("\n")
|
||||||
lines.forEachIndexed { index, line ->
|
lines.forEachIndexed { index, line ->
|
||||||
if (index == lines.size - 1 && !str.endsWith("\n")) {
|
if (index == lines.size - 1 && !str.endsWith("\n")) {
|
||||||
buffer.append(line)
|
buffer.append(line)
|
||||||
} else {
|
} else {
|
||||||
buffer.append(line)
|
buffer.append(line)
|
||||||
flushBuffer()
|
flushBuffer()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
} else {
|
} else {
|
||||||
buffer.append(str)
|
buffer.append(str)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private fun flushBuffer() {
|
private fun flushBuffer() {
|
||||||
val message = buffer.toString().trim()
|
val message = buffer.toString().trim()
|
||||||
if (message.isNotBlank()) {
|
if (message.isNotBlank()) {
|
||||||
errLog.error(message)
|
errLog.error(message)
|
||||||
}
|
}
|
||||||
buffer.clear()
|
buffer.clear()
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun flush() {
|
override fun flush() {
|
||||||
flushBuffer()
|
flushBuffer()
|
||||||
super.flush()
|
super.flush()
|
||||||
}
|
}
|
||||||
}, true)
|
}, true)
|
||||||
|
|
||||||
System.setErr(errLogger)
|
System.setErr(errLogger)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 完全重定向(包括第三方库的输出)
|
* 完全重定向(包括第三方库的输出)
|
||||||
* 同时重定向标准输出和错误输出到对应的日志级别
|
* 同时重定向标准输出和错误输出到对应的日志级别
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun redirectAll() {
|
fun redirectAll() {
|
||||||
redirectOutToInfo()
|
redirectOutToInfo()
|
||||||
redirectErrToError()
|
redirectErrToError()
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 恢复原始输出流
|
* 恢复原始输出流
|
||||||
* 将System.out和System.err恢复到原始状态
|
* 将System.out和System.err恢复到原始状态
|
||||||
*/
|
*/
|
||||||
@JvmStatic
|
@JvmStatic
|
||||||
fun restore() {
|
fun restore() {
|
||||||
System.setOut(originalOut)
|
System.setOut(originalOut)
|
||||||
System.setErr(originalErr)
|
System.setErr(originalErr)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile FieldStructure.kt
|
* CurrentFile FieldStructure.kt
|
||||||
* LastUpdate 2026-07-02 10:22:42
|
* LastUpdate 2026-11-04 11:53:07
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -30,31 +30,31 @@ import java.lang.reflect.Modifier
|
|||||||
* 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段,
|
* 该类继承自JNA的Structure类,通过反射自动获取子类的公共非静态字段,
|
||||||
* 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。
|
* 并按声明顺序返回字段名列表,用于JNA结构体的字段映射。
|
||||||
*/
|
*/
|
||||||
open class FieldStructure : Structure() {
|
abstract class FieldStructure : Structure() {
|
||||||
/**
|
/**
|
||||||
* 获取结构体字段顺序列表
|
* 获取结构体字段顺序列表
|
||||||
* 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段,
|
* 通过反射遍历当前类及其父类的所有声明字段,过滤出公共非静态字段,
|
||||||
* 按照字段在类中声明的顺序返回字段名列表。
|
* 按照字段在类中声明的顺序返回字段名列表。
|
||||||
*
|
*
|
||||||
* @return 包含字段名的列表,按声明顺序排列
|
* @return 包含字段名的列表,按声明顺序排列
|
||||||
*/
|
*/
|
||||||
override fun getFieldOrder(): MutableList<String> {
|
override fun getFieldOrder(): MutableList<String> {
|
||||||
val fieldOrderList: MutableList<String> = ArrayList()
|
val fieldOrderList: MutableList<String> = ArrayList()
|
||||||
var cls: Class<*> = javaClass
|
var cls: Class<*> = javaClass
|
||||||
while (cls != FieldStructure::class.java) {
|
while (cls != FieldStructure::class.java) {
|
||||||
val fields = cls.getDeclaredFields()
|
val fields = cls.getDeclaredFields()
|
||||||
var modifiers: Int
|
var modifiers: Int
|
||||||
for (field in fields) {
|
for (field in fields) {
|
||||||
modifiers = field.modifiers
|
modifiers = field.modifiers
|
||||||
if (Modifier.isStatic(modifiers) ||
|
if (Modifier.isStatic(modifiers) ||
|
||||||
!Modifier.isPublic(modifiers)
|
!Modifier.isPublic(modifiers)
|
||||||
) {
|
) {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
fieldOrderList.add(field.name)
|
fieldOrderList.add(field.name)
|
||||||
}
|
}
|
||||||
cls = cls.getSuperclass()
|
cls = cls.getSuperclass()
|
||||||
}
|
}
|
||||||
return fieldOrderList
|
return fieldOrderList
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile Jackson3JsonApi.kt
|
* CurrentFile Jackson3JsonApi.kt
|
||||||
* LastUpdate 2026-10-12 13:59:59
|
* LastUpdate 2026-11-17 19:59:59
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -26,8 +26,6 @@ import com.mingliqiye.utils.exception.JsonException
|
|||||||
import com.mingliqiye.utils.json.api.JackSon3JsonItem.Companion.getJsonItem
|
import com.mingliqiye.utils.json.api.JackSon3JsonItem.Companion.getJsonItem
|
||||||
import com.mingliqiye.utils.json.api.base.JsonApi
|
import com.mingliqiye.utils.json.api.base.JsonApi
|
||||||
import com.mingliqiye.utils.json.api.type.JsonTypeReference
|
import com.mingliqiye.utils.json.api.type.JsonTypeReference
|
||||||
import com.mingliqiye.utils.json.converters.base.BaseJsonConverter
|
|
||||||
import com.mingliqiye.utils.json.converters.base.getJackson3Module
|
|
||||||
import com.mingliqiye.utils.json.objects.base.*
|
import com.mingliqiye.utils.json.objects.base.*
|
||||||
import tools.jackson.core.type.TypeReference
|
import tools.jackson.core.type.TypeReference
|
||||||
import tools.jackson.databind.JsonNode
|
import tools.jackson.databind.JsonNode
|
||||||
@@ -36,262 +34,336 @@ import tools.jackson.databind.node.JsonNodeType
|
|||||||
import tools.jackson.databind.node.ObjectNode
|
import tools.jackson.databind.node.ObjectNode
|
||||||
import java.lang.reflect.Type
|
import java.lang.reflect.Type
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson3的JSON处理实现类,提供JSON字符串解析、格式化、合并、节点操作等功能。
|
||||||
|
*
|
||||||
|
* 节点路径操作([getNodeValue]、[updateNodeValue])使用JSON Pointer风格路径(如"/user/name")。
|
||||||
|
* ObjectMapper支持直接持有,也支持通过get/set回调间接访问外部实例。
|
||||||
|
*/
|
||||||
class Jackson3JsonApi : JsonApi {
|
class Jackson3JsonApi : JsonApi {
|
||||||
|
|
||||||
var get: () -> ObjectMapper = { _prObjectMapper!! }
|
/**
|
||||||
var set: (ObjectMapper) -> Unit = { _prObjectMapper = it }
|
* ObjectMapper的获取回调,默认返回内部持有的实例
|
||||||
|
*/
|
||||||
|
var get: () -> ObjectMapper = { _prObjectMapper!! }
|
||||||
|
/**
|
||||||
|
* ObjectMapper的设置回调,默认写入内部持有的实例
|
||||||
|
*/
|
||||||
|
var set: (ObjectMapper) -> Unit = { _prObjectMapper = it }
|
||||||
|
|
||||||
private var _prObjectMapper: ObjectMapper? = null
|
private var _prObjectMapper: ObjectMapper? = null
|
||||||
|
|
||||||
|
|
||||||
var objectMapper: ObjectMapper
|
/**
|
||||||
get() = get()
|
* 当前使用的ObjectMapper实例,读写均通过[get]/[set]回调转发
|
||||||
private set(value) = set(value)
|
*/
|
||||||
|
var objectMapper: ObjectMapper
|
||||||
|
get() = get()
|
||||||
|
private set(value) = set(value)
|
||||||
|
|
||||||
constructor(objectMapper: ObjectMapper) {
|
/**
|
||||||
_prObjectMapper = objectMapper
|
* 使用指定的ObjectMapper构造实例
|
||||||
}
|
*
|
||||||
|
* @param objectMapper 自定义的ObjectMapper实例
|
||||||
|
*/
|
||||||
|
constructor(objectMapper: ObjectMapper) {
|
||||||
|
_prObjectMapper = objectMapper
|
||||||
|
}
|
||||||
|
|
||||||
constructor(
|
/**
|
||||||
get: () -> ObjectMapper,
|
* 使用获取/设置回调构造实例,ObjectMapper由外部管理
|
||||||
set: (ObjectMapper) -> Unit,
|
*
|
||||||
) {
|
* @param get ObjectMapper的获取回调
|
||||||
this.get = get
|
* @param set ObjectMapper的设置回调
|
||||||
this.set = set
|
*/
|
||||||
}
|
constructor(
|
||||||
|
get: () -> ObjectMapper,
|
||||||
|
set: (ObjectMapper) -> Unit,
|
||||||
|
) {
|
||||||
|
this.get = get
|
||||||
|
this.set = set
|
||||||
|
}
|
||||||
|
|
||||||
constructor() {
|
/**
|
||||||
_prObjectMapper = ObjectMapper()
|
* 使用默认的ObjectMapper构造实例
|
||||||
}
|
*/
|
||||||
|
constructor() {
|
||||||
|
_prObjectMapper = ObjectMapper()
|
||||||
|
}
|
||||||
|
|
||||||
override fun <T> parse(json: String, clazz: Class<T>): T {
|
override fun <T> parse(json: String, clazz: Class<T>): T {
|
||||||
try {
|
try {
|
||||||
return objectMapper.readValue(json, clazz)
|
return objectMapper.readValue(json, clazz)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to parse JSON to ${clazz.simpleName}", e)
|
throw JsonException("Failed to parse JSON to ${clazz.simpleName}", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
|
override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
|
||||||
try {
|
try {
|
||||||
return objectMapper.readValue(json, object : TypeReference<T>() {
|
return objectMapper.readValue(json, object : TypeReference<T>() {
|
||||||
override fun getType(): Type = type.type
|
override fun getType(): Type = type.type
|
||||||
})
|
})
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to parse JSON to type: $type", e)
|
throw JsonException("Failed to parse JSON to type: $type", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun format(obj: Any): String {
|
override fun format(obj: Any): String {
|
||||||
try {
|
try {
|
||||||
return objectMapper.writeValueAsString(obj)
|
return objectMapper.writeValueAsString(obj)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to format object to JSON: ${obj.javaClass.simpleName}", e)
|
throw JsonException("Failed to format object to JSON: ${obj.javaClass.simpleName}", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun formatPretty(obj: Any): String {
|
override fun formatPretty(obj: Any): String {
|
||||||
try {
|
try {
|
||||||
return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj)
|
return objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to format object to pretty JSON: ${obj.javaClass.simpleName}", e)
|
throw JsonException("Failed to format object to pretty JSON: ${obj.javaClass.simpleName}", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun isValidJson(json: String): Boolean {
|
override fun isValidJson(json: String): Boolean {
|
||||||
return try {
|
return try {
|
||||||
objectMapper.readTree(json)
|
objectMapper.readTree(json)
|
||||||
true
|
true
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
false
|
false
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun merge(vararg jsons: String): String {
|
/**
|
||||||
try {
|
* 合并多个JSON对象字符串;无参数时返回"{}",遇到非对象JSON时抛出JsonException
|
||||||
if (jsons.isEmpty()) return "{}"
|
*/
|
||||||
|
override fun merge(vararg jsons: String): String {
|
||||||
|
try {
|
||||||
|
if (jsons.isEmpty()) return "{}"
|
||||||
|
|
||||||
val resultNode = objectMapper.createObjectNode()
|
val resultNode = objectMapper.createObjectNode()
|
||||||
|
|
||||||
for (json in jsons) {
|
for (json in jsons) {
|
||||||
val node = objectMapper.readTree(json)
|
val node = objectMapper.readTree(json)
|
||||||
if (node is ObjectNode) {
|
if (node is ObjectNode) {
|
||||||
resultNode.setAll(node)
|
resultNode.setAll(node)
|
||||||
} else {
|
} else {
|
||||||
throw JsonException("Cannot merge non-object JSON: $json")
|
throw JsonException("Cannot merge non-object JSON: $json")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return objectMapper.writeValueAsString(resultNode)
|
return objectMapper.writeValueAsString(resultNode)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to merge JSON objects", e)
|
throw JsonException("Failed to merge JSON objects", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun getNodeValue(json: String, path: String): String? {
|
/**
|
||||||
try {
|
* 获取指定路径的节点值,路径为JSON Pointer风格(如"/user/name"),节点缺失或为null时返回null
|
||||||
val rootNode = objectMapper.readTree(json)
|
*/
|
||||||
val node = rootNode.at(path)
|
override fun getNodeValue(json: String, path: String): String? {
|
||||||
|
try {
|
||||||
|
val rootNode = objectMapper.readTree(json)
|
||||||
|
val node = rootNode.at(path)
|
||||||
|
|
||||||
return if (node.isMissingNode || node.isNull) {
|
return if (node.isMissingNode || node.isNull) {
|
||||||
null
|
null
|
||||||
} else {
|
} else {
|
||||||
node.asString()
|
node.asString()
|
||||||
}
|
}
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to get node value at path: $path", e)
|
throw JsonException("Failed to get node value at path: $path", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun updateNodeValue(json: String, path: String, newValue: Any): String {
|
/**
|
||||||
try {
|
* 更新指定路径的节点值,路径为JSON Pointer风格(如"/user/name"),空路径时替换整个根节点
|
||||||
val rootNode = objectMapper.readTree(json)
|
*/
|
||||||
|
override fun updateNodeValue(json: String, path: String, newValue: Any): String {
|
||||||
|
try {
|
||||||
|
val rootNode = objectMapper.readTree(json)
|
||||||
|
|
||||||
// 处理 JSON Pointer 路径
|
// 处理 JSON Pointer 路径
|
||||||
val pathParts = path.split("/").filter { it.isNotEmpty() }
|
val pathParts = path.split("/").filter { it.isNotEmpty() }
|
||||||
|
|
||||||
if (pathParts.isEmpty()) {
|
if (pathParts.isEmpty()) {
|
||||||
// 替换整个根节点
|
// 替换整个根节点
|
||||||
return objectMapper.writeValueAsString(newValue)
|
return objectMapper.writeValueAsString(newValue)
|
||||||
}
|
}
|
||||||
|
|
||||||
when (val parentNode = findParentNode(rootNode, pathParts)) {
|
when (val parentNode = findParentNode(rootNode, pathParts)) {
|
||||||
is ObjectNode -> {
|
is ObjectNode -> {
|
||||||
val fieldName = pathParts.last()
|
val fieldName = pathParts.last()
|
||||||
val valueNode = objectMapper.valueToTree<JsonNode>(newValue)
|
val valueNode = objectMapper.valueToTree<JsonNode>(newValue)
|
||||||
parentNode.replace(fieldName, valueNode)
|
parentNode.replace(fieldName, valueNode)
|
||||||
}
|
}
|
||||||
|
|
||||||
else -> {
|
else -> {
|
||||||
throw JsonException("Cannot update node: parent is not an object node at path: $path")
|
throw JsonException("Cannot update node: parent is not an object node at path: $path")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return objectMapper.writeValueAsString(rootNode)
|
return objectMapper.writeValueAsString(rootNode)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to update node value at path: $path", e)
|
throw JsonException("Failed to update node value at path: $path", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun <D> convert(source: Any, destinationClass: Class<D>): D {
|
override fun <D> convert(source: Any, destinationClass: Class<D>): D {
|
||||||
try {
|
try {
|
||||||
return objectMapper.convertValue(source, destinationClass)
|
return objectMapper.convertValue(source, destinationClass)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException(
|
throw JsonException(
|
||||||
"Failed to convert from ${source.javaClass.simpleName} to ${destinationClass.simpleName}", e
|
"Failed to convert from ${source.javaClass.simpleName} to ${destinationClass.simpleName}", e
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun <D> convert(
|
override fun <D> convert(
|
||||||
source: Any,
|
source: Any,
|
||||||
destinationType: JsonTypeReference<D>,
|
destinationType: JsonTypeReference<D>,
|
||||||
): D {
|
): D {
|
||||||
try {
|
try {
|
||||||
return objectMapper.convertValue(source, object : TypeReference<D>() {
|
return objectMapper.convertValue(source, object : TypeReference<D>() {
|
||||||
override fun getType(): Type = destinationType.type
|
override fun getType(): Type = destinationType.type
|
||||||
})
|
})
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to convert from ${source.javaClass.simpleName} to type: $destinationType", e)
|
throw JsonException("Failed to convert from ${source.javaClass.simpleName} to type: $destinationType", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
// 辅助方法:查找父节点
|
// 辅助方法:查找父节点
|
||||||
private fun findParentNode(root: JsonNode, pathParts: List<String>): JsonNode {
|
private fun findParentNode(root: JsonNode, pathParts: List<String>): JsonNode {
|
||||||
var current: JsonNode = root
|
var current: JsonNode = root
|
||||||
|
|
||||||
// 遍历到最后一个元素之前(即找到父节点)
|
// 遍历到最后一个元素之前(即找到父节点)
|
||||||
for (i in 0 until pathParts.size - 1) {
|
for (i in 0 until pathParts.size - 1) {
|
||||||
val part = pathParts[i]
|
val part = pathParts[i]
|
||||||
current = when {
|
current = when {
|
||||||
part.matches(Regex("\\d+")) -> current.get(part.toInt())
|
part.matches(Regex("\\d+")) -> current.get(part.toInt())
|
||||||
else -> current.get(part)
|
else -> current.get(part)
|
||||||
} ?: throw JsonException("Path not found: ${pathParts.subList(0, i + 1).joinToString("/")}")
|
} ?: throw JsonException("Path not found: ${pathParts.subList(0, i + 1).joinToString("/")}")
|
||||||
}
|
}
|
||||||
|
|
||||||
return current
|
return current
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun addJsonConverter(c: BaseJsonConverter<*, *>) {
|
|
||||||
val mapperBuilder = Jackson3ApiJavaHelper.rebuild(objectMapper)
|
|
||||||
mapperBuilder.addModule(c.getJackson3Module())
|
|
||||||
this.objectMapper = mapperBuilder.build()
|
|
||||||
}
|
|
||||||
|
|
||||||
override fun parseJsonItem(json: String): JsonItem {
|
/**
|
||||||
try {
|
* 将JSON字符串解析为JsonItem对象,解析失败时包装为JsonException抛出
|
||||||
return getJsonItem(objectMapper.readTree(json))
|
*/
|
||||||
} catch (e: Exception) {
|
override fun parseJsonItem(json: String): JsonItem {
|
||||||
throw JsonException("Failed to parseJsonItem", e)
|
try {
|
||||||
}
|
return getJsonItem(objectMapper.readTree(json))
|
||||||
}
|
} catch (e: Exception) {
|
||||||
|
throw JsonException("Failed to parseJsonItem", e)
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson3的JsonItem标记实现类,通过伴生对象工厂方法创建具体的JsonItem
|
||||||
|
*/
|
||||||
class JackSon3JsonItem : JsonItem {
|
class JackSon3JsonItem : JsonItem {
|
||||||
companion object {
|
/**
|
||||||
fun getJsonItem(node: JsonNode): JsonItem {
|
* 伴生对象,提供JsonNode到JsonItem的工厂方法
|
||||||
return when (node.nodeType) {
|
*/
|
||||||
JsonNodeType.OBJECT -> JackSon3JsonObject(node)
|
companion object {
|
||||||
JsonNodeType.ARRAY -> JackSon3JsonArray(node)
|
/**
|
||||||
JsonNodeType.BOOLEAN -> JackSon3JsonBoolean(node)
|
* 根据JsonNode的节点类型创建对应的JsonItem实例
|
||||||
JsonNodeType.NULL -> JsonNull()
|
*
|
||||||
JsonNodeType.NUMBER -> JackSon3JsonNumber(node)
|
* @param node Jackson3的JsonNode节点
|
||||||
JsonNodeType.STRING -> JackSon3JsonString(node)
|
* @return 与节点类型对应的JsonItem实例
|
||||||
else -> throw IllegalStateException("unknown type ${node.nodeType}")
|
* @throws IllegalStateException 当节点类型未知时抛出
|
||||||
}
|
*/
|
||||||
}
|
fun getJsonItem(node: JsonNode): JsonItem {
|
||||||
}
|
return when (node.nodeType) {
|
||||||
|
JsonNodeType.OBJECT -> JackSon3JsonObject(node)
|
||||||
|
JsonNodeType.ARRAY -> JackSon3JsonArray(node)
|
||||||
|
JsonNodeType.BOOLEAN -> JackSon3JsonBoolean(node)
|
||||||
|
JsonNodeType.NULL -> JsonNull()
|
||||||
|
JsonNodeType.NUMBER -> JackSon3JsonNumber(node)
|
||||||
|
JsonNodeType.STRING -> JackSon3JsonString(node)
|
||||||
|
else -> throw IllegalStateException("unknown type ${node.nodeType}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson3节点的JSON数字类型
|
||||||
|
*
|
||||||
|
* @param node 数字类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSon3JsonNumber(node: JsonNode) : JsonNumber(node.asString())
|
class JackSon3JsonNumber(node: JsonNode) : JsonNumber(node.asString())
|
||||||
|
/**
|
||||||
|
* 基于Jackson3节点的JSON布尔类型
|
||||||
|
*
|
||||||
|
* @param node 布尔类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSon3JsonBoolean(node: JsonNode) : JsonBoolean(node.asBoolean())
|
class JackSon3JsonBoolean(node: JsonNode) : JsonBoolean(node.asBoolean())
|
||||||
|
/**
|
||||||
|
* 基于Jackson3节点的JSON字符串类型
|
||||||
|
*
|
||||||
|
* @param node 字符串类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSon3JsonString(node: JsonNode) : JsonString(node.asString())
|
class JackSon3JsonString(node: JsonNode) : JsonString(node.asString())
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson3节点的JSON数组类型
|
||||||
|
*
|
||||||
|
* @property node 数组类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSon3JsonArray(val node: JsonNode) : JsonArray() {
|
class JackSon3JsonArray(val node: JsonNode) : JsonArray() {
|
||||||
override fun getIndex(index: Int): JsonItem {
|
override fun getIndex(index: Int): JsonItem {
|
||||||
return JackSon3JsonItem.getJsonItem(node.get(index))
|
return JackSon3JsonItem.getJsonItem(node.get(index))
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> {
|
override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> {
|
||||||
val iteet = node.iterator().withIndex()
|
val iteet = node.iterator().withIndex()
|
||||||
return object : Iterator<IndexedValue<JsonItem>> {
|
return object : Iterator<IndexedValue<JsonItem>> {
|
||||||
override fun next(): IndexedValue<JsonItem> {
|
override fun next(): IndexedValue<JsonItem> {
|
||||||
val it = iteet.next()
|
val it = iteet.next()
|
||||||
return IndexedValue(it.index, JackSon3JsonItem.getJsonItem(it.value))
|
return IndexedValue(it.index, JackSon3JsonItem.getJsonItem(it.value))
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun hasNext(): Boolean {
|
override fun hasNext(): Boolean {
|
||||||
return iteet.hasNext()
|
return iteet.hasNext()
|
||||||
}
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson3节点的JSON对象类型
|
||||||
|
*
|
||||||
|
* @property node 对象类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSon3JsonObject(val node: JsonNode) : JsonObject() {
|
class JackSon3JsonObject(val node: JsonNode) : JsonObject() {
|
||||||
override fun getField(name: String): JsonItem {
|
override fun getField(name: String): JsonItem {
|
||||||
return JackSon3JsonItem.getJsonItem(node.get(name))
|
return JackSon3JsonItem.getJsonItem(node.get(name))
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> {
|
override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> {
|
||||||
return object : Iterator<Map.Entry<String, JsonItem>> {
|
return object : Iterator<Map.Entry<String, JsonItem>> {
|
||||||
val it = node.properties().iterator()
|
val it = node.properties().iterator()
|
||||||
override fun next(): Map.Entry<String, JsonItem> {
|
override fun next(): Map.Entry<String, JsonItem> {
|
||||||
val utem = it.next()
|
val utem = it.next()
|
||||||
return object : Map.Entry<String, JsonItem> {
|
return object : Map.Entry<String, JsonItem> {
|
||||||
override val key: String
|
override val key: String
|
||||||
get() = utem.key
|
get() = utem.key
|
||||||
override val value: JsonItem
|
override val value: JsonItem
|
||||||
get() = JackSon3JsonItem.getJsonItem(utem.value)
|
get() = JackSon3JsonItem.getJsonItem(utem.value)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun hasNext(): Boolean {
|
override fun hasNext(): Boolean {
|
||||||
return it.hasNext()
|
return it.hasNext()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile JacksonJsonApi.kt
|
* CurrentFile JacksonJsonApi.kt
|
||||||
* LastUpdate 2026-10-12 10:48:31
|
* LastUpdate 2026-11-17 19:59:59
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -33,8 +33,6 @@ import com.mingliqiye.utils.exception.JsonException
|
|||||||
import com.mingliqiye.utils.json.api.JackSonJsonItem.Companion.getJsonItem
|
import com.mingliqiye.utils.json.api.JackSonJsonItem.Companion.getJsonItem
|
||||||
import com.mingliqiye.utils.json.api.base.JsonApi
|
import com.mingliqiye.utils.json.api.base.JsonApi
|
||||||
import com.mingliqiye.utils.json.api.type.JsonTypeReference
|
import com.mingliqiye.utils.json.api.type.JsonTypeReference
|
||||||
import com.mingliqiye.utils.json.converters.base.BaseJsonConverter
|
|
||||||
import com.mingliqiye.utils.json.converters.base.getJacksonModule
|
|
||||||
import com.mingliqiye.utils.json.objects.base.*
|
import com.mingliqiye.utils.json.objects.base.*
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -42,333 +40,385 @@ import com.mingliqiye.utils.json.objects.base.*
|
|||||||
*/
|
*/
|
||||||
class JacksonJsonApi : JsonApi {
|
class JacksonJsonApi : JsonApi {
|
||||||
|
|
||||||
private val objectMapper: ObjectMapper
|
private val objectMapper: ObjectMapper
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用默认的ObjectMapper构造实例
|
* 使用默认的ObjectMapper构造实例
|
||||||
*/
|
*/
|
||||||
constructor() {
|
constructor() {
|
||||||
this.objectMapper = ObjectMapper()
|
this.objectMapper = ObjectMapper()
|
||||||
}
|
}
|
||||||
|
|
||||||
fun getObjectMapper() = objectMapper
|
/**
|
||||||
|
* 获取内部使用的ObjectMapper实例
|
||||||
|
*
|
||||||
|
* @return 当前的ObjectMapper实例
|
||||||
|
*/
|
||||||
|
fun getObjectMapper() = objectMapper
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 使用指定的ObjectMapper构造实例
|
* 使用指定的ObjectMapper构造实例
|
||||||
*
|
*
|
||||||
* @param objectMapper 自定义的ObjectMapper实例
|
* @param objectMapper 自定义的ObjectMapper实例
|
||||||
*/
|
*/
|
||||||
constructor(objectMapper: ObjectMapper) {
|
constructor(objectMapper: ObjectMapper) {
|
||||||
this.objectMapper = objectMapper
|
this.objectMapper = objectMapper
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将JSON字符串解析为指定类型的对象
|
* 将JSON字符串解析为指定类型的对象
|
||||||
*
|
*
|
||||||
* @param json 待解析的JSON字符串
|
* @param json 待解析的JSON字符串
|
||||||
* @param clazz 目标对象类型
|
* @param clazz 目标对象类型
|
||||||
* @param <T> 泛型参数,表示目标对象类型
|
* @param <T> 泛型参数,表示目标对象类型
|
||||||
* @return 解析后的对象
|
* @return 解析后的对象
|
||||||
* @throws JsonException 当解析失败时抛出异常
|
* @throws JsonException 当解析失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun <T> parse(json: String, clazz: Class<T>): T {
|
override fun <T> parse(json: String, clazz: Class<T>): T {
|
||||||
return try {
|
return try {
|
||||||
objectMapper.readValue(json, clazz)
|
objectMapper.readValue(json, clazz)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to parse JSON string", e)
|
throw JsonException("Failed to parse JSON string", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将JSON字符串解析为复杂泛型结构的对象(如List、Map等)
|
* 将JSON字符串解析为复杂泛型结构的对象(如List、Map等)
|
||||||
*
|
*
|
||||||
* @param json JSON字符串
|
* @param json JSON字符串
|
||||||
* @param type 泛型类型引用
|
* @param type 泛型类型引用
|
||||||
* @param <T> 泛型参数,表示目标对象类型
|
* @param <T> 泛型参数,表示目标对象类型
|
||||||
* @return 解析后的对象
|
* @return 解析后的对象
|
||||||
* @throws JsonException 当解析失败时抛出异常
|
* @throws JsonException 当解析失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
|
override fun <T> parse(json: String, type: JsonTypeReference<T>): T {
|
||||||
return try {
|
return try {
|
||||||
val reader: ObjectReader = objectMapper.readerFor(
|
val reader: ObjectReader = objectMapper.readerFor(
|
||||||
objectMapper.constructType(type.type)
|
objectMapper.constructType(type.type)
|
||||||
)
|
)
|
||||||
reader.readValue(json)
|
reader.readValue(json)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to parse JSON string", e)
|
throw JsonException("Failed to parse JSON string", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将对象格式化为JSON字符串
|
* 将对象格式化为JSON字符串
|
||||||
*
|
*
|
||||||
* @return 格式化后的JSON字符串
|
* @return 格式化后的JSON字符串
|
||||||
* @throws JsonException 当格式化失败时抛出异常
|
* @throws JsonException 当格式化失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun format(obj: Any): String {
|
override fun format(obj: Any): String {
|
||||||
return try {
|
return try {
|
||||||
objectMapper.writeValueAsString(obj)
|
objectMapper.writeValueAsString(obj)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException(
|
throw JsonException(
|
||||||
"Failed to format object to JSON string", e
|
"Failed to format object to JSON string", e
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fun formatUnicode(obj: Any): String {
|
/**
|
||||||
return try {
|
* 将对象格式化为JSON字符串,非ASCII字符以Unicode转义形式输出
|
||||||
objectMapper.writer().with(JsonGenerator.Feature.ESCAPE_NON_ASCII).writeValueAsString(obj)
|
*
|
||||||
} catch (e: Exception) {
|
* @param obj 待格式化的对象
|
||||||
throw JsonException(throwable = e)
|
* @return 格式化后的JSON字符串
|
||||||
}
|
* @throws JsonException 当格式化失败时抛出异常
|
||||||
}
|
*/
|
||||||
|
fun formatUnicode(obj: Any): String {
|
||||||
|
return try {
|
||||||
|
objectMapper.writer().with(JsonGenerator.Feature.ESCAPE_NON_ASCII).writeValueAsString(obj)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
throw JsonException(throwable = e)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将对象格式化为美化(带缩进)的JSON字符串
|
* 将对象格式化为美化(带缩进)的JSON字符串
|
||||||
*
|
*
|
||||||
* @return 美化后的JSON字符串
|
* @return 美化后的JSON字符串
|
||||||
* @throws JsonException 当格式化失败时抛出异常
|
* @throws JsonException 当格式化失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun formatPretty(obj: Any): String {
|
override fun formatPretty(obj: Any): String {
|
||||||
return try {
|
return try {
|
||||||
objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj)
|
objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(obj)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException(
|
throw JsonException(
|
||||||
"Failed to format object to pretty JSON string", e
|
"Failed to format object to pretty JSON string", e
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
fun formatPrettyUnicode(obj: Any): String {
|
/**
|
||||||
return try {
|
* 将对象格式化为美化(带缩进)的JSON字符串,非ASCII字符以Unicode转义形式输出
|
||||||
objectMapper.writerWithDefaultPrettyPrinter().with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
|
*
|
||||||
.writeValueAsString(obj)
|
* @param obj 待格式化的对象
|
||||||
} catch (e: Exception) {
|
* @return 美化后的JSON字符串
|
||||||
throw JsonException(
|
* @throws JsonException 当格式化失败时抛出异常
|
||||||
"Failed to format object to pretty JSON string", e
|
*/
|
||||||
)
|
fun formatPrettyUnicode(obj: Any): String {
|
||||||
}
|
return try {
|
||||||
}
|
objectMapper.writerWithDefaultPrettyPrinter().with(JsonGenerator.Feature.ESCAPE_NON_ASCII)
|
||||||
|
.writeValueAsString(obj)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
throw JsonException(
|
||||||
|
"Failed to format object to pretty JSON string", e
|
||||||
|
)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 判断给定字符串是否是有效的JSON格式
|
* 判断给定字符串是否是有效的JSON格式
|
||||||
*
|
*
|
||||||
* @param json 待验证的字符串
|
* @param json 待验证的字符串
|
||||||
* @return 如果是有效JSON返回true,否则返回false
|
* @return 如果是有效JSON返回true,否则返回false
|
||||||
*/
|
*/
|
||||||
override fun isValidJson(json: String): Boolean {
|
override fun isValidJson(json: String): Boolean {
|
||||||
return try {
|
return try {
|
||||||
objectMapper.readTree(json)
|
objectMapper.readTree(json)
|
||||||
true
|
true
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
false
|
false
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 合并多个JSON字符串为一个JSON对象
|
* 合并多个JSON字符串为一个JSON对象
|
||||||
*
|
*
|
||||||
* @param jsons 多个JSON字符串
|
* @param jsons 多个JSON字符串
|
||||||
* @return 合并后的JSON字符串
|
* @return 合并后的JSON字符串
|
||||||
* @throws JsonException 当合并失败时抛出异常
|
* @throws JsonException 当合并失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun merge(vararg jsons: String): String {
|
override fun merge(vararg jsons: String): String {
|
||||||
val result: ObjectNode = objectMapper.createObjectNode()
|
val result: ObjectNode = objectMapper.createObjectNode()
|
||||||
for (json in jsons) {
|
for (json in jsons) {
|
||||||
try {
|
try {
|
||||||
val node: JsonNode = objectMapper.readTree(json)
|
val node: JsonNode = objectMapper.readTree(json)
|
||||||
if (node.isObject) {
|
if (node.isObject) {
|
||||||
result.setAll<JsonNode>(node as ObjectNode)
|
result.setAll<JsonNode>(node as ObjectNode)
|
||||||
}
|
}
|
||||||
} catch (_: Exception) {
|
} catch (_: Exception) {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
return try {
|
return try {
|
||||||
objectMapper.writeValueAsString(result)
|
objectMapper.writeValueAsString(result)
|
||||||
} catch (e: JsonProcessingException) {
|
} catch (e: JsonProcessingException) {
|
||||||
throw JsonException("Failed to merge JSON strings", e)
|
throw JsonException("Failed to merge JSON strings", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 获取JSON字符串中指定路径的节点值
|
* 获取JSON字符串中指定路径的节点值
|
||||||
*
|
*
|
||||||
* @param json JSON字符串
|
* @param json JSON字符串
|
||||||
* @param path 节点路径,使用"."分隔
|
* @param path 节点路径,使用"."分隔
|
||||||
* @return 节点值的文本表示,如果路径不存在则返回null
|
* @return 节点值的文本表示,如果路径不存在则返回null
|
||||||
* @throws JsonException 当获取节点值失败时抛出异常
|
* @throws JsonException 当获取节点值失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun getNodeValue(json: String, path: String): String? {
|
override fun getNodeValue(json: String, path: String): String? {
|
||||||
return try {
|
return try {
|
||||||
var node: JsonNode = objectMapper.readTree(json)
|
var node: JsonNode = objectMapper.readTree(json)
|
||||||
val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
|
val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
|
||||||
for (p in paths) {
|
for (p in paths) {
|
||||||
node = node.get(p)
|
node = node.get(p)
|
||||||
}
|
}
|
||||||
node.asText()
|
node.asText()
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to get node value", e)
|
throw JsonException("Failed to get node value", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 更新JSON字符串中指定路径的节点值
|
* 更新JSON字符串中指定路径的节点值
|
||||||
*
|
*
|
||||||
* @param json JSON字符串
|
* @param json JSON字符串
|
||||||
* @param path 节点路径,使用"."分隔
|
* @param path 节点路径,使用"."分隔
|
||||||
* @param newValue 新的节点值
|
* @param newValue 新的节点值
|
||||||
* @return 更新后的JSON字符串
|
* @return 更新后的JSON字符串
|
||||||
* @throws JsonException 当更新节点值失败时抛出异常
|
* @throws JsonException 当更新节点值失败时抛出异常
|
||||||
*/
|
*/
|
||||||
override fun updateNodeValue(json: String, path: String, newValue: Any): String {
|
override fun updateNodeValue(json: String, path: String, newValue: Any): String {
|
||||||
return try {
|
return try {
|
||||||
val node: JsonNode = objectMapper.readTree(json)
|
val node: JsonNode = objectMapper.readTree(json)
|
||||||
if (node is ObjectNode) {
|
if (node is ObjectNode) {
|
||||||
val objectNode: ObjectNode = node
|
val objectNode: ObjectNode = node
|
||||||
val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
|
val paths: Array<String> = path.split("\\.".toRegex()).toTypedArray()
|
||||||
var current: JsonNode = objectNode
|
var current: JsonNode = objectNode
|
||||||
|
|
||||||
// 导航到目标节点的父节点
|
// 导航到目标节点的父节点
|
||||||
for (i in 0 until paths.size - 1) {
|
for (i in 0 until paths.size - 1) {
|
||||||
current = current.get(paths[i])
|
current = current.get(paths[i])
|
||||||
if (current !is ObjectNode) {
|
if (current !is ObjectNode) {
|
||||||
return json // 路径不存在或无效
|
return json // 路径不存在或无效
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// 更新值
|
// 更新值
|
||||||
if (current is ObjectNode) {
|
if (current is ObjectNode) {
|
||||||
val parent: ObjectNode = current
|
val parent: ObjectNode = current
|
||||||
parent.set<JsonNode>(
|
parent.set<JsonNode>(
|
||||||
paths[paths.size - 1], objectMapper.valueToTree(newValue)
|
paths[paths.size - 1], objectMapper.valueToTree(newValue)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
objectMapper.writeValueAsString(objectNode)
|
objectMapper.writeValueAsString(objectNode)
|
||||||
}
|
}
|
||||||
json
|
json
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to update node value", e)
|
throw JsonException("Failed to update node value", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 在不同对象类型之间进行转换
|
* 在不同对象类型之间进行转换
|
||||||
*
|
*
|
||||||
* @param source 源对象
|
* @param source 源对象
|
||||||
* @param destinationClass 目标对象类型
|
* @param destinationClass 目标对象类型
|
||||||
* @param <T> 源对象类型
|
* @param <T> 源对象类型
|
||||||
* @param <D> 目标对象类型
|
* @param <D> 目标对象类型
|
||||||
* @return 转换后的对象
|
* @return 转换后的对象
|
||||||
*/
|
*/
|
||||||
override fun <D> convert(source: Any, destinationClass: Class<D>): D {
|
override fun <D> convert(source: Any, destinationClass: Class<D>): D {
|
||||||
try {
|
try {
|
||||||
return objectMapper.convertValue(source, destinationClass)
|
return objectMapper.convertValue(source, destinationClass)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to update node value", e)
|
throw JsonException("Failed to update node value", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 在不同泛型对象类型之间进行转换
|
* 在不同泛型对象类型之间进行转换
|
||||||
*
|
*
|
||||||
* @param source 源对象
|
* @param source 源对象
|
||||||
* @param destinationType 目标对象的泛型类型引用
|
* @param destinationType 目标对象的泛型类型引用
|
||||||
* @param <T> 源对象类型
|
* @param <T> 源对象类型
|
||||||
* @param <D> 目标对象类型
|
* @param <D> 目标对象类型
|
||||||
* @return 转换后的对象
|
* @return 转换后的对象
|
||||||
*/
|
*/
|
||||||
override fun <D> convert(source: Any, destinationType: JsonTypeReference<D>): D {
|
override fun <D> convert(source: Any, destinationType: JsonTypeReference<D>): D {
|
||||||
try {
|
try {
|
||||||
return objectMapper.convertValue(
|
return objectMapper.convertValue(
|
||||||
source, objectMapper.constructType(destinationType.type)
|
source, objectMapper.constructType(destinationType.type)
|
||||||
)
|
)
|
||||||
} catch (e: Exception) {
|
} catch (e: Exception) {
|
||||||
throw JsonException("Failed to update node value", e)
|
throw JsonException("Failed to update node value", e)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun addJsonConverter(c: BaseJsonConverter<*, *>) {
|
/**
|
||||||
try {
|
* 将JSON字符串解析为JsonItem对象,解析失败时包装为JsonException抛出
|
||||||
objectMapper.registerModule(c.getJacksonModule())
|
*/
|
||||||
} catch (e: Exception) {
|
override fun parseJsonItem(json: String): JsonItem {
|
||||||
throw JsonException("Failed to update node value", e)
|
try {
|
||||||
}
|
return getJsonItem(objectMapper.readTree(json))
|
||||||
}
|
} catch (e: Exception) {
|
||||||
|
throw JsonException("Failed to parseJsonItem", e)
|
||||||
override fun parseJsonItem(json: String): JsonItem {
|
}
|
||||||
try {
|
}
|
||||||
return getJsonItem(objectMapper.readTree(json))
|
|
||||||
} catch (e: Exception) {
|
|
||||||
throw JsonException("Failed to parseJsonItem", e)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson2的JsonItem标记实现类,通过伴生对象工厂方法创建具体的JsonItem
|
||||||
|
*/
|
||||||
class JackSonJsonItem : JsonItem {
|
class JackSonJsonItem : JsonItem {
|
||||||
companion object {
|
/**
|
||||||
fun getJsonItem(node: JsonNode): JsonItem {
|
* 伴生对象,提供JsonNode到JsonItem的工厂方法
|
||||||
return when (node.nodeType) {
|
*/
|
||||||
JsonNodeType.OBJECT -> JackSonJsonObject(node)
|
companion object {
|
||||||
JsonNodeType.ARRAY -> JackSonJsonArray(node)
|
/**
|
||||||
JsonNodeType.BOOLEAN -> JackSonJsonBoolean(node)
|
* 根据JsonNode的节点类型创建对应的JsonItem实例
|
||||||
JsonNodeType.NULL -> JsonNull()
|
*
|
||||||
JsonNodeType.NUMBER -> JackSonJsonNumber(node)
|
* @param node Jackson2的JsonNode节点
|
||||||
JsonNodeType.STRING -> JackSonJsonString(node)
|
* @return 与节点类型对应的JsonItem实例
|
||||||
else -> throw IllegalStateException("unknown type ${node.nodeType}")
|
* @throws IllegalStateException 当节点类型未知时抛出
|
||||||
}
|
*/
|
||||||
}
|
fun getJsonItem(node: JsonNode): JsonItem {
|
||||||
}
|
return when (node.nodeType) {
|
||||||
|
JsonNodeType.OBJECT -> JackSonJsonObject(node)
|
||||||
|
JsonNodeType.ARRAY -> JackSonJsonArray(node)
|
||||||
|
JsonNodeType.BOOLEAN -> JackSonJsonBoolean(node)
|
||||||
|
JsonNodeType.NULL -> JsonNull()
|
||||||
|
JsonNodeType.NUMBER -> JackSonJsonNumber(node)
|
||||||
|
JsonNodeType.STRING -> JackSonJsonString(node)
|
||||||
|
else -> throw IllegalStateException("unknown type ${node.nodeType}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson2节点的JSON数字类型
|
||||||
|
*
|
||||||
|
* @param node 数字类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSonJsonNumber(node: JsonNode) : JsonNumber(node.asText())
|
class JackSonJsonNumber(node: JsonNode) : JsonNumber(node.asText())
|
||||||
|
/**
|
||||||
|
* 基于Jackson2节点的JSON布尔类型
|
||||||
|
*
|
||||||
|
* @param node 布尔类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSonJsonBoolean(node: JsonNode) : JsonBoolean(node.asBoolean())
|
class JackSonJsonBoolean(node: JsonNode) : JsonBoolean(node.asBoolean())
|
||||||
|
/**
|
||||||
|
* 基于Jackson2节点的JSON字符串类型
|
||||||
|
*
|
||||||
|
* @param node 字符串类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSonJsonString(node: JsonNode) : JsonString(node.asText())
|
class JackSonJsonString(node: JsonNode) : JsonString(node.asText())
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson2节点的JSON数组类型
|
||||||
|
*
|
||||||
|
* @property node 数组类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSonJsonArray(val node: JsonNode) : JsonArray() {
|
class JackSonJsonArray(val node: JsonNode) : JsonArray() {
|
||||||
override fun getIndex(index: Int): JsonItem {
|
override fun getIndex(index: Int): JsonItem {
|
||||||
return getJsonItem(node.get(index))
|
return getJsonItem(node.get(index))
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> {
|
override fun iteratorArray(): Iterator<IndexedValue<JsonItem>> {
|
||||||
val iteet = node.iterator().withIndex()
|
val iteet = node.iterator().withIndex()
|
||||||
return object : Iterator<IndexedValue<JsonItem>> {
|
return object : Iterator<IndexedValue<JsonItem>> {
|
||||||
override fun next(): IndexedValue<JsonItem> {
|
override fun next(): IndexedValue<JsonItem> {
|
||||||
val it = iteet.next()
|
val it = iteet.next()
|
||||||
return IndexedValue(it.index, getJsonItem(it.value))
|
return IndexedValue(it.index, getJsonItem(it.value))
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun hasNext(): Boolean {
|
override fun hasNext(): Boolean {
|
||||||
return iteet.hasNext()
|
return iteet.hasNext()
|
||||||
}
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于Jackson2节点的JSON对象类型
|
||||||
|
*
|
||||||
|
* @property node 对象类型的JsonNode节点
|
||||||
|
*/
|
||||||
class JackSonJsonObject(val node: JsonNode) : JsonObject() {
|
class JackSonJsonObject(val node: JsonNode) : JsonObject() {
|
||||||
override fun getField(name: String): JsonItem {
|
override fun getField(name: String): JsonItem {
|
||||||
return getJsonItem(node.get(name))
|
return getJsonItem(node.get(name))
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> {
|
override fun iteratorObject(): Iterator<Map.Entry<String, JsonItem>> {
|
||||||
return object : Iterator<Map.Entry<String, JsonItem>> {
|
return object : Iterator<Map.Entry<String, JsonItem>> {
|
||||||
val it = node.properties().iterator()
|
val it = node.properties().iterator()
|
||||||
override fun next(): Map.Entry<String, JsonItem> {
|
override fun next(): Map.Entry<String, JsonItem> {
|
||||||
val utem = it.next()
|
val utem = it.next()
|
||||||
return object : Map.Entry<String, JsonItem> {
|
return object : Map.Entry<String, JsonItem> {
|
||||||
override val key: String
|
override val key: String
|
||||||
get() = utem.key
|
get() = utem.key
|
||||||
override val value: JsonItem
|
override val value: JsonItem
|
||||||
get() = getJsonItem(utem.value)
|
get() = getJsonItem(utem.value)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
override fun hasNext(): Boolean {
|
override fun hasNext(): Boolean {
|
||||||
return it.hasNext()
|
return it.hasNext()
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
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