StorageReference

AGCStorageManagement

getStorage()

获取引用所在AGCStorageManagement实例。

StorageReference

child(String objectPath)

获取子目录的引用。

StorageReference

getParent()

获取父目录的引用。

StorageReference

getRoot()

获取根目录引用。

String

getBucket()

获取引用所在的存储实例名称。

String

getName()

获取文件或目录名。

String

getPath()

获取云端文件或目录的路径。

Task<FileMetadata>

getFileMetadata()

获取文件或目录的元数据。

Task<FileMetadata>

updateFileMetadata(FileMetadata attribute)

更新文件元数据，采用覆盖更新的方式。

Task<void>

delete()

删除云端文件。

Task<ListResult>

list(int max, String marker)

分页获取目录下的文件列表。

Task<ListResult>

list(int max)

获取目录下指定文件数量的文件列表。

Task<ListResult>

listAll()

获取目录下所有文件列表，包含文件和子目录。

UploadTask

putFile(File srcFile, FileMetadata attribute, Long offset)

将本地文件存储到云端，从offset位置继续上传文件的剩下部分。

UploadTask

putFile(File srcFile, FileMetadata attribute)

将本地文件存储到云端。

UploadTask

putFile(File srcFile)

将本地文件存储到云端。

UploadTask

putBytes(byte[] bytes, FileMetadata attribute)

将本地文件的二进制字节数组上传到云端。

UploadTask

putBytes(byte[] bytes, FileMetadata attribute, Long offset)

从offset位置开始将本地的二进制字节数组上传到云端。

DownloadTask

getFile(File destFile)

下载一个云端文件到本地路径并指定文件名称。

DownloadTask

getFile(Uri destUri)

下载一个云端文件到本地路径并指定文件名称。

StreamDownloadTask

getStream()

返回一个流式的下载任务。

StreamDownloadTask

getStream(StreamDownloadTask.StreamHandler streamHandler)

返回一个实现了数据流处理事件的流式下载任务。

Task<byte[]>

getBytes(final long maxDownloadBytes)

从云端存储中下载指定的数据到二进制字节数组中。

Task<Uri>

getDownloadUrl()

获取云端文件的分享地址。

List<UploadTask>

getActiveUploadTasks()

获取当前引用下处于运行状态的上传任务列表。

List<DownloadTask>

getActiveDownloadTasks()

获取当前引用下处于运行状态的下载任务列表。

int

compareTo(StorageReference other)

比较引用地址。

String

toString()

返回引用的Url地址。

boolean

equals(Object other)

比较引用是否相同。

int

hashCode()

返回引用的hashcode值。

public AGCStorageManagement getStorage()

获取AGCStorageManagement实例。

AGCStorageManagement

返回引用所在的AGCStorageManagement实例。

public StorageReference child(String objectPath)

获取子目录的引用。

objectPath

子目录的路径。如果路径不存在，则返回null。

StorageReference

返回子目录的StorageReference实例。

public StorageReference getParent()

获取父目录的引用。

StorageReference

返回父目录的StorageReference实例。如果当前为根目录，则返回根目录的引用。

public StorageReference getRoot()

获取根目录的引用。

StorageReference

返回根目录的StorageReference实例。

public String getBucket()

获取引用所在的存储实例名称。

String

存储实例名称。

public String getName()

获取文件或目录名。

String

返回云端文件或目录名。

public String getPath()

获取云端文件或目录的路径。

String

返回云端文件或目录的路径。

public Task<FileMetadata> getFileMetadata()

获取文件或目录的元数据。

Task<FileMetadata>

文件或目录的元数据获取任务的结果。

public Task<FileMetadata> updateFileMetadata(FileMetadata attribute)

更新文件的元数据，采用覆盖更新的方式。

attribute

需要更新的文件的元数据。

Task<FileMetadata>

元数据的更新任务结果。

public Task<void> delete()

删除云端文件。

Task<void>

删除任务的结果。

public Task<ListResult> list(int max, String marker)

分页获取当前目录下的文件列表，包括文件和子目录。

max

分页获取时，指定获取的文件和子目录的总数量。

限制：max的范围在1~1000之间。

marker

分页标识。先使用ListResult.getPageMarker方法获取下一页的分页标识，再调用本方法获取下一页数据。

Task<ListResult>

