Java使用阿里云OSS对象存储上传图片

Java使用阿里云OSS对象存储上传图片

2017年03月27日 10:47:28 陌上桑花开花 阅读数 26804更多
分类专栏: 工作案例总结
版权声明:本文为博主原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。

示例说明
 
该案例是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. }

测试结果:

登录账户查看是否已经上传成功:

Java使用阿里云OSS对象存储上传图片Java使用阿里云OSS对象存储上传图片

也可以下载OSS客户端查看:

客户端下载地址:http://download.csdn.net/detail/u014079773/9793762

登录客户端:

Java使用阿里云OSS对象存储上传图片Java使用阿里云OSS对象存储上传图片

显示推荐内容
上一篇:经验分享:10个简单实用的 jQuery 代码片段


下一篇:自定义滚动条CSS样式