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.com
accessKeyId=您的key
accessKeySecret=您的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 {
	
	//log
	private static final Logger LOG = LoggerFactory.getLogger(OSSUnit.class);
	
	//阿里雲API的內或外網域名
	private static String ENDPOINT;
	//阿里雲API的密鑰Access Key ID
	private static String ACCESS_KEY_ID;
	//阿里雲API的密鑰Access Key Secret
	private static String ACCESS_KEY_SECRET;
	
	//init static datas
	static{
		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的Metadata
			ObjectMetadata 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 {
	
	//log
	private static final Logger LOG = LoggerFactory.getLogger(OSSUnitTest.class);
	
	private OSSUnit ossunit = null;
	private OSSClient client = null;
	private String bucketName = "oss-test-my";
	@Before
	public void initUnit(){
		ossunit = new OSSUnit();
		client = OSSUnit.getOSSClient();
	}

	@Test
	public void testCreateBucket() {
		String bucketName = "oss-test-my";
		//創建bucket
		assertEquals(true, OSSUnit.createBucket(client, bucketName));
	}
	
	@Test
	public void testDeleteBucket(){
		String bucketName = "oss-test-my";
		//刪除bucket
		OSSUnit.deleteBucket(client, bucketName);
		//console log :刪除oss-test-myBucket成功
	}
	
	@Test
	public 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
	}
	
	@Test
	public 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);
		}
	}
	
	@Test
	public 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>

打開效果: