mirai-core-api/net.mamoe.mirai.contact.file/AbsoluteFileFolder

AbsoluteFileFolder

@NotStableForInheritance

interface AbsoluteFileFolder

绝对文件或目录标识. 精确表示一个远程文件. 不会受同名文件或目录的影响.

Since

2.8

Types

Companion

object Companion

Functions

delete

abstract suspend fun delete(): Boolean

删除远程文件或目录. 只会根据 id 精确地删除一个文件或目录, 不会删除其他同名文件或目录. 成功时返回 true, 当远程文件或目录不存在时返回 false.

exists

abstract suspend fun exists(): Boolean

查询该远程文件或目录是否还存在于服务器.

refresh

abstract suspend fun refresh(): Boolean

更新当前 AbsoluteFileFolder 对象的文件或目录信息 (lastModifiedTime, absolutePath 等). 成功时返回 true, 当远程文件或目录不存在时返回 false.

refreshed

abstract suspend fun refreshed(): AbsoluteFileFolder?

返回更新了文件或目录信息 (lastModifiedTime 等) 的, 指向相同文件的 AbsoluteFileFolder. 不会更新当前 AbsoluteFileFolder 对象.

renameTo

abstract suspend fun renameTo(newName: String): Boolean

重命名远程文件或目录, 并且修改当前(this) AbsoluteFileFolder 的 name. 成功时返回 true, 当远程文件或目录不存在时返回 false.

toString

abstract override fun toString(): String

Properties

absolutePath

abstract val absolutePath: String

绝对路径, 如 /foo/bar.txt.

contact

abstract val contact: FileSupported

该对象所属 FileSupported

abstract val id: String

文件或目录的 ID, 即 fileId 或 folderId. 该属性由服务器维护, 通常唯一且持久.

isFile

abstract val isFile: Boolean

表示远程文件时返回 true.

isFolder

abstract val isFolder: Boolean

表示远程目录时返回 true.

lastModifiedTime

abstract val lastModifiedTime: Long

远程文件或目录的最后修改时间戳, 单位秒.

name

abstract val name: String

文件名或目录名.

parent

abstract val parent: AbsoluteFolder?

上级 AbsoluteFileFolder.

uploaderId

abstract val uploaderId: Long

上传者 ID.

uploadTime

abstract val uploadTime: Long

远程文件或目录的创建时间, 时间戳秒.

Inheritors

AbsoluteFile

AbsoluteFolder

Extensions

extension

val AbsoluteFileFolder.extension: String

返回文件的后缀名. 如 foo.txt 返回 txt.

nameWithoutExtension

val AbsoluteFileFolder.nameWithoutExtension: String

返回去掉文件后缀的文件名. 如 foo.txt 返回 foo.