1. 程式人生 > >Java使用阿里雲OSS物件儲存上傳圖片

Java使用阿里雲OSS物件儲存上傳圖片

開發環境:

開發工具:eclipse4.4+jdk7 均64位

OSS Java SDK依賴下列包:

  • aliyun-sdk-oss-2.2.1.jar
  • hamcrest-core-1.1.jar
  • jdom-1.1.jar
  • commons-codec-1.9.jar
  • httpclient-4.4.1.jar(重點)
  • commons-logging-1.2.jar
  • httpcore-4.4.1.jar(重點)
  • log4j-1.2.15.jar

其中,log4j-1.2.15.jar是可選的,需要日誌功能的時加入該包。其它包都是必不可少的。

解決辦法:您的工程中在加入OSS Java SDK依賴的包,加入方法如下:

  • 如果您的工程是Eclipse。請參考Java-SDK使用手冊,”安裝”-> “方式二:在Eclipse專案中匯入工程依賴的包”;
  • 如果您的工程是maven。則直接新增依賴即可如:
<dependency>
   <groupId>com.aliyun.oss</groupId>
   <artifactId>aliyun-sdk-oss</artifactId>
   <version>2.5.0</version>
</dependency> 

程式碼:

阿里雲OSS物件儲存常量:

package com.qianjiang.util.aliyunoss;

/**
 * @class:OSSClientConstants
 * @descript:阿里雲註冊使用者基本常量
 * @date:2017年3月16日 下午5:52:34
 * @author sang
 */
public class OSSClientConstants {
	//阿里雲API的外網域名
    public static final String ENDPOINT = "oss-cn-shanghai.aliyuncs.com";
    //阿里雲API的金鑰Access Key ID
    public static final String ACCESS_KEY_ID = "LTAIRGxaf6yoUsj0";
    //阿里雲API的金鑰Access Key Secret
    public static final String ACCESS_KEY_SECRET = "3gcfQkeWjaJ3tunuv4yyY4DStgpriz";
    //阿里雲API的bucket名稱
    public static final String BACKET_NAME = "uploadpicture";
    //阿里雲API的資料夾名稱
    public static final String FOLDER="somnus/";
    
    
}
阿里雲基本引數詳解:

endpoint是訪問OSS的域名。如果您已經在OSS的控制檯上 建立了Bucket,請在控制檯上檢視域名。
如果您還沒有建立Bucket,endpoint選擇請參看文件中心的“開發人員指南 > 基本概念 > 訪問域名”,
連結地址是:https://help.aliyun.com/document_detail/oss/user_guide/oss_concept/endpoint.html?spm=5176.docoss/user_guide/endpoint_region
endpoint的格式形如“http://oss-cn-hangzhou.aliyuncs.com/”,注意http://後不帶bucket名稱,
比如“http://bucket-name.oss-cn-hangzhou.aliyuncs.com”,是錯誤的endpoint,請去掉其中的“bucket-name”。
    
accessKeyId和accessKeySecret是OSS的訪問金鑰,您可以在控制檯上建立和檢視,
建立和檢視訪問金鑰的連結地址是:

https://ak-console.aliyun.com/#/

注意:accessKeyId和accessKeySecret前後都沒有空格,從控制檯複製時請檢查並去除多餘的空格。
    
 Bucket用來管理所儲存Object的儲存空間,詳細描述請參看“開發人員指南 > 基本概念 > OSS基本概念介紹”。
 Bucket命名規範如下:只能包括小寫字母,數字和短橫線(-),必須以小寫字母或者數字開頭,長度必須在3-63位元組之間。
    
 Object是OSS儲存資料的基本單元,稱為OSS的物件,也被稱為OSS的檔案。詳細描述請參看“開發人員指南 > 基本概念 > OSS基本概念介紹”。
 Object命名規範如下:使用UTF-8編碼,長度必須在1-1023位元組之間,不能以“/”或者“\”字元開頭。
  就是上傳檔名的名稱,名稱唯一
    
 建立模擬資料夾
 OSS是沒有資料夾這個概念的,所有元素都是以Object來儲存。
 建立模擬資料夾本質上來說是建立了一個size為0的Object。
 對於這個Object可以上傳下載,只是控制檯會對以”/“結尾的Object以資料夾的方式展示。
 連結地址:https://help.aliyun.com/document_detail/32015.html?spm=5176.doc32013.2.5.ITwaY2

上傳工具類:

package com.qianjiang.util.aliyunoss;

import java.io.ByteArrayInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.InputStream;

import org.apache.log4j.Logger;

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;

/**
 * @class:AliyunOSSClientUtil
 * @descript:java使用阿里雲OSS儲存物件上傳圖片
 * @date:2017年3月16日 下午5:58:08
 * @author sang
 */
