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

AbsoluteFolder

@NotStableForInheritance

expect interface AbsoluteFolder : AbsoluteFileFolder

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

Since

2.8

@NotStableForInheritance

actual interface AbsoluteFolder : AbsoluteFileFolder

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

Since

2.8

@NotStableForInheritance

actual interface AbsoluteFolder : AbsoluteFileFolder

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

Since

2.8

Types

Companion

expect object Companion

actual object Companion

Functions

children

expect abstract suspend fun children(): Flow<AbsoluteFileFolder>

actual abstract suspend fun children(): Flow<AbsoluteFileFolder>

childrenStream

abstract suspend fun childrenStream(): Stream<AbsoluteFileFolder>

createFolder

expect abstract suspend fun createFolder(name: String): AbsoluteFolder

创建一个名称为 name 的子目录. 返回成功创建的或已有的子目录. 当目标目录已经存在时则直接返回该目录.

actual abstract suspend fun createFolder(name: String): AbsoluteFolder

创建一个名称为 name 的子目录. 返回成功创建的或已有的子目录. 当目标目录已经存在时则直接返回该目录.

actual abstract suspend fun createFolder(name: String): AbsoluteFolder

创建一个名称为 name 的子目录. 返回成功创建的或已有的子目录. 当目标目录已经存在时则直接返回该目录.

delete

abstract suspend fun delete(): Boolean

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

abstract suspend fun delete(): Boolean

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

abstract suspend fun delete(): Boolean

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

exists

abstract suspend fun exists(): Boolean

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

abstract suspend fun exists(): Boolean

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

abstract suspend fun exists(): Boolean

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

files

expect abstract suspend fun files(): Flow<AbsoluteFile>

获取该目录下所有文件列表.

actual abstract suspend fun files(): Flow<AbsoluteFile>

获取该目录下所有文件列表.

actual abstract suspend fun files(): Flow<AbsoluteFile>

获取该目录下所有文件列表.

filesStream

abstract suspend fun filesStream(): Stream<AbsoluteFile>

获取该目录下所有文件列表.

folders

expect abstract suspend fun folders(): Flow<AbsoluteFolder>

actual abstract suspend fun folders(): Flow<AbsoluteFolder>

foldersStream

abstract suspend fun foldersStream(): Stream<AbsoluteFolder>

isEmpty

expect open fun isEmpty(): Boolean

当该目录为空时返回 true.

actual open fun isEmpty(): Boolean

当该目录为空时返回 true.

actual open fun isEmpty(): Boolean

当该目录为空时返回 true.

refresh

abstract suspend fun refresh(): Boolean

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

abstract suspend fun refresh(): Boolean

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

abstract suspend fun refresh(): Boolean

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

refreshed

expect abstract suspend override fun refreshed(): AbsoluteFolder?

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

actual abstract suspend override fun refreshed(): AbsoluteFolder?

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

actual abstract suspend override fun refreshed(): AbsoluteFolder?

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

renameTo

abstract suspend fun renameTo(newName: String): Boolean

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

abstract suspend fun renameTo(newName: String): Boolean

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

abstract suspend fun renameTo(newName: String): Boolean

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

resolveAll

expect abstract suspend fun resolveAll(path: String): Flow<AbsoluteFileFolder>

根据路径获取指向的所有路径为 path 的文件和目录列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件和目录.

actual abstract suspend fun resolveAll(path: String): Flow<AbsoluteFileFolder>

根据路径获取指向的所有路径为 path 的文件和目录列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件和目录.

actual abstract suspend fun resolveAll(path: String): Flow<AbsoluteFileFolder>

根据路径获取指向的所有路径为 path 的文件和目录列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件和目录.

resolveAllStream

abstract suspend fun resolveAllStream(path: String): Stream<AbsoluteFileFolder>

根据路径获取指向的所有路径为 path 的文件和目录列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件和目录.

resolveFileById

expect abstract suspend fun resolveFileById(id: String, deep: Boolean = false): AbsoluteFile?

精确获取 AbsoluteFile.id 为 id 的文件. 在目标文件不存在时返回 null. 当 deep 为 true 时还会深入子目录查找.

@JvmOverloads

actual abstract suspend fun resolveFileById(id: String, deep: Boolean = false): AbsoluteFile?

精确获取 AbsoluteFile.id 为 id 的文件. 在目标文件不存在时返回 null. 当 deep 为 true 时还会深入子目录查找.

actual abstract suspend fun resolveFileById(id: String, deep: Boolean): AbsoluteFile?

精确获取 AbsoluteFile.id 为 id 的文件. 在目标文件不存在时返回 null. 当 deep 为 true 时还会深入子目录查找.

resolveFiles

expect abstract suspend fun resolveFiles(path: String): Flow<AbsoluteFile>

