从零搭建Spring Boot脚手架（7）：整合OSS做为文件服务器

1. 前言

文件服务器是一个应用必要的组件之一。最先我搞过FTP，而后又用过FastDFS，接私活的时候我用MongoDB也凑合凑合。现现在时代不一样了，开始流行起了OSS。

Gitee: https://gitee.com/felord/kono day06 分支 欢迎Star

GitHub: https://github.com/NotFound40... day06 分支 欢迎Star

2. 什么是OSS

全称为Object Storage Service，也叫对象存储服务，是一种解决和处理离散单元的方法，可提供基于分布式系统之上的对象形式的数据存储服务，具备可拓展、可管理、低成本等特色，支持中心和边缘存储，可以实现存储需求的弹性伸缩，主要应用于海量数据管理的各种场景。

这概念真是够难以理解的。简单说点我知道的吧，日常咱们的文件地址都是 /User/felord/video/xxx.mp4的目录树结构，系统先要找到User，而后一级一级往下找一直到目标为止，这是一种结构化的存储方式。对象存储就不同了，全部的文件都放在一个特定的池子里，只不过文件的携带有它本身的元信息，经过元信息去检索文件。这里举一个形象的例子：

{"oss":[
    {"file":"xxxxx","meta":{"id":"1111"},"type":""},
    {"content":"xxxxx","meta":{"id":"1211"},"type":"","created":"","name":""}, 
]}

上图的oss就是一个对象存储，它里面存了携带信息不同、甚至结构都不同的东西，咱们能够根据其元信息meta检索它们。OSS具备如下特色：

• 效率更高。不受复杂目录系统对性能的影响。
• 可扩展性更强。分布式架构，更便于进行水平扩展，从而容纳进任意大规模的数据。
• 可用性更强。数据通常都会有多个位于不一样机器的复制，确保数据不丢失。
• 平台无关，能够经过Restful接口进行操做对象。

OSS一般被用来存储图片、音视频等文件，以及对这些文件的处理。

3. 哪些OSS可使用

一般咱们有两种选择，花钱买或者本身搞。

充钱才能变得更强

这句话这里也是很实用的，目前几乎全部的云厂商都有本身的对象存储产品，你能够对比一下花钱购买它们，经过配合CDN能达到很是好的用户体验，胖哥的felord.cn就使用了云厂商的对象存储。购买他们的服务

• 可靠性强，数据丢失可能性低。
• 免维护，不须要自行维护。
• 可配合其它一些特点功能，好比缩略图、CDN等等。

本身动手丰衣足食

不想花钱就只能本身动手了，目前我知道的开源方案有两种。

一种是Ceph,一个分布式存储系统，高可用，高扩展性。可是通常人玩不转，就连开源中国的红薯都被坑惨了😆。

另外一种是Minio，用Golang写的。我目前还没发现有什么坑，文档竟然还有中文文档！我用Docker不到三分钟就玩起来了，竟然还自带控制台！其它功能也挺齐全，各类客户端SDK齐全。

由于安装过于简单就不演示了。

4. 整合到Spring Boot

不管你花钱仍是本身搞均可以，这两种方式各有各的好处。因此我要把这两种方式整合到kono Spring Boot脚手架项目中。这种组件封装成为Spring Boot Starter再好不过了。在平常开发中这种基础组件都建议作成Starter。参考个人 最强自定义Spring Boot Starter教程里的方式，我将aliyun的OSS SDK和Minio SDK封装成Starter了。

达到了开箱即用。并且很是灵活，你配置哪一种使用哪一种，能够二选一，也能够全都要，还能够全都不要。

项目地址: https://gitee.com/felord/oss-...。

获取到项目后经过Maven命令mvn install安装到本地依赖库，或者你发布到你的远程私有Maven仓库。而后再引用Starter，切记前后步骤：

<!--  必定要先拉取项目经过 mvn install 安装到本地  -->
<dependency>
    <groupId>cn.felord</groupId>
    <artifactId>oss-spring-boot-starter</artifactId>
    <version>1.0.0.RELEASE</version>
</dependency>

Minio配置流程

接着就是使用了，先在你Minio的控制台上建立一个bucket,能够理解为一个对象池。

而后把策略设置为可读写。

搞完开始在项目中配置，application.yaml中:

oss:
  minio:
  # 启用 
    active: true  
    access-key: minio_access_key
    secret-key: felord_cn_sec_key
  # minio 地址  
    endpoint: http://localhost:9000

aliyun OSS 配置流程

额外引入依赖：

<dependency>
    <groupId>com.aliyun.oss</groupId>
    <artifactId>aliyun-sdk-oss</artifactId>
    <version>2.5.0</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>4.3.8</version>
</dependency>

这是必须的步骤。

去ali OSS控制台申请跟Minio差很少的几样东西用来配置：

oss:
  aliyun:
    active: true
    access-key-id: LTAI4GH4EQXtKEbJDrADvWNH
    access-key-secret: XjDpNn5JqHAHPDXGL6xIebyUkyFAZ7
    endpoint: oss-cn-beijing.aliyuncs.com

Starter的使用

如下是我对OSS操做的抽象接口：

package cn.felord.oss;

import java.io.InputStream;

/**
 * The interface Storage.
 *
 * @author felord.cn
 * @since 2020 /8/24 19:54
 */
public interface Storage {


    /**
     * 存放对象
     *
     * @param bucketName   bucket  名称
     * @param objectName  自定义对象名称
     * @param inputStream  对象的输入流
     * @param contentType  参考http 的 MimeType 值
     * @throws Exception the exception
     */
    void putObject(String bucketName, String objectName, InputStream inputStream, String contentType) throws Exception;

    /**
     *  获取对象
     *
     * @param bucketName the bucket name
     * @param objectName the object name
     * @return the object
     */
    InputStream getObject(String bucketName, String objectName) throws Exception;

    /**
     *  获取对象的URL
     *
     * @param bucketName the bucket name
     * @param objectName the object name
     * @return the object url
     */
    String getObjectUrl(String bucketName, String objectName) throws Exception;

    /**
     *  删除对象
     *
     * @param bucketName the bucket name
     * @param objectName the object name
     */
    void removeObject(String bucketName, String objectName) throws Exception;

}

而后分别使用了以上两种OSS进行了实现。

并分别以aliyunStorage、minioStorage为名称将AliyunStorage和MinioStorage注入Spring IoC。

使用起来很是简单：

@Autowired
@Qualifier("minioStorage")
Storage storage;

@Test
public void testOss() throws Exception {
    File file = new File("./456.jpg");

    InputStream inputStream = new FileInputStream(file);

    storage.putObject("img","pic_122",inputStream, MimeTypeUtils.IMAGE_JPEG_VALUE);
}

5. 总结

今天的整合与往常不太同样，主要是一些通用功能的组件化封装的实际演示，另外简单描述了对象存储的功能和使用场景，但愿对你有用。多多关注：码农小胖哥,跟我一块儿整合脚手架。

关注公众号：Felordcn 获取更多资讯

我的博客：https://felord.cn