public class AliyunOSSClientUtil {
	//log日誌
	private static Logger logger = Logger.getLogger(AliyunOSSClientUtil.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;
	//阿里雲API的bucket名稱
	private static String BACKET_NAME;
	//阿里雲API的資料夾名稱
	private static String FOLDER;
	//初始化屬性
	static{
		ENDPOINT = OSSClientConstants.ENDPOINT;
		ACCESS_KEY_ID = OSSClientConstants.ACCESS_KEY_ID;
		ACCESS_KEY_SECRET = OSSClientConstants.ACCESS_KEY_SECRET;
		BACKET_NAME = OSSClientConstants.BACKET_NAME;
		FOLDER = OSSClientConstants.FOLDER;
	}
	
	/**
	 * 獲取阿里雲OSS客戶端物件
	 * @return ossClient
	 */
	public static  OSSClient getOSSClient(){
		return new OSSClient(ENDPOINT,ACCESS_KEY_ID, ACCESS_KEY_SECRET);
	}

	/**
	 * 建立儲存空間
	 * @param ossClient      OSS連線
	 * @param bucketName 儲存空間
	 * @return
	 */
	public  static String createBucketName(OSSClient ossClient,String bucketName){
		//儲存空間
		final String bucketNames=bucketName;
		if(!ossClient.doesBucketExist(bucketName)){
			//建立儲存空間
			Bucket bucket=ossClient.createBucket(bucketName);
			logger.info("建立儲存空間成功");
			return bucket.getName();
		}
		return bucketNames;
	}
	
	/**
	 * 刪除儲存空間buckName
	 * @param ossClient  oss物件
	 * @param bucketName  儲存空間
	 */
    public static  void deleteBucket(OSSClient ossClient, String bucketName){  
    	ossClient.deleteBucket(bucketName);   
        logger.info("刪除" + bucketName + "Bucket成功");  
    }  
	
	/**
	 * 建立模擬資料夾
	 * @param ossClient oss連線
	 * @param bucketName 儲存空間
	 * @param folder   模擬資料夾名如"qj_nanjing/"
	 * @return  資料夾名
	 */
	public  static String createFolder(OSSClient ossClient,String bucketName,String folder){
		//資料夾名 
		final String keySuffixWithSlash =folder;
		//判斷資料夾是否存在,不存在則建立
		if(!ossClient.doesObjectExist(bucketName, keySuffixWithSlash)){
			//建立資料夾
			ossClient.putObject(bucketName, keySuffixWithSlash, new ByteArrayInputStream(new byte[0]));
			logger.info("建立資料夾成功");
			//得到資料夾名
			OSSObject object = ossClient.getObject(bucketName, keySuffixWithSlash);
			String fileDir=object.getKey();
			return fileDir;
		}
		return keySuffixWithSlash;
	}
	
	 /**  
	    * 根據key刪除OSS伺服器上的檔案  
	    * @param ossClient  oss連線
	    * @param bucketName  儲存空間 
	    * @param folder  模擬資料夾名 如"qj_nanjing/"
	    * @param key Bucket下的檔案的路徑名+檔名 如:"upload/cake.jpg"
	    */    
	   public static void deleteFile(OSSClient ossClient, String bucketName, String folder, String key){    
		    ossClient.deleteObject(bucketName, folder + key);   
	        logger.info("刪除" + bucketName + "下的檔案" + folder + key + "成功");  
	   } 
	
	/**
	 * 上傳圖片至OSS
	 * @param ossClient  oss連線
	 * @param file 上傳檔案(檔案全路徑如:D:\\image\\cake.jpg)
	 * @param bucketName  儲存空間
	 * @param folder 模擬資料夾名 如"qj_nanjing/"
	 * @return String 返回的唯一MD5數字簽名
	 * */
	public static  String uploadObject2OSS(OSSClient ossClient, File file, String bucketName, String folder) {
		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());  
            //指定該Object被下載時的網頁的快取行為
            metadata.setCacheControl("no-cache"); 
            //指定該Object下設定Header
            metadata.setHeader("Pragma", "no-cache");  
            //指定該Object被下載時的內容編碼格式
            metadata.setContentEncoding("utf-8");  
            //檔案的MIME,定義檔案的型別及網頁編碼,決定瀏覽器將以什麼形式、什麼編碼讀取檔案。如果使用者沒有指定則根據Key或檔名的副檔名生成,
            //如果沒有副檔名則填預設值application/octet-stream
            metadata.setContentType(getContentType(fileName));  
            //指定該Object被下載時的名稱(指示MINME使用者代理如何顯示附加的檔案,開啟或下載,及檔名稱)
            metadata.setContentDisposition("filename/filesize=" + fileName + "/" + fileSize + "Byte.");  
            //上傳檔案   (上傳檔案流的形式)
            PutObjectResult putResult = ossClient.putObject(bucketName, folder + fileName, is, metadata);  
			//解析結果
			resultStr = putResult.getETag();
		} catch (Exception e) {
			e.printStackTrace();
			 logger.error("上傳阿里雲OSS伺服器異常." + e.getMessage(), e);  
		}
		return resultStr;
	}

	/**
	 * 通過檔名判斷並獲取OSS服務檔案上傳時檔案的contentType
	 * @param fileName 檔名
	 * @return 檔案的contentType
	 */
	public static  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 "image/jpeg";
	}
    
	//測試
	public static void main(String[] args) {
		//初始化OSSClient
		OSSClient ossClient=AliyunOSSClientUtil.getOSSClient();
		//上傳檔案
		String files="D:\\image\\1010.jpg,D:\\image\\1111.jpg,D:\\image\\1212.jpg,D:\\image\\1313.jpg,D:\\image\\2222.jpg,D:\\image\\3333.jpg,"
				+ "D:\\image\\4444.jpg,D:\\image\\5555.jpg,D:\\image\\6666.jpg,D:\\image\\7777.jpg,D:\\image\\8888.jpg";
		String[] file=files.split(",");
		for(String filename:file){
			//System.out.println("filename:"+filename);
			File filess=new File(filename);
			String md5key = AliyunOSSClientUtil.uploadObject2OSS(ossClient, filess, BACKET_NAME, FOLDER);  
			logger.info("上傳後的檔案MD5數字唯一簽名:" + md5key);  
			//上傳後的檔案MD5數字唯一簽名:40F4131427068E08451D37F02021473A
		}
		
		
	}
	
	
}
測試結果:

登入賬戶檢視是否已經上傳成功:


也可以下載OSS客戶端檢視:

登入客戶端: