Java操作aliyun-OSS对象存储

官网https://www.aliyun.com/product/oss第一句话：

“对象存储（Object Storage Service，简称OSS），是阿里云对外提供的海量、安全和高可靠的云存储服务。RESTFul API的平台无关性，容量和处理能力的弹性扩展，按实际容量付费真正使您专注于核心业务。”

当项目在使用的过程中会产生一些文件并需要存储，而自己的服务器容量不足够大来存储这些文件，这个时候就可以选择阿里云的对象存储服务。当然这是我的使用场景，你也可以参考官网的使用场景。

使用前提在“快速入门”里写得有，你需要开通服务并创建资源空间。

使用方法SDK手册中已经写得非常清楚了：https://help.aliyun.com/document_detail/32015.html?spm=5176.doc32013.6.305.MD4X5m

“在OSS中，用户操作的基本数据单元是文件（Object）。OSS Java SDK提供了丰富的文件上传接口，可以通过以下方式上传文件:

1.流式上传

2.文件上传

3.追加上传

4.分片上传

5.断点续传上传”

我采用的是文件上传方式:

需要的jar包

<dependency>
<groupId>com.aliyun.oss</groupId>
<artifactId>aliyun-sdk-oss</artifactId>
<version>2.2.3</version>
</dependency>

首先你需要一个OSSClient，里面的keyId以及keySecret是你在开通服务的时候获得的;OSS是没有文件夹这个概念的，所有元素都是以Object来存储，代码中的myKey或keys是你上传的Object的完整的键名称，比如你上传到 test/myWord/new.doc 里面，那么你的myKey就是“test/myWord/new.doc”，不管你本地的文件名称是什么，上传到云端之后的对象名称就是你的myKey的名称;OSS允许用户自定义Http header，在上传文件的方法中，设置了上传内容类型以及上传文件长度，之前看到一篇文章，是说这个云服务是按照量来计费的，所以需要告知它你要上传的内容长度，但是如果我不设置长度，貌似也能上传成功，原因还不清楚:

/**
* OSSClient
*
* @author andy
* @date 2016年8月31日
*/
public class OSSClientUtil {
// 访问OSS的域名， endpoint以上海为例，其它region请按实际情况填写
private static String endpoint = "http://oss-cn-shanghai.aliyuncs.com";
private static String accessKeyId = "<yourAccessKeyId>";
private static String accessKeySecret = "<yourAccessKeySecret>";
private static String bucketName = "<yourBucketName>";

//getter/setter方法略

}

在上传文件的时候，你需要先创建OSSClient实例，然后调用上传文件的方法。

import java.io.File;
import java.io.InputStream;
import java.util.List;

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSSClient;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.DeleteObjectsRequest;
import com.aliyun.oss.model.DeleteObjectsResult;
import com.aliyun.oss.model.GetObjectRequest;
import com.aliyun.oss.model.OSSObject;
import com.aliyun.oss.model.OSSObjectSummary;
import com.aliyun.oss.model.ObjectListing;
import com.aliyun.oss.model.ObjectMetadata;
import com.aliyun.oss.model.PutObjectResult;

