com.qikemi.packages.alibaba.aliyun.oss

类 BucketService

java.lang.Object

com.qikemi.packages.alibaba.aliyun.oss.BucketService

public class BucketService
extends Object

Bucket是OSS上的命名空间，也是计费、权限控制、日志记录等高级功能的管理实体；Bucket名称在整个OSS服务中具有全局唯一性，且不能修改； 存储在OSS上的每个Object必须都包含在某个Bucket中 。一个应用，例如图片分享网站，可以对应一个或多个Bucket。一个用户最多可创建10个Bucket ，但每个Bucket中存放的Object的数量和大小总和没有限制，用户不需要考虑数据的可扩展性。

构造器概要

构造器

构造器和说明
BucketService()

方法概要

限定符和类型	方法和说明
static com.aliyun.openservices.oss.model.Bucket	create(com.aliyun.openservices.oss.OSSClient client, String bucketName) 创建一个Bucket，如果创建成功，则返回新的Bucket Bucket命名规则： 只能包括小写字母，数字，短横线（-） 必须以小写字母或者数字开头 长度必须在3-63字节之间
static void	delete(com.aliyun.openservices.oss.OSSClient client, String bucketName) 删除Bucket 如果Bucket不为空（Bucket中有Object），则Bucket无法删除，必须清空Bucket后才能成功删除
static boolean	doesBucketExist(com.aliyun.openservices.oss.OSSClient client, String bucketName) 判断Bucket是否存在
static List<com.aliyun.openservices.oss.model.Bucket>	list(com.aliyun.openservices.oss.OSSClient client) 列出用户所有的Bucket
static void	setBucketAcl(com.aliyun.openservices.oss.OSSClient client, String bucketName, com.aliyun.openservices.oss.model.CannedAccessControlList acl) Bucket权限控制 public-read-write: 任何人（包括匿名访问）都可以对该bucket中的object进行上传、下载和删除操作；所有这些操作产生的费用由该bucket的创建者承担 ，请慎用该权限。

从类继承的方法 java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

BucketService

public BucketService()

方法详细资料

create

public static com.aliyun.openservices.oss.model.Bucket create(com.aliyun.openservices.oss.OSSClient client,
                                                              String bucketName)

创建一个Bucket，如果创建成功，则返回新的Bucket
Bucket命名规则：
只能包括小写字母，数字，短横线（-）
必须以小写字母或者数字开头
长度必须在3-63字节之间

返回:

list

public static List<com.aliyun.openservices.oss.model.Bucket> list(com.aliyun.openservices.oss.OSSClient client)

列出用户所有的Bucket

返回:

doesBucketExist

public static boolean doesBucketExist(com.aliyun.openservices.oss.OSSClient client,
                                      String bucketName)

判断Bucket是否存在

参数:

client -

bucketName -

返回:

delete

public static void delete(com.aliyun.openservices.oss.OSSClient client,
                          String bucketName)

删除Bucket
如果Bucket不为空（Bucket中有Object），则Bucket无法删除，必须清空Bucket后才能成功删除

参数:

client -

bucketName -

setBucketAcl

public static void setBucketAcl(com.aliyun.openservices.oss.OSSClient client,
                                String bucketName,
                                com.aliyun.openservices.oss.model.CannedAccessControlList acl)

Bucket权限控制 public-read-write: 任何人（包括匿名访问）都可以对该bucket中的object进行上传、下载和删除操作；所有这些操作产生的费用由该bucket的创建者承担 ，请慎用该权限。
public-read: 只有该bucket的创建者可以对该bucket内的Object进行写操作（包括上传和删除）；任何人（包括匿名访问） 可以对该bucket中的object进行读操作。
private: 只有该bucket的创建者才可以访问此Bukcet。其他人禁止对此Bucket做任何操作。

参数:

client -

bucketName -

acl
- CannedAccessControlList是枚举类型，包含三个值： Private 、 PublicRead 、 PublicReadWrite ，它们分别对应相关权限