public final class BucketManager
extends java.lang.Object
| 限定符和类型 | 类和说明 |
|---|---|
static class |
BucketManager.BatchOperations
文件管理批量操作指令构建对象
|
class |
BucketManager.FileListIterator
创建文件列表迭代器
|
| 构造器和说明 |
|---|
BucketManager(Auth auth,
Client client) |
BucketManager(Auth auth,
Configuration cfg)
构建一个新的 BucketManager 对象
|
| 限定符和类型 | 方法和说明 |
|---|---|
Response |
asynFetch(java.lang.String url,
java.lang.String bucket,
java.lang.String key)
异步第三方资源抓取 从指定 URL 抓取资源,并将该资源存储到指定空间中。
|
Response |
asynFetch(java.lang.String url,
java.lang.String bucket,
java.lang.String key,
java.lang.String md5,
java.lang.String etag,
java.lang.String callbackurl,
java.lang.String callbackbody,
java.lang.String callbackbodytype,
java.lang.String callbackhost,
java.lang.String fileType)
异步第三方资源抓取 从指定 URL 抓取资源,并将该资源存储到指定空间中。
|
Response |
batch(BucketManager.BatchOperations operations)
批量文件管理请求
|
java.lang.String[] |
buckets()
获取账号下所有空间名称列表
|
Response |
changeHeaders(java.lang.String bucket,
java.lang.String key,
java.util.Map<java.lang.String,java.lang.String> headers)
修改文件的元数据
|
Response |
changeMime(java.lang.String bucket,
java.lang.String key,
java.lang.String mime)
修改文件的MimeType
|
Response |
changeStatus(java.lang.String bucket,
java.lang.String key,
int status)
修改文件的状态(禁用或者正常)
|
Response |
changeType(java.lang.String bucket,
java.lang.String key,
StorageType type)
修改文件的类型(普通存储或低频存储)
|
Response |
checkAsynFetchid(java.lang.String region,
java.lang.String fetchWorkId)
查询异步抓取任务
|
void |
copy(java.lang.String fromBucket,
java.lang.String fromFileKey,
java.lang.String toBucket,
java.lang.String toFileKey)
复制文件,要求空间在同一账号下
|
Response |
copy(java.lang.String fromBucket,
java.lang.String fromFileKey,
java.lang.String toBucket,
java.lang.String toFileKey,
boolean force)
复制文件,要求空间在同一账号下,可以设置force参数为true强行覆盖空间已有同名文件
|
void |
createBucket(java.lang.String bucketName,
java.lang.String region) |
BucketManager.FileListIterator |
createFileListIterator(java.lang.String bucket,
java.lang.String prefix)
根据前缀获取文件列表的迭代器
|
BucketManager.FileListIterator |
createFileListIterator(java.lang.String bucket,
java.lang.String prefix,
int limit,
java.lang.String delimiter)
根据前缀获取文件列表的迭代器
|
Response |
delete(java.lang.String bucket,
java.lang.String key)
删除指定空间、文件名的文件
|
Response |
deleteAfterDays(java.lang.String bucket,
java.lang.String key,
int days)
设置文件的存活时间
|
void |
deleteBucket(java.lang.String bucketname) |
java.lang.String[] |
domainList(java.lang.String bucket)
获取该空间下所有的domain
|
static java.lang.String |
encodedEntry(java.lang.String bucket)
EncodedEntryURI格式,用在不指定key值的情况下
|
static java.lang.String |
encodedEntry(java.lang.String bucket,
java.lang.String key)
EncodedEntryURI格式,其中 bucket+":"+key 称之为 entry
|
FetchRet |
fetch(java.lang.String url,
java.lang.String bucket)
抓取指定地址的文件,以指定名称保存在指定空间
要求指定url可访问,大文件不建议使用此接口抓取。
|
FetchRet |
fetch(java.lang.String url,
java.lang.String bucket,
java.lang.String key)
抓取指定地址的文件,以指定名称保存在指定空间
要求指定url可访问,大文件不建议使用此接口抓取。
|
BucketInfo |
getBucketInfo(java.lang.String bucket) |
FileListing |
listFiles(java.lang.String bucket,
java.lang.String prefix,
java.lang.String marker,
int limit,
java.lang.String delimiter) |
FileListing |
listFilesV2(java.lang.String bucket,
java.lang.String prefix,
java.lang.String marker,
int limit,
java.lang.String delimiter) |
Response |
listV1(java.lang.String bucket,
java.lang.String prefix,
java.lang.String marker,
int limit,
java.lang.String delimiter)
列举空间文件 v1 接口,返回一个 response 对象。
|
Response |
listV2(java.lang.String bucket,
java.lang.String prefix,
java.lang.String marker,
int limit,
java.lang.String delimiter)
列举空间文件 v2 接口,返回一个 response 对象。
|
Response |
move(java.lang.String fromBucket,
java.lang.String fromFileKey,
java.lang.String toBucket,
java.lang.String toFileKey)
移动文件。
|
Response |
move(java.lang.String fromBucket,
java.lang.String fromFileKey,
java.lang.String toBucket,
java.lang.String toFileKey,
boolean force)
移动文件,要求空间在同一账号下
|
void |
prefetch(java.lang.String bucket,
java.lang.String key)
对于设置了镜像存储的空间,从镜像源站抓取指定名称的资源并存储到该空间中
如果该空间中已存在该名称的资源,则会将镜像源站的资源覆盖空间中相同名称的资源
|
Response |
rename(java.lang.String bucket,
java.lang.String oldFileKey,
java.lang.String newFileKey)
重命名空间中的文件
|
Response |
rename(java.lang.String bucket,
java.lang.String oldFileKey,
java.lang.String newFileKey,
boolean force)
重命名空间中的文件,可以设置force参数为true强行覆盖空间已有同名文件
|
void |
setBucketAcl(java.lang.String bucket,
AclType acl) |
Response |
setImage(java.lang.String bucket,
java.lang.String srcSiteUrl)
设置空间的镜像源站
|
Response |
setImage(java.lang.String bucket,
java.lang.String srcSiteUrl,
java.lang.String host)
设置空间的镜像源站
|
void |
setIndexPage(java.lang.String bucket,
IndexPageType type) |
FileInfo |
stat(java.lang.String bucket,
java.lang.String fileKey)
获取空间中文件的属性
|
Response |
unsetImage(java.lang.String bucket)
取消空间的镜像源站设置
|
public BucketManager(Auth auth, Configuration cfg)
auth - Auth对象cfg - Configuration对象public static java.lang.String encodedEntry(java.lang.String bucket,
java.lang.String key)
bucket - key - public static java.lang.String encodedEntry(java.lang.String bucket)
bucket - 空间名称public java.lang.String[] buckets()
throws QiniuException
QiniuExceptionpublic void createBucket(java.lang.String bucketName,
java.lang.String region)
throws QiniuException
QiniuExceptionpublic void deleteBucket(java.lang.String bucketname)
throws QiniuException
QiniuExceptionpublic java.lang.String[] domainList(java.lang.String bucket)
throws QiniuException
bucket - QiniuExceptionpublic BucketManager.FileListIterator createFileListIterator(java.lang.String bucket, java.lang.String prefix)
bucket - 空间名prefix - 文件名前缀public BucketManager.FileListIterator createFileListIterator(java.lang.String bucket, java.lang.String prefix, int limit, java.lang.String delimiter)
bucket - 空间名prefix - 文件名前缀limit - 每次迭代的长度限制,最大1000,推荐值 100delimiter - 指定目录分隔符,列出所有公共前缀(模拟列出目录效果)。缺省值为空字符串public Response listV1(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter) throws QiniuException
bucket - 空间名prefix - 文件名前缀marker - 上一次获取文件列表时返回的 markerlimit - 每次迭代的长度限制,最大1000,推荐值 100delimiter - 指定目录分隔符,列出所有公共前缀(模拟列出目录效果)。缺省值为空字符串QiniuExceptionpublic FileListing listFiles(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter) throws QiniuException
QiniuExceptionpublic Response listV2(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter) throws QiniuException
bucket - 空间名prefix - 文件名前缀marker - 上一次获取文件列表时返回的 markerlimit - 每次迭代的长度限制,推荐值 10000delimiter - 指定目录分隔符,列出所有公共前缀(模拟列出目录效果)。缺省值为空字符串QiniuExceptionpublic FileListing listFilesV2(java.lang.String bucket, java.lang.String prefix, java.lang.String marker, int limit, java.lang.String delimiter) throws QiniuException
QiniuExceptionpublic FileInfo stat(java.lang.String bucket, java.lang.String fileKey) throws QiniuException
bucket - 空间名称fileKey - 文件名称QiniuExceptionpublic Response delete(java.lang.String bucket, java.lang.String key) throws QiniuException
bucket - 空间名称key - 文件名称QiniuExceptionpublic Response changeMime(java.lang.String bucket, java.lang.String key, java.lang.String mime) throws QiniuException
bucket - 空间名称key - 文件名称mime - 文件的新MimeTypeQiniuExceptionpublic Response changeHeaders(java.lang.String bucket, java.lang.String key, java.util.Map<java.lang.String,java.lang.String> headers) throws QiniuException
bucket - 空间名称key - 文件名称headers - 需要修改的文件元数据QiniuExceptionpublic Response changeType(java.lang.String bucket, java.lang.String key, StorageType type) throws QiniuException
bucket - 空间名称key - 文件名称type - type=0 表示普通存储,type=1 表示低频存存储QiniuExceptionpublic Response changeStatus(java.lang.String bucket, java.lang.String key, int status) throws QiniuException
bucket - 空间名称key - 文件名称status - 0表示启用;1表示禁用。QiniuExceptionpublic Response rename(java.lang.String bucket, java.lang.String oldFileKey, java.lang.String newFileKey, boolean force) throws QiniuException
bucket - 空间名称oldFileKey - 文件名称newFileKey - 新文件名force - 强制覆盖空间中已有同名(和 newFileKey 相同)的文件QiniuExceptionpublic Response rename(java.lang.String bucket, java.lang.String oldFileKey, java.lang.String newFileKey) throws QiniuException
bucket - 空间名称oldFileKey - 文件名称newFileKey - 新文件名QiniuExceptionpublic Response copy(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey, boolean force) throws QiniuException
fromBucket - 源空间名称fromFileKey - 源文件名称toBucket - 目的空间名称toFileKey - 目的文件名称force - 强制覆盖空间中已有同名(和 toFileKey 相同)的文件QiniuExceptionpublic void copy(java.lang.String fromBucket,
java.lang.String fromFileKey,
java.lang.String toBucket,
java.lang.String toFileKey)
throws QiniuException
fromBucket - 源空间名称fromFileKey - 源文件名称toBucket - 目的空间名称toFileKey - 目的文件名称QiniuExceptionpublic Response move(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey, boolean force) throws QiniuException
fromBucket - 源空间名称fromFileKey - 源文件名称toBucket - 目的空间名称toFileKey - 目的文件名称force - 强制覆盖空间中已有同名(和 toFileKey 相同)的文件QiniuExceptionpublic Response move(java.lang.String fromBucket, java.lang.String fromFileKey, java.lang.String toBucket, java.lang.String toFileKey) throws QiniuException
fromBucket - 源空间名称fromFileKey - 源文件名称toBucket - 目的空间名称toFileKey - 目的文件名称QiniuExceptionpublic FetchRet fetch(java.lang.String url, java.lang.String bucket) throws QiniuException
url - 待抓取的文件链接bucket - 文件抓取后保存的空间QiniuExceptionpublic FetchRet fetch(java.lang.String url, java.lang.String bucket, java.lang.String key) throws QiniuException
url - 待抓取的文件链接bucket - 文件抓取后保存的空间key - 文件抓取后保存的文件名QiniuExceptionpublic Response asynFetch(java.lang.String url, java.lang.String bucket, java.lang.String key) throws QiniuException
url - 待抓取的文件链接,支持设置多个,以';'分隔bucket - 文件抓取后保存的空间key - 文件抓取后保存的文件名QiniuExceptionpublic Response asynFetch(java.lang.String url, java.lang.String bucket, java.lang.String key, java.lang.String md5, java.lang.String etag, java.lang.String callbackurl, java.lang.String callbackbody, java.lang.String callbackbodytype, java.lang.String callbackhost, java.lang.String fileType) throws QiniuException
url - 待抓取的文件链接,支持设置多个,以';'分隔bucket - 文件抓取后保存的空间key - 文件抓取后保存的文件名md5 - 文件md5,传入以后会在存入存储时对文件做校验,校验失败则不存入指定空间etag - 文件etag,传入以后会在存入存储时对文件做校验,校验失败则不存入指定空间callbackurl - 回调URL,详细解释请参考上传策略中的callbackUrlcallbackbody - 回调Body,如果callbackurl不为空则必须指定。与普通上传一致支持魔法变量,callbackbodytype - 回调Body内容类型,默认为"application/x-www-form-urlencoded",callbackhost - 回调时使用的HostfileType - 存储文件类型 0:正常存储(默认),1:低频存储QiniuExceptionpublic Response checkAsynFetchid(java.lang.String region, java.lang.String fetchWorkId) throws QiniuException
region - 抓取任务所在bucket区域 华东 z0 华北 z1 华南 z2 北美 na0 东南亚 as0fetchWorkId - 抓取任务idQiniuExceptionpublic void prefetch(java.lang.String bucket,
java.lang.String key)
throws QiniuException
bucket - 空间名称key - 文件名称QiniuExceptionpublic Response setImage(java.lang.String bucket, java.lang.String srcSiteUrl) throws QiniuException
bucket - 空间名称srcSiteUrl - 镜像回源地址QiniuExceptionpublic Response setImage(java.lang.String bucket, java.lang.String srcSiteUrl, java.lang.String host) throws QiniuException
bucket - 空间名称srcSiteUrl - 镜像回源地址host - 镜像回源HostQiniuExceptionpublic Response unsetImage(java.lang.String bucket) throws QiniuException
bucket - 空间名称QiniuExceptionpublic Response deleteAfterDays(java.lang.String bucket, java.lang.String key, int days) throws QiniuException
bucket - 空间名称key - 文件名称days - 存活时间,单位:天QiniuExceptionpublic void setBucketAcl(java.lang.String bucket,
AclType acl)
throws QiniuException
QiniuExceptionpublic BucketInfo getBucketInfo(java.lang.String bucket) throws QiniuException
QiniuExceptionpublic void setIndexPage(java.lang.String bucket,
IndexPageType type)
throws QiniuException
QiniuExceptionpublic Response batch(BucketManager.BatchOperations operations) throws QiniuException
QiniuException