/**
* 从云端上传下载查询删除文件
*
* @author andy
* @date 2016年8月31日
*/
public class FileLoadUtil {

/**
* 文件上传
*
* @param myKey
* @param file 要上传的文件
*/
public static void upLoadFileToALiyun(String myKey, File file) {
// 创建OSSClient实例
OSSClient ossClient = new OSSClient(OSSClientUtil.getEndpoint(), OSSClientUtil.getAccessKeyId(), OSSClientUtil.getAccessKeySecret());
// 创建上传Object的Metadata
ObjectMetadata meta = new ObjectMetadata();
// 设置上传内容类型docx
meta.setContentType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
// 设置上传文件长度
meta.setContentLength(file.length());
// 上传文件
try {
PutObjectResult m_Result = ossClient.putObject(OSSClientUtil.getBucketName(), myKey, file, meta);
System.out.println(m_Result.getETag());
} catch (OSSException oe) {
oe.printStackTrace();
throw new OSSException();
} catch (ClientException ce) {
ce.printStackTrace();
throw new ClientException();
} catch (Exception e) {
e.printStackTrace();
} finally {
ossClient.shutdown();// 关闭client
}
}

/**
* 文件下载
*
* @param myKey
* @param tempFileName 要下载的文件名
* @throws Exception
*/
public static void downloadFileFromALiyun(String myKey, String tempFileName) throws Exception {
// 创建OSSClient实例
OSSClient ossClient = new OSSClient(OSSClientUtil.getEndpoint(), OSSClientUtil.getAccessKeyId(), OSSClientUtil.getAccessKeySecret());
InputStream inputStream = null;
// 下载object到文件
try {
OSSObject ossObject = ossClient.getObject(new GetObjectRequest(OSSClientUtil.getBucketName(), myKey));
inputStream = ossObject.getObjectContent();
String newStr = new String(tempFileName.getBytes(), "UTF-8");
File f = new File(newStr);
FileUtil.inputstreamToFile(inputStream, f);
} catch (OSSException oe) {
oe.printStackTrace();
throw new Exception(oe.getErrorMessage());
} catch (ClientException ce) {
ce.printStackTrace();
throw new Exception(ce.getErrorMessage());
} catch (Exception e) {
e.printStackTrace();
throw new Exception(e.getMessage());
} finally {
ossClient.shutdown();// 关闭client
FileUtil.closeInputStream(inputStream);
}
}

// 查看Bucket中的Object。详细请参看“SDK手册 > Java-SDK > 管理文件”。
public static void queryObject() {
// 创建OSSClient实例
OSSClient ossClient = new OSSClient(OSSClientUtil.getEndpoint(), OSSClientUtil.getAccessKeyId(), OSSClientUtil.getAccessKeySecret());
try {
// 要查找的文件
ObjectListing objectListing = ossClient.listObjects(OSSClientUtil.getBucketName(), "yourObjectKey/");
List<OSSObjectSummary> objectSummary = objectListing.getObjectSummaries();
System.out.println("您有以下Object：");
for (OSSObjectSummary object : objectSummary) {
System.out.println("\t" + object.getKey());
}
} catch (OSSException oe) {
oe.printStackTrace();
} catch (ClientException ce) {
ce.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
} finally {
ossClient.shutdown();// 关闭client
}
}

// 删除Object。详细请参看“SDK手册 > Java-SDK > 管理文件”。
public static void deleteSingleObect(String myKey) {
//创建OSSClient实例
OSSClient ossClient = new OSSClient(OSSClientUtil.getEndpoint(), OSSClientUtil.getAccessKeyId(), OSSClientUtil.getAccessKeySecret());
try {
ossClient.deleteObject(OSSClientUtil.getBucketName(), myKey);
} catch (OSSException oe) {
oe.printStackTrace();
} catch (ClientException ce) {
ce.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
} finally {
ossClient.shutdown();// 关闭client
}
}

/**
* 批量删除object
*/
public static void deleteBatchObect(List<String> keys) {
// 删除Object。详细请参看“SDK手册 > Java-SDK > 管理文件”。
OSSClient ossClient = new OSSClient(OSSClientUtil.getEndpoint(), OSSClientUtil.getAccessKeyId(), OSSClientUtil.getAccessKeySecret());
try {
// 删除Objects
DeleteObjectsResult deleteObjectsResult = ossClient.deleteObjects(new DeleteObjectsRequest(OSSClientUtil.getBucketName()).withKeys(keys));
List<String> deletedObjects = deleteObjectsResult.getDeletedObjects();
} catch (OSSException oe) {
oe.printStackTrace();
} catch (ClientException ce) {
ce.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
} finally {
ossClient.shutdown();// 关闭client
}
}

public static boolean doesObjectExist(String myKey) {
OSSClient ossClient = new OSSClient(OSSClientUtil.getEndpoint(), OSSClientUtil.getAccessKeyId(), OSSClientUtil.getAccessKeySecret());
boolean found = false;
try {
found = ossClient.doesObjectExist(OSSClientUtil.getBucketName(), myKey);
} catch (OSSException oe) {
oe.printStackTrace();
} catch (ClientException ce) {
ce.printStackTrace();
} catch (Exception e) {
e.printStackTrace();
} finally {
ossClient.shutdown();// 关闭client
}
return found;
}

public static void main(String[] args) {
// queryObject();
// deleteBatchObect();
// System.out.println(doesObjectExist("yourObjectKey/test.doc"));
}
}