PDF《对象存储OSS》

对象存储OSS SDK手册 q q q q q q SDK手册 Java-SDK 前言 前言 SDK下载 Java SDK开发包(2015-11-24) 版本号 2.

0.7:java_sdk_20151124.zip 版本迭代详情参考这里 简介 本文档主要介绍OSS Java SDK的安装和使用,针对于JAVA SDK版本2.0.7.本文档假设您已经开通了阿里云 OSS 服务,并创建了Access Key ID 和Access Key Secret.文中的ID 指的是Access Key ID,KEY 指的是 Access Key Secret.如果您还没有开通或者还不了解OSS,请登录OSS产品主页获取更多的帮助. 安装 安装 直接在Eclipse中使用JAR包 步骤如下: 在官方网站下载 Open Service Java SDK . 解压文件. 将解压后文件夹中的文件: aliyun-sdk-oss-.jar 以及lib文件夹下的所有文件拷贝到你的工程 文件夹中. 在Eclipse右键工程 ->

Properties ->

Java Build Path ->

Add JARs . 选择你拷贝的所有JAR文件. 经过上面几步之后,你就可以在工程中使用OSS JAVA SDK了. 在Maven工程中使用SDK 在Maven工程中使用JAVA SDK十分简单,只要在在pom.xml文件中加入依赖就可以了.以2.0.6版本为例,在 对象存储OSS/SDK手册

1 dependencies 标签内加入如下内容: 快速入门 快速入门 在这一章里,您将学到如何用OSS Java SDK完成一些基本的操作. Step-1.初始化一个OSSClient SDK的OSS操作通过OSSClient类完成的,下面代码创建一个OSSClient对象: 在上面代码中,变量 accessKeyId 与accessKeySecret 是由系统分配给用户的,称为ID对,用于标识用户,可 能属于您的阿里云账号或者RAM账号为访问OSS做签名验证.关于OSSClient的详细介绍,参见 OSSClient. Step-2. 新建bucket Bucket是OSS全局命名空间,相当于数据的容器,可以存储若干Object.您可以按照下面的代码新建一个 Bucket: com.aliyun.oss aliyun-sdk-oss 2.0.6 import com.aliyun.oss.OSSClient;

public class Sample { public static void main(String[] args) { String accessKeyId = ;

String accessKeySecret = ;

// 以杭州为例 String endpoint = http://oss-cn-hangzhou.aliyuncs.com ;

// 初始化一个OSSClient OSSClient client = new OSSClient(endpoint,accessKeyId, accessKeySecret);

// 下面是一些调用代码... ... } } public void createBucket(String bucketName) { // 初始化OSSClient OSSClient client = new OSSClient(endpoint,accessKeyId, accessKeySecret);

// 新建一个Bucket client.createBucket(bucketName);

} 对象存储OSS/SDK手册

2 关于Bucket的命名规范,参见Bucket中的命名规范. Step-3. 上传Object Object是OSS中最基本的数据单元,您可以把它简单地理解为文件,用下面代码可以实现一个Object的上传: Object通过InputStream的形式上传到OSS中.在上面的例子里我们可以看出,每个上传的Object,都需要指 定和此Object关联的ObjectMetadata.ObjectMetaData是用户对该object的描述,由一系列name-value对 组成;

其中ContentLength是必须设置的,以便SDK可以正确识别上传Object的大小.为了保证上传文件服务 器端与本地一致,用户可以设置ContentMD5,OSS会计算上传数据的MD5值并与用户上传的MD5值比较 ,如果不一致返回InvalidDigest错误码.关于Object的命名规范,参见Object中的命名规范 .关于上传 Object更详细的信息,参见Object中的上传Object . Step-4. 列出所有Object 当您完成一系列上传后,可能需要查看某个Bucket中有哪些Object,可以通过下面的程序实现: public void putObject(String bucketName, String key, String filePath) throws FileNotFoundException { // 初始化OSSClient OSSClient client = new OSSClient(endpoint,accessKeyId, accessKeySecret);