Compare commits
55
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
3bacf90940
|
||
|
|
28a2987dc3
|
||
|
|
8069de37f2
|
||
|
|
51eb838a36
|
||
|
|
d0887ea1f7
|
||
|
|
16da482de7
|
||
|
|
aa83f575b1
|
||
|
|
510ff69e2c
|
||
|
|
184db461d7
|
||
|
|
535c03d14a
|
||
|
|
5714aef444
|
||
|
|
7a3bc01b11
|
||
|
|
792ddf0255
|
||
|
|
f4025cbad9 | ||
|
|
eaf7ee7a31 | ||
|
|
38ad9884d0 | ||
|
|
0e5ce5597b | ||
|
|
85fd391849 | ||
|
|
390afa5462
|
||
|
|
31987b9b14 | ||
|
|
474071e43b
|
||
|
|
6624c00553
|
||
|
|
2c423c4aff
|
||
|
|
f7abd6c271
|
||
|
|
60ec0e2883
|
||
|
|
e00f8ad7a1 | ||
|
|
454cd53553
|
||
|
|
bc8927db26
|
||
|
|
450b4e1a93
|
||
|
|
a5a532bc82
|
||
|
|
f2ee83ca64
|
||
|
|
66ec71cbc7
|
||
|
|
f773b1975e
|
||
|
|
3f666d652d
|
||
|
|
00c1be6387
|
||
|
|
2063d86097
|
||
|
|
2db24530d6
|
||
|
|
2bcd4b329c
|
||
|
|
a081744f14
|
||
|
|
1509597032
|
||
|
|
ac92f62967
|
||
|
|
683aeb2c7f
|
||
|
|
5eed682aa1
|
||
|
|
578f0a3e89
|
||
|
|
075dc2346a
|
||
|
|
23548c0c3d
|
||
|
|
4b187f3774
|
||
|
|
c90c1d590b
|
||
|
|
42a3302495
|
||
|
|
496c3e6248
|
||
|
|
9002f41c63
|
||
|
|
58806e85f1
|
||
|
|
0f5748d55d
|
||
|
|
8f8ffc72db
|
||
|
|
fcd528a821
|
@@ -45,3 +45,4 @@ log
|
|||||||
node_modules
|
node_modules
|
||||||
*lock*
|
*lock*
|
||||||
.kotlin
|
.kotlin
|
||||||
|
secret.gpg
|
||||||
|
|||||||
@@ -1,8 +0,0 @@
|
|||||||
{
|
|
||||||
"$schema": "https://json.schemastore.org/prettierrc",
|
|
||||||
"plugins": [
|
|
||||||
"prettier-plugin-java"
|
|
||||||
],
|
|
||||||
"tabWidth": 4,
|
|
||||||
"useTabs": true
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,61 @@
|
|||||||
|
# Changelog
|
||||||
|
|
||||||
|

|
||||||
|
|
||||||
|
本文件记录 mingli-utils 各版本的主要变更。
|
||||||
|
|
||||||
|
## [5.5.2] - 2026-11-17
|
||||||
|
|
||||||
|
### 新增
|
||||||
|
|
||||||
|
- **tuple**:实现 `Tuple.compareTo` 字典序比较——同类型可比较元素按自然顺序,
|
||||||
|
其余按字符串形式比较;公共前缀相等时元素个数较少的元组在前。
|
||||||
|
新增 `TestTuple` 测试覆盖 6 种比较场景。
|
||||||
|
|
||||||
|
## [5.5.1] - 2026-11-17
|
||||||
|
|
||||||
|
### 新增
|
||||||
|
|
||||||
|
- **json**:新增 `reader` / `witer` / `judgment` 三组抽象,为 Jackson2 与 Jackson3 分别提供
|
||||||
|
`JsonReader`、`JsonArrayReader`、`JsonObjectReader`、`JsonWriter`、`ArrayWriter`、`ObjectWriter`
|
||||||
|
与 `ReaderJudgment` 实现(`BaseJsonReader` / `BaseJsonWriter` / `BaseJsonJudgment` 等基类)。
|
||||||
|
- **exception**:新增 `JsonFormatException`,表示 JSON 格式错误,继承自 `JsonException`。
|
||||||
|
- **time**:`DateTime.now(zone)` 支持指定时区;新增 `DateTime.atZone(zoneId)` 时区转换方法,
|
||||||
|
`toString()` 输出包含 `zoneId`。
|
||||||
|
|
||||||
|
### 变更
|
||||||
|
|
||||||
|
- **json**:重构转换器体系——移除按类型划分的 `BaseJsonIntConverter`、`BaseJsonStringConverter`
|
||||||
|
等 10 个转换器及 `JsonConverter` 接口,统一由 `BaseJsonConverter` 与 `JsonConverterUtils` 处理;
|
||||||
|
简化 `DateTimeJsonConverter`、`UUIDJsonConverter`、`NetworkEndpointJsonConverter` 与
|
||||||
|
Jackson2/Jackson3 序列化/反序列化桥接实现;精简 `JSONA` 与 `JsonApi` 门面。
|
||||||
|
- **tuple**:`Tuple` 声明实现 `Comparable<Tuple>`;迭代器改为基于 `toMutableList()` 的简化实现。
|
||||||
|
- **springboot**:`JsonAutoConfiguration` 与 `JacksonJsonBuilder` / `JacksonJsonBuilderImpl`
|
||||||
|
同步适配新的 JSON 转换器体系。
|
||||||
|
|
||||||
|
### 文档
|
||||||
|
|
||||||
|
- 补全 src 下全部 Kotlin 文件的中文 KDoc 与 Java 文件的 Javadoc(约 1.3 万处),
|
||||||
|
覆盖 exception、json、springboot、mybatis/mybatisplus、thread/netty/http、
|
||||||
|
Tuple1~Tuple100 生成类、MediaType 全部枚举项及测试代码;已有文档保持不变。
|
||||||
|
|
||||||
|
## [5.4.4] - 2026-11-17
|
||||||
|
|
||||||
|
- 构建脚本调整(build.gradle.kts 发布配置完善)。
|
||||||
|
- SpringBoot 自动配置重构:新增 `JsonAutoConfiguration` 与 `JacksonBuilder`,
|
||||||
|
精简 Jackson2/Jackson3 JsonApi 自动配置。
|
||||||
|
|
||||||
|
## [5.4.3] - 2026-11-17
|
||||||
|
|
||||||
|
- 新增 `JacksonJsonBuilder` / `JacksonJsonBuilderImpl` 构建器。
|
||||||
|
- `DateTime`、`UUID` 小幅调整;补充 log4j2 测试配置。
|
||||||
|
|
||||||
|
## [5.4.2] - 2026-11
|
||||||
|
|
||||||
|
- 修复 `JSONA.jsonApi` 编译错误。
|
||||||
|
- **mybatisplus**:新增 `FastBaseIServiceNew3518`(适配 MyBatis-Plus 3.5.18)。
|
||||||
|
|
||||||
|
## [5.4.0] - 2026-11
|
||||||
|
|
||||||
|
- **mybatisplus**:新增 `FastBaseIService`。
|
||||||
|
- 全项目统一 Tab 缩进并补全尾随逗号。
|
||||||
@@ -0,0 +1,25 @@
|
|||||||
|
mingli-utils
|
||||||
|
Copyright 2025 mingliqiye
|
||||||
|
|
||||||
|
This product includes software developed by third parties.
|
||||||
|
The original copyright notices and licenses are reproduced below.
|
||||||
|
|
||||||
|
------------------------------------------------------------
|
||||||
|
|
||||||
|
https://github.com/jeremyh/jBCrypt (org.mindrot:jbcrypt@0.4)
|
||||||
|
|
||||||
|
Copyright (c) 2006 Damien Miller <djm@mindrot.org>
|
||||||
|
|
||||||
|
Permission to use, copy, modify, and distribute this software for any
|
||||||
|
purpose with or without fee is hereby granted, provided that the above
|
||||||
|
copyright notice and this permission notice appear in all copies.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
||||||
|
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
||||||
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
||||||
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
|
||||||
|
------------------------------------------------------------
|
||||||
+204
-115
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,170 +16,259 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils
|
* ModuleName mingli-utils
|
||||||
* CurrentFile build.gradle.kts
|
* CurrentFile build.gradle.kts
|
||||||
* LastUpdate 2025-09-15 22:22:00
|
* 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
|
||||||
id("java-library")
|
signing
|
||||||
id("maven-publish")
|
`java-library`
|
||||||
kotlin("jvm") version "2.2.20"
|
`maven-publish`
|
||||||
id("org.jetbrains.dokka") version "2.0.0"
|
kotlin("jvm") version "2.2.20"
|
||||||
|
kotlin("kapt") version "2.2.20"
|
||||||
|
id("org.jetbrains.dokka") version "2.1.0"
|
||||||
|
id("org.jetbrains.dokka-javadoc") version "2.1.0"
|
||||||
|
kotlin("plugin.spring") version "2.1.0"
|
||||||
}
|
}
|
||||||
val GROUPSID = project.properties["GROUPSID"] as String
|
val GROUPSID = project.properties["GROUPSID"] as String
|
||||||
val VERSIONS = project.properties["VERSIONS"] as String
|
val VERSIONS = project.properties["VERSIONS"] as String
|
||||||
val ARTIFACTID = project.properties["ARTIFACTID"] as String
|
val ARTIFACTID = project.properties["ARTIFACTID"] as String
|
||||||
|
val JDKVERSIONS = (project.properties["JDKVERSIONS"] as String).toInt()
|
||||||
|
|
||||||
|
|
||||||
group = GROUPSID
|
group = GROUPSID
|
||||||
version = VERSIONS
|
version = VERSIONS
|
||||||
|
|
||||||
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()
|
||||||
|
|
||||||
sourceSets {
|
|
||||||
main {
|
|
||||||
java {
|
|
||||||
srcDirs("src/main/java")
|
|
||||||
}
|
|
||||||
kotlin {
|
|
||||||
srcDirs("src/main/kotlin")
|
|
||||||
}
|
|
||||||
resources {
|
|
||||||
srcDirs("src/main/resources")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
java {
|
java {
|
||||||
withSourcesJar()
|
toolchain.languageVersion.set(JavaLanguageVersion.of(JDKVERSIONS))
|
||||||
toolchain.languageVersion.set(JavaLanguageVersion.of(8))
|
withSourcesJar()
|
||||||
|
}
|
||||||
|
kotlin {
|
||||||
|
jvmToolchain(JDKVERSIONS)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
repositories {
|
||||||
|
mavenLocal()
|
||||||
|
maven {
|
||||||
|
name = "mingliqiye-public"
|
||||||
|
url = uri("https://repository.mingliqiye.com/repository/maven-public/")
|
||||||
|
}
|
||||||
|
mavenCentral()
|
||||||
|
}
|
||||||
dependencies {
|
dependencies {
|
||||||
annotationProcessor("org.jetbrains:annotations:24.0.0")
|
implementation("org.slf4j:slf4j-api:2.0.17")
|
||||||
annotationProcessor("org.projectlombok:lombok:1.18.38")
|
implementation(kotlin("reflect"))
|
||||||
compileOnly("org.springframework.boot:spring-boot-starter:2.7.14")
|
api("com.mingliqiye.utils.aliasfor:alias-for:1.0.1")
|
||||||
compileOnly("com.fasterxml.jackson.core:jackson-databind:2.19.2")
|
compileOnly("org.mindrot:jbcrypt:0.4")
|
||||||
compileOnly("com.google.code.gson:gson:2.13.1")
|
compileOnly("com.squareup.okhttp3:okhttp:5.3.2")
|
||||||
compileOnly("org.mybatis:mybatis:3.5.19")
|
compileOnly("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
||||||
compileOnly("com.alibaba.fastjson2:fastjson2:2.0.58")
|
compileOnly("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
|
||||||
compileOnly("org.projectlombok:lombok:1.18.38")
|
compileOnly("org.springframework:spring-context:5.3.0")
|
||||||
implementation("org.bouncycastle:bcprov-jdk18on:1.81")
|
compileOnly("org.springframework.boot:spring-boot-autoconfigure:2.7.16")
|
||||||
implementation("com.github.f4b6a3:uuid-creator:6.1.0")
|
compileOnly("tools.jackson.core:jackson-databind:3.1.0")
|
||||||
implementation("org.mindrot:jbcrypt:0.4")
|
compileOnly(fileTree("libs"))
|
||||||
implementation("org.jetbrains:annotations:24.0.0")
|
compileOnly("com.google.code.gson:gson:2.13.2")
|
||||||
compileOnly("net.java.dev.jna:jna:5.17.0")
|
compileOnly("org.mybatis:mybatis:3.5.19")
|
||||||
implementation("org.slf4j:slf4j-api:2.0.17")
|
compileOnly("io.netty:netty-all:4.2.15.Final")
|
||||||
implementation("com.mingliqiye.utils.jna:WinKernel32Api:1.0.1")
|
compileOnly("com.baomidou:mybatis-plus-core:3.5.15")
|
||||||
|
compileOnly("net.java.dev.jna:jna:5.17.0")
|
||||||
|
compileOnly("org.springdoc:springdoc-openapi-starter-webmvc-ui:2.8.8")
|
||||||
|
compileOnly("com.baomidou:mybatis-plus-extension:3.5.15")
|
||||||
|
compileOnly("com.baomidou:mybatis-plus-jsqlparser:3.5.15")
|
||||||
|
compileOnly("com.baomidou:mybatis-plus-spring:3.5.9")
|
||||||
|
testImplementation("org.junit.jupiter:junit-jupiter:5.7.1")
|
||||||
|
testRuntimeOnly("org.junit.platform:junit-platform-launcher")
|
||||||
|
testImplementation("com.mingliqiye.logger:logger-log4j2:1.0.9")
|
||||||
|
testImplementation("com.google.code.gson:gson:2.13.2")
|
||||||
|
|
||||||
|
testImplementation("com.fasterxml.jackson.core:jackson-databind:2.21.0")
|
||||||
|
testImplementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.21.0")
|
||||||
|
|
||||||
|
testImplementation("tools.jackson.module:jackson-module-kotlin:3.1.0")
|
||||||
|
testImplementation("tools.jackson.core:jackson-databind:3.1.0")
|
||||||
|
testImplementation(kotlin("test"))
|
||||||
|
}
|
||||||
|
|
||||||
|
repositories {
|
||||||
|
mavenLocal()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
tasks.withType<JavaCompile> {
|
tasks.withType<JavaCompile>().configureEach {
|
||||||
options.encoding = "UTF-8"
|
options.encoding = "UTF-8"
|
||||||
|
}
|
||||||
|
|
||||||
|
tasks.named<Test>("test") {
|
||||||
|
useJUnitPlatform()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
tasks.withType<JavaExec>().configureEach {
|
tasks.withType<JavaExec> {
|
||||||
jvmArgs = listOf(
|
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 {
|
||||||
|
arguments {
|
||||||
|
arg(
|
||||||
|
"kapt.kotlin.generated",
|
||||||
|
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
|
||||||
manifest {
|
from("LICENSE") { into("META-INF") }
|
||||||
attributes(
|
from("NOTICE") { into("META-INF") }
|
||||||
mapOf(
|
manifest {
|
||||||
"Main-Class" to "com.mingliqiye.utils.Main",
|
attributes(
|
||||||
"Specification-Title" to ARTIFACTID,
|
mapOf(
|
||||||
"Specification-Version" to VERSIONS,
|
"Main-Class" to "com.mingliqiye.utils.main.Main",
|
||||||
"Specification-Vendor" to "minglipro",
|
"Specification-Title" to ARTIFACTID,
|
||||||
"Specification-Build-Time" to LocalDateTime.now()
|
"Specification-Version" to VERSIONS,
|
||||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")),
|
"Specification-Vendor" to "minglipro",
|
||||||
"Specification-Package" to GROUPSID,
|
"Specification-Build-Time" to LocalDateTime.now()
|
||||||
"Specification-Build-Number" to "1",
|
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")),
|
||||||
"Specification-Build-OS" to System.getProperty("os.name"),
|
"Specification-Package" to GROUPSID,
|
||||||
"Specification-Build-Java" to System.getProperty("java.version"),
|
"Specification-Build-Number" to "1",
|
||||||
"Specification-Build-Java-Vendor" to System.getProperty("java.vendor"),
|
"Specification-Build-OS" to System.getProperty("os.name"),
|
||||||
"Specification-Build-Java-Vendor-URL" to System.getProperty("java.vendor.url"),
|
"Specification-Build-Java" to System.getProperty("java.version"),
|
||||||
"Implementation-Title" to ARTIFACTID,
|
"Specification-Build-Java-Vendor" to System.getProperty("java.vendor"),
|
||||||
"Implementation-Version" to VERSIONS,
|
"Specification-Build-Java-Vendor-URL" to System.getProperty("java.vendor.url"),
|
||||||
"Implementation-Package" to GROUPSID,
|
"Implementation-Title" to ARTIFACTID,
|
||||||
"Implementation-Vendor" to "minglipro",
|
"Implementation-Version" to VERSIONS,
|
||||||
"Implementation-Build-Time" to LocalDateTime.now()
|
"Implementation-Package" to GROUPSID,
|
||||||
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
|
"Implementation-Vendor" to "minglipro",
|
||||||
|
"Implementation-Build-Time" to LocalDateTime.now()
|
||||||
|
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS"))
|
||||||
|
|
||||||
)
|
)
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
val isJdk8Build = project.findProperty("buildForJdk8") == "true"
|
val isJdk8Build = project.findProperty("buildForJdk8") == "true"
|
||||||
|
|
||||||
repositories {
|
|
||||||
maven {
|
dokka {
|
||||||
url = uri("https://maven.aliyun.com/repository/public/")
|
pluginsConfiguration.html {
|
||||||
}
|
customAssets.from("logo.png")
|
||||||
mavenCentral()
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.register<Jar>("javaDocJar") {
|
tasks.register<Jar>("javaDocJar") {
|
||||||
group = "build"
|
group = "build"
|
||||||
archiveClassifier.set("javadoc")
|
archiveClassifier.set("javadoc")
|
||||||
dependsOn(tasks.dokkaJavadoc)
|
dependsOn("dokkaGenerateJavadoc")
|
||||||
from(buildDir.resolve("dokka/javadoc"))
|
from(buildDir.resolve("dokka/javadoc"))
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.register<Jar>("kotlinDocJar") {
|
tasks.register<Jar>("kotlinDocJar") {
|
||||||
group = "build"
|
group = "build"
|
||||||
archiveClassifier.set("kotlindoc")
|
archiveClassifier.set("kotlindoc")
|
||||||
dependsOn(tasks.dokkaHtml)
|
dependsOn("dokkaGeneratePublicationHtml")
|
||||||
from(buildDir.resolve("dokka/html"))
|
from(buildDir.resolve("dokka/html"))
|
||||||
}
|
}
|
||||||
publishing {
|
publishing {
|
||||||
repositories {
|
publications {
|
||||||
maven {
|
create<MavenPublication>("mavenJava") {
|
||||||
name = "MavenRepositoryRaw"
|
from(components["java"])
|
||||||
url = uri("C:/data/git/maven-repository-raw")
|
artifact(tasks.named("javaDocJar"))
|
||||||
}
|
artifact(tasks.named("kotlinDocJar"))
|
||||||
}
|
artifactId = ARTIFACTID
|
||||||
publications {
|
pom {
|
||||||
create<MavenPublication>("mavenJava") {
|
name = "mingli-utils"
|
||||||
from(components["java"])
|
url = "https://mingli-utils.mingliqiye.com"
|
||||||
artifact(tasks.named("javaDocJar"))
|
description = "A Java/kotlin Utils"
|
||||||
artifact(tasks.named("kotlinDocJar"))
|
licenses {
|
||||||
artifactId = ARTIFACTID
|
license {
|
||||||
java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
|
name = "The Apache License, Version 2.0"
|
||||||
}
|
url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
developers {
|
||||||
|
developer {
|
||||||
|
id = "minglipro"
|
||||||
|
name = "mingli"
|
||||||
|
email = "minglipro@163.com"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
scm {
|
||||||
|
connection = "scm:git:https://git.mingliqiye.com/minglipro/mingli-utils.git"
|
||||||
|
developerConnection = "scm:git:https://git.mingliqiye.com:minglipro/mingli-utils.git"
|
||||||
|
url = "https://git.mingliqiye.com/minglipro/mingli-utils"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
signing {
|
||||||
|
sign(publishing.publications)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
tasks.build {
|
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("META-INF/meta-data") {
|
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 {
|
||||||
|
val secretKeyRingFile = System.getenv("SIGNING_SECRET_KEY_RING_FILE")
|
||||||
|
val keyId = System.getenv("SIGNING_KEY_ID")
|
||||||
|
useGpgCmd()
|
||||||
|
project.ext.set("signing.secretKeyRingFile", secretKeyRingFile)
|
||||||
|
project.ext.set("signing.keyId", keyId)
|
||||||
|
project.ext.set("signing.password", "")
|
||||||
}
|
}
|
||||||
|
|||||||
+4
-4
@@ -1,5 +1,5 @@
|
|||||||
#
|
#
|
||||||
# Copyright 2025 mingliqiye
|
# Copyright 2026 mingliqiye
|
||||||
#
|
#
|
||||||
# Licensed under the Apache License, Version 2.0 (the "License");
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
# you may not use this file except in compliance with the License.
|
# you may not use this file except in compliance with the License.
|
||||||
@@ -16,10 +16,10 @@
|
|||||||
# ProjectName mingli-utils
|
# ProjectName mingli-utils
|
||||||
# ModuleName mingli-utils
|
# ModuleName mingli-utils
|
||||||
# CurrentFile gradle.properties
|
# CurrentFile gradle.properties
|
||||||
# LastUpdate 2025-09-15 22:32:50
|
# LastUpdate 2026-11-17 09:07:20
|
||||||
# UpdateUser MingLiPro
|
# UpdateUser MingLiPro
|
||||||
#
|
#
|
||||||
JDKVERSIONS=1.8
|
JDKVERSIONS=17
|
||||||
GROUPSID=com.mingliqiye.utils
|
GROUPSID=com.mingliqiye.utils
|
||||||
ARTIFACTID=mingli-utils
|
ARTIFACTID=mingli-utils
|
||||||
VERSIONS=4.0.7
|
VERSIONS=5.5.2
|
||||||
|
|||||||
@@ -1,57 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright 2025 mingliqiye
|
|
||||||
*
|
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
* you may not use this file except in compliance with the License.
|
|
||||||
* You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*
|
|
||||||
* ProjectName mingli-utils
|
|
||||||
* ModuleName mingli-utils.jdk8
|
|
||||||
* CurrentFile build.gradle.kts
|
|
||||||
* LastUpdate 2025-09-15 22:32:50
|
|
||||||
* UpdateUser MingLiPro
|
|
||||||
*/
|
|
||||||
plugins {
|
|
||||||
id("java-library")
|
|
||||||
id("maven-publish")
|
|
||||||
}
|
|
||||||
val GROUPSID = project.properties["GROUPSID"] as String
|
|
||||||
val VERSIONS = project.properties["VERSIONS"] as String
|
|
||||||
val ARTIFACTID = project.properties["ARTIFACTID"] as String
|
|
||||||
version = VERSIONS
|
|
||||||
group = GROUPSID
|
|
||||||
|
|
||||||
base.archivesName.set(ARTIFACTID)
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
publishing {
|
|
||||||
repositories {
|
|
||||||
maven {
|
|
||||||
name = "MavenRepositoryRaw"
|
|
||||||
url = uri("C:/data/git/maven-repository-raw")
|
|
||||||
}
|
|
||||||
}
|
|
||||||
publications {
|
|
||||||
create<MavenPublication>("mavenJava") {
|
|
||||||
from(components["java"])
|
|
||||||
artifactId = "$ARTIFACTID-win-jdk8"
|
|
||||||
groupId = GROUPSID
|
|
||||||
version = VERSIONS
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
|
|
||||||
dependencies {
|
|
||||||
api(rootProject)
|
|
||||||
implementation("com.mingliqiye.utils.jna:WinKernel32Platform:1.0.1")
|
|
||||||
}
|
|
||||||
Binary file not shown.
Binary file not shown.
@@ -1,14 +0,0 @@
|
|||||||
{
|
|
||||||
"name": "maven-repository",
|
|
||||||
"version": "1.0.0",
|
|
||||||
"scripts": {
|
|
||||||
"build": "gradle build-jar",
|
|
||||||
"buildw": "gradlew build-jar",
|
|
||||||
"format": "prettier --write \"**/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,json,java}\"",
|
|
||||||
"f": "prettier --write \"**/*.{js,ts,jsx,tsx,cjs,cts,mjs,mts,vue,astro,json,java}\""
|
|
||||||
},
|
|
||||||
"devDependencies": {
|
|
||||||
"prettier-plugin-java": "^2.7.1",
|
|
||||||
"prettier": "^3.6.2"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
+14
-3
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,10 +16,21 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils
|
* ModuleName mingli-utils
|
||||||
* CurrentFile settings.gradle.kts
|
* CurrentFile settings.gradle.kts
|
||||||
* LastUpdate 2025-09-15 22:32:50
|
* LastUpdate 2026-02-26 10:52:01
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
include("jdk8")
|
plugins {
|
||||||
|
id("com.gradleup.nmcp.settings").version("1.4.4")
|
||||||
|
}
|
||||||
|
|
||||||
val ARTIFACTID: String by settings.extra
|
val ARTIFACTID: String by settings.extra
|
||||||
rootProject.name = ARTIFACTID
|
rootProject.name = ARTIFACTID
|
||||||
|
|
||||||
|
nmcpSettings {
|
||||||
|
centralPortal {
|
||||||
|
username = System.getenv("sonatype.username")
|
||||||
|
password = System.getenv("sonatype.password")
|
||||||
|
publishingType = "AUTOMATIC"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -0,0 +1,43 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Jackson3ApiJavaHelper.java
|
||||||
|
* LastUpdate 2026-03-18 08:32:31
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.json.api;
|
||||||
|
|
||||||
|
import tools.jackson.databind.ObjectMapper;
|
||||||
|
import tools.jackson.databind.cfg.MapperBuilder;
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Jackson 3 API 的 Java 辅助类,用于在 Java 侧调用 Kotlin 内联/受限 API。
|
||||||
|
*/
|
||||||
|
public class Jackson3ApiJavaHelper {
|
||||||
|
/**
|
||||||
|
* 基于现有 ObjectMapper 创建可重新配置的 MapperBuilder。
|
||||||
|
*
|
||||||
|
* @param objectMapper 需要重建的 ObjectMapper 实例
|
||||||
|
* @return 由该 ObjectMapper 派生的 MapperBuilder
|
||||||
|
*/
|
||||||
|
@SuppressWarnings("rawtypes")
|
||||||
|
static MapperBuilder rebuild(ObjectMapper objectMapper) {
|
||||||
|
return objectMapper.rebuild();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,152 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Main.java
|
||||||
|
* LastUpdate 2026-02-26 15:04:49
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.main;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.lang.management.ManagementFactory;
|
||||||
|
import java.net.InetAddress;
|
||||||
|
import java.time.LocalDateTime;
|
||||||
|
import java.time.format.DateTimeFormatter;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 工具库入口类,提供启动 Banner 打印以及进程、主机、用户等基础信息的获取方法。
|
||||||
|
*/
|
||||||
|
public class Main {
|
||||||
|
/**
|
||||||
|
* 启动时打印的 ASCII 艺术 Banner 文本
|
||||||
|
*/
|
||||||
|
public final static String BANNER =
|
||||||
|
"| $$\\ $$\\ $$\\ $$\\ $$\\ $$$$$$$$\\ $$$$$$\\ \n" +
|
||||||
|
"| $$$\\ $$$ |$$ | $$ | $$ |\\__$$ __|$$ __$$\\ \n" +
|
||||||
|
"| $$$$\\ $$$$ |$$ | $$ | $$ | $$ | $$ / \\__| \n" +
|
||||||
|
"| $$\\$$\\$$ $$ |$$ | $$ | $$ | $$ | \\$$$$$$\\ \n" +
|
||||||
|
"| $$ \\$$$ $$ |$$ | $$ | $$ | $$ | \\____$$\\ \n" +
|
||||||
|
"| $$ |\\$ /$$ |$$ | $$ | $$ | $$ | $$\\ $$ | \n" +
|
||||||
|
"| $$ | \\_/ $$ |$$$$$$$$\\\\$$$$$$ | $$ | \\$$$$$$ \n" +
|
||||||
|
"| \\__| \\__|\\________|\\______/ \\__| \\______/ \n|\n";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 程序入口,打印 Banner 与构建元数据信息,打印失败时静默忽略。
|
||||||
|
*
|
||||||
|
* @param args 命令行参数(未使用)
|
||||||
|
*/
|
||||||
|
public static void main(String[] args) {
|
||||||
|
try {
|
||||||
|
printb();
|
||||||
|
} catch (IOException ignored) {
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前进程 PID 字符串。
|
||||||
|
*
|
||||||
|
* @return 当前进程 PID;获取失败时返回 "-1"
|
||||||
|
*/
|
||||||
|
public static String getPid() {
|
||||||
|
try {
|
||||||
|
var name = ManagementFactory.getRuntimeMXBean().getName();
|
||||||
|
var index = name.indexOf('@');
|
||||||
|
if (index > 0) {
|
||||||
|
return name.substring(0, index);
|
||||||
|
} else {
|
||||||
|
return "-1";
|
||||||
|
}
|
||||||
|
} catch (Exception e) {
|
||||||
|
return "-1";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取计算机名,依次尝试环境变量 COMPUTERNAME、HOSTNAME 与本机主机名。
|
||||||
|
*
|
||||||
|
* @return 计算机名;获取失败时返回 "unknown"
|
||||||
|
*/
|
||||||
|
public static String getComputerName() {
|
||||||
|
try {
|
||||||
|
var name = System.getenv("COMPUTERNAME");
|
||||||
|
if (name == null || name.isEmpty()) {
|
||||||
|
name = System.getenv("HOSTNAME");
|
||||||
|
}
|
||||||
|
if (name == null || name.isEmpty()) {
|
||||||
|
name = InetAddress.getLocalHost().getHostName();
|
||||||
|
}
|
||||||
|
return name != null ? name : "unknown";
|
||||||
|
} catch (Exception e) {
|
||||||
|
return "unknown";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前用户名,依次尝试环境变量 USERNAME、USER 与 user.name。
|
||||||
|
*
|
||||||
|
* @return 当前用户名;获取失败时返回 "unknown"
|
||||||
|
*/
|
||||||
|
public static String getUserName() {
|
||||||
|
try {
|
||||||
|
String user = System.getenv("USERNAME");
|
||||||
|
|
||||||
|
if (user == null || user.isEmpty()) {
|
||||||
|
user = System.getenv("USER");
|
||||||
|
}
|
||||||
|
if (user == null || user.isEmpty()) {
|
||||||
|
user = System.getenv("user.name");
|
||||||
|
}
|
||||||
|
if (user == null || user.isEmpty()) {
|
||||||
|
user = "unknown";
|
||||||
|
}
|
||||||
|
return user;
|
||||||
|
} catch (Exception e) {
|
||||||
|
return "unknown";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 打印 Banner 及构建元数据、JDK 版本、PID、计算机名、用户名与当前时间。
|
||||||
|
* 若元数据资源不存在则直接返回。
|
||||||
|
*
|
||||||
|
* @throws IOException 读取元数据资源失败时抛出
|
||||||
|
*/
|
||||||
|
public static void printb() throws IOException {
|
||||||
|
InputStream inputStream = Main.class.getResourceAsStream("/META-INF/meta-data");
|
||||||
|
if (inputStream == null) return;
|
||||||
|
String data = new String(inputStream.readAllBytes());
|
||||||
|
inputStream.close();
|
||||||
|
StringBuilder sb = new StringBuilder(BANNER);
|
||||||
|
for (String sz : data.split("\n")) {
|
||||||
|
var d = sz.split("=");
|
||||||
|
sb.append("| -> ").append(d[0]).append(": ").append(d[1]).append("\n");
|
||||||
|
}
|
||||||
|
sb.append("| -> jdkVersion: ").append(System.getProperty("java.specification.version")).append("\n");
|
||||||
|
sb.append("| -> pid: ").append(getPid()).append("\n");
|
||||||
|
sb.append("| -> computerName: ").append(getComputerName()).append("\n");
|
||||||
|
sb.append("| -> userName: ").append(getUserName()).append("\n");
|
||||||
|
sb.append("| -> time: ")
|
||||||
|
.append(LocalDateTime.now()
|
||||||
|
.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss.SSSSSSS")))
|
||||||
|
.append("\n");
|
||||||
|
System.out.println();
|
||||||
|
System.out.println(sb);
|
||||||
|
}
|
||||||
|
}
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile AesUtils.kt
|
* CurrentFile AesUtils.kt
|
||||||
* LastUpdate 2025-09-15 22:32:50
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -25,8 +25,7 @@
|
|||||||
|
|
||||||
package com.mingliqiye.utils.aes
|
package com.mingliqiye.utils.aes
|
||||||
|
|
||||||
import com.mingliqiye.utils.base64.decode
|
import com.mingliqiye.utils.base.BaseType
|
||||||
import com.mingliqiye.utils.base64.encode
|
|
||||||
import java.nio.charset.StandardCharsets
|
import java.nio.charset.StandardCharsets
|
||||||
import java.security.GeneralSecurityException
|
import java.security.GeneralSecurityException
|
||||||
import java.security.MessageDigest
|
import java.security.MessageDigest
|
||||||
@@ -35,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()
|
||||||
|
|
||||||
|
|
||||||
@@ -51,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 encode(
|
return BaseType.BASE64.encode(
|
||||||
"${encode(iv)}:${encode(encrypted)}".toByteArray()
|
"${BaseType.BASE64.encode(iv)}:${BaseType.BASE64.encode(encrypted)}".toByteArray()
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -84,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(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 = decode(parts[0]!!)
|
val iv = BaseType.BASE64.decode(parts[0]!!)
|
||||||
val encryptedData = 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
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -117,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)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,41 @@
|
|||||||
|
/*
|
||||||
|
* 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 AutoService.kt
|
||||||
|
* LastUpdate 2026-02-07 17:00:39
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.annotation
|
||||||
|
|
||||||
|
import kotlin.reflect.KClass
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 标记一个类为其提供自动服务注册功能的注解。
|
||||||
|
*
|
||||||
|
* 此注解用于标识那些需要被自动注册为服务的类。通过指定[value]参数,
|
||||||
|
* 可以声明该类实现的服务接口类型。注解的作用范围限定为类(CLASS),
|
||||||
|
* 并且仅在源码级别保留(SOURCE),不会编译到字节码中。
|
||||||
|
* @since 4.6.3
|
||||||
|
*
|
||||||
|
* @param value 需要注册的服务接口类型数组,默认为空数组。
|
||||||
|
*/
|
||||||
|
@Target(AnnotationTarget.CLASS)
|
||||||
|
@Retention(AnnotationRetention.SOURCE)
|
||||||
|
annotation class AutoService(
|
||||||
|
val value: Array<KClass<*>> = [],
|
||||||
|
)
|
||||||
@@ -0,0 +1,39 @@
|
|||||||
|
/*
|
||||||
|
* 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 DateTimeJsonFormat.kt
|
||||||
|
* LastUpdate 2026-02-07 08:05:39
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.annotation
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.time.Formatter
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 日期时间JSON格式化注解,用于标注字段的日期时间格式化方式
|
||||||
|
*
|
||||||
|
* @property value 格式化器类型,默认为NONE
|
||||||
|
* @property formatter 自定义格式化字符串,默认为空字符串
|
||||||
|
* @property repcZero 是否替换零值,默认为true
|
||||||
|
*/
|
||||||
|
@Target(AnnotationTarget.FIELD)
|
||||||
|
annotation class DateTimeJsonFormat(
|
||||||
|
val value: Formatter = Formatter.NONE,
|
||||||
|
val formatter: String = "",
|
||||||
|
val repcZero: Boolean = true,
|
||||||
|
)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile UUIDJsonFormat.kt
|
||||||
|
* LastUpdate 2026-02-07 08:05:58
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.annotation
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.base.BaseType
|
||||||
|
import com.mingliqiye.utils.uuid.UUIDFormatType
|
||||||
|
|
||||||
|
/**
|
||||||
|
* UUID JSON格式化注解,用于指定UUID字段在JSON序列化/反序列化时的格式
|
||||||
|
*
|
||||||
|
* @property value UUID格式类型,默认为 NO_UPPER_SPACE
|
||||||
|
* @property base 基数类型,默认为 BASE16
|
||||||
|
*/
|
||||||
|
@Target(AnnotationTarget.FIELD)
|
||||||
|
annotation class UUIDJsonFormat(
|
||||||
|
val value: UUIDFormatType = UUIDFormatType.NO_UPPER_SPACE,
|
||||||
|
val base: BaseType = BaseType.BASE16,
|
||||||
|
)
|
||||||
@@ -0,0 +1,124 @@
|
|||||||
|
/*
|
||||||
|
* 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 AutoServiceProcessor.kt
|
||||||
|
* LastUpdate 2026-03-11 08:46:40
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.annotation.processor
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.annotation.AutoService
|
||||||
|
import javax.annotation.processing.AbstractProcessor
|
||||||
|
import javax.annotation.processing.ProcessingEnvironment
|
||||||
|
import javax.annotation.processing.RoundEnvironment
|
||||||
|
import javax.annotation.processing.SupportedAnnotationTypes
|
||||||
|
import javax.lang.model.element.TypeElement
|
||||||
|
import javax.lang.model.type.MirroredTypesException
|
||||||
|
import javax.lang.model.type.TypeMirror
|
||||||
|
import javax.tools.StandardLocation
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* [AutoService] 注解的编译期处理器。
|
||||||
|
*
|
||||||
|
* 扫描标注了 [AutoService] 的类,收集服务接口与实现类的映射关系,
|
||||||
|
* 并在编译输出目录的 META-INF/services 下生成对应的服务注册文件。
|
||||||
|
*/
|
||||||
|
@SupportedAnnotationTypes("com.mingliqiye.utils.annotation.AutoService")
|
||||||
|
class AutoServiceProcessor : AbstractProcessor() {
|
||||||
|
override fun init(processingEnv: ProcessingEnvironment) {
|
||||||
|
super.init(processingEnv)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 处理标注了 [AutoService] 的元素,收集服务接口与实现类的映射并生成服务注册文件。
|
||||||
|
* 若注解未显式指定服务接口,则默认使用该类直接实现的接口。
|
||||||
|
*
|
||||||
|
* @param annotations 本轮处理的注解类型集合
|
||||||
|
* @param roundEnv 当前轮次的处理环境
|
||||||
|
* @return 是否已处理该注解,存在标注元素时返回 true,否则返回 false
|
||||||
|
*/
|
||||||
|
override fun process(
|
||||||
|
annotations: Set<TypeElement>,
|
||||||
|
roundEnv: RoundEnvironment,
|
||||||
|
): Boolean {
|
||||||
|
|
||||||
|
val service = mutableMapOf<String, MutableList<String>>()
|
||||||
|
val elements = roundEnv.getElementsAnnotatedWith(AutoService::class.java)
|
||||||
|
if (elements.isEmpty()) return false
|
||||||
|
for (element in elements) {
|
||||||
|
val autoServiceAnnotation = element.getAnnotation(AutoService::class.java)
|
||||||
|
var asd = (try {
|
||||||
|
autoServiceAnnotation!!.value.map { it.java.name }
|
||||||
|
} catch (e: MirroredTypesException) {
|
||||||
|
e.typeMirrors.map(TypeMirror::toString)
|
||||||
|
})
|
||||||
|
|
||||||
|
if (asd.isEmpty()) {
|
||||||
|
if (element is TypeElement) {
|
||||||
|
asd = element.interfaces.map { it.toString() }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for (data in asd) {
|
||||||
|
var ldata: MutableList<String>? = service[data]
|
||||||
|
if (ldata == null) {
|
||||||
|
ldata = mutableListOf()
|
||||||
|
service[data] = ldata
|
||||||
|
}
|
||||||
|
ldata.add(element.toString())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
processClassAnnotation(service)
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据服务接口与实现类的映射,在 META-INF/services 目录下生成服务注册文件。
|
||||||
|
* 实现列表为空或文件创建失败时打印提示信息并跳过。
|
||||||
|
*
|
||||||
|
* @param map 服务接口全限定名到实现类全限定名列表的映射
|
||||||
|
*/
|
||||||
|
fun processClassAnnotation(map: Map<String, MutableList<String>>) {
|
||||||
|
map.forEach { (interfaceName, implementations) ->
|
||||||
|
if (implementations.isEmpty()) {
|
||||||
|
println("警告: $interfaceName 的实现列表为空!")
|
||||||
|
return@forEach
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
val serviceFile = processingEnv.filer.createResource(
|
||||||
|
StandardLocation.CLASS_OUTPUT,
|
||||||
|
"",
|
||||||
|
"META-INF/services/$interfaceName"
|
||||||
|
)
|
||||||
|
val content = StringBuilder()
|
||||||
|
serviceFile.openWriter().use { writer ->
|
||||||
|
implementations.forEach { impl ->
|
||||||
|
val line = "$impl\n"
|
||||||
|
content.append(line)
|
||||||
|
writer.write(line)
|
||||||
|
}
|
||||||
|
writer.flush()
|
||||||
|
}
|
||||||
|
|
||||||
|
} catch (e: Exception) {
|
||||||
|
println("文件创建失败: ${e.javaClass.name} - ${e.message}")
|
||||||
|
e.printStackTrace()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,340 @@
|
|||||||
|
/*
|
||||||
|
* 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 ArrayUtils.kt
|
||||||
|
* LastUpdate 2026-03-12 10:08:42
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
|
||||||
|
@file:JvmName("ArrayUtils")
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.array
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.base.BaseType
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组转换为十六进制字符串
|
||||||
|
*
|
||||||
|
* @return 大写的十六进制字符串,每两个字符表示一个字节
|
||||||
|
* @since 4.6.0
|
||||||
|
* @see toHexByteArray
|
||||||
|
*/
|
||||||
|
fun ByteArray.toHexString(): String = BaseType.BASE16.encode(this).uppercase()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将十六进制字符串转换为字节数组
|
||||||
|
*
|
||||||
|
* @return 对应的字节数组
|
||||||
|
* @throws IllegalArgumentException 如果字符串包含非十六进制字符
|
||||||
|
* @since 4.6.0
|
||||||
|
* @see toHexString
|
||||||
|
*/
|
||||||
|
fun String.toHexByteArray(): ByteArray = BaseType.BASE16.decode(this.lowercase())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前数组的指定范围复制到目标数组
|
||||||
|
*
|
||||||
|
* @param dest 目标数组
|
||||||
|
* @param srcPos 源数组起始位置(包含)
|
||||||
|
* @param distPos 目标数组起始位置(包含)
|
||||||
|
* @param len 要复制的元素数量
|
||||||
|
* @return 源数组自身(支持链式调用)
|
||||||
|
* @throws IndexOutOfBoundsException 如果索引超出范围
|
||||||
|
* @throws IllegalArgumentException 如果参数无效
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun <T> Array<T>.copyTo(dest: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 创建新数组并复制当前数组的指定范围
|
||||||
|
*
|
||||||
|
* @param srcPos 源数组起始位置(包含)
|
||||||
|
* @param distPos 目标数组起始位置(包含)
|
||||||
|
* @param len 要复制的元素数量,也作为新数组的长度
|
||||||
|
* @return 新创建的数组
|
||||||
|
* @throws IndexOutOfBoundsException 如果索引超出范围
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun <T> Array<T>.copyTo(srcPos: Int, distPos: Int, len: Int): Array<T> =
|
||||||
|
java.lang.reflect.Array.newInstance(this.javaClass.componentType, len).also {
|
||||||
|
System.arraycopy(this, srcPos, it, distPos, len)
|
||||||
|
}.let {
|
||||||
|
@Suppress("UNCHECKED_CAST")
|
||||||
|
it as Array<T>
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将源数组的指定范围复制到当前数组
|
||||||
|
*
|
||||||
|
* @param src 源数组
|
||||||
|
* @param srcPos 源数组起始位置(包含)
|
||||||
|
* @param distPos 当前数组起始位置(包含)
|
||||||
|
* @param len 要复制的元素数量
|
||||||
|
* @return 当前数组自身(支持链式调用)
|
||||||
|
* @throws IndexOutOfBoundsException 如果索引超出范围
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun <T> Array<T>.copyFrom(src: Array<T>, srcPos: Int, distPos: Int, len: Int): Array<T> = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== BooleanArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun BooleanArray.copyTo(dest: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun BooleanArray.copyTo(srcPos: Int, distPos: Int, len: Int): BooleanArray =
|
||||||
|
BooleanArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun BooleanArray.copyFrom(src: BooleanArray, srcPos: Int, distPos: Int, len: Int): BooleanArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== ByteArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun ByteArray.copyTo(dest: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun ByteArray.copyTo(srcPos: Int, distPos: Int, len: Int): ByteArray =
|
||||||
|
ByteArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun ByteArray.copyFrom(src: ByteArray, srcPos: Int, distPos: Int, len: Int): ByteArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== CharArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun CharArray.copyTo(dest: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun CharArray.copyTo(srcPos: Int, distPos: Int, len: Int): CharArray =
|
||||||
|
CharArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun CharArray.copyFrom(src: CharArray, srcPos: Int, distPos: Int, len: Int): CharArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== DoubleArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun DoubleArray.copyTo(dest: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun DoubleArray.copyTo(srcPos: Int, distPos: Int, len: Int): DoubleArray =
|
||||||
|
DoubleArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun DoubleArray.copyFrom(src: DoubleArray, srcPos: Int, distPos: Int, len: Int): DoubleArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== FloatArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun FloatArray.copyTo(dest: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun FloatArray.copyTo(srcPos: Int, distPos: Int, len: Int): FloatArray =
|
||||||
|
FloatArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun FloatArray.copyFrom(src: FloatArray, srcPos: Int, distPos: Int, len: Int): FloatArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== IntArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun IntArray.copyTo(dest: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun IntArray.copyTo(srcPos: Int, distPos: Int, len: Int): IntArray =
|
||||||
|
IntArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun IntArray.copyFrom(src: IntArray, srcPos: Int, distPos: Int, len: Int): IntArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== LongArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun LongArray.copyTo(dest: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun LongArray.copyTo(srcPos: Int, distPos: Int, len: Int): LongArray =
|
||||||
|
LongArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun LongArray.copyFrom(src: LongArray, srcPos: Int, distPos: Int, len: Int): LongArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/* ==================== ShortArray 扩展 ==================== */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.0
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun ShortArray.copyTo(dest: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
|
||||||
|
System.arraycopy(this, srcPos, dest, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyTo
|
||||||
|
* @since 4.6.2
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopy")
|
||||||
|
fun ShortArray.copyTo(srcPos: Int, distPos: Int, len: Int): ShortArray =
|
||||||
|
ShortArray(len).also { newArray ->
|
||||||
|
System.arraycopy(this, srcPos, newArray, distPos, len)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @see Array.copyFrom
|
||||||
|
* @since 4.6.1
|
||||||
|
*/
|
||||||
|
@JvmName("arrayCopyFrom")
|
||||||
|
fun ShortArray.copyFrom(src: ShortArray, srcPos: Int, distPos: Int, len: Int): ShortArray = this.also {
|
||||||
|
System.arraycopy(src, srcPos, this, distPos, len)
|
||||||
|
}
|
||||||
@@ -0,0 +1,73 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base10Codec.kt
|
||||||
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
import java.math.BigInteger
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base10 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 提供字节数组与十进制字符串之间的相互转换功能,基于 [BigInteger] 实现。
|
||||||
|
*/
|
||||||
|
internal class Base10Codec : BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为Base10字符串(十进制)
|
||||||
|
*
|
||||||
|
* @param bytes 需要编码的字节数组
|
||||||
|
* @return 编码后的Base10字符串(十进制数字)
|
||||||
|
*/
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
if (bytes.isEmpty()) return "0"
|
||||||
|
|
||||||
|
// 将字节数组转换为正的大整数
|
||||||
|
val bigInt = BigInteger(1, bytes) // 参数1表示正数
|
||||||
|
return bigInt.toString(10) // 转换为10进制字符串
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将Base10字符串解码为字节数组
|
||||||
|
*
|
||||||
|
* @param string 需要解码的Base10字符串(十进制数字)
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
// 验证输入是否为有效的十进制数字
|
||||||
|
if (!string.matches(Regex("\\d+"))) {
|
||||||
|
throw IllegalArgumentException("Base10字符串只能包含数字0-9")
|
||||||
|
}
|
||||||
|
|
||||||
|
val bigInt = BigInteger(string, 10) // 从10进制解析
|
||||||
|
|
||||||
|
// 转换为字节数组,并确保保留前导零
|
||||||
|
var byteArray = bigInt.toByteArray()
|
||||||
|
|
||||||
|
// BigInteger.toByteArray() 可能会添加一个符号字节
|
||||||
|
// 对于正数,如果第一个字节是0,需要移除它
|
||||||
|
if (byteArray.isNotEmpty() && byteArray[0] == 0.toByte()) {
|
||||||
|
byteArray = byteArray.copyOfRange(1, byteArray.size)
|
||||||
|
}
|
||||||
|
|
||||||
|
return byteArray
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base16Codec.kt
|
||||||
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base16编解码器实现类
|
||||||
|
* 提供字节数组与十六进制字符串之间的相互转换功能
|
||||||
|
*/
|
||||||
|
internal class Base16Codec : BaseCodec {
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为十六进制字符串
|
||||||
|
* @param bytes 待编码的字节数组
|
||||||
|
* @return 编码后的十六进制字符串,每个字节对应两位十六进制字符
|
||||||
|
*/
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
// 将每个字节转换为两位十六进制字符串并拼接
|
||||||
|
return bytes.joinToString("") {
|
||||||
|
it.toInt().and(0xff).toString(16).padStart(2, '0')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将十六进制字符串解码为字节数组
|
||||||
|
* @param string 待解码的十六进制字符串
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
// 按每两个字符分组,转换为字节
|
||||||
|
return string.chunked(2).map {
|
||||||
|
it.toInt(16).toByte()
|
||||||
|
}.toByteArray()
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,329 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base256Codec.kt
|
||||||
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base256 字符集 256个
|
||||||
|
*
|
||||||
|
* 256个字符 要字符集的下面复制
|
||||||
|
*
|
||||||
|
* !#$%&()*+,-./0123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[]^_`abcdefghijklmnopqrstuvwxyz{|}~§±×÷←↑→↓⇒⇔∀∃∅∆∇∈∉∋∌∏∑−∓∕∗∘∙√∛∜∞∟∠∣∥∧∨∩∪∫∬∭∮∯∰∱∲∳∴∵∶∷≈≠≡≤≥≦≧≪≫≺≻⊂⊃⊆⊇⊈⊉⊊⊋⊕⊖⊗⊘⊙⊚⊛⊜⊝⊞⊟⊠⊡⊢⊣⊤⊥⊦⊧⊨⊩⊪⊫⊬⊭⊮⊯⋀⋁⋂⋃⋄⋅⋆⋇⋈⋉⋊⋋⋌⋍⋎⋏⋐⋑⋒⋓⋔⋕⋖⋗⋘⋙⋚⋛⋜⋝⋞⋟⋠⋡⋢⋣⋤⋥⋦⋧⋨⋩▁▂▃▄▅▆▇█▉▊▋▌▍▎▏▐░▒▓▔▕▖▗▘▙
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
internal class Base256Codec : BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 伴生对象,持有 Base256 的编码字符集及其反向索引表。
|
||||||
|
*/
|
||||||
|
companion object {
|
||||||
|
/**
|
||||||
|
* Base256 编码字符集,共 256 个字符,数组索引即对应的字节值(0~255)。
|
||||||
|
*/
|
||||||
|
val code = arrayOf(
|
||||||
|
'!',
|
||||||
|
'#',
|
||||||
|
'$',
|
||||||
|
'%',
|
||||||
|
'&',
|
||||||
|
'(',
|
||||||
|
')',
|
||||||
|
'*',
|
||||||
|
'+',
|
||||||
|
',',
|
||||||
|
'-',
|
||||||
|
'.',
|
||||||
|
'/',
|
||||||
|
'0',
|
||||||
|
'1',
|
||||||
|
'2',
|
||||||
|
'3',
|
||||||
|
'4',
|
||||||
|
'5',
|
||||||
|
'6',
|
||||||
|
'7',
|
||||||
|
'8',
|
||||||
|
'9',
|
||||||
|
':',
|
||||||
|
';',
|
||||||
|
'<',
|
||||||
|
'=',
|
||||||
|
'>',
|
||||||
|
'?',
|
||||||
|
'@',
|
||||||
|
'A',
|
||||||
|
'B',
|
||||||
|
'C',
|
||||||
|
'D',
|
||||||
|
'E',
|
||||||
|
'F',
|
||||||
|
'G',
|
||||||
|
'H',
|
||||||
|
'I',
|
||||||
|
'J',
|
||||||
|
'K',
|
||||||
|
'L',
|
||||||
|
'M',
|
||||||
|
'N',
|
||||||
|
'O',
|
||||||
|
'P',
|
||||||
|
'Q',
|
||||||
|
'R',
|
||||||
|
'S',
|
||||||
|
'T',
|
||||||
|
'U',
|
||||||
|
'V',
|
||||||
|
'W',
|
||||||
|
'X',
|
||||||
|
'Y',
|
||||||
|
'Z',
|
||||||
|
'[',
|
||||||
|
']',
|
||||||
|
'^',
|
||||||
|
'_',
|
||||||
|
'`',
|
||||||
|
'a',
|
||||||
|
'b',
|
||||||
|
'c',
|
||||||
|
'd',
|
||||||
|
'e',
|
||||||
|
'f',
|
||||||
|
'g',
|
||||||
|
'h',
|
||||||
|
'i',
|
||||||
|
'j',
|
||||||
|
'k',
|
||||||
|
'l',
|
||||||
|
'm',
|
||||||
|
'n',
|
||||||
|
'o',
|
||||||
|
'p',
|
||||||
|
'q',
|
||||||
|
'r',
|
||||||
|
's',
|
||||||
|
't',
|
||||||
|
'u',
|
||||||
|
'v',
|
||||||
|
'w',
|
||||||
|
'x',
|
||||||
|
'y',
|
||||||
|
'z',
|
||||||
|
'{',
|
||||||
|
'|',
|
||||||
|
'}',
|
||||||
|
'~',
|
||||||
|
'§',
|
||||||
|
'±',
|
||||||
|
'×',
|
||||||
|
'÷',
|
||||||
|
'←',
|
||||||
|
'↑',
|
||||||
|
'→',
|
||||||
|
'↓',
|
||||||
|
'⇒',
|
||||||
|
'⇔',
|
||||||
|
'∀',
|
||||||
|
'∃',
|
||||||
|
'∅',
|
||||||
|
'∆',
|
||||||
|
'∇',
|
||||||
|
'∈',
|
||||||
|
'∉',
|
||||||
|
'∋',
|
||||||
|
'∌',
|
||||||
|
'∏',
|
||||||
|
'∑',
|
||||||
|
'−',
|
||||||
|
'∓',
|
||||||
|
'∕',
|
||||||
|
'∗',
|
||||||
|
'∘',
|
||||||
|
'∙',
|
||||||
|
'√',
|
||||||
|
'∛',
|
||||||
|
'∜',
|
||||||
|
'∞',
|
||||||
|
'∟',
|
||||||
|
'∠',
|
||||||
|
'∣',
|
||||||
|
'∥',
|
||||||
|
'∧',
|
||||||
|
'∨',
|
||||||
|
'∩',
|
||||||
|
'∪',
|
||||||
|
'∫',
|
||||||
|
'∬',
|
||||||
|
'∭',
|
||||||
|
'∮',
|
||||||
|
'∯',
|
||||||
|
'∰',
|
||||||
|
'∱',
|
||||||
|
'∲',
|
||||||
|
'∳',
|
||||||
|
'∴',
|
||||||
|
'∵',
|
||||||
|
'∶',
|
||||||
|
'∷',
|
||||||
|
'≈',
|
||||||
|
'≠',
|
||||||
|
'≡',
|
||||||
|
'≤',
|
||||||
|
'≥',
|
||||||
|
'≦',
|
||||||
|
'≧',
|
||||||
|
'≪',
|
||||||
|
'≫',
|
||||||
|
'≺',
|
||||||
|
'≻',
|
||||||
|
'⊂',
|
||||||
|
'⊃',
|
||||||
|
'⊆',
|
||||||
|
'⊇',
|
||||||
|
'⊈',
|
||||||
|
'⊉',
|
||||||
|
'⊊',
|
||||||
|
'⊋',
|
||||||
|
'⊕',
|
||||||
|
'⊖',
|
||||||
|
'⊗',
|
||||||
|
'⊘',
|
||||||
|
'⊙',
|
||||||
|
'⊚',
|
||||||
|
'⊛',
|
||||||
|
'⊜',
|
||||||
|
'⊝',
|
||||||
|
'⊞',
|
||||||
|
'⊟',
|
||||||
|
'⊠',
|
||||||
|
'⊡',
|
||||||
|
'⊢',
|
||||||
|
'⊣',
|
||||||
|
'⊤',
|
||||||
|
'⊥',
|
||||||
|
'⊦',
|
||||||
|
'⊧',
|
||||||
|
'⊨',
|
||||||
|
'⊩',
|
||||||
|
'⊪',
|
||||||
|
'⊫',
|
||||||
|
'⊬',
|
||||||
|
'⊭',
|
||||||
|
'⊮',
|
||||||
|
'⊯',
|
||||||
|
'⋀',
|
||||||
|
'⋁',
|
||||||
|
'⋂',
|
||||||
|
'⋃',
|
||||||
|
'⋄',
|
||||||
|
'⋅',
|
||||||
|
'⋆',
|
||||||
|
'⋇',
|
||||||
|
'⋈',
|
||||||
|
'⋉',
|
||||||
|
'⋊',
|
||||||
|
'⋋',
|
||||||
|
'⋌',
|
||||||
|
'⋍',
|
||||||
|
'⋎',
|
||||||
|
'⋏',
|
||||||
|
'⋐',
|
||||||
|
'⋑',
|
||||||
|
'⋒',
|
||||||
|
'⋓',
|
||||||
|
'⋔',
|
||||||
|
'⋕',
|
||||||
|
'⋖',
|
||||||
|
'⋗',
|
||||||
|
'⋘',
|
||||||
|
'⋙',
|
||||||
|
'⋚',
|
||||||
|
'⋛',
|
||||||
|
'⋜',
|
||||||
|
'⋝',
|
||||||
|
'⋞',
|
||||||
|
'⋟',
|
||||||
|
'⋠',
|
||||||
|
'⋡',
|
||||||
|
'⋢',
|
||||||
|
'⋣',
|
||||||
|
'⋤',
|
||||||
|
'⋥',
|
||||||
|
'⋦',
|
||||||
|
'⋧',
|
||||||
|
'⋨',
|
||||||
|
'⋩',
|
||||||
|
'▁',
|
||||||
|
'▂',
|
||||||
|
'▃',
|
||||||
|
'▄',
|
||||||
|
'▅',
|
||||||
|
'▆',
|
||||||
|
'▇',
|
||||||
|
'█',
|
||||||
|
'▉',
|
||||||
|
'▊',
|
||||||
|
'▋',
|
||||||
|
'▌',
|
||||||
|
'▍',
|
||||||
|
'▎',
|
||||||
|
'▏',
|
||||||
|
'▐',
|
||||||
|
'░',
|
||||||
|
'▒',
|
||||||
|
'▓',
|
||||||
|
'▔',
|
||||||
|
'▕',
|
||||||
|
'▖',
|
||||||
|
'▗',
|
||||||
|
'▘',
|
||||||
|
'▙'
|
||||||
|
)
|
||||||
|
/**
|
||||||
|
* 字符到字节值的反向映射表,用于解码时快速查找字符对应的索引。
|
||||||
|
*/
|
||||||
|
val codeMap = code.mapIndexed { index, c -> c to index }.toMap()
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
val result = CharArray(bytes.size)
|
||||||
|
for (i in bytes.indices) {
|
||||||
|
val unsignedByte = bytes[i].toInt() and 0xFF
|
||||||
|
result[i] = code[unsignedByte]
|
||||||
|
}
|
||||||
|
return String(result)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 Base256 字符串解码为字节数组。
|
||||||
|
*
|
||||||
|
* @param string 待解码的字符串,所有字符必须属于编码字符集
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
* @throws NullPointerException 如果字符串中包含字符集之外的字符
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
val result = ByteArray(string.length)
|
||||||
|
for (i in string.indices) {
|
||||||
|
result[i] = codeMap[string[i]]!!.toByte()
|
||||||
|
}
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,71 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base2Codec.kt
|
||||||
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base2 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 提供字节数组与二进制字符串(每字节 8 位,高位在前)之间的相互转换功能。
|
||||||
|
*/
|
||||||
|
internal class Base2Codec : BaseCodec {
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
if (bytes.isEmpty()) return ""
|
||||||
|
val result = StringBuilder()
|
||||||
|
for ((index, byte) in bytes.withIndex()) {
|
||||||
|
val unsignedByte = byte.toInt() and 0xFF
|
||||||
|
val binary = unsignedByte.toString(2).padStart(8, '0')
|
||||||
|
result.append(binary)
|
||||||
|
}
|
||||||
|
return result.toString()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将二进制字符串解码为字节数组。
|
||||||
|
*
|
||||||
|
* @param string 待解码的二进制字符串,长度必须为 8 的倍数且仅包含字符 '0' 和 '1'
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
* @throws IllegalArgumentException 如果字符串长度不是 8 的倍数或包含非法字符
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
if (string.length % 8 != 0) {
|
||||||
|
throw IllegalArgumentException(
|
||||||
|
"BASE1字符串长度必须是8的倍数,当前长度: ${string.length}"
|
||||||
|
)
|
||||||
|
}
|
||||||
|
if (!string.matches(Regex("[01]+"))) {
|
||||||
|
throw IllegalArgumentException(
|
||||||
|
"BASE1字符串只能包含字符'0'和'1'"
|
||||||
|
)
|
||||||
|
}
|
||||||
|
val byteCount = string.length / 8
|
||||||
|
val result = ByteArray(byteCount)
|
||||||
|
for (i in 0 until byteCount) {
|
||||||
|
val startIndex = i * 8
|
||||||
|
val endIndex = startIndex + 8
|
||||||
|
val binaryStr = string.substring(startIndex, endIndex)
|
||||||
|
val byteValue = binaryStr.toInt(2)
|
||||||
|
result[i] = byteValue.toByte()
|
||||||
|
}
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base64Codec.kt
|
||||||
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
import java.util.*
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64编解码工具类
|
||||||
|
* 提供Base64编码和解码功能的实现
|
||||||
|
*/
|
||||||
|
internal class Base64Codec : BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64编码器实例
|
||||||
|
* 用于执行字节数组到Base64字符串的编码操作
|
||||||
|
*/
|
||||||
|
val encoder: Base64.Encoder = Base64.getEncoder()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64解码器实例
|
||||||
|
* 用于执行Base64字符串到字节数组的解码操作
|
||||||
|
*/
|
||||||
|
val decoder: Base64.Decoder = Base64.getDecoder()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为Base64字符串
|
||||||
|
*
|
||||||
|
* @param bytes 待编码的字节数组
|
||||||
|
* @return 编码后的Base64字符串
|
||||||
|
*/
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
return encoder.encodeToString(bytes)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将Base64字符串解码为字节数组
|
||||||
|
*
|
||||||
|
* @param string 待解码的Base64字符串
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
return decoder.decode(string)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,65 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base64NoPaddingCodec.kt
|
||||||
|
* LastUpdate 2026-11-16 14:24:59
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
import java.util.*
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 无填充 Base64 URL 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 使用 URL 安全的 Base64 字母表,编码结果不带末尾的 '=' 填充字符。
|
||||||
|
*/
|
||||||
|
internal class Base64NoPaddingCodec : BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64编码器实例
|
||||||
|
* 用于执行字节数组到Base64字符串的编码操作
|
||||||
|
*/
|
||||||
|
val encoder: Base64.Encoder = Base64.getUrlEncoder().withoutPadding()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64解码器实例
|
||||||
|
* 用于执行Base64字符串到字节数组的解码操作
|
||||||
|
*/
|
||||||
|
val decoder: Base64.Decoder = Base64.getUrlDecoder()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为Base64字符串
|
||||||
|
*
|
||||||
|
* @param bytes 待编码的字节数组
|
||||||
|
* @return 编码后的Base64字符串
|
||||||
|
*/
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
return encoder.encodeToString(bytes)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将Base64字符串解码为字节数组
|
||||||
|
*
|
||||||
|
* @param string 待解码的Base64字符串
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
return decoder.decode(string)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,65 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base64UrlCodec.kt
|
||||||
|
* LastUpdate 2026-11-16 14:24:59
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
import java.util.*
|
||||||
|
|
||||||
|
/**
|
||||||
|
* URL 安全 Base64 编解码器实现类。
|
||||||
|
*
|
||||||
|
* 使用 '-' 和 '_' 替代标准 Base64 中的 '+' 和 '/',适用于 URL 与文件名场景。
|
||||||
|
*/
|
||||||
|
internal class Base64UrlCodec : BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64编码器实例
|
||||||
|
* 用于执行字节数组到Base64字符串的编码操作
|
||||||
|
*/
|
||||||
|
val encoder: Base64.Encoder = Base64.getUrlEncoder()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base64解码器实例
|
||||||
|
* 用于执行Base64字符串到字节数组的解码操作
|
||||||
|
*/
|
||||||
|
val decoder: Base64.Decoder = Base64.getUrlDecoder()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为Base64字符串
|
||||||
|
*
|
||||||
|
* @param bytes 待编码的字节数组
|
||||||
|
* @return 编码后的Base64字符串
|
||||||
|
*/
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
return encoder.encodeToString(bytes)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将Base64字符串解码为字节数组
|
||||||
|
*
|
||||||
|
* @param string 待解码的Base64字符串
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
return decoder.decode(string)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,407 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Base91Codec.kt
|
||||||
|
* LastUpdate 2026-03-12 10:34:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base91 编解码工具类,用于将字节数组编码为 Base91 字符串,或将 Base91 字符串解码为原始字节数组。
|
||||||
|
*
|
||||||
|
* Base91 是一种高效的二进制到文本的编码方式,相较于 Base64,它使用更少的字符来表示相同的数据。
|
||||||
|
*/
|
||||||
|
internal class Base91Codec : BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 伴生对象,持有 Base91 的编码表与解码表。
|
||||||
|
*/
|
||||||
|
companion object {
|
||||||
|
/**
|
||||||
|
* Base91 编码表,共 91 个可打印 ASCII 字符。
|
||||||
|
*/
|
||||||
|
val ENCODING_TABLE: CharArray = charArrayOf(
|
||||||
|
'A', 'B', 'C', 'D', 'E', 'F', 'G', 'H', 'I', 'J', 'K', 'L', 'M',
|
||||||
|
'N', 'O', 'P', 'Q', 'R', 'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
|
||||||
|
'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm',
|
||||||
|
'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z',
|
||||||
|
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', '!', '#', '$',
|
||||||
|
'%', '&', '(', ')', '*', '+', ',', '.', '/', ':', ';', '<', '=',
|
||||||
|
'>', '?', '@', '[', ']', '^', '_', '`', '{', '|', '}', '~', '"'
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base91 解码表,大小为 256,用于快速查找字符对应的数值。
|
||||||
|
* 初始化时将所有元素设为 -1,表示无效字符;然后根据 ENCODING_TABLE 填充有效字符的索引。
|
||||||
|
*/
|
||||||
|
val DECODING_TABLE: Array<Int> = arrayOf(
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
62,
|
||||||
|
90,
|
||||||
|
63,
|
||||||
|
64,
|
||||||
|
65,
|
||||||
|
66,
|
||||||
|
-1,
|
||||||
|
67,
|
||||||
|
68,
|
||||||
|
69,
|
||||||
|
70,
|
||||||
|
71,
|
||||||
|
-1,
|
||||||
|
72,
|
||||||
|
73,
|
||||||
|
52,
|
||||||
|
53,
|
||||||
|
54,
|
||||||
|
55,
|
||||||
|
56,
|
||||||
|
57,
|
||||||
|
58,
|
||||||
|
59,
|
||||||
|
60,
|
||||||
|
61,
|
||||||
|
74,
|
||||||
|
75,
|
||||||
|
76,
|
||||||
|
77,
|
||||||
|
78,
|
||||||
|
79,
|
||||||
|
80,
|
||||||
|
0,
|
||||||
|
1,
|
||||||
|
2,
|
||||||
|
3,
|
||||||
|
4,
|
||||||
|
5,
|
||||||
|
6,
|
||||||
|
7,
|
||||||
|
8,
|
||||||
|
9,
|
||||||
|
10,
|
||||||
|
11,
|
||||||
|
12,
|
||||||
|
13,
|
||||||
|
14,
|
||||||
|
15,
|
||||||
|
16,
|
||||||
|
17,
|
||||||
|
18,
|
||||||
|
19,
|
||||||
|
20,
|
||||||
|
21,
|
||||||
|
22,
|
||||||
|
23,
|
||||||
|
24,
|
||||||
|
25,
|
||||||
|
81,
|
||||||
|
-1,
|
||||||
|
82,
|
||||||
|
83,
|
||||||
|
84,
|
||||||
|
85,
|
||||||
|
26,
|
||||||
|
27,
|
||||||
|
28,
|
||||||
|
29,
|
||||||
|
30,
|
||||||
|
31,
|
||||||
|
32,
|
||||||
|
33,
|
||||||
|
34,
|
||||||
|
35,
|
||||||
|
36,
|
||||||
|
37,
|
||||||
|
38,
|
||||||
|
39,
|
||||||
|
40,
|
||||||
|
41,
|
||||||
|
42,
|
||||||
|
43,
|
||||||
|
44,
|
||||||
|
45,
|
||||||
|
46,
|
||||||
|
47,
|
||||||
|
48,
|
||||||
|
49,
|
||||||
|
50,
|
||||||
|
51,
|
||||||
|
86,
|
||||||
|
87,
|
||||||
|
88,
|
||||||
|
89,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1,
|
||||||
|
-1
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为 Base91 字符串。
|
||||||
|
*
|
||||||
|
* @param bytes 待编码的字节数组
|
||||||
|
* @return 编码后的 Base91 字符串
|
||||||
|
*/
|
||||||
|
override fun encode(bytes: ByteArray): String {
|
||||||
|
if (bytes.isEmpty()) return ""
|
||||||
|
val sb = StringBuilder()
|
||||||
|
var ebq = 0 // 编码缓冲区,用于暂存待处理的位数据
|
||||||
|
var en = 0 // 当前缓冲区中的有效位数
|
||||||
|
|
||||||
|
for (b in bytes) {
|
||||||
|
// 将当前字节加入缓冲区
|
||||||
|
ebq = ebq or ((b.toInt() and 0xFF) shl en)
|
||||||
|
en += 8
|
||||||
|
|
||||||
|
// 每当缓冲区中有超过 13 位的数据时,尝试进行编码
|
||||||
|
if (en > 13) {
|
||||||
|
var ev = ebq and 0x1FFF // 取出低 13 位作为候选值
|
||||||
|
if (ev > 88) {
|
||||||
|
// 如果候选值大于 88,则使用 13 位编码
|
||||||
|
ebq = ebq shr 13
|
||||||
|
en -= 13
|
||||||
|
} else {
|
||||||
|
// 否则使用 14 位编码
|
||||||
|
ev = ebq and 0x3FFF
|
||||||
|
ebq = ebq shr 14
|
||||||
|
en -= 14
|
||||||
|
}
|
||||||
|
// 将两个字符追加到结果中
|
||||||
|
sb.append(ENCODING_TABLE[ev % 91])
|
||||||
|
sb.append(ENCODING_TABLE[ev / 91])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 处理剩余未编码的数据
|
||||||
|
if (en > 0) {
|
||||||
|
sb.append(ENCODING_TABLE[ebq % 91])
|
||||||
|
if (en > 7 || ebq > 90) {
|
||||||
|
sb.append(ENCODING_TABLE[ebq / 91])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return sb.toString()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 Base91 字符串解码为原始字节数组。
|
||||||
|
*
|
||||||
|
* @param string 待解码的 Base91 字符串
|
||||||
|
* @return 解码后的字节数组
|
||||||
|
*/
|
||||||
|
override fun decode(string: String): ByteArray {
|
||||||
|
if (string.isEmpty()) return ByteArray(0)
|
||||||
|
var dbq = 0 // 解码缓冲区,用于暂存待处理的位数据
|
||||||
|
var dn = 0 // 当前缓冲区中的有效位数
|
||||||
|
var dv = -1 // 当前读取到的 Base91 值
|
||||||
|
val buffer = ByteArray(string.length * 13 / 8) // 预分配输出缓冲区
|
||||||
|
var index = 0 // 输出缓冲区写入位置
|
||||||
|
|
||||||
|
for (c in string.toCharArray()) {
|
||||||
|
// 忽略不在编码表中的字符
|
||||||
|
if (DECODING_TABLE[c.code] == -1) continue
|
||||||
|
|
||||||
|
if (dv == -1) {
|
||||||
|
// 第一次读取字符,保存为 dv
|
||||||
|
dv = DECODING_TABLE[c.code]
|
||||||
|
} else {
|
||||||
|
// 第二次读取字符,组合成完整的 Base91 值
|
||||||
|
dv += DECODING_TABLE[c.code] * 91
|
||||||
|
dbq = dbq or (dv shl dn)
|
||||||
|
// 根据值大小判断是 13 位还是 14 位编码
|
||||||
|
dn += if ((dv and 0x1FFF) > 88) 13 else 14
|
||||||
|
|
||||||
|
// 将缓冲区中完整的字节写入输出数组
|
||||||
|
do {
|
||||||
|
buffer[index++] = (dbq and 0xFF).toByte()
|
||||||
|
dbq = dbq shr 8
|
||||||
|
dn -= 8
|
||||||
|
} while (dn > 7)
|
||||||
|
|
||||||
|
dv = -1 // 重置 dv,准备下一轮读取
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 处理最后剩余的一个字符(如果存在)
|
||||||
|
if (dv != -1) {
|
||||||
|
buffer[index++] = ((dbq or (dv shl dn)) and 0xFF).toByte()
|
||||||
|
}
|
||||||
|
|
||||||
|
// 返回实际使用的部分
|
||||||
|
return buffer.copyOf(index)
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,178 @@
|
|||||||
|
/*
|
||||||
|
* 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 BaseCodec.kt
|
||||||
|
* LastUpdate 2026-10-11 16:52:16
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.exception.CodecException
|
||||||
|
import java.io.File
|
||||||
|
import java.nio.file.Path
|
||||||
|
|
||||||
|
/**
|
||||||
|
* BaseCodec 接口定义了一组用于编码和解码数据的基本方法。
|
||||||
|
* 提供了对字节数组、字符串、文件和路径的编码与解码功能,
|
||||||
|
* 并支持安全操作(在发生异常时返回默认值或布尔状态)。
|
||||||
|
*/
|
||||||
|
interface BaseCodec {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对字节数组进行编码,并捕获可能发生的异常。
|
||||||
|
*
|
||||||
|
* @param bytes 需要编码的字节数组
|
||||||
|
* @return 编码后的字符串结果
|
||||||
|
* @throws CodecException 如果编码过程中发生异常
|
||||||
|
*/
|
||||||
|
fun catchEncode(bytes: ByteArray) = try {
|
||||||
|
encode(bytes)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
throw CodecException(throwable = e)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对字符串进行解码,并捕获可能发生的异常。
|
||||||
|
*
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
* @return 解码后的字节数组结果
|
||||||
|
* @throws CodecException 如果解码过程中发生异常
|
||||||
|
*/
|
||||||
|
fun catchDecode(string: String) = try {
|
||||||
|
decode(string)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
throw CodecException(throwable = e)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组编码为字符串。
|
||||||
|
*
|
||||||
|
* @param bytes 需要编码的字节数组
|
||||||
|
* @return 编码后的字符串结果
|
||||||
|
*/
|
||||||
|
fun encode(bytes: ByteArray): String
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字符串解码为字节数组。
|
||||||
|
*
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
* @return 解码后的字节数组结果
|
||||||
|
*/
|
||||||
|
fun decode(string: String): ByteArray
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对文件内容进行编码。
|
||||||
|
*
|
||||||
|
* @param file 需要编码的文件对象
|
||||||
|
* @return 文件内容编码后的字符串结果
|
||||||
|
*/
|
||||||
|
fun encode(file: File) = catchEncode(file.readBytes())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字符串解码后写入指定文件。
|
||||||
|
*
|
||||||
|
* @param file 目标文件对象
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
*/
|
||||||
|
fun decode(file: File, string: String) =
|
||||||
|
file.writeBytes(catchDecode(string))
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 安全地对文件内容进行编码,如果发生异常则返回 null。
|
||||||
|
*
|
||||||
|
* @param file 需要编码的文件对象
|
||||||
|
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
||||||
|
*/
|
||||||
|
fun encodeSafe(file: File) = try {
|
||||||
|
encode(file)
|
||||||
|
} catch (_: Exception) {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 安全地将字符串解码并写入指定文件,如果成功则返回 true,否则返回 false。
|
||||||
|
*
|
||||||
|
* @param file 目标文件对象
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
* @return 操作是否成功的布尔值
|
||||||
|
*/
|
||||||
|
fun decodeSafe(file: File, string: String) = try {
|
||||||
|
decode(file, string)
|
||||||
|
true
|
||||||
|
} catch (_: Exception) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对路径指向的文件内容进行编码。
|
||||||
|
*
|
||||||
|
* @param path 需要编码的文件路径
|
||||||
|
* @return 文件内容编码后的字符串结果
|
||||||
|
*/
|
||||||
|
fun encode(path: Path) = catchEncode(path.toFile().readBytes())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字符串解码后写入指定路径的文件。
|
||||||
|
*
|
||||||
|
* @param path 目标文件路径
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
*/
|
||||||
|
fun decode(path: Path, string: String) = path.toFile().writeBytes(catchDecode(string))
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 安全地对路径指向的文件内容进行编码,如果发生异常则返回 null。
|
||||||
|
*
|
||||||
|
* @param path 需要编码的文件路径
|
||||||
|
* @return 文件内容编码后的字符串结果,若失败则返回 null
|
||||||
|
*/
|
||||||
|
fun encodeSafe(path: Path) = try {
|
||||||
|
encode(path)
|
||||||
|
} catch (_: Exception) {
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 安全地将字符串解码并写入指定路径的文件,如果成功则返回 true,否则返回 false。
|
||||||
|
*
|
||||||
|
* @param path 目标文件路径
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
* @return 操作是否成功的布尔值
|
||||||
|
*/
|
||||||
|
fun decodeSafe(path: Path, string: String) = try {
|
||||||
|
decode(path, string)
|
||||||
|
true
|
||||||
|
} catch (_: Exception) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对字符串进行编码。
|
||||||
|
*
|
||||||
|
* @param string 需要编码的字符串
|
||||||
|
* @return 编码后的字符串结果
|
||||||
|
*/
|
||||||
|
fun encode(string: String) = catchEncode(string.toByteArray())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字符串解码为 UTF-8 格式的字符串。
|
||||||
|
*
|
||||||
|
* @param string 需要解码的字符串
|
||||||
|
* @return 解码后的 UTF-8 字符串结果
|
||||||
|
*/
|
||||||
|
fun decodetoString(string: String) = catchDecode(string).toString(Charsets.UTF_8)
|
||||||
|
}
|
||||||
@@ -0,0 +1,70 @@
|
|||||||
|
/*
|
||||||
|
* 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 BaseType.kt
|
||||||
|
* LastUpdate 2026-11-16 14:21:51
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.base.code.BASE10 as CODE_BASE10
|
||||||
|
import com.mingliqiye.utils.base.code.BASE16 as CODE_BASE16
|
||||||
|
import com.mingliqiye.utils.base.code.BASE2 as CODE_BASE2
|
||||||
|
import com.mingliqiye.utils.base.code.BASE256 as CODE_BASE256
|
||||||
|
import com.mingliqiye.utils.base.code.BASE64 as CODE_BASE64
|
||||||
|
import com.mingliqiye.utils.base.code.BASE64_NO_PADDING as CODE_BASE64_NO_PADDING
|
||||||
|
import com.mingliqiye.utils.base.code.BASE64_URL as CODE_BASE64_URL
|
||||||
|
import com.mingliqiye.utils.base.code.BASE91 as CODE_BASE91
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Base 编码类型枚举。
|
||||||
|
*
|
||||||
|
* 每个枚举项持有一个编解码器的工厂函数,枚举本身实现了 [BaseCodec],
|
||||||
|
* 可直接作为编解码器使用,编码与解码操作委托给对应的编解码器实例。
|
||||||
|
*
|
||||||
|
* @param baseCodec 编解码器的工厂函数,每次访问 [codec] 时调用以创建实例
|
||||||
|
*/
|
||||||
|
enum class BaseType(private val baseCodec: () -> BaseCodec) : BaseCodec {
|
||||||
|
|
||||||
|
/** 二进制(Base2)编解码。 */
|
||||||
|
BASE2(::CODE_BASE2),
|
||||||
|
/** 十进制(Base10)编解码。 */
|
||||||
|
BASE10(::CODE_BASE10),
|
||||||
|
/** 十六进制(Base16)编解码。 */
|
||||||
|
BASE16(::CODE_BASE16),
|
||||||
|
/** 标准 Base64 编解码。 */
|
||||||
|
BASE64(::CODE_BASE64),
|
||||||
|
/** URL 安全的 Base64 编解码。 */
|
||||||
|
BASE64_URL(::CODE_BASE64_URL),
|
||||||
|
/** 无填充(不带末尾 '=')的 URL 安全 Base64 编解码。 */
|
||||||
|
BASE64_NO_PADDING(::CODE_BASE64_NO_PADDING),
|
||||||
|
/** Base91 编解码。 */
|
||||||
|
BASE91(::CODE_BASE91),
|
||||||
|
/** Base256 编解码。 */
|
||||||
|
BASE256(::CODE_BASE256);
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前类型对应的编解码器实例(每次访问都会通过工厂函数新建)。
|
||||||
|
*/
|
||||||
|
val codec
|
||||||
|
get() = baseCodec()
|
||||||
|
|
||||||
|
override fun encode(bytes: ByteArray) = codec.encode(bytes)
|
||||||
|
override fun decode(string: String) = codec.decode(string)
|
||||||
|
|
||||||
|
}
|
||||||
@@ -0,0 +1,100 @@
|
|||||||
|
/*
|
||||||
|
* 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 BaseCodes.kt
|
||||||
|
* LastUpdate 2026-11-16 14:10:57
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
@file:JvmName("BaseCodes")
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.base.code
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.base.*
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base2编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为二进制格式。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base2")
|
||||||
|
val BASE2: BaseCodec by lazy {
|
||||||
|
Base2Codec()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base10编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为十进制格式。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base10")
|
||||||
|
val BASE10: BaseCodec by lazy {
|
||||||
|
Base10Codec()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base16编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为十六进制格式。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base16")
|
||||||
|
val BASE16: BaseCodec by lazy {
|
||||||
|
Base16Codec()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base64编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为Base64格式,常用于URL安全传输或存储。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base64")
|
||||||
|
val BASE64: BaseCodec by lazy {
|
||||||
|
Base64Codec()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base64 URL编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为URL安全的Base64格式。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base64Url")
|
||||||
|
val BASE64_URL: BaseCodec by lazy {
|
||||||
|
Base64UrlCodec()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供无填充Base64 URL编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为URL安全的Base64格式,且结果不带末尾的'='填充字符。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base64NoPadding")
|
||||||
|
val BASE64_NO_PADDING: BaseCodec by lazy {
|
||||||
|
Base64NoPaddingCodec()
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base91编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为Base91格式,具有较高的压缩效率。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base91")
|
||||||
|
val BASE91: BaseCodec by lazy {
|
||||||
|
Base91Codec()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 提供Base256编码器的懒加载实例。
|
||||||
|
* 该编码器用于将数据编码为Base256格式,适用于字节级数据处理。
|
||||||
|
*/
|
||||||
|
@get:JvmName("base256")
|
||||||
|
val BASE256: BaseCodec by lazy {
|
||||||
|
Base256Codec()
|
||||||
|
}
|
||||||
@@ -1,160 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright 2025 mingliqiye
|
|
||||||
*
|
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
* you may not use this file except in compliance with the License.
|
|
||||||
* You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*
|
|
||||||
* ProjectName mingli-utils
|
|
||||||
* ModuleName mingli-utils.main
|
|
||||||
* CurrentFile Base64Utils.kt
|
|
||||||
* LastUpdate 2025-09-15 22:32:50
|
|
||||||
* UpdateUser MingLiPro
|
|
||||||
*/
|
|
||||||
@file:JvmName("Base64Utils")
|
|
||||||
|
|
||||||
package com.mingliqiye.utils.base64
|
|
||||||
|
|
||||||
import java.io.File
|
|
||||||
import java.io.IOException
|
|
||||||
import java.nio.file.Path
|
|
||||||
import java.util.*
|
|
||||||
|
|
||||||
val BASE_64_ENCODER: Base64.Encoder = Base64.getEncoder()
|
|
||||||
val BASE_64_DECODER: Base64.Decoder = Base64.getDecoder()
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将字节数组编码为Base64字符串
|
|
||||||
*
|
|
||||||
* @param bytes 需要编码的字节数组
|
|
||||||
* @return 编码后的Base64字符串
|
|
||||||
*/
|
|
||||||
fun encode(bytes: ByteArray): String {
|
|
||||||
return BASE_64_ENCODER.encodeToString(bytes)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将Base64字符串解码为字节数组
|
|
||||||
*
|
|
||||||
* @param string 需要解码的Base64字符串
|
|
||||||
* @return 解码后的字节数组
|
|
||||||
*/
|
|
||||||
fun decode(string: String): ByteArray {
|
|
||||||
return BASE_64_DECODER.decode(string)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将文件内容编码为Base64字符串
|
|
||||||
*
|
|
||||||
* @param file 需要编码的文件
|
|
||||||
* @return 文件内容的Base64编码字符串
|
|
||||||
* @throws IOException 当文件读取失败时抛出
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
|
||||||
fun encode(file: File): String {
|
|
||||||
return encode(file.readBytes())
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将Base64字符串解码并写入文件
|
|
||||||
*
|
|
||||||
* @param file 目标文件
|
|
||||||
* @param string 需要解码的Base64字符串
|
|
||||||
* @throws IOException 当文件写入失败时抛出
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
|
||||||
fun decode(file: File, string: String) {
|
|
||||||
file.writeBytes(decode(string))
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 安全地将文件内容编码为Base64字符串,出现异常时返回null
|
|
||||||
*
|
|
||||||
* @param file 需要编码的文件
|
|
||||||
* @return 文件内容的Base64编码字符串,失败时返回null
|
|
||||||
*/
|
|
||||||
fun encodeSafe(file: File): String? {
|
|
||||||
return try {
|
|
||||||
encode(file)
|
|
||||||
} catch (_: Exception) {
|
|
||||||
null
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 安全地将Base64字符串解码并写入文件,返回操作是否成功
|
|
||||||
*
|
|
||||||
* @param file 目标文件
|
|
||||||
* @param string 需要解码的Base64字符串
|
|
||||||
* @return 操作成功返回true,失败返回false
|
|
||||||
*/
|
|
||||||
fun decodeSafe(file: File, string: String): Boolean {
|
|
||||||
return try {
|
|
||||||
decode(file, string)
|
|
||||||
true
|
|
||||||
} catch (_: Exception) {
|
|
||||||
false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将路径对应的文件内容编码为Base64字符串
|
|
||||||
*
|
|
||||||
* @param path 需要编码的文件路径
|
|
||||||
* @return 文件内容的Base64编码字符串
|
|
||||||
* @throws IOException 当文件读取失败时抛出
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
|
||||||
fun encode(path: Path): String {
|
|
||||||
return encode(path.toFile().readBytes())
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将Base64字符串解码并写入路径指定的文件
|
|
||||||
*
|
|
||||||
* @param path 目标文件路径
|
|
||||||
* @param string 需要解码的Base64字符串
|
|
||||||
* @throws IOException 当文件写入失败时抛出
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
|
||||||
fun decode(path: Path, string: String) {
|
|
||||||
path.toFile().writeBytes(decode(string))
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 安全地将路径对应的文件内容编码为Base64字符串,出现异常时返回null
|
|
||||||
*
|
|
||||||
* @param path 需要编码的文件路径
|
|
||||||
* @return 文件内容的Base64编码字符串,失败时返回null
|
|
||||||
*/
|
|
||||||
fun encodeSafe(path: Path): String? {
|
|
||||||
return try {
|
|
||||||
encode(path)
|
|
||||||
} catch (_: Exception) {
|
|
||||||
null
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 安全地将Base64字符串解码并写入路径指定的文件,返回操作是否成功
|
|
||||||
*
|
|
||||||
* @param path 目标文件路径
|
|
||||||
* @param string 需要解码的Base64字符串
|
|
||||||
* @return 操作成功返回true,失败返回false
|
|
||||||
*/
|
|
||||||
fun decodeSafe(path: Path, string: String): Boolean {
|
|
||||||
return try {
|
|
||||||
decode(path, string)
|
|
||||||
true
|
|
||||||
} catch (_: Exception) {
|
|
||||||
false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -0,0 +1,97 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2025 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile BCrypt.kt
|
||||||
|
* LastUpdate 2025-09-19 20:17:41
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
@file:JvmName("BCrypt")
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.bcrypt
|
||||||
|
|
||||||
|
|
||||||
|
import java.security.SecureRandom
|
||||||
|
import org.mindrot.jbcrypt.BCrypt as JBCrypt
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用随机生成的盐对字符串进行 BCrypt 哈希。
|
||||||
|
*
|
||||||
|
* @param string 需要哈希的明文字符串
|
||||||
|
* @return BCrypt 哈希字符串
|
||||||
|
*/
|
||||||
|
fun hashpw(string: String): String {
|
||||||
|
return hashpw(string, gensalt())
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用指定的盐对字符串进行 BCrypt 哈希。
|
||||||
|
*
|
||||||
|
* @param string 需要哈希的明文字符串
|
||||||
|
* @param salt BCrypt 盐字符串,默认随机生成
|
||||||
|
* @return BCrypt 哈希字符串
|
||||||
|
*/
|
||||||
|
fun hashpw(string: String, salt: String = gensalt()): String {
|
||||||
|
return JBCrypt.hashpw(string, salt)
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 验证明文字符串与 BCrypt 哈希是否匹配。
|
||||||
|
*
|
||||||
|
* @param string 明文字符串
|
||||||
|
* @param bcrypted 已生成的 BCrypt 哈希字符串
|
||||||
|
* @return 匹配返回 true,否则返回 false
|
||||||
|
*/
|
||||||
|
fun checkpw(string: String, bcrypted: String): Boolean {
|
||||||
|
return JBCrypt.checkpw(string, bcrypted)
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 生成默认工作因子(10)的 BCrypt 盐。
|
||||||
|
*
|
||||||
|
* @return BCrypt 盐字符串
|
||||||
|
*/
|
||||||
|
fun gensalt(): String {
|
||||||
|
return JBCrypt.gensalt()
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 生成指定工作因子的 BCrypt 盐。
|
||||||
|
*
|
||||||
|
* @param long 工作因子(log2 迭代次数),值越大计算越慢
|
||||||
|
* @return BCrypt 盐字符串
|
||||||
|
*/
|
||||||
|
fun gensalt(long: Int): String {
|
||||||
|
return JBCrypt.gensalt(long)
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用指定的安全随机数生成器生成 BCrypt 盐。
|
||||||
|
*
|
||||||
|
* @param long 工作因子(log2 迭代次数)
|
||||||
|
* @param secureRandom 用于生成盐的安全随机数生成器
|
||||||
|
* @return BCrypt 盐字符串
|
||||||
|
*/
|
||||||
|
fun gensalt(long: Int, secureRandom: SecureRandom): String {
|
||||||
|
return JBCrypt.gensalt(long, secureRandom)
|
||||||
|
}
|
||||||
@@ -1,241 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright 2025 mingliqiye
|
|
||||||
*
|
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
* you may not use this file except in compliance with the License.
|
|
||||||
* You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*
|
|
||||||
* ProjectName mingli-utils
|
|
||||||
* ModuleName mingli-utils.main
|
|
||||||
* CurrentFile Factory.kt
|
|
||||||
* LastUpdate 2025-09-15 22:32:50
|
|
||||||
* UpdateUser MingLiPro
|
|
||||||
*/
|
|
||||||
@file:JvmName("Factory")
|
|
||||||
|
|
||||||
package com.mingliqiye.utils.bean
|
|
||||||
|
|
||||||
import com.mingliqiye.utils.bean.annotation.ComponentBean
|
|
||||||
import com.mingliqiye.utils.bean.annotation.InjectBean
|
|
||||||
import java.io.File
|
|
||||||
import java.net.URL
|
|
||||||
import java.util.*
|
|
||||||
import java.util.concurrent.ConcurrentHashMap
|
|
||||||
import kotlin.reflect.KClass
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 存储所有已注册的Bean实例,键为Bean名称,值为Bean实例
|
|
||||||
*/
|
|
||||||
private val BEANS: ConcurrentHashMap<String, Any> = ConcurrentHashMap()
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 存储按类型查找的Bean实例,键为Bean的Class对象,值为Bean实例
|
|
||||||
*/
|
|
||||||
private val TYPE_BEANS: ConcurrentHashMap<KClass<*>, Any> = ConcurrentHashMap()
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 自动扫描指定类所在包下的所有类并注册为Bean
|
|
||||||
*
|
|
||||||
* @param c 指定的类,用于获取其所在的包
|
|
||||||
* @throws IllegalArgumentException 如果传入的类为null或位于默认包中
|
|
||||||
*/
|
|
||||||
fun autoScan(c: Class<*>?) {
|
|
||||||
if (c == null) {
|
|
||||||
throw IllegalArgumentException("Class cannot be null")
|
|
||||||
}
|
|
||||||
val pkg = c.`package`
|
|
||||||
if (pkg == null) {
|
|
||||||
throw IllegalArgumentException("Class is in the default package")
|
|
||||||
}
|
|
||||||
scan(pkg.name)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 扫描指定包路径下的所有类文件,并注册其中带有@ComponentBean注解的类为Bean
|
|
||||||
*
|
|
||||||
* @param basePackage 要扫描的基础包名
|
|
||||||
* @throws RuntimeException 如果在扫描过程中发生异常
|
|
||||||
*/
|
|
||||||
fun scan(basePackage: String) {
|
|
||||||
try {
|
|
||||||
val path = basePackage.replace('.', '/')
|
|
||||||
val classLoader = Thread.currentThread().contextClassLoader
|
|
||||||
val resources: Enumeration<URL> = classLoader.getResources(path)
|
|
||||||
while (resources.hasMoreElements()) {
|
|
||||||
val resource = resources.nextElement()
|
|
||||||
val file = File(resource.toURI())
|
|
||||||
scanDirectory(file, basePackage)
|
|
||||||
}
|
|
||||||
injectDependencies()
|
|
||||||
} catch (e: Exception) {
|
|
||||||
throw RuntimeException(e)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 递归扫描目录中的所有类文件,并注册符合条件的类为Bean
|
|
||||||
*
|
|
||||||
* @param directory 当前要扫描的目录
|
|
||||||
* @param packageName 当前目录对应的包名
|
|
||||||
* @throws Exception 如果在扫描或类加载过程中发生异常
|
|
||||||
*/
|
|
||||||
private fun scanDirectory(directory: File, packageName: String) {
|
|
||||||
val files = directory.listFiles() ?: return
|
|
||||||
|
|
||||||
for (file in files) {
|
|
||||||
if (file.isDirectory) {
|
|
||||||
scanDirectory(file, "$packageName.${file.name}")
|
|
||||||
} else if (file.name.endsWith(".class")) {
|
|
||||||
val className = packageName + '.' + file.name.replace(".class", "")
|
|
||||||
registerComponent(Class.forName(className))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 注册一个带有@ComponentBean注解的类为Bean实例
|
|
||||||
*
|
|
||||||
* @param clazz 要注册的类
|
|
||||||
* @throws Exception 如果在实例化类或处理注解时发生异常
|
|
||||||
*/
|
|
||||||
private fun registerComponent(clazz: Class<*>) {
|
|
||||||
if (clazz.isAnnotationPresent(ComponentBean::class.java)) {
|
|
||||||
val component = clazz.getAnnotation(ComponentBean::class.java)
|
|
||||||
val name = component.value.ifEmpty { clazz.name }
|
|
||||||
val instance = clazz.getDeclaredConstructor().newInstance()
|
|
||||||
BEANS[name] = instance
|
|
||||||
val kClass = clazz.kotlin
|
|
||||||
TYPE_BEANS[kClass] = instance
|
|
||||||
|
|
||||||
for (interfaceClass in clazz.interfaces) {
|
|
||||||
TYPE_BEANS.putIfAbsent(interfaceClass.kotlin, instance)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 对所有已注册的Bean进行依赖注入处理
|
|
||||||
*
|
|
||||||
* @throws Exception 如果在注入过程中发生异常
|
|
||||||
*/
|
|
||||||
private fun injectDependencies() {
|
|
||||||
for (bean in BEANS.values) {
|
|
||||||
for (field in bean.javaClass.declaredFields) {
|
|
||||||
if (field.isAnnotationPresent(InjectBean::class.java)) {
|
|
||||||
val inject = field.getAnnotation(InjectBean::class.java)
|
|
||||||
val dependency = findDependency(field.type, inject.value)
|
|
||||||
if (dependency == null) {
|
|
||||||
throw IllegalStateException(
|
|
||||||
"No suitable dependency found for field " + field.name + " in class " + bean.javaClass.name
|
|
||||||
)
|
|
||||||
}
|
|
||||||
field.isAccessible = true
|
|
||||||
field.set(bean, dependency)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据类型和名称查找对应的依赖实例
|
|
||||||
*
|
|
||||||
* @param type 依赖的类型
|
|
||||||
* @param name 依赖的名称(可为空)
|
|
||||||
* @return 找到的依赖实例,未找到则返回null
|
|
||||||
*/
|
|
||||||
private fun findDependency(type: Class<*>, name: String): Any? {
|
|
||||||
if (name.isNotEmpty()) {
|
|
||||||
return BEANS[name]
|
|
||||||
}
|
|
||||||
|
|
||||||
val dependency = TYPE_BEANS[type.kotlin]
|
|
||||||
if (dependency != null) {
|
|
||||||
return dependency
|
|
||||||
}
|
|
||||||
|
|
||||||
for (interfaceType in TYPE_BEANS.keys) {
|
|
||||||
if (type.isAssignableFrom(interfaceType.java)) {
|
|
||||||
return TYPE_BEANS[interfaceType]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return null
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将一个对象添加到Bean容器中,使用其类名作为键
|
|
||||||
*
|
|
||||||
* @param obj 要添加的对象
|
|
||||||
* @throws RuntimeException 如果在注入依赖时发生异常
|
|
||||||
*/
|
|
||||||
fun add(obj: Any) {
|
|
||||||
val clazz = obj.javaClass
|
|
||||||
val name = clazz.name
|
|
||||||
BEANS[name] = obj
|
|
||||||
TYPE_BEANS[clazz.kotlin] = obj
|
|
||||||
try {
|
|
||||||
injectDependencies()
|
|
||||||
} catch (e: Exception) {
|
|
||||||
throw RuntimeException(e)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将一个对象以指定名称添加到Bean容器中
|
|
||||||
*
|
|
||||||
* @param name Bean的名称
|
|
||||||
* @param obj 要添加的对象
|
|
||||||
* @throws RuntimeException 如果在注入依赖时发生异常
|
|
||||||
*/
|
|
||||||
fun add(name: String, obj: Any) {
|
|
||||||
BEANS[name] = obj
|
|
||||||
TYPE_BEANS[obj.javaClass.kotlin] = obj
|
|
||||||
try {
|
|
||||||
injectDependencies()
|
|
||||||
} catch (e: Exception) {
|
|
||||||
throw RuntimeException(e)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据类型获取对应的Bean实例
|
|
||||||
*
|
|
||||||
* @param objclass Bean的类型
|
|
||||||
* @param T Bean的泛型类型
|
|
||||||
* @return 对应类型的Bean实例,未找到则返回null
|
|
||||||
*/
|
|
||||||
@Suppress("UNCHECKED_CAST")
|
|
||||||
fun <T : Any> get(objclass: KClass<T>): T? {
|
|
||||||
return TYPE_BEANS[objclass] as? T
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据名称和类型获取对应的Bean实例
|
|
||||||
*
|
|
||||||
* @param name Bean的名称
|
|
||||||
* @param objclass Bean的类型
|
|
||||||
* @param T Bean的泛型类型
|
|
||||||
* @return 对应名称和类型的Bean实例,未找到则返回null
|
|
||||||
*/
|
|
||||||
@Suppress("UNCHECKED_CAST")
|
|
||||||
fun <T : Any> get(name: String, objclass: KClass<T>): T? {
|
|
||||||
return BEANS[name] as? T
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据名称获取对应的Bean实例
|
|
||||||
*
|
|
||||||
* @param name Bean的名称
|
|
||||||
* @return 对应名称的Bean实例,未找到则返回null
|
|
||||||
*/
|
|
||||||
fun get(name: String): Any? {
|
|
||||||
return BEANS[name]
|
|
||||||
}
|
|
||||||
@@ -1,96 +0,0 @@
|
|||||||
/*
|
|
||||||
* Copyright 2025 mingliqiye
|
|
||||||
*
|
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
||||||
* you may not use this file except in compliance with the License.
|
|
||||||
* You may obtain a copy of the License at
|
|
||||||
*
|
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
*
|
|
||||||
* Unless required by applicable law or agreed to in writing, software
|
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
||||||
* See the License for the specific language governing permissions and
|
|
||||||
* limitations under the License.
|
|
||||||
*
|
|
||||||
* ProjectName mingli-utils
|
|
||||||
* ModuleName mingli-utils.main
|
|
||||||
* CurrentFile SpringBeanUtils.kt
|
|
||||||
* LastUpdate 2025-09-15 22:32:50
|
|
||||||
* UpdateUser MingLiPro
|
|
||||||
*/
|
|
||||||
|
|
||||||
package com.mingliqiye.utils.bean.springboot
|
|
||||||
|
|
||||||
import org.springframework.beans.BeansException
|
|
||||||
import org.springframework.context.ApplicationContext
|
|
||||||
import org.springframework.context.ApplicationContextAware
|
|
||||||
import org.springframework.stereotype.Component
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Spring Bean工具类,用于获取Spring容器中的Bean实例
|
|
||||||
* 实现ApplicationContextAware接口以获取Spring的应用上下文
|
|
||||||
*/
|
|
||||||
@Component
|
|
||||||
class SpringBeanUtils : ApplicationContextAware {
|
|
||||||
|
|
||||||
companion object {
|
|
||||||
|
|
||||||
@JvmStatic
|
|
||||||
private var applicationContext: ApplicationContext? = null
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据Bean名称获取Bean实例
|
|
||||||
*
|
|
||||||
* @param name Bean的名称
|
|
||||||
* @return 指定名称的Bean实例
|
|
||||||
* @throws BeansException 当获取Bean失败时抛出
|
|
||||||
* @throws ClassCastException 当类型转换失败时抛出
|
|
||||||
*/
|
|
||||||
@JvmStatic
|
|
||||||
@Throws(BeansException::class, ClassCastException::class)
|
|
||||||
@Suppress("UNCHECKED_CAST")
|
|
||||||
fun <T> getBean(name: String): T {
|
|
||||||
return applicationContext!!.getBean(name) as T
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据Bean类型获取Bean实例
|
|
||||||
*
|
|
||||||
* @param clazz Bean的类型
|
|
||||||
* @return 指定类型的Bean实例
|
|
||||||
* @throws BeansException 当获取Bean失败时抛出
|
|
||||||
*/
|
|
||||||
@JvmStatic
|
|
||||||
@Throws(BeansException::class)
|
|
||||||
fun <T> getBean(clazz: Class<T>): T {
|
|
||||||
return applicationContext!!.getBean(clazz)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 根据Bean名称和类型获取Bean实例
|
|
||||||
*
|
|
||||||
* @param name Bean的名称
|
|
||||||
* @param clazz Bean的类型
|
|
||||||
* @return 指定名称和类型的Bean实例
|
|
||||||
* @throws BeansException 当获取Bean失败时抛出
|
|
||||||
*/
|
|
||||||
@JvmStatic
|
|
||||||
@Throws(BeansException::class)
|
|
||||||
fun <T> getBean(name: String, clazz: Class<T>): T {
|
|
||||||
return applicationContext!!.getBean<T>(name, clazz)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 设置Spring的应用上下文
|
|
||||||
*
|
|
||||||
* @param applicationContext Spring的应用上下文
|
|
||||||
* @throws BeansException 当设置应用上下文失败时抛出
|
|
||||||
*/
|
|
||||||
@Throws(BeansException::class)
|
|
||||||
override fun setApplicationContext(applicationContext: ApplicationContext) {
|
|
||||||
SpringBeanUtils.applicationContext = applicationContext
|
|
||||||
}
|
|
||||||
}
|
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,383 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile ByteBufferWrapperConvertor.kt
|
||||||
|
* LastUpdate 2026-03-15 11:05:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.buffer.convertor
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.buffer.ByteBufferWrapper
|
||||||
|
import com.mingliqiye.utils.bytes.ByteFlags
|
||||||
|
import com.mingliqiye.utils.time.DateTime
|
||||||
|
import com.mingliqiye.utils.uuid.UUID
|
||||||
|
import java.math.BigDecimal
|
||||||
|
import java.math.BigInteger
|
||||||
|
import java.time.LocalDateTime
|
||||||
|
import java.util.*
|
||||||
|
import java.util.concurrent.ConcurrentHashMap
|
||||||
|
import java.util.UUID as JUUID
|
||||||
|
|
||||||
|
/**
|
||||||
|
* ByteBufferWrapper 类型转换器接口。
|
||||||
|
*
|
||||||
|
* 定义某种类型与 [ByteBufferWrapper] 之间的读写规则。
|
||||||
|
*
|
||||||
|
* @param T 该转换器处理的数据类型
|
||||||
|
*/
|
||||||
|
interface ByteBufferWrapperConvertorInterface<T : Any> {
|
||||||
|
/**
|
||||||
|
* 将对象写入缓冲区。
|
||||||
|
*
|
||||||
|
* @param obj 要写入的对象
|
||||||
|
* @param byteBufferWrapper 目标缓冲区包装器
|
||||||
|
*/
|
||||||
|
fun write(obj: T, byteBufferWrapper: ByteBufferWrapper)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从缓冲区中读取对象。
|
||||||
|
*
|
||||||
|
* @param byteBufferWrapper 源缓冲区包装器
|
||||||
|
* @param parameters 读取时需要的额外参数(如数组长度)
|
||||||
|
* @return 读取并转换后的对象
|
||||||
|
*/
|
||||||
|
fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取该转换器处理的数据类型。
|
||||||
|
*
|
||||||
|
* @return 类型对应的 Class 对象
|
||||||
|
*/
|
||||||
|
fun getType(): Class<T>
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* ByteBufferWrapper 类型转换器抽象基类。
|
||||||
|
*
|
||||||
|
* 提供转换器实例的缓存创建以及默认转换器的注册功能。
|
||||||
|
*
|
||||||
|
* @param T 该转换器处理的数据类型
|
||||||
|
*/
|
||||||
|
abstract class ByteBufferWrapperConvertor<T : Any> : ByteBufferWrapperConvertorInterface<T> {
|
||||||
|
/**
|
||||||
|
* 返回包含所处理类型信息的字符串表示。
|
||||||
|
*/
|
||||||
|
override fun toString(): String {
|
||||||
|
return "ByteBufferWrapperConvertor(type=${getType()})"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 伴生对象,管理转换器实例缓存并提供默认转换器安装方法。
|
||||||
|
*/
|
||||||
|
companion object {
|
||||||
|
private val _instantiations =
|
||||||
|
ConcurrentHashMap<Class<ByteBufferWrapperConvertor<*>>, ByteBufferWrapperConvertor<*>>()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取指定转换器类的实例,不存在时通过无参构造函数创建并缓存。
|
||||||
|
*
|
||||||
|
* @param clazz 转换器类对应的 Class 对象
|
||||||
|
* @return 缓存的或新创建的转换器实例
|
||||||
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
fun getInstantiation(clazz: Class<ByteBufferWrapperConvertor<*>>): ByteBufferWrapperConvertor<*> {
|
||||||
|
return _instantiations.getOrPut(clazz) {
|
||||||
|
clazz.getConstructor().newInstance()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取具体化类型 T 对应的转换器实例,不存在时创建并缓存。
|
||||||
|
*
|
||||||
|
* @param T 转换器类型,必须提供无参构造函数
|
||||||
|
* @return 缓存的或新创建的转换器实例
|
||||||
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
@Suppress("UNCHECKED_CAST")
|
||||||
|
inline fun <reified T : ByteBufferWrapperConvertor<*>> getInstantiation(): ByteBufferWrapperConvertor<*> {
|
||||||
|
return getInstantiation(T::class.java as Class<ByteBufferWrapperConvertor<*>>)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 安装所有默认转换器。
|
||||||
|
*
|
||||||
|
* 将基础类型、大数、字符串、时间、UUID 及各类数组的转换器注册到 [ByteBufferWrapper]。
|
||||||
|
*/
|
||||||
|
fun defaultConvertorInstall() {
|
||||||
|
ByteBufferWrapper.addConvertor<BigDecimalBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<BigIntegerBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<BooleanBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<BytedBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<ByteFlagsBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<CharBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<DateBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<DateTimeFlagsBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<DoubleBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<FloatBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<IntBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<JUUIDBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<LocalDateTimeBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<LongBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<ShortBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<StringBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<UUIDBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<ByteArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<CharArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<ShortArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<IntArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<LongArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<FloatArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<DoubleArrayBufferWrapperConvertor>()
|
||||||
|
ByteBufferWrapper.addConvertor<BooleanArrayBufferWrapperConvertor>()
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于读写函数构造的通用对象转换器。
|
||||||
|
*
|
||||||
|
* 通过传入的写入函数、读取函数和类型信息实现转换逻辑,读取时忽略额外参数。
|
||||||
|
*
|
||||||
|
* @param T 该转换器处理的数据类型
|
||||||
|
* @param write 写入函数,将对象写入缓冲区
|
||||||
|
* @param read 读取函数,从缓冲区读取对象
|
||||||
|
* @param typer 该转换器处理的数据类型对应的 Class 对象
|
||||||
|
*/
|
||||||
|
abstract class ObjectBufferWrapperConvertor<T : Any>(
|
||||||
|
val write: ByteBufferWrapper.(obj: T) -> Unit,
|
||||||
|
val read: ByteBufferWrapper.() -> T,
|
||||||
|
val typer: Class<T>,
|
||||||
|
) : ByteBufferWrapperConvertor<T>() {
|
||||||
|
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
|
||||||
|
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T =
|
||||||
|
read.invoke(byteBufferWrapper)
|
||||||
|
|
||||||
|
override fun getType(): Class<T> = typer
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/** [Byte] 类型转换器,使用 putByte/getByte 读写。 */
|
||||||
|
class BytedBufferWrapperConvertor : ObjectBufferWrapperConvertor<Byte>(
|
||||||
|
ByteBufferWrapper::putByte,
|
||||||
|
ByteBufferWrapper::getByte,
|
||||||
|
Byte::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Char] 类型转换器,使用 putChar/getChar 读写。 */
|
||||||
|
class CharBufferWrapperConvertor : ObjectBufferWrapperConvertor<Char>(
|
||||||
|
ByteBufferWrapper::putChar,
|
||||||
|
ByteBufferWrapper::getChar,
|
||||||
|
Char::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Short] 类型转换器,使用 putShort/getShort 读写。 */
|
||||||
|
class ShortBufferWrapperConvertor : ObjectBufferWrapperConvertor<Short>(
|
||||||
|
ByteBufferWrapper::putShort,
|
||||||
|
ByteBufferWrapper::getShort,
|
||||||
|
Short::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Int] 类型转换器,使用 putInt/getInt 读写。 */
|
||||||
|
class IntBufferWrapperConvertor : ObjectBufferWrapperConvertor<Int>(
|
||||||
|
ByteBufferWrapper::putInt,
|
||||||
|
ByteBufferWrapper::getInt,
|
||||||
|
Int::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Long] 类型转换器,使用 putLong/getLong 读写。 */
|
||||||
|
class LongBufferWrapperConvertor : ObjectBufferWrapperConvertor<Long>(
|
||||||
|
ByteBufferWrapper::putLong,
|
||||||
|
ByteBufferWrapper::getLong,
|
||||||
|
Long::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Double] 类型转换器,使用 putDouble/getDouble 读写。 */
|
||||||
|
class DoubleBufferWrapperConvertor : ObjectBufferWrapperConvertor<Double>(
|
||||||
|
ByteBufferWrapper::putDouble,
|
||||||
|
ByteBufferWrapper::getDouble,
|
||||||
|
Double::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Float] 类型转换器,使用 putFloat/getFloat 读写。 */
|
||||||
|
class FloatBufferWrapperConvertor : ObjectBufferWrapperConvertor<Float>(
|
||||||
|
ByteBufferWrapper::putFloat,
|
||||||
|
ByteBufferWrapper::getFloat,
|
||||||
|
Float::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [BigInteger] 类型转换器,使用 putBigInteger/getBigInteger 读写。 */
|
||||||
|
class BigIntegerBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigInteger>(
|
||||||
|
ByteBufferWrapper::putBigInteger,
|
||||||
|
ByteBufferWrapper::getBigInteger,
|
||||||
|
BigInteger::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [BigDecimal] 类型转换器,使用 putBigDecimal/getBigDecimal 读写。 */
|
||||||
|
class BigDecimalBufferWrapperConvertor : ObjectBufferWrapperConvertor<BigDecimal>(
|
||||||
|
ByteBufferWrapper::putBigDecimal,
|
||||||
|
ByteBufferWrapper::getBigDecimal,
|
||||||
|
BigDecimal::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Boolean] 类型转换器,使用 putBoolean/getBoolean 读写。 */
|
||||||
|
class BooleanBufferWrapperConvertor : ObjectBufferWrapperConvertor<Boolean>(
|
||||||
|
ByteBufferWrapper::putBoolean,
|
||||||
|
ByteBufferWrapper::getBoolean,
|
||||||
|
Boolean::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [String] 类型转换器,使用 putString/getString 读写。 */
|
||||||
|
class StringBufferWrapperConvertor : ObjectBufferWrapperConvertor<String>(
|
||||||
|
ByteBufferWrapper::putString,
|
||||||
|
ByteBufferWrapper::getString,
|
||||||
|
String::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [ByteFlags] 类型转换器,使用 putFlag/getFlag 读写。 */
|
||||||
|
class ByteFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<ByteFlags>(
|
||||||
|
ByteBufferWrapper::putFlag,
|
||||||
|
ByteBufferWrapper::getFlag,
|
||||||
|
ByteFlags::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
/** Java [JUUID] 类型转换器,使用 putUUID/getJUUID 读写。 */
|
||||||
|
class JUUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<JUUID>(
|
||||||
|
ByteBufferWrapper::putUUID,
|
||||||
|
ByteBufferWrapper::getJUUID,
|
||||||
|
JUUID::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** 自定义 [UUID] 类型转换器,使用 putUUID/getUUID 读写。 */
|
||||||
|
class UUIDBufferWrapperConvertor : ObjectBufferWrapperConvertor<UUID>(
|
||||||
|
ByteBufferWrapper::putUUID,
|
||||||
|
ByteBufferWrapper::getUUID,
|
||||||
|
UUID::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [DateTime] 类型转换器,使用 putDateTime/getDateTime 读写。 */
|
||||||
|
class DateTimeFlagsBufferWrapperConvertor : ObjectBufferWrapperConvertor<DateTime>(
|
||||||
|
ByteBufferWrapper::putDateTime,
|
||||||
|
ByteBufferWrapper::getDateTime,
|
||||||
|
DateTime::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [LocalDateTime] 类型转换器,使用 putLocalDateTime/getLocalDateTime 读写。 */
|
||||||
|
class LocalDateTimeBufferWrapperConvertor : ObjectBufferWrapperConvertor<LocalDateTime>(
|
||||||
|
ByteBufferWrapper::putLocalDateTime,
|
||||||
|
ByteBufferWrapper::getLocalDateTime,
|
||||||
|
LocalDateTime::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [Date] 类型转换器,使用 putDate/getDate 读写。 */
|
||||||
|
class DateBufferWrapperConvertor : ObjectBufferWrapperConvertor<Date>(
|
||||||
|
ByteBufferWrapper::putDate,
|
||||||
|
ByteBufferWrapper::getDate,
|
||||||
|
Date::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 基于读写函数构造的通用数组转换器。
|
||||||
|
*
|
||||||
|
* 读取时要求额外参数的第一个元素为 Int 类型的数组长度。
|
||||||
|
*
|
||||||
|
* @param T 该转换器处理的数组类型
|
||||||
|
* @param write 写入函数,将数组写入缓冲区
|
||||||
|
* @param read 读取函数,按指定长度从缓冲区读取数组
|
||||||
|
* @param typer 该转换器处理的数组类型对应的 Class 对象
|
||||||
|
*/
|
||||||
|
abstract class ArrayBufferWrapperConvertor<T : Any>(
|
||||||
|
val write: ByteBufferWrapper.(obj: T) -> Unit,
|
||||||
|
val read: ByteBufferWrapper.(size: Int) -> T,
|
||||||
|
val typer: Class<T>,
|
||||||
|
) : ByteBufferWrapperConvertor<T>() {
|
||||||
|
override fun write(obj: T, byteBufferWrapper: ByteBufferWrapper) = write.invoke(byteBufferWrapper, obj)
|
||||||
|
/**
|
||||||
|
* 从缓冲区读取数组,要求 parameters[0] 为 Int 类型的长度。
|
||||||
|
*
|
||||||
|
* @throws IllegalArgumentException 如果参数为空或第一个参数不是 Int
|
||||||
|
*/
|
||||||
|
override fun read(byteBufferWrapper: ByteBufferWrapper, parameters: Array<Any>): T {
|
||||||
|
if (parameters.isEmpty()) {
|
||||||
|
throw IllegalArgumentException("parameters cannot be empty, must has a Int")
|
||||||
|
}
|
||||||
|
val size = parameters[0]
|
||||||
|
if (size !is Int)
|
||||||
|
throw IllegalArgumentException("parameters[0] cannot be Int, must has a Int")
|
||||||
|
return read.invoke(byteBufferWrapper, size)
|
||||||
|
}
|
||||||
|
|
||||||
|
override fun getType(): Class<T> = typer
|
||||||
|
}
|
||||||
|
|
||||||
|
/** [ByteArray] 类型转换器,使用 putByteArray/getByteArray 读写。 */
|
||||||
|
class ByteArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ByteArray>(
|
||||||
|
ByteBufferWrapper::putByteArray,
|
||||||
|
ByteBufferWrapper::getByteArray,
|
||||||
|
ByteArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [CharArray] 类型转换器,使用 putCharArray/getCharArray 读写。 */
|
||||||
|
class CharArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<CharArray>(
|
||||||
|
ByteBufferWrapper::putCharArray,
|
||||||
|
ByteBufferWrapper::getCharArray,
|
||||||
|
CharArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [ShortArray] 类型转换器,使用 putShortArray/getShortArray 读写。 */
|
||||||
|
class ShortArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<ShortArray>(
|
||||||
|
ByteBufferWrapper::putShortArray,
|
||||||
|
ByteBufferWrapper::getShortArray,
|
||||||
|
ShortArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [IntArray] 类型转换器,使用 putIntArray/getIntArray 读写。 */
|
||||||
|
class IntArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<IntArray>(
|
||||||
|
ByteBufferWrapper::putIntArray,
|
||||||
|
ByteBufferWrapper::getIntArray,
|
||||||
|
IntArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [LongArray] 类型转换器,使用 putLongArray/getLongArray 读写。 */
|
||||||
|
class LongArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<LongArray>(
|
||||||
|
ByteBufferWrapper::putLongArray,
|
||||||
|
ByteBufferWrapper::getLongArray,
|
||||||
|
LongArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [FloatArray] 类型转换器,使用 putFloatArray/getFloatArray 读写。 */
|
||||||
|
class FloatArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<FloatArray>(
|
||||||
|
ByteBufferWrapper::putFloatArray,
|
||||||
|
ByteBufferWrapper::getFloatArray,
|
||||||
|
FloatArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
/** [DoubleArray] 类型转换器,使用 putDoubleArray/getDoubleArray 读写。 */
|
||||||
|
class DoubleArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<DoubleArray>(
|
||||||
|
ByteBufferWrapper::putDoubleArray,
|
||||||
|
ByteBufferWrapper::getDoubleArray,
|
||||||
|
DoubleArray::class.java,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
/** [BooleanArray] 类型转换器,使用 putBooleanArray/getBooleanArray 读写。 */
|
||||||
|
class BooleanArrayBufferWrapperConvertor : ArrayBufferWrapperConvertor<BooleanArray>(
|
||||||
|
ByteBufferWrapper::putBooleanArray,
|
||||||
|
ByteBufferWrapper::getBooleanArray,
|
||||||
|
BooleanArray::class.java,
|
||||||
|
)
|
||||||
@@ -0,0 +1,306 @@
|
|||||||
|
/*
|
||||||
|
* 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 ByteBufferUtils.kt
|
||||||
|
* LastUpdate 2026-07-02 09:31:01
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
@file:JvmName("ByteBufferUtils")
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.bytes
|
||||||
|
|
||||||
|
import java.io.IOException
|
||||||
|
import java.io.OutputStream
|
||||||
|
import java.nio.BufferUnderflowException
|
||||||
|
import java.nio.ByteBuffer
|
||||||
|
import java.nio.charset.Charset
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字符串以指定字符集编码后写入 [ByteBuffer],并在末尾追加一个空字节(`0x00`)作为字符串终止符。
|
||||||
|
*
|
||||||
|
* 此方法适用于需要 C 风格字符串(null-terminated string)的协议或场景。
|
||||||
|
*
|
||||||
|
* @param string 要写入的字符串,不可为 null
|
||||||
|
* @param charset 字符编码,默认为 [Charsets.UTF_8]
|
||||||
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putString(string: String, charset: Charset = Charsets.UTF_8): ByteBuffer =
|
||||||
|
this.put(string.toByteArray(charset)).put(0x00)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 [ByteBuffer] 中读取一个以空字节(`0x00`)结尾的字符串。
|
||||||
|
*
|
||||||
|
* 该方法会持续读取字节,直到遇到第一个 `0x00`(null terminator)为止,并将之前读取的字节按指定字符集解码为字符串。
|
||||||
|
* **注意**:此操作会修改缓冲区的位置(position),且不处理缓冲区越界情况(若无终止符会抛出异常)。
|
||||||
|
*
|
||||||
|
* @param charset 字符编码,默认为 [Charsets.UTF_8]
|
||||||
|
* @return 解码后的字符串(不含终止符)
|
||||||
|
* @throws BufferUnderflowException 如果缓冲区中没有足够的字节(即未找到终止符)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.getString(charset: Charset = Charsets.UTF_8): String {
|
||||||
|
val data = ArrayList<Byte>()
|
||||||
|
while (true) {
|
||||||
|
val byte = this.get()
|
||||||
|
if (byte == 0x00.toByte()) {
|
||||||
|
break
|
||||||
|
}
|
||||||
|
data.add(byte)
|
||||||
|
}
|
||||||
|
return String(data.toByteArray(), charset)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 [ByteBuffer] 中剩余的全部字节读取为一个 [ByteArray]。
|
||||||
|
*
|
||||||
|
* 此方法会读取从当前位置到 limit 之间的所有字节,并推进 position。
|
||||||
|
*
|
||||||
|
* @return 包含剩余字节的新字节数组
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.toByteArray(): ByteArray {
|
||||||
|
val ba = ByteArray(this.remaining())
|
||||||
|
this.get(ba)
|
||||||
|
return ba
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将一个布尔列表(长度必须为 8)转换为 [ByteFlags] 并写入 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* 列表索引 0~7 分别对应位 b0~b7(b0 为最低有效位)。
|
||||||
|
*
|
||||||
|
* @param bit 长度为 8 的布尔列表,表示 8 个位的状态
|
||||||
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
|
* @throws IndexOutOfBoundsException 如果列表长度不足 8
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putByteFlags(
|
||||||
|
bit: List<Boolean> = List(8) { false },
|
||||||
|
): ByteBuffer = this.putByteFlags(
|
||||||
|
ByteFlags(
|
||||||
|
bit[0],
|
||||||
|
bit[1],
|
||||||
|
bit[2],
|
||||||
|
bit[3],
|
||||||
|
bit[4],
|
||||||
|
bit[5],
|
||||||
|
bit[6],
|
||||||
|
bit[7],
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将一个布尔数组(长度必须为 8)转换为 [ByteFlags] 并写入 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* 数组索引 0~7 分别对应位 b0~b7(b0 为最低有效位)。
|
||||||
|
*
|
||||||
|
* @param bit 长度为 8 的布尔数组
|
||||||
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
|
* @throws IndexOutOfBoundsException 如果数组长度不足 8
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putByteFlags(
|
||||||
|
bit: BooleanArray = BooleanArray(8),
|
||||||
|
): ByteBuffer = this.putByteFlags(
|
||||||
|
ByteFlags(
|
||||||
|
bit[0],
|
||||||
|
bit[1],
|
||||||
|
bit[2],
|
||||||
|
bit[3],
|
||||||
|
bit[4],
|
||||||
|
bit[5],
|
||||||
|
bit[6],
|
||||||
|
bit[7],
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 [ByteFlags] 对象转换为字节并写入 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* @param byteFlags 要写入的位标志对象
|
||||||
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putByteFlags(byteFlags: ByteFlags): ByteBuffer = this.put(byteFlags.toByte())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过 8 个独立的布尔参数构造 [ByteFlags] 并写入 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* 参数顺序:`bit0`(LSB)到 `bit7`(MSB)。
|
||||||
|
*
|
||||||
|
* @param bit0 第 0 位(最低位)
|
||||||
|
* @param bit1 第 1 位
|
||||||
|
* @param bit2 第 2 位
|
||||||
|
* @param bit3 第 3 位
|
||||||
|
* @param bit4 第 4 位
|
||||||
|
* @param bit5 第 5 位
|
||||||
|
* @param bit6 第 6 位
|
||||||
|
* @param bit7 第 7 位(最高位)
|
||||||
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putByteFlags(
|
||||||
|
bit0: Boolean = false,
|
||||||
|
bit1: Boolean = false,
|
||||||
|
bit2: Boolean = false,
|
||||||
|
bit3: Boolean = false,
|
||||||
|
bit4: Boolean = false,
|
||||||
|
bit5: Boolean = false,
|
||||||
|
bit6: Boolean = false,
|
||||||
|
bit7: Boolean = false,
|
||||||
|
): ByteBuffer = this.putByteFlags(
|
||||||
|
ByteFlags(
|
||||||
|
bit0,
|
||||||
|
bit1,
|
||||||
|
bit2,
|
||||||
|
bit3,
|
||||||
|
bit4,
|
||||||
|
bit5,
|
||||||
|
bit6,
|
||||||
|
bit7,
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 [ByteBuffer] 中读取一个字节,并将其解析为 [ByteFlags] 对象。
|
||||||
|
*
|
||||||
|
* @return 表示该字节各位状态的 [ByteFlags] 实例
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.getByteFlags(): ByteFlags = ByteFlags(this.get())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 [ByteBuffer] 中读取一个字节,并将其解释为布尔值。
|
||||||
|
*
|
||||||
|
* 约定:`0x01` 表示 `true`,其他值(包括 `0x00`)均视为 `false`。
|
||||||
|
*
|
||||||
|
* @return 布尔值
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.getBoolean(): Boolean = this.get() == 0x01.toByte()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将布尔值写入 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* 约定:`true` 写为 `0x01`,`false` 写为 `0x00`。
|
||||||
|
*
|
||||||
|
* @param boolean 要写入的布尔值
|
||||||
|
* @return 当前 [ByteBuffer] 实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putBoolean(boolean: Boolean): ByteBuffer = this.put(if (boolean) 0x01 else 0x00)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前字节数组包装为一个只读的 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* 使用 [ByteBuffer.wrap] 创建,position 初始为 0,limit 为数组长度。
|
||||||
|
*
|
||||||
|
* @return 包装后的 [ByteBuffer] 实例
|
||||||
|
*/
|
||||||
|
fun ByteArray.toByteBuffer(): ByteBuffer {
|
||||||
|
return ByteBuffer.wrap(this)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从ByteBuffer中读取一个变长整数(VarNumber)。
|
||||||
|
*
|
||||||
|
* 变长整数使用可变长度编码方式,每个字节的最高位表示是否还有后续字节:
|
||||||
|
* - 如果最高位为1,则表示还有下一个字节;
|
||||||
|
* - 如果最高位为0,则表示当前字节是最后一个字节。
|
||||||
|
*
|
||||||
|
* @param size 最大允许读取的字节数,默认为8(即Long类型的最大长度)。
|
||||||
|
* @return 解码后的长整型数值。
|
||||||
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.getVarLong(size: Int = 8): Long {
|
||||||
|
var numRead = 0
|
||||||
|
var result: Long = 0
|
||||||
|
var read: Byte
|
||||||
|
do {
|
||||||
|
read = this.get()
|
||||||
|
// 将当前字节的有效7位数据左移相应位置后与结果进行按位或运算
|
||||||
|
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||||
|
numRead++
|
||||||
|
if (numRead > size) {
|
||||||
|
throw IOException("VarNumber is too big")
|
||||||
|
}
|
||||||
|
} while ((read.toLong() and 128) != 0L)
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从ByteBuffer中读取一个变长整数(VarNumber),返回Int类型。
|
||||||
|
*
|
||||||
|
* @return 解码后的整型数值。
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.getVarInt(): Int = this.getVarLong(4).toInt()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从ByteBuffer中读取一个变长整数(VarNumber),返回Short类型。
|
||||||
|
*
|
||||||
|
* @return 解码后的短整型数值。
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.getVarShort(): Short = this.getVarLong(2).toShort()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从输入流中读取一个变长长整数(VarLong),最大长度默认为8个字节。
|
||||||
|
*
|
||||||
|
* @return 解码后的长整型数值。
|
||||||
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun ByteBuffer.getVarLong(): Long = this.getVarLong(8)
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将长整型数值编码为变长格式并写入ByteBuffer
|
||||||
|
*
|
||||||
|
* 变长整数使用可变长度编码方式,每个字节的最高位表示是否还有后续字节:
|
||||||
|
* - 如果数值还有更多字节,则最高位设为1;
|
||||||
|
* - 最后一个字节最高位设为0。
|
||||||
|
*
|
||||||
|
* @param value 要写入的长整型数值
|
||||||
|
* @return 当前ByteBuffer实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putVarLong(value: Long): ByteBuffer {
|
||||||
|
var v = value
|
||||||
|
while (v >= 0x80) {
|
||||||
|
this.put((v and 0x7F or 0x80).toByte())
|
||||||
|
v = v shr 7
|
||||||
|
}
|
||||||
|
this.put(v.toByte())
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将整型数值编码为变长格式并写入ByteBuffer
|
||||||
|
*
|
||||||
|
* @param value 要写入的整型数值
|
||||||
|
* @return 当前ByteBuffer实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putVarInt(value: Int): ByteBuffer = this.putVarLong(value.toLong())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将短整型数值编码为变长格式并写入ByteBuffer
|
||||||
|
*
|
||||||
|
* @param value 要写入的短整型数值
|
||||||
|
* @return 当前ByteBuffer实例(支持链式调用)
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.putVarShort(value: Short): ByteBuffer = this.putVarLong(value.toLong())
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 [ByteBuffer] 中剩余的全部字节写入指定的输出流。
|
||||||
|
*
|
||||||
|
* 此操作会读取从当前位置到 limit 之间的所有字节,并推进 position。
|
||||||
|
*
|
||||||
|
* @param outputStream 目标输出流
|
||||||
|
* @throws IOException 如果写入过程中发生 I/O 错误
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.writeStream(outputStream: OutputStream) = outputStream.write(this.toByteArray())
|
||||||
@@ -0,0 +1,83 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile ByteConvertible.kt
|
||||||
|
* LastUpdate 2026-02-08 10:25:22
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.bytes
|
||||||
|
|
||||||
|
import java.io.OutputStream
|
||||||
|
import java.io.Serializable
|
||||||
|
import java.nio.ByteBuffer
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 可转换为字节数组的对象接口。
|
||||||
|
*
|
||||||
|
* 实现该接口的对象可以将自身序列化为字节数组,并支持写入输出流或 [ByteBuffer]。
|
||||||
|
*/
|
||||||
|
interface ByteConvertible : Serializable {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前对象转换为字节数组。
|
||||||
|
*
|
||||||
|
* @return 表示当前对象的字节数组
|
||||||
|
*/
|
||||||
|
fun toBytes(): ByteArray
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前对象转换后的字节数组写入指定的输出流。
|
||||||
|
*
|
||||||
|
* @param outputStream 目标输出流
|
||||||
|
*/
|
||||||
|
fun writeToStream(outputStream: OutputStream) {
|
||||||
|
outputStream.write(toBytes())
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前对象转换后的字节数组写入指定的 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* @param byteBuffer 目标缓冲区
|
||||||
|
*/
|
||||||
|
fun putToByteBuffer(byteBuffer: ByteBuffer) {
|
||||||
|
byteBuffer.put(toBytes())
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 伴生对象,提供面向输出流和缓冲区的便捷扩展函数。
|
||||||
|
*/
|
||||||
|
companion object {
|
||||||
|
/**
|
||||||
|
* 将 [ByteConvertible] 对象写入当前输出流。
|
||||||
|
*
|
||||||
|
* @param byteConvertible 要写入的可转换对象
|
||||||
|
*/
|
||||||
|
fun OutputStream.write(byteConvertible: ByteConvertible) {
|
||||||
|
byteConvertible.writeToStream(this)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将 [ByteConvertible] 对象写入当前 [ByteBuffer]。
|
||||||
|
*
|
||||||
|
* @param byteConvertible 要写入的可转换对象
|
||||||
|
*/
|
||||||
|
fun ByteBuffer.put(byteConvertible: ByteConvertible) {
|
||||||
|
byteConvertible.putToByteBuffer(this)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,485 @@
|
|||||||
|
/*
|
||||||
|
* 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 ByteFlags.kt
|
||||||
|
* LastUpdate 2026-11-16 21:35:04
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.bytes
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示一个字节(8 位)的布尔标志集合。
|
||||||
|
*
|
||||||
|
* 每一位对应一个布尔值,其中:
|
||||||
|
* - `b0` 表示最低有效位(LSB,bit 0,值为 0x01)
|
||||||
|
* - `b7` 表示最高有效位(MSB,bit 7,值为 0x80)
|
||||||
|
*
|
||||||
|
* 该类支持从字节、布尔数组、二进制字符串等构造,并提供位操作、状态查询和格式化输出等功能。
|
||||||
|
*/
|
||||||
|
data class ByteFlags(
|
||||||
|
/** 第 0 位(最低位,0x01) */
|
||||||
|
var b0: Boolean = false,
|
||||||
|
/** 第 1 位(0x02) */
|
||||||
|
var b1: Boolean = false,
|
||||||
|
/** 第 2 位(0x04) */
|
||||||
|
var b2: Boolean = false,
|
||||||
|
/** 第 3 位(0x08) */
|
||||||
|
var b3: Boolean = false,
|
||||||
|
/** 第 4 位(0x10) */
|
||||||
|
var b4: Boolean = false,
|
||||||
|
/** 第 5 位(0x20) */
|
||||||
|
var b5: Boolean = false,
|
||||||
|
/** 第 6 位(0x40) */
|
||||||
|
var b6: Boolean = false,
|
||||||
|
/** 第 7 位(最高位,0x80) */
|
||||||
|
var b7: Boolean = false,
|
||||||
|
) {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过一个 [Byte] 值构造 [ByteFlags] 实例。
|
||||||
|
*
|
||||||
|
* @param byte 用于初始化的字节值(仅使用低 8 位)
|
||||||
|
*/
|
||||||
|
constructor(byte: Byte) : this() {
|
||||||
|
fromByte(byte)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从给定的 [Byte] 值解析并设置各个位标志。
|
||||||
|
*
|
||||||
|
* @param byte 要解析的字节
|
||||||
|
*/
|
||||||
|
fun fromByte(byte: Byte): ByteFlags {
|
||||||
|
val value = byte.toInt() and 0xFF
|
||||||
|
b0 = (value and 0x01) != 0
|
||||||
|
b1 = (value and 0x02) != 0
|
||||||
|
b2 = (value and 0x04) != 0
|
||||||
|
b3 = (value and 0x08) != 0
|
||||||
|
b4 = (value and 0x10) != 0
|
||||||
|
b5 = (value and 0x20) != 0
|
||||||
|
b6 = (value and 0x40) != 0
|
||||||
|
b7 = (value and 0x80) != 0
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前标志状态转换为一个 [Byte] 值。
|
||||||
|
*
|
||||||
|
* @return 对应的字节值(范围 0x00 ~ 0xFF,以有符号字节形式返回)
|
||||||
|
*/
|
||||||
|
fun toByte(): Byte {
|
||||||
|
var result = 0
|
||||||
|
if (b0) result = result or 0x01
|
||||||
|
if (b1) result = result or 0x02
|
||||||
|
if (b2) result = result or 0x04
|
||||||
|
if (b3) result = result or 0x08
|
||||||
|
if (b4) result = result or 0x10
|
||||||
|
if (b5) result = result or 0x20
|
||||||
|
if (b6) result = result or 0x40
|
||||||
|
if (b7) result = result or 0x80
|
||||||
|
return result.toByte()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过索引(0~7)获取对应位的布尔值。
|
||||||
|
*
|
||||||
|
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||||
|
* @return 该位是否为 true
|
||||||
|
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||||
|
*/
|
||||||
|
operator fun get(index: Int): Boolean {
|
||||||
|
return when (index) {
|
||||||
|
0 -> b0
|
||||||
|
1 -> b1
|
||||||
|
2 -> b2
|
||||||
|
3 -> b3
|
||||||
|
4 -> b4
|
||||||
|
5 -> b5
|
||||||
|
6 -> b6
|
||||||
|
7 -> b7
|
||||||
|
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过索引(0~7)设置对应位的布尔值。
|
||||||
|
*
|
||||||
|
* @param index 位索引(0 = LSB, 7 = MSB)
|
||||||
|
* @param value 要设置的布尔值
|
||||||
|
* @throws IndexOutOfBoundsException 如果索引不在 0~7 范围内
|
||||||
|
*/
|
||||||
|
operator fun set(index: Int, value: Boolean): ByteFlags {
|
||||||
|
when (index) {
|
||||||
|
0 -> b0 = value
|
||||||
|
1 -> b1 = value
|
||||||
|
2 -> b2 = value
|
||||||
|
3 -> b3 = value
|
||||||
|
4 -> b4 = value
|
||||||
|
5 -> b5 = value
|
||||||
|
6 -> b6 = value
|
||||||
|
7 -> b7 = value
|
||||||
|
else -> throw IndexOutOfBoundsException("索引必须在0-7之间")
|
||||||
|
}
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将所有 8 个位设置为 `true`。
|
||||||
|
*/
|
||||||
|
fun setAll(): ByteFlags {
|
||||||
|
b0 = true
|
||||||
|
b1 = true
|
||||||
|
b2 = true
|
||||||
|
b3 = true
|
||||||
|
b4 = true
|
||||||
|
b5 = true
|
||||||
|
b6 = true
|
||||||
|
b7 = true
|
||||||
|
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将所有 8 个位设置为 `false`。
|
||||||
|
*/
|
||||||
|
fun clearAll(): ByteFlags {
|
||||||
|
b0 = false
|
||||||
|
b1 = false
|
||||||
|
b2 = false
|
||||||
|
b3 = false
|
||||||
|
b4 = false
|
||||||
|
b5 = false
|
||||||
|
b6 = false
|
||||||
|
b7 = false
|
||||||
|
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对所有位执行逻辑取反(true ↔ false)。
|
||||||
|
*/
|
||||||
|
fun toggleAll(): ByteFlags {
|
||||||
|
b0 = !b0
|
||||||
|
b1 = !b1
|
||||||
|
b2 = !b2
|
||||||
|
b3 = !b3
|
||||||
|
b4 = !b4
|
||||||
|
b5 = !b5
|
||||||
|
b6 = !b6
|
||||||
|
b7 = !b7
|
||||||
|
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 切换指定索引位的状态(true 变 false,反之亦然)。
|
||||||
|
*
|
||||||
|
* @param index 要切换的位索引(0~7)
|
||||||
|
* @throws IndexOutOfBoundsException 如果索引无效
|
||||||
|
*/
|
||||||
|
fun toggle(index: Int): ByteFlags {
|
||||||
|
this[index] = !this[index]
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查是否所有位都为 `true`。
|
||||||
|
*
|
||||||
|
* @return 若全部为 true 则返回 true,否则 false
|
||||||
|
*/
|
||||||
|
fun allTrue(): Boolean {
|
||||||
|
return b0 && b1 && b2 && b3 && b4 && b5 && b6 && b7
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 检查是否所有位都为 `false`。
|
||||||
|
*
|
||||||
|
* @return 若全部为 false 则返回 true,否则 false
|
||||||
|
*/
|
||||||
|
fun allFalse(): Boolean {
|
||||||
|
return !b0 && !b1 && !b2 && !b3 && !b4 && !b5 && !b6 && !b7
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 统计值为 `true` 的位数量。
|
||||||
|
*
|
||||||
|
* @return true 位的个数(0~8)
|
||||||
|
*/
|
||||||
|
fun countTrue(): Int {
|
||||||
|
var count = 0
|
||||||
|
if (b0) count++
|
||||||
|
if (b1) count++
|
||||||
|
if (b2) count++
|
||||||
|
if (b3) count++
|
||||||
|
if (b4) count++
|
||||||
|
if (b5) count++
|
||||||
|
if (b6) count++
|
||||||
|
if (b7) count++
|
||||||
|
return count
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 统计值为 `false` 的位数量。
|
||||||
|
*
|
||||||
|
* @return false 位的个数(0~8)
|
||||||
|
*/
|
||||||
|
fun countFalse(): Int = 8 - countTrue()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过位名称(如 "b0"、"bit3" 等)获取对应位的值。
|
||||||
|
*
|
||||||
|
* 支持别名:`bN` 或 `bitN`(不区分大小写)。
|
||||||
|
*
|
||||||
|
* @param name 位的名称(例如 "b0", "BIT5")
|
||||||
|
* @return 对应位的布尔值
|
||||||
|
* @throws IllegalArgumentException 如果名称无效
|
||||||
|
*/
|
||||||
|
fun getByName(name: String): Boolean {
|
||||||
|
return when (name.lowercase()) {
|
||||||
|
"b0", "bit0" -> b0
|
||||||
|
"b1", "bit1" -> b1
|
||||||
|
"b2", "bit2" -> b2
|
||||||
|
"b3", "bit3" -> b3
|
||||||
|
"b4", "bit4" -> b4
|
||||||
|
"b5", "bit5" -> b5
|
||||||
|
"b6", "bit6" -> b6
|
||||||
|
"b7", "bit7" -> b7
|
||||||
|
else -> throw IllegalArgumentException("未知的位名称: $name")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前状态转换为标准二进制字符串(MSB 在前)。
|
||||||
|
*
|
||||||
|
* 例如:若 b7=true, b6=false, ..., b0=true,则返回 "10000001"
|
||||||
|
*
|
||||||
|
* @return 8 位二进制字符串(高位在左)
|
||||||
|
*/
|
||||||
|
fun toBinaryString(): String {
|
||||||
|
return buildString {
|
||||||
|
if (b7) append('1') else append('0')
|
||||||
|
if (b6) append('1') else append('0')
|
||||||
|
if (b5) append('1') else append('0')
|
||||||
|
if (b4) append('1') else append('0')
|
||||||
|
if (b3) append('1') else append('0')
|
||||||
|
if (b2) append('1') else append('0')
|
||||||
|
if (b1) append('1') else append('0')
|
||||||
|
if (b0) append('1') else append('0')
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前状态转换为十六进制字符串(带 0x 前缀,大写,两位)。
|
||||||
|
*
|
||||||
|
* 例如:若值为 10,则返回 "0x0A"
|
||||||
|
*
|
||||||
|
* @return 格式如 "0xXX" 的十六进制字符串
|
||||||
|
*/
|
||||||
|
fun toHexString(): String {
|
||||||
|
return "0x" + (toByte().toInt() and 0xFF).toString(16).padStart(2, '0').uppercase()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前位状态转换为布尔数组。
|
||||||
|
*
|
||||||
|
* 数组顺序为 [b0, b1, b2, ..., b7](LSB 在前)。
|
||||||
|
*
|
||||||
|
* @return 长度为 8 的布尔数组
|
||||||
|
*/
|
||||||
|
fun toBooleanArray(): BooleanArray {
|
||||||
|
return booleanArrayOf(b0, b1, b2, b3, b4, b5, b6, b7)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从布尔数组初始化位状态。
|
||||||
|
*
|
||||||
|
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
||||||
|
*
|
||||||
|
* @param array 布尔数组(长度至少为 8)
|
||||||
|
* @throws IllegalArgumentException 如果数组长度不足 8
|
||||||
|
*/
|
||||||
|
fun fromBooleanArray(array: BooleanArray): ByteFlags {
|
||||||
|
require(array.size >= 8) { "数组长度至少为8" }
|
||||||
|
b0 = array[0]
|
||||||
|
b1 = array[1]
|
||||||
|
b2 = array[2]
|
||||||
|
b3 = array[3]
|
||||||
|
b4 = array[4]
|
||||||
|
b5 = array[5]
|
||||||
|
b6 = array[6]
|
||||||
|
b7 = array[7]
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对两个 [ByteFlags] 执行按位“与”操作(AND)。
|
||||||
|
*
|
||||||
|
* 结果的每一位 = this位 && other位
|
||||||
|
*
|
||||||
|
* @param other 另一个 ByteFlags 实例
|
||||||
|
* @return 新的 ByteFlags 实例,表示 AND 结果
|
||||||
|
*/
|
||||||
|
infix fun and(other: ByteFlags): ByteFlags {
|
||||||
|
return ByteFlags(
|
||||||
|
this.b0 && other.b0,
|
||||||
|
this.b1 && other.b1,
|
||||||
|
this.b2 && other.b2,
|
||||||
|
this.b3 && other.b3,
|
||||||
|
this.b4 && other.b4,
|
||||||
|
this.b5 && other.b5,
|
||||||
|
this.b6 && other.b6,
|
||||||
|
this.b7 && other.b7
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对两个 [ByteFlags] 执行按位“或”操作(OR)。
|
||||||
|
*
|
||||||
|
* 结果的每一位 = this位 || other位
|
||||||
|
*
|
||||||
|
* @param other 另一个 ByteFlags 实例
|
||||||
|
* @return 新的 ByteFlags 实例,表示 OR 结果
|
||||||
|
*/
|
||||||
|
infix fun or(other: ByteFlags): ByteFlags {
|
||||||
|
return ByteFlags(
|
||||||
|
this.b0 || other.b0,
|
||||||
|
this.b1 || other.b1,
|
||||||
|
this.b2 || other.b2,
|
||||||
|
this.b3 || other.b3,
|
||||||
|
this.b4 || other.b4,
|
||||||
|
this.b5 || other.b5,
|
||||||
|
this.b6 || other.b6,
|
||||||
|
this.b7 || other.b7
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对两个 [ByteFlags] 执行按位“异或”操作(XOR)。
|
||||||
|
*
|
||||||
|
* 结果的每一位 = this位 != other位
|
||||||
|
*
|
||||||
|
* @param other 另一个 ByteFlags 实例
|
||||||
|
* @return 新的 ByteFlags 实例,表示 XOR 结果
|
||||||
|
*/
|
||||||
|
infix fun xor(other: ByteFlags): ByteFlags {
|
||||||
|
return ByteFlags(
|
||||||
|
this.b0 != other.b0,
|
||||||
|
this.b1 != other.b1,
|
||||||
|
this.b2 != other.b2,
|
||||||
|
this.b3 != other.b3,
|
||||||
|
this.b4 != other.b4,
|
||||||
|
this.b5 != other.b5,
|
||||||
|
this.b6 != other.b6,
|
||||||
|
this.b7 != other.b7
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对当前 [ByteFlags] 执行按位“非”操作(NOT)。
|
||||||
|
*
|
||||||
|
* 每一位取反。
|
||||||
|
*
|
||||||
|
* @return 新的 ByteFlags 实例,所有位取反
|
||||||
|
*/
|
||||||
|
operator fun not(): ByteFlags {
|
||||||
|
return ByteFlags(
|
||||||
|
!b0, !b1, !b2, !b3, !b4, !b5, !b6, !b7
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 返回可读的字符串表示,包含二进制和十六进制形式。
|
||||||
|
*
|
||||||
|
* 示例:`ByteFlags(10100001 = 0xA1)`
|
||||||
|
*
|
||||||
|
* @return 字符串描述
|
||||||
|
*/
|
||||||
|
override fun toString(): String {
|
||||||
|
return "ByteFlags(${toBinaryString()} = ${toHexString()})"
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 伴生对象,提供 [ByteFlags] 的多种静态工厂方法。
|
||||||
|
*/
|
||||||
|
companion object {
|
||||||
|
/**
|
||||||
|
* 创建一个所有位均为 `true` 的 [ByteFlags] 实例。
|
||||||
|
*
|
||||||
|
* @return 全 1 的 ByteFlags(值为 0xFF)
|
||||||
|
*/
|
||||||
|
fun allTrue(): ByteFlags {
|
||||||
|
return ByteFlags(b0 = true, b1 = true, b2 = true, b3 = true, b4 = true, b5 = true, b6 = true, b7 = true)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 创建一个所有位均为 `false` 的 [ByteFlags] 实例。
|
||||||
|
*
|
||||||
|
* @return 全 0 的 ByteFlags(值为 0x00)
|
||||||
|
*/
|
||||||
|
fun allFalse(): ByteFlags {
|
||||||
|
return ByteFlags()
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从 8 位二进制字符串创建 [ByteFlags] 实例。
|
||||||
|
*
|
||||||
|
* 字符串格式:高位在前(MSB first),如 "10000001" 表示 b7=1, b0=1。
|
||||||
|
*
|
||||||
|
* @param binary 8 位二进制字符串(仅含 '0' 和 '1')
|
||||||
|
* @return 对应的 ByteFlags 实例
|
||||||
|
* @throws IllegalArgumentException 如果字符串长度不是 8 或包含非法字符
|
||||||
|
*/
|
||||||
|
fun fromBinaryString(binary: String): ByteFlags {
|
||||||
|
require(binary.length == 8) { "二进制字符串长度必须为8" }
|
||||||
|
require(binary.all { it == '0' || it == '1' }) { "二进制字符串只能包含0和1" }
|
||||||
|
return ByteFlags(
|
||||||
|
binary[7] == '1', // b0 是最低位(对应字符串最后一位)
|
||||||
|
binary[6] == '1',
|
||||||
|
binary[5] == '1',
|
||||||
|
binary[4] == '1',
|
||||||
|
binary[3] == '1',
|
||||||
|
binary[2] == '1',
|
||||||
|
binary[1] == '1',
|
||||||
|
binary[0] == '1' // b7 是最高位(对应字符串第一位)
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从布尔数组创建 [ByteFlags] 实例。
|
||||||
|
*
|
||||||
|
* 使用数组的前 8 个元素(索引 0~7),分别对应 b0~b7。
|
||||||
|
*
|
||||||
|
* @param booleanArray 布尔数组(长度至少为 8)
|
||||||
|
* @return 对应的 ByteFlags 实例
|
||||||
|
* @throws IllegalArgumentException 如果数组长度不足 8
|
||||||
|
*/
|
||||||
|
fun fromBooleanArray(booleanArray: BooleanArray): ByteFlags {
|
||||||
|
return ByteFlags().fromBooleanArray(booleanArray)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从整数创建 [ByteFlags] 实例(仅使用低 8 位)。
|
||||||
|
*
|
||||||
|
* @param value 输入整数
|
||||||
|
* @return 对应的 ByteFlags 实例
|
||||||
|
*/
|
||||||
|
fun fromInt(value: Int): ByteFlags {
|
||||||
|
return ByteFlags((value and 0xFF).toByte())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,31 +16,114 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile ByteUtils.kt
|
* CurrentFile ByteUtils.kt
|
||||||
* LastUpdate 2025-09-15 17:26:34
|
* LastUpdate 2026-05-22 13:26:55
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
@file:JvmName("ByteUtils")
|
@file:JvmName("ByteUtils")
|
||||||
|
|
||||||
package com.mingliqiye.utils.bytes
|
package com.mingliqiye.utils.bytes
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.base.BaseType
|
||||||
|
import com.mingliqiye.utils.stream.SuperStream
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_ASC: Byte = 0x10
|
const val ESC_ASC: Byte = 0x10
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_DESC: Byte = 0x1B
|
const val ESC_DESC: Byte = 0x1B
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_NONE: Byte = 0x00
|
const val ESC_NONE: Byte = 0x00
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_START: Byte = 0x01
|
const val ESC_START: Byte = 0x01
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_END: Byte = 0x02
|
const val ESC_END: Byte = 0x02
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_ESC: Byte = 0x03
|
const val ESC_ESC: Byte = 0x03
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_CONTROL: Byte = 0x04
|
const val ESC_CONTROL: Byte = 0x04
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_DATA: Byte = 0x05
|
const val ESC_DATA: Byte = 0x05
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 转义字符常量定义
|
||||||
|
* 定义了用于数据传输或协议通信中的特殊控制字节值
|
||||||
|
*/
|
||||||
const val ESC_RESERVED: Byte = 0x06
|
const val ESC_RESERVED: Byte = 0x06
|
||||||
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 将字节数组转换为十六进制字符串列表
|
* 将字节数组转换为十六进制字符串列表
|
||||||
|
* @receiver 字节数组
|
||||||
* @return 包含每个字节对应十六进制字符串的列表
|
* @return 包含每个字节对应十六进制字符串的列表
|
||||||
*/
|
*/
|
||||||
fun ByteArray.getByteArrayString(): MutableList<String> {
|
fun ByteArray.getByteArrayString(): MutableList<String> {
|
||||||
return this.toList().stream()
|
return this.toList().stream().map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
|
||||||
.map { a -> String.format("0X%02X", a!!.toInt() and 0xFF) }
|
.collect(SuperStream.toListCollector()) as MutableList<String>
|
||||||
.collect(com.mingliqiye.utils.stream.toList()) as MutableList<String>
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将十六进制字符转换为对应的数值
|
||||||
|
* @receiver 十六进制字符
|
||||||
|
* @return 对应的数值(0-15)
|
||||||
|
* @throws NumberFormatException 当字符不是有效的十六进制字符时抛出
|
||||||
|
*/
|
||||||
|
fun Char.hexDigitToValue(): Int {
|
||||||
|
return when (this) {
|
||||||
|
in '0'..'9' -> this - '0'
|
||||||
|
in 'A'..'F' -> this - 'A' + 10
|
||||||
|
in 'a'..'f' -> this - 'a' + 10
|
||||||
|
else -> throw NumberFormatException("Invalid hex character: $this")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将十六进制字符串转换为字节数组
|
||||||
|
*
|
||||||
|
* @param string 输入的十六进制字符串
|
||||||
|
* @return 转换后的字节数组
|
||||||
|
*/
|
||||||
|
fun hexStringToByteArray(string: String): ByteArray {
|
||||||
|
return string.hexToByteArray()
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字节数组转换为十六进制字符串表示。
|
||||||
|
*
|
||||||
|
* @param bytes 输入的字节数组
|
||||||
|
* @return 对应的十六进制字符串
|
||||||
|
*/
|
||||||
|
fun bytesToHex(bytes: ByteArray): String {
|
||||||
|
return BaseType.BASE16.encode(bytes)
|
||||||
|
}
|
||||||
|
|||||||
@@ -0,0 +1,146 @@
|
|||||||
|
/*
|
||||||
|
* 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 StreamUtils.kt
|
||||||
|
* LastUpdate 2026-01-11 09:41:14
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
@file:JvmName("StreamUtils")
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.bytes
|
||||||
|
|
||||||
|
import java.io.IOException
|
||||||
|
import java.io.InputStream
|
||||||
|
import java.io.OutputStream
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从输入流中读取一个变长整数(VarNumber)。
|
||||||
|
*
|
||||||
|
* 变长整数使用可变长度编码方式,每个字节的最高位表示是否还有后续字节:
|
||||||
|
* - 如果最高位为1,则表示还有下一个字节;
|
||||||
|
* - 如果最高位为0,则表示当前字节是最后一个字节。
|
||||||
|
*
|
||||||
|
* @param size 最大允许读取的字节数,默认为8(即Long类型的最大长度)。
|
||||||
|
* @return 解码后的长整型数值。
|
||||||
|
* @throws IOException 当读取过程中发生IO异常或到达流末尾时抛出。
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun InputStream.readVarNumber(size: Int = 8): Long {
|
||||||
|
var numRead = 0
|
||||||
|
var result: Long = 0
|
||||||
|
var read: Byte
|
||||||
|
do {
|
||||||
|
read = this.read().let {
|
||||||
|
if (it == -1) {
|
||||||
|
throw IOException("Reached end of stream")
|
||||||
|
}
|
||||||
|
it.toByte()
|
||||||
|
}
|
||||||
|
result = result or ((read.toLong() and 127) shl (7 * numRead))
|
||||||
|
numRead++
|
||||||
|
if (numRead > size) {
|
||||||
|
throw IOException("VarNumber is too big")
|
||||||
|
}
|
||||||
|
} while ((read.toLong() and 128) != 0L)
|
||||||
|
return result
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从输入流中读取一个变长整数(VarInt),最大长度限制为4个字节。
|
||||||
|
*
|
||||||
|
* @return 解码后的整型数值。
|
||||||
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun InputStream.readVarInt(): Int = this.readVarNumber(4).toInt()
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从输入流中读取一个变长短整数(VarShort),最大长度限制为2个字节。
|
||||||
|
*
|
||||||
|
* @return 解码后的短整型数值。
|
||||||
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun InputStream.readVarShort(): Short = this.readVarNumber(2).toShort()
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 从输入流中读取一个变长长整数(VarLong),最大长度默认为8个字节。
|
||||||
|
*
|
||||||
|
* @return 解码后的长整型数值。
|
||||||
|
* @throws IOException 当读取过程中发生IO异常时抛出。
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun InputStream.readVarLong(): Long = this.readVarNumber()
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将长整型数值编码为变长格式并写入输出流
|
||||||
|
*
|
||||||
|
* 变长整数使用可变长度编码方式,每个字节的最高位表示是否还有后续字节:
|
||||||
|
* - 如果数值还有更多字节,则最高位设为1;
|
||||||
|
* - 最后一个字节最高位设为0。
|
||||||
|
*
|
||||||
|
* @param value 要写入的长整型数值
|
||||||
|
* @param size 最大允许写入的字节数,默认为8
|
||||||
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun OutputStream.writeVarNumber(value: Long, size: Int = 8) {
|
||||||
|
var v = value
|
||||||
|
var numWritten = 0
|
||||||
|
|
||||||
|
while (v >= 0x80 && numWritten < size - 1) {
|
||||||
|
this.write((v and 0x7F or 0x80).toInt())
|
||||||
|
v = v ushr 7
|
||||||
|
numWritten++
|
||||||
|
}
|
||||||
|
|
||||||
|
if (numWritten >= size) {
|
||||||
|
throw IOException("VarNumber is too big")
|
||||||
|
}
|
||||||
|
|
||||||
|
this.write(v.toInt())
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将整型数值编码为变长格式并写入输出流
|
||||||
|
*
|
||||||
|
* @param value 要写入的整型数值
|
||||||
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun OutputStream.writeVarInt(value: Int): Unit = this.writeVarNumber(value.toLong(), 4)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将短整型数值编码为变长格式并写入输出流
|
||||||
|
*
|
||||||
|
* @param value 要写入的短整型数值
|
||||||
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun OutputStream.writeVarShort(value: Short): Unit = this.writeVarNumber(value.toLong(), 2)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将长整型数值编码为变长格式并写入输出流
|
||||||
|
*
|
||||||
|
* @param value 要写入的长整型数值
|
||||||
|
* @throws IOException 当写入过程中发生IO异常时抛出
|
||||||
|
*/
|
||||||
|
@Throws(IOException::class)
|
||||||
|
fun OutputStream.writeVarLong(value: Long): Unit = this.writeVarNumber(value, 8)
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,48 +16,70 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile CloneUtils.kt
|
* CurrentFile CloneUtils.kt
|
||||||
* LastUpdate 2025-09-15 09:30:37
|
* LastUpdate 2026-02-08 10:36:51
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
@file:JvmName("CloneUtils")
|
@file:JvmName("CloneUtils")
|
||||||
|
|
||||||
package com.mingliqiye.utils.clone
|
package com.mingliqiye.utils.clone
|
||||||
|
|
||||||
import com.mingliqiye.utils.json.JsonApi
|
import com.mingliqiye.utils.exception.JsonException
|
||||||
import com.mingliqiye.utils.json.JsonException
|
import com.mingliqiye.utils.json.api.JSONA
|
||||||
import java.io.*
|
import java.io.*
|
||||||
|
|
||||||
|
|
||||||
inline fun <reified T> Serializable.deepClone(): T {
|
/**
|
||||||
return deepClone(this) as T
|
* 通过 Java 序列化机制对当前对象进行深克隆。
|
||||||
|
*
|
||||||
|
* @param T 对象类型,必须实现 [Serializable]
|
||||||
|
* @return 深克隆后的新对象
|
||||||
|
*/
|
||||||
|
@JvmName("_inline_deepClone")
|
||||||
|
inline fun <reified T : Serializable> T.deepClone(): T {
|
||||||
|
return deepClone(this)
|
||||||
}
|
}
|
||||||
|
|
||||||
inline fun <reified T> T.deepJsonClone(jsonApi: JsonApi): T {
|
/**
|
||||||
try {
|
* 通过 JSON 序列化与反序列化对当前对象进行深克隆。
|
||||||
return jsonApi.convert(this, this!!.javaClass) as T
|
*
|
||||||
|
* @param T 对象类型
|
||||||
} catch (e: Exception) {
|
* @return 深克隆后的新对象
|
||||||
throw JsonException(
|
* @throws JsonException 如果 JSON 转换过程中发生异常
|
||||||
"Failed to deep clone object using JSON",
|
*/
|
||||||
e
|
inline fun <reified T> T.deepJsonClone(): T {
|
||||||
)
|
try {
|
||||||
}
|
return JSONA.convert(this as Any, this!!.javaClass) as T
|
||||||
|
} catch (e: Exception) {
|
||||||
|
throw JsonException(
|
||||||
|
"Failed to deep clone object using JSON", e
|
||||||
|
)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过 Java 序列化机制对对象进行深克隆。
|
||||||
|
*
|
||||||
|
* 将对象序列化到内存后再反序列化,得到一个全新的对象副本。
|
||||||
|
*
|
||||||
|
* @param T 对象类型,必须实现 [Serializable]
|
||||||
|
* @param obj 要克隆的对象
|
||||||
|
* @return 深克隆后的新对象
|
||||||
|
* @throws RuntimeException 如果序列化或反序列化过程中发生 I/O 异常或类找不到
|
||||||
|
*/
|
||||||
@Suppress("UNCHECKED_CAST")
|
@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)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile IsChanged.kt
|
* CurrentFile IsChanged.kt
|
||||||
* LastUpdate 2025-09-15 09:30:37
|
* LastUpdate 2026-01-31 21:13:45
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
|
|
||||||
@@ -34,71 +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()
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 默认构造函数,初始化数据为 null
|
* 无参构造函数,初始数据为 null
|
||||||
*/
|
*/
|
||||||
constructor() : this(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
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,282 @@
|
|||||||
|
/*
|
||||||
|
* 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 ConfigurationProp.kt
|
||||||
|
* LastUpdate 2026-07-01 12:37:05
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.configuration
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 配置属性注解,用于标记配置类中的字段,支持通过命令行参数进行初始化。
|
||||||
|
*
|
||||||
|
* @param name 配置项的名称,默认为空字符串,表示使用字段名作为配置项名称。
|
||||||
|
* @param description 配置项的描述信息,默认为空字符串。
|
||||||
|
* @param showHelper 是否显示帮助信息,默认为 true。
|
||||||
|
*/
|
||||||
|
@Retention(AnnotationRetention.RUNTIME)
|
||||||
|
@Target(
|
||||||
|
AnnotationTarget.TYPE_PARAMETER,
|
||||||
|
AnnotationTarget.VALUE_PARAMETER,
|
||||||
|
AnnotationTarget.FIELD, // 添加字段支持
|
||||||
|
AnnotationTarget.PROPERTY // 添加属性支持
|
||||||
|
)
|
||||||
|
annotation class ConfigurationProp(val name: String = "", val description: String = "", val showHelper: Boolean = true)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据字段名生成对应的 setter 方法名。
|
||||||
|
*
|
||||||
|
* @param fieldName 字段名。
|
||||||
|
* @return 对应的 setter 方法名。
|
||||||
|
*/
|
||||||
|
private fun getSetterName(fieldName: String): String {
|
||||||
|
return "set" + fieldName.take(1).uppercase() + fieldName.substring(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据字段名生成对应的 getter 方法名。
|
||||||
|
*
|
||||||
|
* @param fieldName 字段名。
|
||||||
|
* @return 对应的 getter 方法名。
|
||||||
|
*/
|
||||||
|
private fun getGetterName(fieldName: String): String {
|
||||||
|
return "get" + fieldName.take(1).uppercase() + fieldName.substring(1)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 配置初始化器,用于解析命令行参数并填充配置对象。
|
||||||
|
*/
|
||||||
|
open class ConfigurationProps {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 伴生对象,提供根据命令行参数初始化配置类实例的静态方法。
|
||||||
|
*/
|
||||||
|
companion object {
|
||||||
|
/**
|
||||||
|
* 初始化配置类实例,并根据命令行参数填充其字段。
|
||||||
|
*
|
||||||
|
* @param clazz 配置类的 Class 对象。
|
||||||
|
* @param args 命令行参数数组。
|
||||||
|
* @return 初始化后的配置类实例。
|
||||||
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
fun <T : ConfigurationProps> init(clazz: Class<T>, args: Array<String>): T {
|
||||||
|
val mapsArgs = parseArguments(args)
|
||||||
|
val instance = clazz.getDeclaredConstructor().newInstance()
|
||||||
|
|
||||||
|
processFields(clazz, instance, mapsArgs)
|
||||||
|
|
||||||
|
return instance
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 解析命令行参数,将其转换为键值对映射。
|
||||||
|
*
|
||||||
|
* 支持以下格式:
|
||||||
|
* - `--key=value` 或 `-k=value`:键值对形式。
|
||||||
|
* - `--key value` 或 `-k value`:键和值分开的形式。
|
||||||
|
* - `--flag` 或 `-f`:布尔标志形式,默认值为 "true"。
|
||||||
|
*
|
||||||
|
* @param args 命令行参数数组。
|
||||||
|
* @return 解析后的键值对映射。
|
||||||
|
*/
|
||||||
|
private fun parseArguments(args: Array<String>): Map<String, List<String>> {
|
||||||
|
val mapsArgs = mutableMapOf<String, MutableList<String>>()
|
||||||
|
|
||||||
|
var i = 0
|
||||||
|
while (i < args.size) {
|
||||||
|
val arg = args[i]
|
||||||
|
|
||||||
|
when {
|
||||||
|
arg.startsWith("--") -> {
|
||||||
|
// 处理 --key=value 格式
|
||||||
|
if (arg.contains("=")) {
|
||||||
|
val (key, value) = arg.substring(2).split("=", limit = 2)
|
||||||
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
|
}
|
||||||
|
// 处理 --key value 格式
|
||||||
|
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||||
|
val key = arg.substring(2)
|
||||||
|
val value = args[i + 1]
|
||||||
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
|
i++ // 跳过下一个参数
|
||||||
|
}
|
||||||
|
// 处理 --flag 格式的布尔标志
|
||||||
|
else {
|
||||||
|
val key = arg.substring(2)
|
||||||
|
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
arg.startsWith("-") -> {
|
||||||
|
// 处理 -k=value 格式
|
||||||
|
if (arg.contains("=")) {
|
||||||
|
val (key, value) = arg.substring(1).split("=", limit = 2)
|
||||||
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
|
}
|
||||||
|
// 处理 -k value 格式
|
||||||
|
else if (i + 1 < args.size && !args[i + 1].startsWith("-")) {
|
||||||
|
val key = arg.substring(1)
|
||||||
|
val value = args[i + 1]
|
||||||
|
mapsArgs.getOrPut(key) { mutableListOf() }.add(value)
|
||||||
|
i++
|
||||||
|
}
|
||||||
|
// 处理 -f 格式的布尔标志
|
||||||
|
else {
|
||||||
|
val key = arg.substring(1)
|
||||||
|
mapsArgs.getOrPut(key) { mutableListOf() }.add("true")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
i++
|
||||||
|
}
|
||||||
|
|
||||||
|
return mapsArgs
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 处理配置类中的字段,根据解析出的参数设置字段值。
|
||||||
|
*
|
||||||
|
* @param clazz 配置类的 Class 对象。
|
||||||
|
* @param instance 配置类的实例。
|
||||||
|
* @param mapsArgs 解析后的命令行参数映射。
|
||||||
|
*/
|
||||||
|
private fun <T : ConfigurationProps> processFields(
|
||||||
|
clazz: Class<T>,
|
||||||
|
instance: T,
|
||||||
|
mapsArgs: Map<String, List<String>>,
|
||||||
|
) {
|
||||||
|
val fields = clazz.declaredFields
|
||||||
|
|
||||||
|
for (field in fields) {
|
||||||
|
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||||
|
if (configurationProp != null) {
|
||||||
|
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||||
|
val values = mapsArgs[fieldName]
|
||||||
|
|
||||||
|
if (values != null) {
|
||||||
|
try {
|
||||||
|
val setter = clazz.getDeclaredMethod(
|
||||||
|
getSetterName(field.name),
|
||||||
|
field.type
|
||||||
|
)
|
||||||
|
|
||||||
|
val value = convertValue(field.type, values, configurationProp)
|
||||||
|
setter.invoke(instance, value)
|
||||||
|
} catch (e: Exception) {
|
||||||
|
println("Warning: Failed to set field ${field.name}: ${e.message}")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将字符串值转换为目标类型。
|
||||||
|
*
|
||||||
|
* @param type 目标类型。
|
||||||
|
* @param values 字符串值列表。
|
||||||
|
* @param annotation 配置属性注解。
|
||||||
|
* @return 转换后的值。
|
||||||
|
*/
|
||||||
|
private fun convertValue(
|
||||||
|
type: Class<*>,
|
||||||
|
values: List<String>,
|
||||||
|
annotation: ConfigurationProp,
|
||||||
|
): Any? {
|
||||||
|
val lastValue = values.lastOrNull() ?: return null
|
||||||
|
|
||||||
|
return when (type) {
|
||||||
|
String::class.java -> lastValue
|
||||||
|
|
||||||
|
Integer::class.java, Int::class.java -> try {
|
||||||
|
lastValue.toInt()
|
||||||
|
} catch (e: NumberFormatException) {
|
||||||
|
println("Warning: Invalid integer value '$lastValue'")
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
Long::class.java, java.lang.Long::class.java -> try {
|
||||||
|
lastValue.toLong()
|
||||||
|
} catch (e: NumberFormatException) {
|
||||||
|
println("Warning: Invalid long value '$lastValue'")
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
Double::class.java, java.lang.Double::class.java -> try {
|
||||||
|
lastValue.toDouble()
|
||||||
|
} catch (e: NumberFormatException) {
|
||||||
|
println("Warning: Invalid double value '$lastValue'")
|
||||||
|
null
|
||||||
|
}
|
||||||
|
|
||||||
|
Boolean::class.java, java.lang.Boolean::class.java -> when (lastValue.lowercase()) {
|
||||||
|
"true", "1", "yes", "on" -> true
|
||||||
|
"false", "0", "no", "off" -> false
|
||||||
|
else -> {
|
||||||
|
println("Warning: Invalid boolean value '$lastValue'")
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
List::class.java -> values
|
||||||
|
|
||||||
|
else -> {
|
||||||
|
println("Warning: Unsupported type ${type.simpleName}")
|
||||||
|
null
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 打印配置项帮助信息,列出所有标注了 ConfigurationProp 且允许显示帮助的字段名称、类型和描述。
|
||||||
|
*/
|
||||||
|
fun printHelp() {
|
||||||
|
val fields = this::class.java.declaredFields
|
||||||
|
val help = StringBuilder()
|
||||||
|
for (field in fields) {
|
||||||
|
val configurationProp = field.getAnnotation(ConfigurationProp::class.java)
|
||||||
|
if (configurationProp != null && configurationProp.showHelper) {
|
||||||
|
val fieldName = configurationProp.name.ifEmpty { field.name }
|
||||||
|
help.append("$fieldName -> Type: ${field.type.simpleName}")
|
||||||
|
if (configurationProp.description.isNotEmpty()) {
|
||||||
|
help.append(" Description: ${configurationProp.description}")
|
||||||
|
}
|
||||||
|
help.append("\n")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
println(help)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 当前配置对象所有声明字段的名称与值的映射。
|
||||||
|
*/
|
||||||
|
val fields: Map<String, Any?>
|
||||||
|
get() {
|
||||||
|
val fields = this::class.java.declaredFields
|
||||||
|
val fieldValues = mutableMapOf<String, Any?>()
|
||||||
|
for (field in fields) {
|
||||||
|
field.isAccessible = true
|
||||||
|
val fieldName = field.name
|
||||||
|
val fieldValue = field.get(this)
|
||||||
|
fieldValues[fieldName] = fieldValue
|
||||||
|
}
|
||||||
|
return fieldValues
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -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
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,145 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2025 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile DtoUtils.kt
|
||||||
|
* LastUpdate 2025-09-19 13:38:56
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
@file:JvmName("DtoUtils")
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.dto
|
||||||
|
|
||||||
|
import java.lang.reflect.Field
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 克隆一个对象,通过反射创建新实例并复制所有非静态字段值。
|
||||||
|
*
|
||||||
|
* @param obj 要克隆的对象,必须是非空的任意类型实例。
|
||||||
|
* @return 返回一个新的对象实例,其字段值与原对象一致。
|
||||||
|
*/
|
||||||
|
fun <T : Any> clone(obj: T): T {
|
||||||
|
val clazz = obj.javaClass
|
||||||
|
val constructor = clazz.getDeclaredConstructor().apply {
|
||||||
|
isAccessible = true
|
||||||
|
}
|
||||||
|
val instance = constructor.newInstance()
|
||||||
|
|
||||||
|
// 遍历类及其父类的所有字段进行赋值
|
||||||
|
var currentClass: Class<*>? = clazz
|
||||||
|
while (currentClass != null) {
|
||||||
|
currentClass.declaredFields.forEach { field ->
|
||||||
|
if (!java.lang.reflect.Modifier.isStatic(field.modifiers)) {
|
||||||
|
field.isAccessible = true
|
||||||
|
field.set(instance, field.get(obj))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
currentClass = currentClass.superclass
|
||||||
|
}
|
||||||
|
|
||||||
|
return instance
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 定义 DTO 拷贝行为的枚举类型。
|
||||||
|
*/
|
||||||
|
enum class DotCopyType {
|
||||||
|
/**
|
||||||
|
* 表示使用点拷贝(.copy)方式处理字段。
|
||||||
|
*/
|
||||||
|
DOT_COPY,
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示普通拷贝方式处理字段。
|
||||||
|
*/
|
||||||
|
COPY
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 标注用于控制 DTO 字段拷贝行为的注解。
|
||||||
|
*
|
||||||
|
* @param type 指定拷贝类型,默认为 COPY。
|
||||||
|
*/
|
||||||
|
@Retention(AnnotationRetention.RUNTIME)
|
||||||
|
@Target(
|
||||||
|
AnnotationTarget.TYPE_PARAMETER,
|
||||||
|
AnnotationTarget.VALUE_PARAMETER,
|
||||||
|
AnnotationTarget.FIELD,
|
||||||
|
AnnotationTarget.PROPERTY
|
||||||
|
)
|
||||||
|
annotation class DtoCopy(val type: DotCopyType = DotCopyType.COPY)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将源对象转换为目标 DTO 类型的实例,并根据字段名匹配拷贝字段值。
|
||||||
|
*
|
||||||
|
* @param obj 源对象,包含需要被拷贝的数据。
|
||||||
|
* @param dtoClass 目标 DTO 的 Class 对象。
|
||||||
|
* @return 返回一个新的目标 DTO 实例,字段值已从源对象拷贝。
|
||||||
|
*/
|
||||||
|
fun <R : Any> toDto(obj: Any, dtoClass: Class<R>): R {
|
||||||
|
val instance = dtoClass.getDeclaredConstructor().apply {
|
||||||
|
isAccessible = true
|
||||||
|
}.newInstance()
|
||||||
|
|
||||||
|
val sourceFields = getAllFields(obj.javaClass)
|
||||||
|
|
||||||
|
for (sourceField in sourceFields) {
|
||||||
|
sourceField.isAccessible = true
|
||||||
|
val fieldName = sourceField.name
|
||||||
|
val fieldValue = sourceField.get(obj)
|
||||||
|
|
||||||
|
try {
|
||||||
|
val targetField = dtoClass.getDeclaredField(fieldName).apply {
|
||||||
|
isAccessible = true
|
||||||
|
}
|
||||||
|
if (java.lang.reflect.Modifier.isStatic(targetField.modifiers)) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
val ta = targetField.getAnnotation(DtoCopy::class.java)
|
||||||
|
if (ta != null) {
|
||||||
|
if (ta.type == DotCopyType.DOT_COPY) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
targetField.set(instance, fieldValue)
|
||||||
|
|
||||||
|
} catch (e: NoSuchFieldException) {
|
||||||
|
continue
|
||||||
|
} catch (e: IllegalArgumentException) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return instance
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取指定类及其所有父类中声明的所有字段。
|
||||||
|
*
|
||||||
|
* @param clazz 起始类对象。
|
||||||
|
* @return 包含所有字段的列表。
|
||||||
|
*/
|
||||||
|
private fun getAllFields(clazz: Class<*>): List<Field> {
|
||||||
|
val fields = mutableListOf<Field>()
|
||||||
|
var currentClass: Class<*>? = clazz
|
||||||
|
while (currentClass != null && currentClass != Any::class.java) {
|
||||||
|
fields.addAll(currentClass.declaredFields)
|
||||||
|
currentClass = currentClass.superclass
|
||||||
|
}
|
||||||
|
return fields
|
||||||
|
}
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 BadGatewayException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:07:34
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 502 Bad Gateway 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Bad Gateway"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class BadGatewayException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Bad Gateway",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(502, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 BadRequestException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 400 Bad Request 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Bad Request"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class BadRequestException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Bad Request",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(400, message, cause)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile CodecException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:51:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示编码或解码过程中发生的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class CodecException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 ConflictException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 409 Conflict 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Conflict"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class ConflictException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Conflict",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(409, message, cause)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile EmptyJsonException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:26
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 内容为空时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class EmptyJsonException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 ForbiddenException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 403 Forbidden 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Forbidden"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class ForbiddenException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Forbidden",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(403, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 FoundException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 302 Found 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Found"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class FoundException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Found",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(302, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 GatewayTimeoutException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 504 Gateway Timeout 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Gateway Timeout"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class GatewayTimeoutException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Gateway Timeout",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(504, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 GoneException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 410 Gone 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Gone"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class GoneException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Gone",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(410, message, cause)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile HttpException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:52:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 相关异常的基类,继承自 [MingLiUtilsBaseException]。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
open class HttpException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile HttpStatusException.kt
|
||||||
|
* LastUpdate 2026-10-11 17:02:06
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 异常的基类,继承自 [RuntimeException]。
|
||||||
|
*
|
||||||
|
* @param statusCode HTTP 状态码
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
open class HttpStatusException @JvmOverloads constructor(
|
||||||
|
val statusCode: Int,
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile HttpUrlException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:00
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP URL 无效或处理失败时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
open class HttpUrlException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 HttpVersionNotSupportedException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 505 HTTP Version Not Supported 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "HTTP Version Not Supported"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class HttpVersionNotSupportedException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "HTTP Version Not Supported",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(505, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 InternalServerErrorException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 500 Internal Server Error 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Internal Server Error"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class InternalServerErrorException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Internal Server Error",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(500, message, cause)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile InvalidJsonException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:31
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 内容无效或不合法时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class InvalidJsonException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile JsonException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:07
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 自定义异常类,用于处理 JSON 相关操作中出现的错误。
|
||||||
|
*
|
||||||
|
* 该类继承自 [RuntimeException],提供了三种构造函数以支持不同的异常场景:
|
||||||
|
* 1. 仅包含错误信息的构造函数。
|
||||||
|
* 2. 包含错误信息和原因(Throwable)的构造函数。
|
||||||
|
* 3. 仅包含原因(Throwable)的构造函数。
|
||||||
|
*/
|
||||||
|
open class JsonException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile JsonObjectCastException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:36
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 对象类型转换失败时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class JsonObjectCastException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,54 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile JsonParserException.kt
|
||||||
|
* LastUpdate 2026-11-17 16:22:52
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 解析过程中发生的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class JsonParserException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 格式不正确时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class JsonFormatException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile JsonTypeException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:45
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 JSON 数据类型不匹配时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class JsonTypeException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : JsonException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 LengthRequiredException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 411 Length Required 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Length Required"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class LengthRequiredException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Length Required",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(411, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 MethodNotAllowedException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 405 Method Not Allowed 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Method Not Allowed"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class MethodNotAllowedException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Method Not Allowed",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(405, message, cause)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile MingLiUtilsBaseException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:39:21
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
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(
|
||||||
|
message: String? = null,
|
||||||
|
cause: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : RuntimeException(message, cause, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 MovedPermanentlyException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 301 Moved Permanently 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Moved Permanently"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class MovedPermanentlyException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Moved Permanently",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(301, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 MultipleChoicesException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 300 Multiple Choices 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Multiple Choices"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class MultipleChoicesException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Multiple Choices",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(300, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 NotAcceptableException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 406 Not Acceptable 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Not Acceptable"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class NotAcceptableException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Not Acceptable",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(406, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 NotFoundException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 404 Not Found 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Not Found"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class NotFoundException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Not Found",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(404, message, cause)
|
||||||
@@ -0,0 +1,38 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile NotFoundResourceException.kt
|
||||||
|
* LastUpdate 2026-10-11 16:53:58
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示请求的资源未找到时抛出的异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 null
|
||||||
|
* @param throwable 异常原因,默认为 null
|
||||||
|
* @param enableSuppression 是否启用异常抑制,默认为 false
|
||||||
|
* @param writableStackTrace 是否可写入堆栈跟踪信息,默认为 true
|
||||||
|
*/
|
||||||
|
class NotFoundResourceException @JvmOverloads constructor(
|
||||||
|
message: String? = null,
|
||||||
|
throwable: Throwable? = null,
|
||||||
|
enableSuppression: Boolean = false,
|
||||||
|
writableStackTrace: Boolean = true,
|
||||||
|
) : MingLiUtilsBaseException(message, throwable, enableSuppression, writableStackTrace)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 NotImplementedException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 501 Not Implemented 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Not Implemented"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class NotImplementedException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Not Implemented",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(501, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 NotModifiedException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 304 Not Modified 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Not Modified"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class NotModifiedException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Not Modified",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(304, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 PaymentRequiredException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 402 Payment Required 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Payment Required"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class PaymentRequiredException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Payment Required",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(402, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 PreconditionFailedException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 412 Precondition Failed 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Precondition Failed"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class PreconditionFailedException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Precondition Failed",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(412, message, cause)
|
||||||
+34
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 ProxyAuthenticationRequiredException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 407 Proxy Authentication Required 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Proxy Authentication Required"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class ProxyAuthenticationRequiredException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Proxy Authentication Required",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(407, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 RequestEntityTooLargeException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 413 Request Entity Too Large 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Request Entity Too Large"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class RequestEntityTooLargeException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Request Entity Too Large",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(413, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 RequestTimeoutException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 408 Request Timeout 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Request Timeout"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class RequestTimeoutException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Request Timeout",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(408, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 RequestUriTooLargeException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 414 Request URI Too Large 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Request URI Too Large"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class RequestUriTooLargeException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Request URI Too Large",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(414, message, cause)
|
||||||
+34
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 RequestedRangeNotSatisfiableException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 416 Requested Range Not Satisfiable 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Requested Range Not Satisfiable"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class RequestedRangeNotSatisfiableException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Requested Range Not Satisfiable",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(416, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 SeeOtherException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 303 See Other 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "See Other"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class SeeOtherException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "See Other",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(303, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 ServiceUnavailableException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 503 Service Unavailable 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Service Unavailable"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class ServiceUnavailableException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Service Unavailable",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(503, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 TemporaryRedirectException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 307 Temporary Redirect 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Temporary Redirect"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class TemporaryRedirectException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Temporary Redirect",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(307, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 UnauthorizedException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 401 Unauthorized 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Unauthorized"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class UnauthorizedException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Unauthorized",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(401, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 UnsupportedMediaTypeException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:19
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 415 Unsupported Media Type 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Unsupported Media Type"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class UnsupportedMediaTypeException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Unsupported Media Type",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(415, message, cause)
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
/*
|
||||||
|
* 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 UseProxyException.kt
|
||||||
|
* LastUpdate 2026-10-22 22:09:48
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.exception
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 表示 HTTP 305 Use Proxy 异常。
|
||||||
|
*
|
||||||
|
* @param message 异常信息,默认为 "Use Proxy"
|
||||||
|
* @param cause 异常原因,默认为 null
|
||||||
|
*/
|
||||||
|
class UseProxyException @JvmOverloads constructor(
|
||||||
|
override val message: String? = "Use Proxy",
|
||||||
|
override val cause: Throwable? = null,
|
||||||
|
) : HttpStatusException(305, message, cause)
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile FileUtils.kt
|
* CurrentFile FileUtils.kt
|
||||||
* LastUpdate 2025-09-15 09:12:47
|
* LastUpdate 2026-10-28 22:40:34
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
@file:JvmName("FileUtils")
|
@file:JvmName("FileUtils")
|
||||||
@@ -24,323 +24,723 @@
|
|||||||
package com.mingliqiye.utils.file
|
package com.mingliqiye.utils.file
|
||||||
|
|
||||||
import com.mingliqiye.utils.path.OsPath
|
import com.mingliqiye.utils.path.OsPath
|
||||||
|
import java.io.File
|
||||||
import java.io.IOException
|
import java.io.IOException
|
||||||
import java.nio.charset.Charset
|
import java.nio.charset.Charset
|
||||||
import java.nio.charset.StandardCharsets
|
import java.nio.charset.StandardCharsets
|
||||||
import java.nio.file.Files
|
import java.nio.file.Files
|
||||||
|
import java.nio.file.Path
|
||||||
import java.nio.file.Paths
|
import java.nio.file.Paths
|
||||||
import java.nio.file.StandardOpenOption
|
import java.nio.file.StandardOpenOption
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 默认字符集
|
* 默认字符集
|
||||||
*/
|
*/
|
||||||
|
|
||||||
var DEFAULT_CHARSET: Charset = StandardCharsets.UTF_8
|
var DEFAULT_CHARSET: Charset = StandardCharsets.UTF_8
|
||||||
|
|
||||||
/**
|
// 读取文件内容为字符串
|
||||||
* 读取文件内容为字符串
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @return 文件内容字符串
|
|
||||||
* @throws IOException 读取文件时发生错误
|
|
||||||
*/
|
|
||||||
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun readFileToString(filePath: String): String {
|
/**
|
||||||
return readFileToString(filePath, DEFAULT_CHARSET)
|
* 读取文件内容为字符串,使用默认字符集
|
||||||
|
*
|
||||||
|
* @return 文件内容的字符串表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.readFileToString(): String {
|
||||||
|
return this.readFileToString(DEFAULT_CHARSET)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* 读取文件内容为字符串
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @param charset 字符集
|
|
||||||
* @return 文件内容字符串
|
|
||||||
* @throws IOException 读取文件时发生错误
|
|
||||||
*/
|
|
||||||
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun readFileToString(filePath: String, charset: Charset): String {
|
/**
|
||||||
val path = OsPath.of(filePath)
|
* 读取文件内容为字符串
|
||||||
val bytes = Files.readAllBytes(path)
|
*
|
||||||
return String(bytes, charset)
|
* @param charset 字符编码格式
|
||||||
|
* @return 文件内容的字符串表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.readFileToString(charset: Charset): String {
|
||||||
|
val path = OsPath.of(this)
|
||||||
|
val bytes = Files.readAllBytes(path)
|
||||||
|
return String(bytes, charset)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 将字符串写入文件
|
||||||
* 将字符串写入文件
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @param content 要写入的内容
|
|
||||||
* @throws IOException 写入文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun writeStringToFile(filePath: String, content: String) {
|
/**
|
||||||
writeStringToFile(filePath, content, DEFAULT_CHARSET)
|
* 将字符串写入文件,使用默认字符集
|
||||||
|
*
|
||||||
|
* @param content 要写入的字符串内容
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.writeStringToFile(content: String) {
|
||||||
|
this.writeStringToFile(content, DEFAULT_CHARSET)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* 将字符串写入文件
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @param content 要写入的内容
|
|
||||||
* @param charset 字符集
|
|
||||||
* @throws IOException 写入文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun writeStringToFile(filePath: String, content: String, charset: Charset) {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 将字符串写入文件
|
||||||
path.parent?.let { Files.createDirectories(it) }
|
*
|
||||||
Files.write(path, content.toByteArray(charset))
|
* @param content 要写入的字符串内容
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.writeStringToFile(content: String, charset: Charset) {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
path.parent?.let { Files.createDirectories(it) }
|
||||||
|
Files.write(path, content.toByteArray(charset))
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 读取文件内容为字符串列表(按行分割)
|
||||||
* 读取文件内容为字符串列表(按行分割)
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @return 文件内容按行分割的字符串列表
|
|
||||||
* @throws IOException 读取文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun readLines(filePath: String): List<String> {
|
/**
|
||||||
return readLines(filePath, DEFAULT_CHARSET)
|
* 读取文件内容为字符串列表(按行分割),使用默认字符集
|
||||||
|
*
|
||||||
|
* @return 按行分割的字符串列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.readLines(): List<String> {
|
||||||
|
return this.readLines(DEFAULT_CHARSET)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* 读取文件内容为字符串列表(按行分割)
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @param charset 字符集
|
|
||||||
* @return 文件内容按行分割的字符串列表
|
|
||||||
* @throws IOException 读取文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun readLines(filePath: String, charset: Charset): List<String> {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 读取文件内容为字符串列表(按行分割)
|
||||||
return Files.readAllLines(path, charset)
|
*
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @return 按行分割的字符串列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.readLines(charset: Charset): List<String> {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
return Files.readAllLines(path, charset)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 将字符串列表写入文件(每行一个元素)
|
||||||
* 将字符串列表写入文件(每行一个元素)
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @param lines 要写入的行内容列表
|
|
||||||
* @throws IOException 写入文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun writeLines(filePath: String, lines: List<String>) {
|
/**
|
||||||
writeLines(filePath, lines, DEFAULT_CHARSET)
|
* 将字符串列表写入文件(每行一个元素),使用默认字符集
|
||||||
|
*
|
||||||
|
* @param lines 要写入的字符串列表
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.writeLines(lines: List<String>) {
|
||||||
|
this.writeLines(lines, DEFAULT_CHARSET)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* 将字符串列表写入文件(每行一个元素)
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @param lines 要写入的行内容列表
|
|
||||||
* @param charset 字符集
|
|
||||||
* @throws IOException 写入文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun writeLines(filePath: String, lines: List<String>, charset: Charset) {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 将字符串列表写入文件(每行一个元素)
|
||||||
Files.createDirectories(path.parent)
|
*
|
||||||
Files.write(path, lines, charset)
|
* @param lines 要写入的字符串列表
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.writeLines(lines: List<String>, charset: Charset) {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
Files.createDirectories(path.parent)
|
||||||
|
Files.write(path, lines, charset)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 复制文件
|
||||||
* 复制文件
|
|
||||||
*
|
|
||||||
* @param sourcePath 源文件路径
|
|
||||||
* @param targetPath 目标文件路径
|
|
||||||
* @throws IOException 复制文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun copyFile(sourcePath: String, targetPath: String) {
|
/**
|
||||||
val source = Paths.get(sourcePath)
|
* 复制文件到目标路径
|
||||||
val target = Paths.get(targetPath)
|
*
|
||||||
Files.createDirectories(target.parent)
|
* @param targetPath 目标文件路径
|
||||||
Files.copy(source, target)
|
* @throws IOException 复制文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.copyFile(targetPath: String) {
|
||||||
|
val source = Paths.get(this)
|
||||||
|
val target = Paths.get(targetPath)
|
||||||
|
Files.createDirectories(target.parent)
|
||||||
|
Files.copy(source, target)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 删除文件
|
||||||
/**
|
/**
|
||||||
* 删除文件
|
* 删除文件
|
||||||
*
|
*
|
||||||
* @param filePath 文件路径
|
* @return 删除操作是否成功
|
||||||
* @return 如果文件删除成功返回true,否则返回false
|
|
||||||
*/
|
*/
|
||||||
fun deleteFile(filePath: String): Boolean {
|
fun String.deleteFile(): Boolean {
|
||||||
return try {
|
return try {
|
||||||
val path = Paths.get(filePath)
|
val path = Paths.get(this)
|
||||||
Files.deleteIfExists(path)
|
Files.deleteIfExists(path)
|
||||||
} catch (e: IOException) {
|
} catch (e: IOException) {
|
||||||
false
|
false
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 检查文件是否存在
|
||||||
/**
|
/**
|
||||||
* 检查文件是否存在
|
* 检查文件是否存在
|
||||||
*
|
*
|
||||||
* @param filePath 文件路径
|
* @return 文件是否存在
|
||||||
* @return 如果文件存在返回true,否则返回false
|
|
||||||
*/
|
*/
|
||||||
fun exists(filePath: String): Boolean {
|
fun String.exists(): Boolean {
|
||||||
val path = Paths.get(filePath)
|
val path = Paths.get(this)
|
||||||
return Files.exists(path)
|
return Files.exists(path)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 获取文件大小
|
||||||
/**
|
/**
|
||||||
* 获取文件大小
|
* 获取文件大小
|
||||||
*
|
*
|
||||||
* @param filePath 文件路径
|
* @return 文件大小(字节),如果获取失败则返回-1
|
||||||
* @return 文件大小(字节),如果文件不存在返回-1
|
|
||||||
*/
|
*/
|
||||||
|
fun String.getFileSize(): Long {
|
||||||
fun getFileSize(filePath: String): Long {
|
return try {
|
||||||
return try {
|
val path = Paths.get(this)
|
||||||
val path = Paths.get(filePath)
|
Files.size(path)
|
||||||
Files.size(path)
|
} catch (e: IOException) {
|
||||||
} catch (e: IOException) {
|
-1
|
||||||
-1
|
}
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// 创建目录
|
||||||
/**
|
/**
|
||||||
* 创建目录
|
* 创建目录
|
||||||
*
|
*
|
||||||
* @param dirPath 目录路径
|
* @return 创建操作是否成功
|
||||||
* @return 如果目录创建成功返回true,否则返回false
|
|
||||||
*/
|
*/
|
||||||
|
fun String.createDirectory(): Boolean {
|
||||||
fun createDirectory(dirPath: String): Boolean {
|
return try {
|
||||||
return try {
|
val path = Paths.get(this)
|
||||||
val path = Paths.get(dirPath)
|
Files.createDirectories(path)
|
||||||
Files.createDirectories(path)
|
true
|
||||||
true
|
} catch (e: IOException) {
|
||||||
} catch (e: IOException) {
|
false
|
||||||
false
|
}
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 读取文件内容为字节数组
|
||||||
* 获取文件扩展名
|
|
||||||
*
|
|
||||||
* @param fileName 文件名
|
|
||||||
* @return 文件扩展名(不包含点号),如果无扩展名返回空字符串
|
|
||||||
*/
|
|
||||||
|
|
||||||
fun getFileExtension(fileName: String): String {
|
|
||||||
if (fileName.isEmpty()) {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
val lastDotIndex = fileName!!.lastIndexOf('.')
|
|
||||||
return if (lastDotIndex == -1 || lastDotIndex == fileName.length - 1) {
|
|
||||||
""
|
|
||||||
} else fileName.substring(lastDotIndex + 1)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 获取不带扩展名的文件名
|
|
||||||
*
|
|
||||||
* @param fileName 文件名
|
|
||||||
* @return 不带扩展名的文件名
|
|
||||||
*/
|
|
||||||
fun getFileNameWithoutExtension(fileName: String): String {
|
|
||||||
if (fileName.isEmpty()) {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
val lastDotIndex = fileName!!.lastIndexOf('.')
|
|
||||||
return if (lastDotIndex == -1) {
|
|
||||||
fileName
|
|
||||||
} else fileName.substring(0, lastDotIndex)
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 读取文件内容为字节数组
|
|
||||||
*
|
|
||||||
* @param filePath 文件路径
|
|
||||||
* @return 文件内容的字节数组
|
|
||||||
* @throws IOException 读取文件时发生错误
|
|
||||||
*/
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun readFileToByteArray(filePath: String): ByteArray {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 读取文件内容为字节数组
|
||||||
return Files.readAllBytes(path)
|
*
|
||||||
|
* @return 文件内容的字节数组表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.readByteArray(): ByteArray {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
return Files.readAllBytes(path)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 将字节数组写入文件
|
||||||
* 将字节数组写入文件
|
@Throws(IOException::class)
|
||||||
*
|
/**
|
||||||
* @param filePath 文件路径
|
* 将字节数组写入文件
|
||||||
* @param data 要写入的字节数据
|
*
|
||||||
* @throws IOException 写入文件时发生错误
|
* @param data 要写入的字节数组
|
||||||
*/
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.writeByteArray(data: ByteArray) {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
Files.createDirectories(path.parent)
|
||||||
|
Files.write(path, data)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组追加到文件末尾
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组追加到文件末尾
|
||||||
|
*
|
||||||
|
* @param data 要追加的字节数组
|
||||||
|
* @throws IOException 追加文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.appendByteArray(data: ByteArray) {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
Files.createDirectories(path.parent)
|
||||||
|
Files.write(
|
||||||
|
path, data, StandardOpenOption.CREATE, StandardOpenOption.APPEND
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 分块读取大文件为字节数组列表
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 分块读取大文件为字节数组列表
|
||||||
|
*
|
||||||
|
* @param chunkSize 每个块的大小
|
||||||
|
* @return 字节数组列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.readByteArrayChunks(chunkSize: Int): List<ByteArray> {
|
||||||
|
val chunks = mutableListOf<ByteArray>()
|
||||||
|
val path = Paths.get(this)
|
||||||
|
|
||||||
|
Files.newInputStream(path).use { inputStream ->
|
||||||
|
val buffer = ByteArray(chunkSize)
|
||||||
|
var bytesRead: Int
|
||||||
|
while (inputStream.read(buffer).also { bytesRead = it } != -1) {
|
||||||
|
val chunk = ByteArray(bytesRead)
|
||||||
|
System.arraycopy(buffer, 0, chunk, 0, bytesRead)
|
||||||
|
chunks.add(chunk)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return chunks
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组列表写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组列表写入文件
|
||||||
|
*
|
||||||
|
* @param chunks 字节数组列表
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun String.writeByteArrayChunks(chunks: List<ByteArray>) {
|
||||||
|
val path = Paths.get(this)
|
||||||
|
Files.createDirectories(path.parent)
|
||||||
|
|
||||||
|
Files.newOutputStream(path).use { outputStream ->
|
||||||
|
for (chunk in chunks) {
|
||||||
|
outputStream.write(chunk)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 读取文件内容为字符串
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字符串,使用默认字符集
|
||||||
|
*
|
||||||
|
* @return 文件内容的字符串表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.readFileToString(): String {
|
||||||
|
return this.readFileToString(DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun writeByteArrayToFile(filePath: String, data: ByteArray) {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 读取文件内容为字符串
|
||||||
Files.createDirectories(path.parent)
|
*
|
||||||
Files.write(path, data)
|
* @param charset 字符编码格式
|
||||||
|
* @return 文件内容的字符串表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.readFileToString(charset: Charset): String {
|
||||||
|
val bytes = Files.readAllBytes(this)
|
||||||
|
return String(bytes, charset)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 将字符串写入文件
|
||||||
* 将字节数组追加到文件末尾
|
@Throws(IOException::class)
|
||||||
*
|
/**
|
||||||
* @param filePath 文件路径
|
* 将字符串写入文件,使用默认字符集
|
||||||
* @param data 要追加的字节数据
|
*
|
||||||
* @throws IOException 追加数据时发生错误
|
* @param content 要写入的字符串内容
|
||||||
*/
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.writeStringToFile(content: String) {
|
||||||
|
this.writeStringToFile(content, DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun appendByteArrayToFile(filePath: String, data: ByteArray) {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 将字符串写入文件
|
||||||
Files.createDirectories(path.parent)
|
*
|
||||||
Files.write(
|
* @param content 要写入的字符串内容
|
||||||
path, data, StandardOpenOption.CREATE, StandardOpenOption.APPEND
|
* @param charset 字符编码格式
|
||||||
)
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.writeStringToFile(content: String, charset: Charset) {
|
||||||
|
this.parent?.let { Files.createDirectories(it) }
|
||||||
|
Files.write(this, content.toByteArray(charset))
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 读取文件内容为字符串列表
|
||||||
* 分块读取大文件为字节数组列表
|
@Throws(IOException::class)
|
||||||
*
|
/**
|
||||||
* @param filePath 文件路径
|
* 读取文件内容为字符串列表,使用默认字符集
|
||||||
* @param chunkSize 每块大小(字节)
|
*
|
||||||
* @return 文件内容按指定大小分割的字节数组列表
|
* @return 按行分割的字符串列表
|
||||||
* @throws IOException 读取文件时发生错误
|
* @throws IOException 读取文件时发生错误
|
||||||
*/
|
*/
|
||||||
|
fun Path.readLines(): List<String> {
|
||||||
|
return this.readLines(DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun readFileToByteArrayChunks(filePath: String, chunkSize: Int): List<ByteArray> {
|
/**
|
||||||
val chunks = mutableListOf<ByteArray>()
|
* 读取文件内容为字符串列表
|
||||||
val path = Paths.get(filePath)
|
*
|
||||||
|
* @param charset 字符编码格式
|
||||||
Files.newInputStream(path).use { inputStream ->
|
* @return 按行分割的字符串列表
|
||||||
val buffer = ByteArray(chunkSize)
|
* @throws IOException 读取文件时发生错误
|
||||||
var bytesRead: Int
|
*/
|
||||||
while (inputStream.read(buffer).also { bytesRead = it } != -1) {
|
fun Path.readLines(charset: Charset): List<String> {
|
||||||
val chunk = ByteArray(bytesRead)
|
return Files.readAllLines(this, charset)
|
||||||
System.arraycopy(buffer, 0, chunk, 0, bytesRead)
|
|
||||||
chunks.add(chunk)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return chunks
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
// 将字符串列表写入文件
|
||||||
* 将字节数组列表写入文件
|
@Throws(IOException::class)
|
||||||
*
|
/**
|
||||||
* @param filePath 文件路径
|
* 将字符串列表写入文件,使用默认字符集
|
||||||
* @param chunks 字节数组列表
|
*
|
||||||
* @throws IOException 写入文件时发生错误
|
* @param lines 要写入的字符串列表
|
||||||
*/
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.writeLines(lines: List<String>) {
|
||||||
|
this.writeLines(lines, DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
@Throws(IOException::class)
|
@Throws(IOException::class)
|
||||||
fun writeByteArrayChunksToFile(filePath: String, chunks: List<ByteArray>) {
|
/**
|
||||||
val path = Paths.get(filePath)
|
* 将字符串列表写入文件
|
||||||
Files.createDirectories(path.parent)
|
*
|
||||||
|
* @param lines 要写入的字符串列表
|
||||||
Files.newOutputStream(path).use { outputStream ->
|
* @param charset 字符编码格式
|
||||||
for (chunk in chunks) {
|
* @throws IOException 写入文件时发生错误
|
||||||
outputStream.write(chunk)
|
*/
|
||||||
}
|
fun Path.writeLines(lines: List<String>, charset: Charset) {
|
||||||
}
|
Files.createDirectories(this.parent)
|
||||||
|
Files.write(this, lines, charset)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 复制文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 复制文件到目标路径
|
||||||
|
*
|
||||||
|
* @param target 目标文件路径
|
||||||
|
* @throws IOException 复制文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.copyTo(target: Path) {
|
||||||
|
Files.createDirectories(target.parent)
|
||||||
|
Files.copy(this, target)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 删除文件
|
||||||
|
/**
|
||||||
|
* 删除文件
|
||||||
|
*
|
||||||
|
* @return 删除操作是否成功
|
||||||
|
*/
|
||||||
|
fun Path.delete(): Boolean {
|
||||||
|
return try {
|
||||||
|
Files.deleteIfExists(this)
|
||||||
|
} catch (e: IOException) {
|
||||||
|
false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 检查文件是否存在
|
||||||
|
/**
|
||||||
|
* 检查文件是否存在
|
||||||
|
*
|
||||||
|
* @return 文件是否存在
|
||||||
|
*/
|
||||||
|
fun Path.exists(): Boolean {
|
||||||
|
return Files.exists(this)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 获取文件大小
|
||||||
|
/**
|
||||||
|
* 获取文件大小
|
||||||
|
*
|
||||||
|
* @return 文件大小(字节),如果获取失败则返回-1
|
||||||
|
*/
|
||||||
|
fun Path.getFileSize(): Long {
|
||||||
|
return try {
|
||||||
|
Files.size(this)
|
||||||
|
} catch (e: IOException) {
|
||||||
|
-1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 读取文件内容为字节数组
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字节数组
|
||||||
|
*
|
||||||
|
* @return 文件内容的字节数组表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.readByteArray(): ByteArray {
|
||||||
|
return Files.readAllBytes(this)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组写入文件
|
||||||
|
*
|
||||||
|
* @param data 要写入的字节数组
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.writeByteArray(data: ByteArray) {
|
||||||
|
Files.createDirectories(this.parent)
|
||||||
|
Files.write(this, data)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组追加到文件末尾
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组追加到文件末尾
|
||||||
|
*
|
||||||
|
* @param data 要追加的字节数组
|
||||||
|
* @throws IOException 追加文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.appendByteArray(data: ByteArray) {
|
||||||
|
Files.createDirectories(this.parent)
|
||||||
|
Files.write(this, data, StandardOpenOption.CREATE, StandardOpenOption.APPEND)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 分块读取大文件为字节数组列表
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 分块读取大文件为字节数组列表
|
||||||
|
*
|
||||||
|
* @param chunkSize 每个块的大小
|
||||||
|
* @return 字节数组列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.readByteArrayChunks(chunkSize: Int): List<ByteArray> {
|
||||||
|
val chunks = mutableListOf<ByteArray>()
|
||||||
|
|
||||||
|
Files.newInputStream(this).use { inputStream ->
|
||||||
|
val buffer = ByteArray(chunkSize)
|
||||||
|
var bytesRead: Int
|
||||||
|
while (inputStream.read(buffer).also { bytesRead = it } != -1) {
|
||||||
|
val chunk = ByteArray(bytesRead)
|
||||||
|
System.arraycopy(buffer, 0, chunk, 0, bytesRead)
|
||||||
|
chunks.add(chunk)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return chunks
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组列表写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组列表写入文件
|
||||||
|
*
|
||||||
|
* @param chunks 字节数组列表
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun Path.writeByteArrayChunks(chunks: List<ByteArray>) {
|
||||||
|
Files.createDirectories(this.parent)
|
||||||
|
|
||||||
|
Files.newOutputStream(this).use { outputStream ->
|
||||||
|
for (chunk in chunks) {
|
||||||
|
outputStream.write(chunk)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 读取文件内容为字符串
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字符串,使用默认字符集
|
||||||
|
*
|
||||||
|
* @return 文件内容的字符串表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.readFileToString(): String {
|
||||||
|
return this.readFileToString(DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字符串
|
||||||
|
*
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @return 文件内容的字符串表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.readFileToString(charset: Charset): String {
|
||||||
|
return String(this.readBytes(), charset)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字符串写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字符串写入文件,使用默认字符集
|
||||||
|
*
|
||||||
|
* @param content 要写入的字符串内容
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.writeStringToFile(content: String) {
|
||||||
|
this.writeStringToFile(content, DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字符串写入文件
|
||||||
|
*
|
||||||
|
* @param content 要写入的字符串内容
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.writeStringToFile(content: String, charset: Charset) {
|
||||||
|
this.parentFile?.mkdirs()
|
||||||
|
this.writeText(content, charset)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 读取文件内容为字符串列表
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字符串列表,使用默认字符集
|
||||||
|
*
|
||||||
|
* @return 按行分割的字符串列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.readLines(): List<String> {
|
||||||
|
return this.readLines(DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字符串列表
|
||||||
|
*
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @return 按行分割的字符串列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.readLines(charset: Charset): List<String> {
|
||||||
|
return this.readLines(charset)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字符串列表写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字符串列表写入文件,使用默认字符集
|
||||||
|
*
|
||||||
|
* @param lines 要写入的字符串列表
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.writeLines(lines: List<String>) {
|
||||||
|
this.writeLines(lines, DEFAULT_CHARSET)
|
||||||
|
}
|
||||||
|
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字符串列表写入文件
|
||||||
|
*
|
||||||
|
* @param lines 要写入的字符串列表
|
||||||
|
* @param charset 字符编码格式
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.writeLines(lines: List<String>, charset: Charset) {
|
||||||
|
this.parentFile?.mkdirs()
|
||||||
|
for (line in lines) {
|
||||||
|
this.writeText(line + System.lineSeparator(), charset)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// 复制文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 复制文件到目标文件
|
||||||
|
*
|
||||||
|
* @param target 目标文件
|
||||||
|
* @throws IOException 复制文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.copyTo(target: File) {
|
||||||
|
target.parentFile?.mkdirs()
|
||||||
|
this.copyTo(target, overwrite = true)
|
||||||
|
}
|
||||||
|
// 获取文件大小
|
||||||
|
/**
|
||||||
|
* 获取文件大小
|
||||||
|
*
|
||||||
|
* @return 文件大小(字节),如果文件不存在则返回-1L
|
||||||
|
*/
|
||||||
|
fun File.getFileSize(): Long {
|
||||||
|
return if (this.exists()) this.length() else -1L
|
||||||
|
}
|
||||||
|
|
||||||
|
// 创建目录
|
||||||
|
/**
|
||||||
|
* 创建目录
|
||||||
|
*
|
||||||
|
* @return 创建操作是否成功
|
||||||
|
*/
|
||||||
|
fun File.createDirectory(): Boolean {
|
||||||
|
return this.mkdirs()
|
||||||
|
}
|
||||||
|
|
||||||
|
// 读取文件内容为字节数组
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 读取文件内容为字节数组
|
||||||
|
*
|
||||||
|
* @return 文件内容的字节数组表示
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.readByteArray(): ByteArray {
|
||||||
|
return this.readBytes()
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组写入文件
|
||||||
|
*
|
||||||
|
* @param data 要写入的字节数组
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.writeByteArray(data: ByteArray) {
|
||||||
|
this.parentFile?.mkdirs()
|
||||||
|
this.writeBytes(data)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组追加到文件末尾
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组追加到文件末尾
|
||||||
|
*
|
||||||
|
* @param data 要追加的字节数组
|
||||||
|
* @throws IOException 追加文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.appendByteArray(data: ByteArray) {
|
||||||
|
this.parentFile?.mkdirs()
|
||||||
|
this.appendBytes(data)
|
||||||
|
}
|
||||||
|
|
||||||
|
// 分块读取大文件为字节数组列表
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 分块读取大文件为字节数组列表
|
||||||
|
*
|
||||||
|
* @param chunkSize 每个块的大小
|
||||||
|
* @return 字节数组列表
|
||||||
|
* @throws IOException 读取文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.readByteArrayChunks(chunkSize: Int): List<ByteArray> {
|
||||||
|
val chunks = mutableListOf<ByteArray>()
|
||||||
|
|
||||||
|
this.inputStream().use { inputStream ->
|
||||||
|
val buffer = ByteArray(chunkSize)
|
||||||
|
var bytesRead: Int
|
||||||
|
while (inputStream.read(buffer).also { bytesRead = it } != -1) {
|
||||||
|
val chunk = ByteArray(bytesRead)
|
||||||
|
System.arraycopy(buffer, 0, chunk, 0, bytesRead)
|
||||||
|
chunks.add(chunk)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return chunks
|
||||||
|
}
|
||||||
|
|
||||||
|
// 将字节数组列表写入文件
|
||||||
|
@Throws(IOException::class)
|
||||||
|
/**
|
||||||
|
* 将字节数组列表写入文件
|
||||||
|
*
|
||||||
|
* @param chunks 字节数组列表
|
||||||
|
* @throws IOException 写入文件时发生错误
|
||||||
|
*/
|
||||||
|
fun File.writeByteArrayChunks(chunks: List<ByteArray>) {
|
||||||
|
this.parentFile?.mkdirs()
|
||||||
|
|
||||||
|
this.outputStream().use { outputStream ->
|
||||||
|
for (chunk in chunks) {
|
||||||
|
outputStream.write(chunk)
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,7 +16,7 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile ForEach.kt
|
* CurrentFile ForEach.kt
|
||||||
* LastUpdate 2025-09-15 12:44:46
|
* LastUpdate 2026-02-27 12:45:39
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
@file:JvmName("ForEach")
|
@file:JvmName("ForEach")
|
||||||
@@ -35,36 +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 循环并手动维护索引
|
||||||
var index = 0
|
for ((index, element) in iterable.withIndex()) {
|
||||||
for (element in iterable) {
|
action.call(element, index)
|
||||||
action.call(element, index)
|
}
|
||||||
index++
|
}
|
||||||
}
|
}
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -76,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)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -102,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++
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -144,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
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -168,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -181,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -195,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -209,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -221,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -233,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -246,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -259,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -271,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -283,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -296,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -309,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -321,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -333,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -346,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -359,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -371,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -383,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -396,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -409,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -421,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -433,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -446,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -459,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -471,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -483,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -496,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -509,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -521,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -533,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -546,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -559,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -571,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -583,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -596,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -609,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)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -625,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) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -641,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) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -656,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) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -671,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) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -687,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) })
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -703,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) })
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,84 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName mingli-utils
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile Debouncer.kt
|
||||||
|
* LastUpdate 2026-05-23 10:30:38
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.functions
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.netty.NamedThreadFactory
|
||||||
|
import java.util.concurrent.*
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 防抖器类,用于实现防抖功能,防止在短时间内重复执行相同任务
|
||||||
|
*
|
||||||
|
* @author MingLiPro
|
||||||
|
*/
|
||||||
|
class Debouncer(private val delay: Long, unit: TimeUnit) {
|
||||||
|
|
||||||
|
private val scheduler: ScheduledExecutorService = Executors.newSingleThreadScheduledExecutor(
|
||||||
|
NamedThreadFactory { clazz, poolNumber, threadNumber ->
|
||||||
|
"Debouncer-$poolNumber-$threadNumber"
|
||||||
|
}
|
||||||
|
)
|
||||||
|
private val delayedMap: ConcurrentHashMap<Any, Future<*>> = ConcurrentHashMap()
|
||||||
|
private val delayMillis: Long = unit.toMillis(delay)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 执行防抖操作,如果在指定延迟时间内再次调用相同key的任务,则取消之前的任务并重新计时
|
||||||
|
*
|
||||||
|
* @param key 任务的唯一标识符,用于区分不同任务
|
||||||
|
* @param task 要执行的任务
|
||||||
|
*/
|
||||||
|
fun debounce(key: Any, task: Runnable) {
|
||||||
|
// 提交新任务并获取之前可能存在的任务
|
||||||
|
val prev = delayedMap.put(
|
||||||
|
key,
|
||||||
|
scheduler.schedule(
|
||||||
|
{
|
||||||
|
try {
|
||||||
|
task.run()
|
||||||
|
} finally {
|
||||||
|
// 任务执行完成后从映射中移除
|
||||||
|
delayedMap.remove(key)
|
||||||
|
}
|
||||||
|
},
|
||||||
|
delayMillis,
|
||||||
|
TimeUnit.MILLISECONDS
|
||||||
|
)
|
||||||
|
)
|
||||||
|
|
||||||
|
// 如果之前存在任务,则取消它
|
||||||
|
prev?.cancel(true)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 关闭防抖器,取消所有待执行的任务并关闭调度器
|
||||||
|
*/
|
||||||
|
fun shutdown() {
|
||||||
|
// 先取消所有延迟任务
|
||||||
|
for (future in delayedMap.values) {
|
||||||
|
future.cancel(true)
|
||||||
|
}
|
||||||
|
delayedMap.clear()
|
||||||
|
|
||||||
|
// 再关闭调度器
|
||||||
|
scheduler.shutdownNow()
|
||||||
|
}
|
||||||
|
}
|
||||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,305 @@
|
|||||||
|
/*
|
||||||
|
* 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 Pipeline.kt
|
||||||
|
* LastUpdate 2026-10-20 20:59:13
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.functions
|
||||||
|
|
||||||
|
import com.mingliqiye.utils.require.requireTrue
|
||||||
|
import kotlin.reflect.KClass
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 流水线操作类,提供链式调用的操作方式来处理数据转换和操作
|
||||||
|
* @param T 泛型类型,表示流水线中处理的数据类型
|
||||||
|
*/
|
||||||
|
class Pipeline<T>(private val value: T) {
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对当前值进行转换操作,并返回新的Pipeline实例
|
||||||
|
* @param transformer 转换函数,接收当前值并返回转换后的结果
|
||||||
|
* @return 包含转换后结果的新Pipeline实例
|
||||||
|
*/
|
||||||
|
fun <R> transform(transformer: P1RFunction<T, R>): Pipeline<R> = Pipeline(transformer.call(value))
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对当前值进行转换操作,功能与transform相同,提供不同的方法名选择
|
||||||
|
* @param transformer 转换函数,接收当前值并返回转换后的结果
|
||||||
|
* @return 包含转换后结果的新Pipeline实例
|
||||||
|
*/
|
||||||
|
fun <R> then(transformer: P1RFunction<T, R>): Pipeline<R> = transform(transformer)
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 消费当前值但不改变流水线状态,用于执行副作用操作
|
||||||
|
* @param consumer 消费函数,接收当前值进行消费操作
|
||||||
|
* @return 当前Pipeline实例,支持链式调用
|
||||||
|
*/
|
||||||
|
fun consume(consumer: P1Function<T>): Pipeline<T> {
|
||||||
|
consumer.call(value)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 判断当前值是否为null
|
||||||
|
* @return true表示当前值为null,false表示不为null
|
||||||
|
*/
|
||||||
|
fun isNull(): Boolean = (value == null)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 判断当前值是否不为null
|
||||||
|
* @return true表示当前值不为null,false表示为null
|
||||||
|
*/
|
||||||
|
fun isNotNull(): Boolean = (value != null)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据条件过滤当前值,如果条件满足则保持原值,否则设置为null
|
||||||
|
* @param predicate 过滤条件函数,接收当前值并返回布尔值
|
||||||
|
* @return 包含过滤后结果的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun filter(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
|
||||||
|
if (predicate.call(value)) Pipeline(value) else Pipeline(null)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 获取当前流水线中的值
|
||||||
|
* @return 当前流水线中存储的值
|
||||||
|
*/
|
||||||
|
fun getValue(): T = value
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 安全地转换当前值,允许转换结果为null
|
||||||
|
* @param transformer 转换函数,可能返回null
|
||||||
|
* @return 包含转换后结果(可能为null)的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun <R> safeTransform(transformer: P1RFunction<T, R?>): Pipeline<R?> = Pipeline(transformer.call(value))
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前值映射为另一个Pipeline实例
|
||||||
|
* @param mapper 映射函数,接收当前值并返回Pipeline实例
|
||||||
|
* @return 映射后的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun <R> flatMap(mapper: P1RFunction<T, Pipeline<R>>): Pipeline<R> = mapper.call(value)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前值映射为非null结果,如果当前值为null则直接返回null
|
||||||
|
* @param mapper 映射函数,可能返回null
|
||||||
|
* @return 包含映射后结果的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun <R> mapNotNull(mapper: P1RFunction<T, R?>): Pipeline<out R?> =
|
||||||
|
if (value != null) Pipeline(mapper.call(value)!!) else Pipeline(null)
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 将当前值强制转换为指定类型
|
||||||
|
* @param type 目标类型Class对象
|
||||||
|
* @return 包含转换后类型的Pipeline实例
|
||||||
|
* @throws ClassCastException 当类型转换失败时抛出异常
|
||||||
|
*/
|
||||||
|
@Throws(ClassCastException::class)
|
||||||
|
@Suppress("UNCHECKED_CAST")
|
||||||
|
fun <E> cast(type: Class<E>): Pipeline<E> = Pipeline(value as E)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据条件判断是否保留当前值,条件满足时保留,否则返回null
|
||||||
|
* @param predicate 条件判断函数
|
||||||
|
* @return 包含条件判断结果的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun takeIf(predicate: P1RFunction<T, Boolean>): Pipeline<T?> = Pipeline(if (predicate.call(value)) value else null)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 根据条件判断是否保留当前值,条件不满足时保留,否则返回null
|
||||||
|
* @param predicate 条件判断函数
|
||||||
|
* @return 包含条件判断结果的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun takeUnless(predicate: P1RFunction<T, Boolean>): Pipeline<T?> =
|
||||||
|
Pipeline(if (!predicate.call(value)) value else null)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 在当前值上执行指定操作并返回操作结果
|
||||||
|
* @param block 执行函数,接收当前值并返回结果
|
||||||
|
* @return 包含执行结果的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun <R> let(block: P1RFunction<T, R>): Pipeline<R> = Pipeline(block.call(value))
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 如果当前值不为null则返回自身,否则返回默认值的Pipeline实例
|
||||||
|
* @param defaultValue 默认值
|
||||||
|
* @return 当前值或默认值的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun orElse(defaultValue: T): Pipeline<T> = if (value != null) this else Pipeline(defaultValue)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 如果当前值不为null则返回自身,否则通过供应商函数获取默认值
|
||||||
|
* @param supplier 默认值供应商函数
|
||||||
|
* @return 当前值或供应商提供的值的Pipeline实例
|
||||||
|
*/
|
||||||
|
fun orElseGet(supplier: RFunction<T>): Pipeline<T> = if (value != null) this else Pipeline(supplier.call())
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 验证当前值是否等于指定值,如果不相等则抛出异常
|
||||||
|
* @param any 比较的目标值
|
||||||
|
* @param message 错误消息
|
||||||
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
any: Any, message: String, exception: Class<out Exception> = IllegalArgumentException::class.java,
|
||||||
|
): Pipeline<T> {
|
||||||
|
requireTrue(any == value, exception, message)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 验证当前值是否等于指定值,如果不相等则抛出IllegalArgumentException异常
|
||||||
|
* @param any 比较的目标值
|
||||||
|
* @param message 错误消息
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
any: Any, message: String,
|
||||||
|
): Pipeline<T> {
|
||||||
|
requireTrue(any == value, message)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
|
||||||
|
* @param must 验证条件函数
|
||||||
|
* @param message 错误消息
|
||||||
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
must: P1RFunction<T, Boolean>,
|
||||||
|
message: String,
|
||||||
|
exception: Class<out Throwable> = IllegalArgumentException::class.java,
|
||||||
|
): Pipeline<T> {
|
||||||
|
requireTrue(must.call(value), exception, message)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 验证当前值是否等于指定值,如果不相等则抛出异常
|
||||||
|
* @param any 比较的目标值
|
||||||
|
* @param message 错误消息
|
||||||
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
any: Any,
|
||||||
|
message: String,
|
||||||
|
exception: KClass<out Throwable> = IllegalArgumentException::class,
|
||||||
|
): Pipeline<T> {
|
||||||
|
requireTrue(any == value, exception.java, message)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出异常
|
||||||
|
* @param must 验证条件函数
|
||||||
|
* @param message 错误消息
|
||||||
|
* @param exception 异常类型,默认为IllegalArgumentException
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
must: (T) -> Boolean,
|
||||||
|
message: String,
|
||||||
|
exception: KClass<out Throwable> = IllegalArgumentException::class,
|
||||||
|
): Pipeline<T> {
|
||||||
|
requireTrue(must(value), exception.java, message)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用P1RFunction验证当前值是否满足条件,不满足则抛出IllegalArgumentException异常
|
||||||
|
* @param must 验证条件函数
|
||||||
|
* @param message 错误消息
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
must: P1RFunction<T, Boolean>, message: String,
|
||||||
|
): Pipeline<T> {
|
||||||
|
requireTrue(must.call(value), message)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 对当前值执行指定操作但不改变流水线状态
|
||||||
|
* @param block 执行函数,接收当前值
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun also(block: P1Function<T>): Pipeline<T> {
|
||||||
|
block.call(value)
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 验证当前值是否满足指定条件,不满足则抛出IllegalArgumentException异常
|
||||||
|
* @param predicate 验证条件函数
|
||||||
|
* @param lazyMessage 延迟错误消息生成函数,默认返回"Requirement failed"
|
||||||
|
* @return 当前Pipeline实例
|
||||||
|
*/
|
||||||
|
fun require(
|
||||||
|
predicate: P1RFunction<T, Boolean>,
|
||||||
|
lazyMessage: P1RFunction<T, Any> = P1RFunction { "Requirement failed" },
|
||||||
|
): Pipeline<T> {
|
||||||
|
if (!predicate.call(value)) {
|
||||||
|
throw IllegalArgumentException(lazyMessage.call(value).toString())
|
||||||
|
}
|
||||||
|
return this
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用比较器比较当前值与另一个值
|
||||||
|
* @param other 另一个比较值
|
||||||
|
* @param comparator 比较器
|
||||||
|
* @return 比较结果,负数表示小于,0表示相等,正数表示大于
|
||||||
|
*/
|
||||||
|
fun compareWith(other: T, comparator: Comparator<in T>): Int = comparator.compare(value, other)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 使用选择器将当前值转换为可比较类型后与另一个值比较
|
||||||
|
* @param other 另一个比较值
|
||||||
|
* @param selector 选择器函数,将当前值转换为可比较类型
|
||||||
|
* @return 比较结果
|
||||||
|
*/
|
||||||
|
fun <R : Comparable<R>> compareTo(other: R, selector: P1RFunction<T, R>): Int =
|
||||||
|
selector.call(value).compareTo(other)
|
||||||
|
|
||||||
|
|
||||||
|
companion object {
|
||||||
|
/**
|
||||||
|
* 创建包含指定值的Pipeline实例
|
||||||
|
* @param value 要包装的值
|
||||||
|
* @return 新的Pipeline实例
|
||||||
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
fun <T> of(value: T): Pipeline<T> = Pipeline(value)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* 通过供应商函数创建Pipeline实例
|
||||||
|
* @param transformer 值供应商函数
|
||||||
|
* @return 新的Pipeline实例
|
||||||
|
*/
|
||||||
|
@JvmStatic
|
||||||
|
fun <T> of(transformer: RFunction<T>): Pipeline<T> = Pipeline(transformer.call())
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,5 +1,5 @@
|
|||||||
/*
|
/*
|
||||||
* Copyright 2025 mingliqiye
|
* Copyright 2026 mingliqiye
|
||||||
*
|
*
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
* you may not use this file except in compliance with the License.
|
* you may not use this file except in compliance with the License.
|
||||||
@@ -16,25 +16,22 @@
|
|||||||
* ProjectName mingli-utils
|
* ProjectName mingli-utils
|
||||||
* ModuleName mingli-utils.main
|
* ModuleName mingli-utils.main
|
||||||
* CurrentFile HashUtils.kt
|
* CurrentFile HashUtils.kt
|
||||||
* LastUpdate 2025-09-15 09:38:04
|
* LastUpdate 2026-01-11 09:09:52
|
||||||
* UpdateUser MingLiPro
|
* UpdateUser MingLiPro
|
||||||
*/
|
*/
|
||||||
@file:JvmName("HashUtils")
|
@file:JvmName("HashUtils")
|
||||||
|
|
||||||
package com.mingliqiye.utils.hash
|
package com.mingliqiye.utils.hash
|
||||||
|
|
||||||
import org.bouncycastle.jce.provider.BouncyCastleProvider
|
|
||||||
import org.mindrot.jbcrypt.BCrypt
|
import com.mingliqiye.utils.bcrypt.checkpw
|
||||||
|
import com.mingliqiye.utils.bcrypt.hashpw
|
||||||
|
import com.mingliqiye.utils.bytes.bytesToHex
|
||||||
import java.io.File
|
import java.io.File
|
||||||
import java.io.FileInputStream
|
import java.io.FileInputStream
|
||||||
import java.io.IOException
|
import java.io.IOException
|
||||||
import java.security.MessageDigest
|
import java.security.MessageDigest
|
||||||
import java.security.NoSuchAlgorithmException
|
import java.security.NoSuchAlgorithmException
|
||||||
import java.security.Security
|
|
||||||
|
|
||||||
private val _addProvider = run {
|
|
||||||
Security.addProvider(BouncyCastleProvider())
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* 计算指定文件的哈希值。
|
* 计算指定文件的哈希值。
|
||||||
@@ -47,42 +44,24 @@ private val _addProvider = run {
|
|||||||
*/
|
*/
|
||||||
@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())
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 将字节数组转换为十六进制字符串表示。
|
|
||||||
*
|
|
||||||
* @param bytes 输入的字节数组
|
|
||||||
* @return 对应的十六进制字符串
|
|
||||||
*/
|
|
||||||
private fun bytesToHex(bytes: ByteArray): String {
|
|
||||||
val hexString = StringBuilder(2 * bytes.size)
|
|
||||||
for (b in bytes) {
|
|
||||||
val hex = Integer.toHexString(0xff and b.toInt())
|
|
||||||
if (hex.length == 1) {
|
|
||||||
hexString.append('0')
|
|
||||||
}
|
|
||||||
hexString.append(hex)
|
|
||||||
}
|
|
||||||
return hexString.toString()
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -92,7 +71,7 @@ private fun bytesToHex(bytes: ByteArray): String {
|
|||||||
* @return 加密后的 BCrypt 哈希字符串
|
* @return 加密后的 BCrypt 哈希字符串
|
||||||
*/
|
*/
|
||||||
fun bcrypt(string: String): String {
|
fun bcrypt(string: String): String {
|
||||||
return BCrypt.hashpw(string, BCrypt.gensalt())
|
return hashpw(string)
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -103,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 BCrypt.checkpw(string, bcrypted)
|
return checkpw(string, bcrypted)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,54 @@
|
|||||||
|
/*
|
||||||
|
* Copyright 2026 mingliqiye
|
||||||
|
*
|
||||||
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||||
|
* you may not use this file except in compliance with the License.
|
||||||
|
* You may obtain a copy of the License at
|
||||||
|
*
|
||||||
|
* http://www.apache.org/licenses/LICENSE-2.0
|
||||||
|
*
|
||||||
|
* Unless required by applicable law or agreed to in writing, software
|
||||||
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
||||||
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||||||
|
* See the License for the specific language governing permissions and
|
||||||
|
* limitations under the License.
|
||||||
|
*
|
||||||
|
* ProjectName FastBaseMapper.kt
|
||||||
|
* ModuleName mingli-utils.main
|
||||||
|
* CurrentFile BaseResponse.kt
|
||||||
|
* LastUpdate 2026-10-26 23:22:18
|
||||||
|
* UpdateUser MingLiPro
|
||||||
|
*/
|
||||||
|
|
||||||
|
package com.mingliqiye.utils.http
|
||||||
|
|
||||||
|
/**
|
||||||
|
* HTTP 响应基类,封装时间、消息、数据和状态码等通用响应字段。
|
||||||
|
*
|
||||||
|
* 除 [time] 外字段均可变,本身非线程安全;
|
||||||
|
* 如需不可变更新语义,请使用子类的 with* 系列方法。
|
||||||
|
*
|
||||||
|
* @param T 响应数据的类型
|
||||||
|
*/
|
||||||
|
open class BaseResponse<T>(
|
||||||
|
/** 响应时间(格式化的字符串),创建后不可修改 */
|
||||||
|
open val time: String,
|
||||||
|
/** 响应消息,可通过 setter 修改 */
|
||||||
|
open var message: String,
|
||||||
|
/** 响应数据,可通过 setter 修改 */
|
||||||
|
open var data: T,
|
||||||
|
/** HTTP 状态码,可通过 setter 修改 */
|
||||||
|
open var statusCode: Int,
|
||||||
|
|
||||||
|
) {
|
||||||
|
/**
|
||||||
|
* 返回响应对象的字符串表示
|
||||||
|
*
|
||||||
|
* 重写toString方法以提供更有意义的对象表示,便于日志记录和调试。
|
||||||
|
* 显示时间、消息、数据类型和值以及状态码。
|
||||||
|
*
|
||||||
|
* @return 格式化的字符串表示
|
||||||
|
*/
|
||||||
|
override fun toString(): String =
|
||||||
|
"${javaClass.simpleName}(time=${time}, message=${message}, data=${data}, statusCode=${statusCode})"
|
||||||
|
}
|
||||||
File diff suppressed because it is too large
Load Diff
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user