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

AbsoluteFile

@NotStableForInheritance
interface AbsoluteFile : AbsoluteFileFolder
Content copied to clipboard

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

Since

2.8

See also

Functions

delete
Link copied to clipboard
abstract suspend fun delete(): Boolean
Content copied to clipboard

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

exists
Link copied to clipboard
abstract suspend fun exists(): Boolean
Content copied to clipboard

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

getUrl
Link copied to clipboard
abstract suspend fun getUrl(): String?
Content copied to clipboard

获得下载链接 URL 字符串. 当远程文件不存在时返回 null.

moveTo
Link copied to clipboard
abstract suspend fun moveTo(folder: AbsoluteFolder): Boolean
Content copied to clipboard

移动远程文件到 folder 目录下. 成功时返回 true, 当远程文件不存在时返回 false.

refresh
Link copied to clipboard
abstract suspend fun refresh(): Boolean
Content copied to clipboard

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

refreshed
Link copied to clipboard
abstract suspend override fun refreshed(): AbsoluteFile?
Content copied to clipboard

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

renameTo
Link copied to clipboard
abstract suspend fun renameTo(newName: String): Boolean
Content copied to clipboard

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

toMessage
Link copied to clipboard
abstract fun toMessage(): FileMessage
Content copied to clipboard

得到 AbsoluteFile 所对应的 FileMessage.

toString
Link copied to clipboard
abstract override fun toString(): String
Content copied to clipboard

Properties

absolutePath
Link copied to clipboard
abstract val absolutePath: String
Content copied to clipboard

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

contact
Link copied to clipboard
abstract val contact: FileSupported
Content copied to clipboard

该对象所属 FileSupported

expiryTime
Link copied to clipboard
abstract val expiryTime: Long
Content copied to clipboard

文件到期时间戳, 单位秒.

id
Link copied to clipboard
abstract val id: String
Content copied to clipboard

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

isFile
Link copied to clipboard
abstract val isFile: Boolean
Content copied to clipboard

表示远程文件时返回 true.

isFolder
Link copied to clipboard
abstract val isFolder: Boolean
Content copied to clipboard

表示远程目录时返回 true.

lastModifiedTime
Link copied to clipboard
abstract val lastModifiedTime: Long
Content copied to clipboard

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

md5
Link copied to clipboard
abstract val md5: ByteArray
Content copied to clipboard

文件内容 MD5.

name
Link copied to clipboard
abstract val name: String
Content copied to clipboard

文件名或目录名.

parent
Link copied to clipboard
abstract val parent: AbsoluteFolder?
Content copied to clipboard

上级 AbsoluteFileFolder.

sha1
Link copied to clipboard
abstract val sha1: ByteArray
Content copied to clipboard

文件内容 SHA-1.

size
Link copied to clipboard
abstract val size: Long
Content copied to clipboard

文件大小 (占用空间), 单位 byte.

uploaderId
Link copied to clipboard
abstract val uploaderId: Long
Content copied to clipboard

上传者 ID.

uploadTime
Link copied to clipboard
abstract val uploadTime: Long
Content copied to clipboard

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