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

时间：2021-11-18 09:15:27

该案例是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。则直接添加依赖即可如：
[html]  view plain  copy
  1. <dependency>  
  2.    <groupId>com.aliyun.oss</groupId>  
  3.    <artifactId>aliyun-sdk-oss</artifactId>  
  4.    <version>2.5.0</version>  
  5. </dependency>   

代码：

阿里云OSS对象存储常量：

[java]  view plain  copy
  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

上传工具类：

[java]  view plain  copy
  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对象存储上传图片

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

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

登录客户端：

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


标签：

相关文章