SpringBoot使用阿里OSS实现文件云存储

以你之姓@ 2022-11-20 08:28 364阅读 0赞

# SpringBoot使用阿里OSS实现文件云存储 #

## 前言 ##

我们在项目中经常会使用到图片或者文档资源，一般来说如何这类文件比较少的时候我们可以直接存在在服务器中，但是如果一旦这些文件到达一定数量的时候如果在放在应用服务器必然会影响应用服务器的性能，并且有时候这些图片资源也要直接用在前端显示当中，所以放在应用服务器也是不妥的。一些比较大的互联网公司可能会使用一些分布式文件系统来达到存储文件的目的，但这种方式门槛过高。如何找到一个合适且性价比高的文件存储方式呢？那么不得不说的就是对象存储服务`OSS`.

**FastDFS分布式文件系统**可参考我的博客：[FastDFS分布式文件系统][FastDFS]

## 正文 ##

## 对象存储服务 ##

**对象存储服务**（`OSS`）：是一种海量、安全、低成本、高可靠的云存储服务，适合存放任意类型的文件:

*  `OSS`可用于图片、音视频、日志等海量文件的存储。
 *  各种终端设备、`Web`网站程序、移动应用可以直接向`OSS`写入或读取数据。
 *  `OSS`支持流式写入和文件写入两种方式。  
    简单地来说，我们通过`OSS`可以避免在服务器中存储大量的文件、图片等资源增加服务器的`IO`的读写带宽。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center]

## SpringBoot使用阿里OSS实现文件云存储 ##

## 前期准备 ##

**第一步：在[阿里云商城][Link 1]购买对象存储服务**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 1]

**第二步：在[阿里云控制台][Link 2]配置`AccessKey`**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 2]

## 代码部分 ##

**maven依赖**

<dependency>
      <groupId>com.aliyun.oss</groupId>
      <artifactId>aliyun-sdk-oss</artifactId>
      <version>3.5.0</version>
    </dependency>
    
    
    <dependency>
      <groupId>commons-io</groupId>
      <artifactId>commons-io</artifactId>
      <version>2.4</version>
    </dependency>
    
    
    <dependency>
      <groupId>commons-fileupload</groupId>
      <artifactId>commons-fileupload</artifactId>
      <version>1.3.3</version>
    </dependency>

**application.properties:配置类**

##basic setting
    server.port = 8080
    server.address =127.0.0.1
    
    # 解除文件大小限制
    spring.servlet.multipart.max-file-size=10MB
    spring.servlet.multipart.max-request-size=10MB

**OssManagerUtil.java:阿里OSS工具类**

/** * 阿里Oss对象存储工具类 */
    public class OssManagerUtil { 
    
        private static String endpoint = “oss中获取的oss公网路径";
        private static String accessKeyId = “自己在阿里云申请的accessKeyId";
        private static String accessKeySecret = "自己在阿里云申请的accessKeySecret";
        private static String bucket = "bucket名称";
    
    
        private static OSS client;
    
    
        static { 
            client = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
        }
    
    
        /** * 上传图片 * * @param fileName 图片名称，图片名称包括文件夹名称和“/” * @param length 图片大小 * @param content 输入流 */
        public static String uploadImage(String fileName, long length, InputStream content) { 
            uploadBucketImage(bucket, fileName, length, content);
            return "https://" + bucket + "." + endpoint + "/" + fileName;
        }
    
    
        /** * 上传文件 * * @param bucket 存储空间名 * @param fileName 文件名(包括文件夹名称和“/”) * @param length 流的长度 * @param content 输入流 */
        public static void uploadBucketImage(String bucket, String fileName, long length, InputStream content) { 
            // 创建上传Object的Metadata
            ObjectMetadata meta = new ObjectMetadata();
            // 必须设置ContentLength
            meta.setContentLength(length);
            // 上传Object.
            client.putObject(bucket, fileName, content, meta);
        }
    
    
        /** * 删除文件 * * @param fileName 文件名称，图片名称包括文件夹名称和“/” */
        public static boolean delShopImage(String fileName) { 
            //判断文件是否存在
            boolean exist = client.doesObjectExist(bucket, fileName);
            //文件不存在删除失败
            if (!exist) { 
                return false;
            }
            //执行删除
            client.deleteObject(bucket, fileName);
            return true;
        }
    
    
        /** * 获得上传文件后url链接 * * @param fileName 文件名(包括文件夹名称和“/”) * @return */
        public static String getUrl(String fileName) { 
            // 设置URL过期时间为10年 3600l* 1000*24*365*10
            Date expiration = new Date(System.currentTimeMillis() + 3600L * 1000 * 24 * 365 * 10);
            // 生成URL
            URL url = client.generatePresignedUrl(bucket, fileName, expiration);
            if (url != null) { 
                return url.toString();
            }
            return null;
        }
    
        /** * 创建存储空间 * * @param bucketName 新建存储空间默认为标准存储类型，私有权限。 * @return */
        public static void crateBucket(String bucketName) { 
            // 新建存储空间默认为标准存储类型，私有权限。
            client.createBucket(bucketName);
        }
    }

## 验证 ##

**测试接口：文件上传**

/** * 文件上传到阿里oss */
    @PostMapping("/uploadFiletoOss")
    @ApiOperation(value = "文件上传到阿里oss")
    public ResponseResult uploadFiletoOss(@RequestParam("file")MultipartFile file)throws IOException{ 
        String fileName = file.getOriginalFilename();
        String suffix = fileName.substring(fileName.lastIndexOf(".") + 1);
        fileName = UUID.randomUUID().toString().replace("-", "") + "." + suffix;
        String url = OssManagerUtil.uploadImage(fileName,file.getInputStream().available(),file.getInputStream());
        return ResponseResult.success(url);
    }

**访问测试接口：**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 3]

**打开接口返回的OSS在线文件URL，得到在线文件：**

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 4]

## 源码 ##

项目源码可从的我的github中获取：[github源码地址][github]

该源码解析可参考我的博客：[开箱即用的SpringBoot模板][SpringBoot]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 5]

[FastDFS]: https://xiyuan.blog.csdn.net/article/details/100582269
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center]: /images/20221120/5c025d8722f3416ebf81f530b757016e.png
[Link 1]: https://help.aliyun.com/product/31815.html?spm=a2c4g.11174283.6.540.4a937da2y3lIB1
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20201027234412839.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA==,size_16,color_FFFFFF,t_70#pic_center
[Link 2]: https://homenew.console.aliyun.com/?spm=a2c4g.11174283.amxosvpfn.19.8ef67da2bUe3dH
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20201027234519272.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA==,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20201027235139831.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA==,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/2020102723520050.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA==,size_16,color_FFFFFF,t_70#pic_center
[github]: https://github.com/luo948521848/xiyuan-for-springboot
[SpringBoot]: https://xiyuan.blog.csdn.net/article/details/109063070
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA_size_16_color_FFFFFF_t_70_pic_center 5]: https://img-blog.csdnimg.cn/20201027235336555.jpg?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk5MDgxOA==,size_16,color_FFFFFF,t_70#pic_center