根据路径获取指向的所有路径为 path 的文件列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件.

actual abstract suspend fun resolveFiles(path: String): Flow<AbsoluteFile>

根据路径获取指向的所有路径为 path 的文件列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件.

actual abstract suspend fun resolveFiles(path: String): Flow<AbsoluteFile>

根据路径获取指向的所有路径为 path 的文件列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件.

resolveFilesStream

abstract suspend fun resolveFilesStream(path: String): Stream<AbsoluteFile>

根据路径获取指向的所有路径为 path 的文件列表. 同时支持相对路径和绝对路径. 支持获取子目录内的文件.

resolveFolder

expect abstract suspend fun resolveFolder(name: String): AbsoluteFolder?

获取一个已存在的名称为 name 的子目录. 当该名称的子目录不存在时返回 null.

actual abstract suspend fun resolveFolder(name: String): AbsoluteFolder?

获取一个已存在的名称为 name 的子目录. 当该名称的子目录不存在时返回 null.

actual abstract suspend fun resolveFolder(name: String): AbsoluteFolder?

获取一个已存在的名称为 name 的子目录. 当该名称的子目录不存在时返回 null.

resolveFolderById

expect abstract suspend fun resolveFolderById(id: String): AbsoluteFolder?

获取一个已存在的 AbsoluteFileFolder.id 为 id 的子目录. 当该名称的子目录不存在时返回 null.

actual abstract suspend fun resolveFolderById(id: String): AbsoluteFolder?

获取一个已存在的 AbsoluteFileFolder.id 为 id 的子目录. 当该名称的子目录不存在时返回 null.

actual abstract suspend fun resolveFolderById(id: String): AbsoluteFolder?

获取一个已存在的 AbsoluteFileFolder.id 为 id 的子目录. 当该名称的子目录不存在时返回 null.

toString

abstract override fun toString(): String

uploadNewFile

expect abstract suspend fun uploadNewFile( filepath: String, content: ExternalResource, callback: ProgressionCallback<AbsoluteFile, Long>? = null): AbsoluteFile

上传一个文件到该目录, 返回上传成功的文件标识.

@JvmOverloads

actual abstract suspend fun uploadNewFile( filepath: String, content: ExternalResource, callback: ProgressionCallback<AbsoluteFile, Long>? = null): AbsoluteFile

上传一个文件到该目录, 返回上传成功的文件标识.

actual abstract suspend fun uploadNewFile( filepath: String, content: ExternalResource, callback: ProgressionCallback<AbsoluteFile, Long>?): AbsoluteFile

上传一个文件到该目录, 返回上传成功的文件标识.

Properties

absolutePath

abstract val absolutePath: String

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

abstract val absolutePath: String

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

abstract val absolutePath: String

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

contact

abstract val contact: FileSupported

该对象所属 FileSupported

abstract val contact: FileSupported

该对象所属 FileSupported

abstract val contact: FileSupported

该对象所属 FileSupported

contentsCount

expect abstract val contentsCount: Int

当前快照中文件数量, 当有文件更新时(上传/删除文件) 该属性不会更新.

actual abstract val contentsCount: Int

当前快照中文件数量, 当有文件更新时(上传/删除文件) 该属性不会更新.

actual abstract val contentsCount: Int

当前快照中文件数量, 当有文件更新时(上传/删除文件) 该属性不会更新.

abstract val id: String

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

abstract val id: String

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

abstract val id: String

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

isFile

abstract val isFile: Boolean

表示远程文件时返回 true.

abstract val isFile: Boolean

表示远程文件时返回 true.

abstract val isFile: Boolean

表示远程文件时返回 true.

isFolder

abstract val isFolder: Boolean

表示远程目录时返回 true.

abstract val isFolder: Boolean

表示远程目录时返回 true.

abstract val isFolder: Boolean

表示远程目录时返回 true.

lastModifiedTime

abstract val lastModifiedTime: Long

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

abstract val lastModifiedTime: Long

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

abstract val lastModifiedTime: Long

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

name

abstract val name: String

文件名或目录名.

abstract val name: String

文件名或目录名.

abstract val name: String

文件名或目录名.

parent

abstract val parent: AbsoluteFolder?

上级 AbsoluteFileFolder.

abstract val parent: AbsoluteFolder?

上级 AbsoluteFileFolder.

abstract val parent: AbsoluteFolder?

上级 AbsoluteFileFolder.

uploaderId

abstract val uploaderId: Long

上传者 ID.

abstract val uploaderId: Long

上传者 ID.

abstract val uploaderId: Long

上传者 ID.

uploadTime

abstract val uploadTime: Long

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

abstract val uploadTime: Long

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

abstract val uploadTime: Long

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

AbsoluteFolder

Since

Since

Since

See also

Types

Functions

Properties