docs: 补全 src 全部 Kotlin KDoc 与 Java Javadoc,版本升级至 5.5.1
Gitea Actions Build / Build (push) Canceled after 0s

为所有缺失文档的公开声明补充中文 KDoc/Javadoc(含 exception、json、
springboot、tuple 生成类、MediaType 枚举项及测试),仅插入注释不改代码;
gradle.properties VERSIONS 5.4.4 -> 5.5.1。
This commit is contained in:
2026-11-17 21:07:58 +08:00
parent d0887ea1f7
commit 51eb838a36
148 changed files with 16651 additions and 15 deletions
@@ -26,8 +26,18 @@ package com.mingliqiye.utils.metadata
import com.mingliqiye.utils.resource.ResourceUtils
import java.util.stream.Collectors.toMap
/**
* 元数据资源定位锚点类,仅用于定位 `/META-INF/meta-data` 资源所在的类加载器
*/
class MetaDataResource
/**
* 读取并解析 `/META-INF/meta-data` 资源文件
*
* 文件内容按行解析为 `key=value` 形式的键值对,空行与格式不合法的行会被忽略。
*
* @return 元数据键值对映射
*/
fun getMetaData(): Map<String, String> {
return ResourceUtils.getResourceAsString<MetaDataResource>("/META-INF/meta-data").split("\n").stream().map {
if (it.isBlank()) {
@@ -42,6 +52,11 @@ fun getMetaData(): Map<String, String> {
}.filter { it != null }.collect(toMap({ it!!.first }, { it!!.second }))
}
/**
* mingli-utils 库的构建元数据,延迟初始化
*
* 从 `/META-INF/meta-data` 资源解析并填充 [MingliUtilsMetaData],缺失的字段以空字符串代替。
*/
val mingliUtilsMetaData: MingliUtilsMetaData by lazy {
val metaData = getMetaData()
MingliUtilsMetaData().apply {
@@ -22,6 +22,17 @@
package com.mingliqiye.utils.metadata
/**
* mingli-utils 库的构建元数据数据类
*
* @property buildTime 构建时间
* @property groupId 构建产物的 GroupId
* @property artifactId 构建产物的 ArtifactId
* @property version 库版本号
* @property buildJdkVersion 构建所使用的 JDK 版本
* @property author 作者
* @property website 项目网站地址
*/
data class MingliUtilsMetaData(
var buildTime: String = "",
var groupId: String = "",