java操作阿里云的对象存储OSS

官网:: 对象存储（Object Storage Service，简称OSS）

以下博客简单介绍连接阿里云的OSS，新建Bucket，删除Bucket，向阿里云的OSS存储中存储单个文件，获取单个文件，删除单个文件等功能。

Api:: 开放式存储（OSS）Java API手册 1.0 documentation

以下为pom依赖：

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

下载地址：Aliyun OSS SDK For Java » 2.2.1

下边为oss的配置文件oss.properties，也可以直接写入代码:

endpoint=oss-cn-beijing.aliyuncs.comaccessKeyId=您的keyaccessKeySecret=您的secret

注endpoint为：OSS外网域名或OSS内网域名去掉您的Bucket.后

OSS的操作代码：

package my.demo.java.z.aliyun.oss;import java.io.File;import java.io.FileInputStream;import java.io.InputStream;import java.util.PropertyResourceBundle;import java.util.ResourceBundle;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import com.aliyun.oss.OSSClient;import com.aliyun.oss.model.Bucket;import com.aliyun.oss.model.OSSObject;import com.aliyun.oss.model.ObjectMetadata;import com.aliyun.oss.model.PutObjectResult;public class OSSUnit {//logprivate static final Logger LOG = LoggerFactory.getLogger(OSSUnit.class);//阿里云API的内或外网域名private static String ENDPOINT;//阿里云API的密钥Access Key IDprivate static String ACCESS_KEY_ID;//阿里云API的密钥Access Key Secretprivate static String ACCESS_KEY_SECRET;//init static datasstatic{ResourceBundle bundle = PropertyResourceBundle.getBundle("properties.oss");ENDPOINT = bundle.containsKey("endpoint") == false ? "" : bundle.getString("endpoint");ACCESS_KEY_ID = bundle.containsKey("accessKeyId") == false? "" : bundle.getString("accessKeyId");ACCESS_KEY_SECRET = bundle.containsKey("accessKeySecret") == false ? "" : bundle.getString("accessKeySecret");}/** * 获取阿里云OSS客户端对象 * */public static final OSSClient getOSSClient(){return new OSSClient(ENDPOINT,ACCESS_KEY_ID, ACCESS_KEY_SECRET);}/** * 新建Bucket  --Bucket权限:私有 * @param bucketName bucket名称 * @return true 新建Bucket成功 * */public static final boolean createBucket(OSSClient client, String bucketName){Bucket bucket = client.createBucket(bucketName); return bucketName.equals(bucket.getName());}/** * 删除Bucket  * @param bucketName bucket名称 * */public static final void deleteBucket(OSSClient client, String bucketName){client.deleteBucket(bucketName); LOG.info("删除" + bucketName + "Bucket成功");}/** * 向阿里云的OSS存储中存储文件  --file也可以用InputStream替代 * @param client OSS客户端 * @param file 上传文件 * @param bucketName bucket名称 * @param diskName 上传文件的目录  --bucket下文件的路径 * @return String 唯一MD5数字签名 * */public static final String uploadObject2OSS(OSSClient client, File file, String bucketName, String diskName) {String resultStr = null;try {InputStream is = new FileInputStream(file);String fileName = file.getName();Long fileSize = file.length();//创建上传Object的MetadataObjectMetadata metadata = new ObjectMetadata();metadata.setContentLength(is.available());metadata.setCacheControl("no-cache");metadata.setHeader("Pragma", "no-cache");metadata.setContentEncoding("utf-8");metadata.setContentType(getContentType(fileName));metadata.setContentDisposition("filename/filesize=" + fileName + "/" + fileSize + "Byte.");//上传文件 PutObjectResult putResult = client.putObject(bucketName, diskName + fileName, is, metadata);//解析结果resultStr = putResult.getETag();} catch (Exception e) {LOG.error("上传阿里云OSS服务器异常." + e.getMessage(), e);}return resultStr;}    /**      * 根据key获取OSS服务器上的文件输入流  * @param client OSS客户端  * @param bucketName bucket名称  * @param diskName 文件路径  * @param key Bucket下的文件的路径名+文件名     */       public static final InputStream getOSS2InputStream(OSSClient client, String bucketName, String diskName, String key){ OSSObject ossObj = client.getObject(bucketName, diskName + key);return ossObj.getObjectContent();     }     /**     * 根据key删除OSS服务器上的文件   * @param client OSS客户端  * @param bucketName bucket名称  * @param diskName 文件路径  * @param key Bucket下的文件的路径名+文件名    */    public static void deleteFile(OSSClient client, String bucketName, String diskName, String key){    client.deleteObject(bucketName, diskName + key);   LOG.info("删除" + bucketName + "下的文件" + diskName + key + "成功");  }           /**      * 通过文件名判断并获取OSS服务文件上传时文件的contentType      * @param fileName 文件名     * @return 文件的contentType        */       public static final String getContentType(String fileName){      String fileExtension = fileName.substring(fileName.lastIndexOf("."));    if("bmp".equalsIgnoreCase(fileExtension)) return "image/bmp";    if("gif".equalsIgnoreCase(fileExtension)) return "image/gif";    if("jpeg".equalsIgnoreCase(fileExtension) || "jpg".equalsIgnoreCase(fileExtension)  || "png".equalsIgnoreCase(fileExtension) ) return "image/jpeg";    if("html".equalsIgnoreCase(fileExtension)) return "text/html";    if("txt".equalsIgnoreCase(fileExtension)) return "text/plain";    if("vsd".equalsIgnoreCase(fileExtension)) return "application/vnd.visio";    if("ppt".equalsIgnoreCase(fileExtension) || "pptx".equalsIgnoreCase(fileExtension)) return "application/vnd.ms-powerpoint";    if("doc".equalsIgnoreCase(fileExtension) || "docx".equalsIgnoreCase(fileExtension)) return "application/msword";    if("xml".equalsIgnoreCase(fileExtension)) return "text/xml";        return "text/html";       }  }

代码对应测试代码junit如下:

package my.demo.java.z.aliyun.oss;import static org.junit.Assert.assertEquals;import java.io.BufferedInputStream;import java.io.BufferedOutputStream;import java.io.File;import java.io.FileNotFoundException;import java.io.FileOutputStream;import java.io.IOException;import org.junit.Before;import org.junit.Test;import org.slf4j.Logger;import org.slf4j.LoggerFactory;import com.aliyun.oss.OSSClient;public class OSSUnitTest {//logprivate static final Logger LOG = LoggerFactory.getLogger(OSSUnitTest.class);private OSSUnit ossunit = null;private OSSClient client = null;private String bucketName = "oss-test-my";@Beforepublic void initUnit(){ossunit = new OSSUnit();client = OSSUnit.getOSSClient();}@Testpublic void testCreateBucket() {String bucketName = "oss-test-my";//创建bucketassertEquals(true, OSSUnit.createBucket(client, bucketName));}@Testpublic void testDeleteBucket(){String bucketName = "oss-test-my";//删除bucketOSSUnit.deleteBucket(client, bucketName);//console log :删除oss-test-myBucket成功}@Testpublic void testUploadObject2OSS(){//上传文件String flilePathName = "C:/Users/Tony_tian/Desktop/csdnimg/preossimg.jpg";File file = new File(flilePathName);String diskName = "datas/image/";String md5key = OSSUnit.uploadObject2OSS(client, file, bucketName, diskName);LOG.info("上传后的文件MD5数字唯一签名:" + md5key);  //上传后的文件MD5数字唯一签名:A30B046A34EB326C4A3BBD784333B017}@Testpublic void testGetOSS2InputStream(){//获取文件try {BufferedInputStream bis = new BufferedInputStream(OSSUnit.getOSS2InputStream(client, bucketName, "datas/image/", "preossimg.jpg"));String resfile = "C:/Users/Tony_tian/Desktop/csdnimg/preossimg_res.jpg";BufferedOutputStream bos = new BufferedOutputStream(new FileOutputStream(new File(resfile)));int itemp = 0;while((itemp = bis.read()) != -1){bos.write(itemp);}LOG.info("文件获取成功"); //console log :文件获取成功bis.close();bos.close();} catch (Exception e) {LOG.error("从OSS获取文件失败:" + e.getMessage(), e);}}@Testpublic void testDeleteFile(){//注：文件夹下只有一个文件，则文件夹也会一起删除；如果多个文件，只会删除指定文件名的文件//删除文件OSSUnit.deleteFile(client, bucketName, "datas/image/", "preossimg.jpg");//console log : 删除oss-test-my下的文件datas/image/preossimg.jpg成功}}

部分效果图:

新建Bucket(Bucket权限:私有，公开需手动设置)前后和删除Bucket：

上传文件前后即删除文件：

注：文件夹下只有一个文件，则文件夹也会一起删除；如果多个文件，只会删除指定文件名的文件

上边记录为私有文件的获取，如果要获取“Bucket权限:公共读”的就很简单了：

<!DOCTYPE html><html><head><meta charset="utf-8" /><title>Aliyun-OSS</title><meta name="keywords" content="Aliyun-OSS"/><meta name="description" content="Aliyun-OSS" /><!--<link rel="stylesheet" href="${serverprc }/static/css/common.css" /><script type="text/javascript" src="${serverprc }/static/js/common.js" charset="utf-8"></script> --></head><body><div>Bucket权限:公共读的图片:<img src="http://tsxs-datas.oss-cn-beijing.aliyuncs.com/image/public/tsxs_title_logo.ico"/></div></body></html>

打开效果: