原

Java使用阿里雲OSS對象存儲上傳圖片

2017年03月27日 10:47:28 陌上桑花開花 閱讀數 26804更多

分類專欄： 工作案例總結

版權聲明：本文為博主原創文章，遵循 CC 4.0 BY-SA 版權協議，轉載請附上原文出處鏈接和本聲明。

本文鏈接： https://blog.csdn.net/u014079773/article/details/66968718

示例說明
 
該案例是OSS Java SDK的示例程序，您可以修改endpoint、accessKeyId、accessKeySecret、bucketName后直接運行。
本示例中的並不包括OSS Java SDK的所有功能，詳細功能及使用方法，請參看“SDK手冊 > Java-SDK”，
鏈接地址是：https://help.aliyun.com/document_detail/oss/sdk/java-sdk/preface.html?spm=5176.docoss/sdk/java-sdk/

調用OSS Java SDK的方法時，拋出異常表示有錯誤發生；沒有拋出異常表示成功執行。
當錯誤發生時，OSS Java SDK的方法會拋出異常，異常中包括錯誤碼、錯誤信息，詳細請參看“SDK手冊 > Java-SDK > 異常處理”，
鏈接地址是：https://help.aliyun.com/document_detail/oss/sdk/java-sdk/exception.html?spm=5176.docoss/api-reference/error-response

OSS控制台可以直觀的看到您調用OSS Java SDK的結果，OSS控制台地址是：https://oss.console.aliyun.com/index#/
OSS控制台使用方法請參看文檔中心的“控制台用戶指南”指南的鏈接地址是：

https://help.aliyun.com/document_detail/oss/getting-started/get-started.html?spm=5176.docoss/user_guide
 
OSS的文檔中心地址是：https://help.aliyun.com/document_detail/oss/user_guide/overview.html
OSS Java SDK的文檔地址是：https://help.aliyun.com/document_detail/oss/sdk/java-sdk/install.html?spm=5176.docoss/sdk/java-sdk
 
OSS開發過程中常見問題鏈接地址：https://help.aliyun.com/document_detail/32024.html?spm=5176.product31815.6.665.JuvIOS

開發環境：

開發工具：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。則直接添加依賴即可如：

1. <dependency>
2. <groupId>com.aliyun.oss</groupId>
3. <artifactId>aliyun-sdk-oss</artifactId>
4. <version>2.5.0</version>
5. </dependency>

代碼：

阿里雲OSS對象存儲常量：

1. package com.qianjiang.util.aliyunoss;
2.  
3. /**
4. * @class:OSSClientConstants
5. * @descript:阿里雲注冊用戶基本常量
6. * @date:2017年3月16日 下午5:52:34
7. * @author sang
8. */
9. public class OSSClientConstants {
10. //阿里雲API的外網域名
11. public static final String ENDPOINT = "oss-cn-shanghai.aliyuncs.com";
12. //阿里雲API的密鑰Access Key ID
13. public static final String ACCESS_KEY_ID = "LTAIRGxaf6yoUsj0";
14. //阿里雲API的密鑰Access Key Secret
15. public static final String ACCESS_KEY_SECRET = "3gcfQkeWjaJ3tunuv4yyY4DStgpriz";
16. //阿里雲API的bucket名稱
17. public static final String BACKET_NAME = "uploadpicture";
18. //阿里雲API的文件夾名稱
19. public static final String FOLDER="somnus/";
20.  
21.  
22. }

阿里雲基本參數詳解：

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

上傳工具類：

1. package com.qianjiang.util.aliyunoss;
2.  
3. import java.io.ByteArrayInputStream;
4. import java.io.File;
5. import java.io.FileInputStream;
6. import java.io.InputStream;
7.  
8. import org.apache.log4j.Logger;
9.  
10. import com.aliyun.oss.OSSClient;
11. import com.aliyun.oss.model.Bucket;
12. import com.aliyun.oss.model.OSSObject;
13. import com.aliyun.oss.model.ObjectMetadata;
14. import com.aliyun.oss.model.PutObjectResult;
15.  
16. /**
17. * @class:AliyunOSSClientUtil
18. * @descript:java使用阿里雲OSS存儲對象上傳圖片
19. * @date:2017年3月16日 下午5:58:08
20. * @author sang
21. */
22. public class AliyunOSSClientUtil {
23. //log日志
24. private static Logger logger = Logger.getLogger(AliyunOSSClientUtil.class);
25. //阿里雲API的內或外網域名
26. private static String ENDPOINT;
27. //阿里雲API的密鑰Access Key ID
28. private static String ACCESS_KEY_ID;
29. //阿里雲API的密鑰Access Key Secret
30. private static String ACCESS_KEY_SECRET;
31. //阿里雲API的bucket名稱
32. private static String BACKET_NAME;
33. //阿里雲API的文件夾名稱
34. private static String FOLDER;
35. //初始化屬性
36. static{
37. ENDPOINT = OSSClientConstants.ENDPOINT;
38. ACCESS_KEY_ID = OSSClientConstants.ACCESS_KEY_ID;
39. ACCESS_KEY_SECRET = OSSClientConstants.ACCESS_KEY_SECRET;
40. BACKET_NAME = OSSClientConstants.BACKET_NAME;
41. FOLDER = OSSClientConstants.FOLDER;
42. }
43.  
44. /**
45. * 獲取阿里雲OSS客戶端對象
46. * @return ossClient
47. */
48. public static OSSClient getOSSClient(){
49. return new OSSClient(ENDPOINT,ACCESS_KEY_ID, ACCESS_KEY_SECRET);
50. }
51.  
52. /**
53. * 創建存儲空間
54. * @param ossClient OSS連接
55. * @param bucketName 存儲空間
56. * @return
57. */
58. public static String createBucketName(OSSClient ossClient,String bucketName){
59. //存儲空間
60. final String bucketNames=bucketName;
61. if(!ossClient.doesBucketExist(bucketName)){
62. //創建存儲空間
63. Bucket bucket=ossClient.createBucket(bucketName);
64. logger.info( "創建存儲空間成功");
65. return bucket.getName();
66. }
67. return bucketNames;
68. }
69.  
70. /**
71. * 刪除存儲空間buckName
72. * @param ossClient oss對象
73. * @param bucketName 存儲空間
74. */
75. public static void deleteBucket(OSSClient ossClient, String bucketName){
76. ossClient.deleteBucket(bucketName);
77. logger.info( "刪除" + bucketName + "Bucket成功");
78. }
79.  
80. /**
81. * 創建模擬文件夾
82. * @param ossClient oss連接
83. * @param bucketName 存儲空間
84. * @param folder 模擬文件夾名如"qj_nanjing/"
85. * @return 文件夾名
86. */
87. public static String createFolder(OSSClient ossClient,String bucketName,String folder){
88. //文件夾名
89. final String keySuffixWithSlash =folder;
90. //判斷文件夾是否存在，不存在則創建
91. if(!ossClient.doesObjectExist(bucketName, keySuffixWithSlash)){
92. //創建文件夾
93. ossClient.putObject(bucketName, keySuffixWithSlash, new ByteArrayInputStream(new byte[0]));
94. logger.info( "創建文件夾成功");
95. //得到文件夾名
96. OSSObject object = ossClient.getObject(bucketName, keySuffixWithSlash);
97. String fileDir=object.getKey();
98. return fileDir;
99. }
100. return keySuffixWithSlash;
101. }
102.  
103. /**
104. * 根據key刪除OSS服務器上的文件
105. * @param ossClient oss連接
106. * @param bucketName 存儲空間
107. * @param folder 模擬文件夾名 如"qj_nanjing/"
108. * @param key Bucket下的文件的路徑名+文件名 如："upload/cake.jpg"
109. */
110. public static void deleteFile(OSSClient ossClient, String bucketName, String folder, String key){
111. ossClient.deleteObject(bucketName, folder + key);
112. logger.info( "刪除" + bucketName + "下的文件" + folder + key + "成功");
113. }
114.  
115. /**
116. * 上傳圖片至OSS
117. * @param ossClient oss連接
118. * @param file 上傳文件（文件全路徑如：D:\\image\\cake.jpg）
119. * @param bucketName 存儲空間
120. * @param folder 模擬文件夾名 如"qj_nanjing/"
121. * @return String 返回的唯一MD5數字簽名
122. * */
123. public static String uploadObject2OSS(OSSClient ossClient, File file, String bucketName, String folder) {
124. String resultStr = null;
125. try {
126. //以輸入流的形式上傳文件
127. InputStream is = new FileInputStream(file);
128. //文件名
129. String fileName = file.getName();
130. //文件大小
131. Long fileSize = file.length();
132. //創建上傳Object的Metadata
133. ObjectMetadata metadata = new ObjectMetadata();
134. //上傳的文件的長度
135. metadata.setContentLength(is.available());
136. //指定該Object被下載時的網頁的緩存行為
137. metadata.setCacheControl( "no-cache");
138. //指定該Object下設置Header
139. metadata.setHeader( "Pragma", "no-cache");
140. //指定該Object被下載時的內容編碼格式
141. metadata.setContentEncoding( "utf-8");
142. //文件的MIME，定義文件的類型及網頁編碼，決定瀏覽器將以什么形式、什么編碼讀取文件。如果用戶沒有指定則根據Key或文件名的擴展名生成，
143. //如果沒有擴展名則填默認值application/octet-stream
144. metadata.setContentType(getContentType(fileName));
145. //指定該Object被下載時的名稱（指示MINME用戶代理如何顯示附加的文件，打開或下載，及文件名稱）
146. metadata.setContentDisposition( "filename/filesize=" + fileName + "/" + fileSize + "Byte.");
147. //上傳文件 (上傳文件流的形式)
148. PutObjectResult putResult = ossClient.putObject(bucketName, folder + fileName, is, metadata);
149. //解析結果
150. resultStr = putResult.getETag();
151. } catch (Exception e) {
152. e.printStackTrace();
153. logger.error( "上傳阿里雲OSS服務器異常." + e.getMessage(), e);
154. }
155. return resultStr;
156. }
157.  
158. /**
159. * 通過文件名判斷並獲取OSS服務文件上傳時文件的contentType
160. * @param fileName 文件名
161. * @return 文件的contentType
162. */
163. public static String getContentType(String fileName){
164. //文件的后綴名
165. String fileExtension = fileName.substring(fileName.lastIndexOf( "."));
166. if(".bmp".equalsIgnoreCase(fileExtension)) {
167. return "image/bmp";
168. }
169. if(".gif".equalsIgnoreCase(fileExtension)) {
170. return "image/gif";
171. }
172. if(".jpeg".equalsIgnoreCase(fileExtension) || ".jpg".equalsIgnoreCase(fileExtension) || ".png".equalsIgnoreCase(fileExtension) ) {
173. return "image/jpeg";
174. }
175. if(".html".equalsIgnoreCase(fileExtension)) {
176. return "text/html";
177. }
178. if(".txt".equalsIgnoreCase(fileExtension)) {
179. return "text/plain";
180. }
181. if(".vsd".equalsIgnoreCase(fileExtension)) {
182. return "application/vnd.visio";
183. }
184. if(".ppt".equalsIgnoreCase(fileExtension) || "pptx".equalsIgnoreCase(fileExtension)) {
185. return "application/vnd.ms-powerpoint";
186. }
187. if(".doc".equalsIgnoreCase(fileExtension) || "docx".equalsIgnoreCase(fileExtension)) {
188. return "application/msword";
189. }
190. if(".xml".equalsIgnoreCase(fileExtension)) {
191. return "text/xml";
192. }
193. //默認返回類型
194. return "image/jpeg";
195. }
196.  
197. //測試
198. public static void main(String[] args) {
199. //初始化OSSClient
200. OSSClient ossClient=AliyunOSSClientUtil.getOSSClient();
201. //上傳文件
202. 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,"
203. + "D:\\image\\4444.jpg,D:\\image\\5555.jpg,D:\\image\\6666.jpg,D:\\image\\7777.jpg,D:\\image\\8888.jpg";
204. String[] file=files.split( ",");
205. for(String filename:file){
206. //System.out.println("filename:"+filename);
207. File filess= new File(filename);
208. String md5key = AliyunOSSClientUtil.uploadObject2OSS(ossClient, filess, BACKET_NAME, FOLDER);
209. logger.info( "上傳后的文件MD5數字唯一簽名:" + md5key);
210. //上傳后的文件MD5數字唯一簽名:40F4131427068E08451D37F02021473A
211. }
212.  
213.  
214. }
215.  
216.  
217. }

測試結果：

登錄賬戶查看是否已經上傳成功：

 

 

也可以下載OSS客戶端查看：

客戶端下載地址：http://download.csdn.net/detail/u014079773/9793762

登錄客戶端：

 

 

 

顯示推薦內容