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的訪問金鑰,您可以在控制檯上建立和檢視,
建立和檢視訪問金鑰的連結地址是:
注意: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客戶端檢視:
登入客戶端: