项目支持将文件上传到三类存储器：

1. 兼容 S3 协议的对象存储：支持 MinIO、腾讯云 COS、七牛云 Kodo、华为云 OBS、亚马逊 S3 等等。
2. 磁盘存储：本地、FTP 服务器、SFTP 服务器。
3. 数据库存储：MySQL、Oracle、PostgreSQL、SQL Server 等等。

技术选型？

• 优先，✔ 推荐方案 1。如果无法使用云服务，可以自己搭建一个 MinIO 服务。参见 https://github.com/minio/minio (opens new window)文章。
• 其次，推荐方案 3。数据库的主从机制可以实现高可用，备份也方便，少量小文件问题不大。
• 最后，× 不推荐方案 2。主要是实现高可用比较困难，无法实现故障转移。

1. 快速入门

本小节，我们来添加个文件配置，并使用它上传下载文件

1.1 新增配置

① 打开 [基础设施 -> 文件管理 -> 文件配置] 菜单，进入文件配置的界面。

② 点击 [新增] 按钮，选择存储器为【S3 对象存储器】，并填写阿里云的配置。如下图：

• 节点地址：oss-cn-shenzhen.aliyuncs.com
• 存储 bucket：ximu233
• accessKey：***
• accessSecret：***
• 自定义域名：https://oss.ximu233.com

③ 添加完后，点击该配置所在行的 [测试] 按钮，测试配置是否正确。

④ 测试通过后，点击该配置所在行的 [主配置] 按钮，设置它为默认的配置，后续使用它进行文件的上传。

1.2 上传文件

① 点击 [基础设施 -> 文件管理 -> 文件列表] 菜单，进入文件列表的界面。

② 点击 [上传文件] 按钮，选择要上传的文件。

③ 上传完成后，如果想要删除，可点击该文件所在行的 [删除] 按钮。

2. 文件上传

项目提供了 2 种文件上传的方式，分别适合前端、后端使用。

2.1 方式一：前端上传

FileController (opens new window)提供了 /admin-api/infra/file/upload RESTful API，用于前端直接上传文件。

// FileController.java

@PostMapping("/upload")
@Operation(summary = "上传文件")
@OperateLog(logArgs = false) // 上传文件，没有记录操作日志的必要
public CommonResult<String> uploadFile(FileUploadReqVO uploadReqVO) throws Exception {
    MultipartFile file = uploadReqVO.getFile();
    String path = uploadReqVO.getPath();
    return success(fileService.createFile(file.getOriginalFilename(), path,
        IoUtil.readBytes(file.getInputStream())));
}

前端上传文件的代码如何实现，可见：

• 文件列表，文件上传 ·index.vue·
• 个人中心，头像修改 userAvatar.vue

2.2 方式二：后端上传

blossom-module-infrastructure 的 FileApi (opens new window)提供了 blossomcreateFile(...) 方法，用于后端需要上传文件的逻辑。

// FileApi.java

/**
 * 保存文件，并返回文件的访问路径
 *
 * @param path 文件路径
 * @param content 文件内容
 * @return 文件路径
 */
String createFile(String path, byte[] content);

注意，需要使用到后端上传的 Maven 模块，需要引入 blossom-module-infrastructure-api 依赖。例如说 blossom-module-system-biz 模块的 pom.xml 文件，引用如下：

<dependency>
    <groupId>cn.econets.boot</groupId>
    <artifactId>blossom-module-infrastructure-api</artifactId>
    <version>${revision}</version>
</dependency>

3. 文件客户端

技术组件 blossom-spring-boot-starter-file (opens new window)，定义了 FileClient接口，抽象了文件客户端的方法。

public interface FileClient {

    /**
     * 获得客户端编号
     *
     * @return 客户端编号
     */
    Long getId();

    /**
     * 上传文件
     *
     * @param content 文件流
     * @param path 相对路径
     * @return 完整路径，即 HTTP 访问地址
     */
    String upload(byte[] content, String path);

    /**
     * 删除文件
     *
     * @param path 相对路径
     */
    void delete(String path);

    /**
     * 获得文件的内容
     *
     * @param path 相对路径
     * @return 文件的内容
     */
    byte[] getContent(String path);

}

FileClient 有 5 个实现类，使用不同存储器进行文件的上传与下载。UML 类图如所示：

文件上传的调用的 UML 时序图如下所示：

4. S3 对象存储的配置

做的不错的云存储服务，都是兼容 S3 协议的。如何获取对应的 S3 配置，艿艿整理到了 S3FileClientConfig (opens new window)配置类。

有一点要注意，云存储服务的 Bucket 需要设置为公共读，不然 URL 无法访问到文件。

并且，最好使用自定义域名，方便迁移到不同的云存储服务。