文件列表的结果。

public Task<ListResult> list(int max)

获取目录下指定数量的文件和子目录的列表。

max

需要获取的文件和子目录的总数量。

限制：max的范围在1~1000之间。

Task<ListResult>

列表结果。

public Task<ListResult> listAll()

获取目录下所有对象，包含文件和子目录。

Task<ListResult>

文件列表结果。

public UploadTask putFile(File srcFile, FileMetadata attribute, Long offset)

将本地文件的二进制数据存储到云端，支持断点续传。

srcFile

待上传文件的二进制数据。

支持的最大文件大小为50GB。

attribute

文件或目录的元数据。

offset

文件的断点续传位置，设置为文件已经传输的字节数，可通过UploadTask.UploadResult.getBytesTransferred()方法获取。

UploadTask

返回上传任务的UploadTask实例。

public UploadTask putFile(File srcFile, FileMetadata attribute)

将本地文件的二进制数据存储到云端，支持自定义文件元数据。

srcFile

待上传文件或目录的二进制数据。

支持的最大文件大小为50GB。

attribute

文件或目录的元数据。

UploadTask

返回上传任务的UploadTask实例。

public UploadTask putFile(File srcFile)

将本地文件的二进制数据存储到云端。

srcFile

待上传文件或目录的二进制数据。

支持的最大文件大小为50GB。

UploadTask

返回上传任务的UploadTask实例。

public UploadTask putBytes(byte[] bytes, FileMetadata attribute)

将本地文件的二进制字节数组上传到云端。

bytes

二进制字节数组。

支持的最大文件为大小5GB。

attribute

文件的元数据。

UploadTask

返回上传任务的UploadTask实例。

public UploadTask putBytes(byte[] bytes, FileMetadata attribute, Long offset)

从offset位置开始将本地的二进制字节数组上传到云端。

bytes

二进制字节数组。

支持的最大文件大小为5GB。

attribute

文件的元数据。

offset

二进制字节数组的断点续传位置。

UploadTask

返回上传任务的UploadTask实例。

public DownloadTask getFile(File destFile)

下载一个云端文件到本地路径并指定文件名称（文件由App管理，当本地文件大小超过0字节时，该接口会将已经下载的文件大小作为断点续传位置，继续从云端下载）。

destFile

待写入文件路径，需提前创建。

DownloadTask

返回下载任务的DownloadTask实例。

public DownloadTask getFile(Uri destUri)

下载一个云端文件到本地路径并指定文件名称（文件由App管理，当本地文件大小超过0字节时，该接口会将已经下载的文件大小作为断点续传位置，继续从云端下载）。

destUri

待写入Uri路径，需提前创建。

DownloadTask

返回下载任务的DownloadTask实例。

public StreamDownloadTask getStream()

返回一个流式的下载任务。

StreamDownloadTask

返回下载任务的StreamDownloadTask实例。

public StreamDownloadTask getStream(StreamDownloadTask.StreamHandler streamHandler)

返回一个实现了数据流处理事件的流式下载任务。

streamHandler

数据流处理事件。

StreamDownloadTask

返回下载任务的StreamDownloadTask实例。

public Task<byte[]> getBytes(final long maxDownloadBytes)

从云端存储中下载指定的数据到二进制字节数组中。

maxDownloadBytes

最大下载的指定数据大小。

Task<byte[]>

返回下载任务的Task<byte[]>实例。

public Task<Uri> getDownloadUrl()

获取云端文件的分享地址。

Task<Uri>

返回下载任务的Task<Uri>实例。

public List<UploadTask> getActiveUploadTasks()

获取当前引用下处于运行状态的上传任务列表。

List<UploadTask>

返回当前引用下处于运行状态的上传任务列表。

public List<DownloadTask> getActiveDownloadTasks()

获取当前引用下处于运行状态的下载任务列表。

List<DownloadTask>

返回当前引用下处于运行状态的下载任务列表。

public int compareTo(StorageReference other)

比较引用地址。

other

另外一个引用。

int

比较引用的结果。

public String toString()

返回引用的Url地址。

String

Url地址信息。

public boolean equals(Object other)

比较引用是否相同。

other

另外一个引用。

boolean

引用是否相同。

• true：相同。
• false：不相同。

public int hashCode()

返回引用的hashcode值。

int

hashcode值。