Gitea Actions Build / Build (push) Canceled after 0s
为所有缺失文档的公开声明补充中文 KDoc/Javadoc(含 exception、json、 springboot、tuple 生成类、MediaType 枚举项及测试),仅插入注释不改代码; gradle.properties VERSIONS 5.4.4 -> 5.5.1。
141 lines
3.1 KiB
Kotlin
141 lines
3.1 KiB
Kotlin
/*
|
|
* 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 OsPath.kt
|
|
* LastUpdate 2026-10-20 20:05:37
|
|
* UpdateUser MingLiPro
|
|
*/
|
|
|
|
|
|
|
|
package com.mingliqiye.utils.path
|
|
|
|
import java.io.File
|
|
import java.net.URI
|
|
import java.nio.file.*
|
|
import java.util.*
|
|
import java.util.function.Consumer
|
|
|
|
/**
|
|
* 操作系统路径封装类,通过委托实现 Path 接口,并提供多种来源的静态工厂方法。
|
|
*
|
|
* @param path 被委托的底层 Path 实例
|
|
*/
|
|
class OsPath private constructor(private val path: Path) : Path by path {
|
|
override fun forEach(action: Consumer<in Path>?) {
|
|
path.forEach(action)
|
|
}
|
|
|
|
override fun spliterator(): Spliterator<Path?> {
|
|
return path.spliterator()
|
|
}
|
|
|
|
override fun startsWith(other: String): Boolean {
|
|
return path.startsWith(other)
|
|
}
|
|
|
|
override fun endsWith(other: String): Boolean {
|
|
return path.endsWith(other)
|
|
}
|
|
|
|
override fun resolve(other: String): Path {
|
|
return path.resolve(other)
|
|
}
|
|
|
|
override fun resolveSibling(other: Path): Path {
|
|
return path.resolveSibling(other)
|
|
}
|
|
|
|
override fun resolveSibling(other: String): Path {
|
|
return path.resolveSibling(other)
|
|
}
|
|
|
|
override fun toFile(): File {
|
|
return path.toFile()
|
|
}
|
|
|
|
override fun register(
|
|
watcher: WatchService,
|
|
vararg events: WatchEvent.Kind<*>,
|
|
): WatchKey {
|
|
return path.register(watcher, *events)
|
|
}
|
|
|
|
override fun iterator(): MutableIterator<Path> {
|
|
return path.iterator()
|
|
}
|
|
|
|
/**
|
|
* 伴生对象,提供从字符串、Path、URI、File 等创建 OsPath 实例的静态工厂方法。
|
|
*/
|
|
companion object {
|
|
/**
|
|
* 根据路径字符串创建 OsPath 实例。
|
|
*
|
|
* @param path 路径字符串
|
|
* @return 对应的 OsPath 实例
|
|
*/
|
|
@JvmStatic
|
|
fun of(path: String): OsPath {
|
|
return of(Paths.get(path))
|
|
}
|
|
|
|
/**
|
|
* 根据 Path 对象创建 OsPath 实例。
|
|
*
|
|
* @param path Path 对象
|
|
* @return 对应的 OsPath 实例
|
|
*/
|
|
@JvmStatic
|
|
fun of(path: Path): OsPath {
|
|
return OsPath(path)
|
|
}
|
|
|
|
/**
|
|
* 根据 URI 创建 OsPath 实例。
|
|
*
|
|
* @param uri 文件 URI
|
|
* @return 对应的 OsPath 实例
|
|
*/
|
|
@JvmStatic
|
|
fun of(uri: URI): OsPath {
|
|
return OsPath(Paths.get(uri))
|
|
}
|
|
|
|
/**
|
|
* 根据 File 对象创建 OsPath 实例。
|
|
*
|
|
* @param file File 对象
|
|
* @return 对应的 OsPath 实例
|
|
*/
|
|
@JvmStatic
|
|
fun of(file: File): OsPath {
|
|
return OsPath(file.toPath())
|
|
}
|
|
|
|
/**
|
|
* 获取表示当前工作目录的 OsPath 实例。
|
|
*
|
|
* @return 当前工作目录对应的 OsPath 实例
|
|
*/
|
|
@JvmStatic
|
|
fun getCwd(): OsPath {
|
|
return OsPath(Paths.get(""))
|
|
}
|
|
}
|
|
}
|