SpringBoot 整合 Minio

MinIO

官网：https://min.io

MinIO 是一个基于 Go 实现的高性能、兼容 S3 协议的对象存储。它采用 GNU AGPL v3 开源协议，项目地址是 https://Github.com/minio/minio 。

它适合存储海量的非结构化的数据，例如说图片、音频、视频等常见文件，备份数据、容器、虚拟机镜像等等，小到 1 KB，大到 5 TB 都可以支持。

SpringBoot 整合 Minio

添加依赖

<properties>
    <JAVA.version>1.8</java.version>
    <minio.version>8.4.3</minio.version>
</properties>

<dependencies>
    <dependency>
        <groupId>io.minio</groupId>
        <artifactId>minio</artifactId>
        <version>${minio.version}</version>
    </dependency>
</dependencies>

Minio 配置类

import io.minio.MinioClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MinioConfig {

    @Value("${minio.url}")
    private String url;

    @Value("${minio.access-key}")
    private String accessKey;

    @Value("${minio.secret-key}")
    private String secretKey;

    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder().endpoint(url).credentials(accessKey, secretKey).build();
    }
}

Application.yml 配置文件

minio:
  url: http://127.0.0.1:9000
  accessKey: 45wsHpkAIWfhghSs11X
  secretKey: D9fghfg6sahgufghfgdOYrwqHqocfgh2njhfgh

MinioTemplate.java 封装方法

封装常用的上传（多文件上传、单文件上传）、获取链接、删除、下载方法，方便使用。

import com.ufan.mall.model.FileVo;
import io.minio.*;
import io.minio.http.Method;
import lombok.SneakyThrows;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.multipart.MultipartFile;

import java.time.LocalDate;
import java.time.format.DateTimeFormatter;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.TimeUnit;

/**
 * @ClassName：MinioTemplate.java
 * @Description：MinioTemplate
 * @Author：tanyp
 * @Date：2023/07/27 15:49
 **/
@Slf4j
@Component
public class MinioTemplate {

    @Autowired
    private MinioClient client;

    /**
     * @MonthName：upload
     * @Description： 上传文件
     * @Author：tanyp
     * @Date：2023/07/27 15:52
     * @Param： [file, bucketName]
     * @return：void
     **/
    public FileVo upload(MultipartFile file, String bucketName) {
        try {
            createBucket(bucketName);

            String oldName = file.getOriginalFilename();
            String fileName = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyyMMdd")) + UuidUtil.getRandomPwd(15) + oldName.substring(oldName.lastIndexOf("."));

            client.putObject(
                    PutObjectArgs.builder()
                            .bucket(bucketName)
                            .object(fileName)
                            .stream(file.getInputStream(), file.getSize(), 0)
                            .contentType(file.getContentType()).build()
            );

            String url = this.getObjUrl(bucketName, fileName);
            return FileVo.builder()
                    .oldFileName(oldName)
                    .newFileName(fileName)
                    .fileUrl(url.substring(0, url.indexOf("?")))
                    .build();
        } catch (Exception e) {
            log.error("上传文件出错:{}", e);
            return null;
        }
    }

    /**
     * @MonthName：uploads
     * @Description： 上传多个文件
     * @Author：tanyp
     * @Date：2023/07/27 15:52
     * @Param： [file, bucketName]
     * @return：void
     **/
    public List<FileVo> uploads(List<MultipartFile> files, String bucketName) {
        try {
            List<FileVo> list = new ArrayList<>();
            createBucket(bucketName);

            for (MultipartFile file : files) {
                String oldName = file.getOriginalFilename();
                String fileName = LocalDate.now().format(DateTimeFormatter.ofPattern("yyyyMMdd")) + UuidUtil.getRandomPwd(15) + oldName.substring(oldName.lastIndexOf("."));

                client.putObject(
                        PutObjectArgs.builder()
                                .bucket(bucketName)
                                .object(fileName)
                                .stream(file.getInputStream(), file.getSize(), 0)
                                .contentType(file.getContentType()).build()
                );

                String url = this.getObjUrl(bucketName, fileName);
                list.add(
                        FileVo.builder()
                                .oldFileName(oldName)
                                .newFileName(fileName)
                                .fileUrl(url.substring(0, url.indexOf("?")))
                                .build()
                );
            }
            return list;
        } catch (Exception e) {
            log.error("上传文件出错:{}", e);
            return null;
        }
    }

    /**
     * @MonthName：download
     * @Description： 下载文件
     * @Author：tanyp
     * @Date：2023/07/27 15:54
     * @Param： [bucketName, fileName]
     * @return：void
     **/
    public void download(String bucketName, String fileName) throws Exception {
        client.downloadObject(DownloadObjectArgs.builder().bucket(bucketName).filename(fileName).build());
    }

    /**
     * @MonthName：getObjUrl
     * @Description： 获取文件链接
     * @Author：tanyp
     * @Date：2023/07/27 15:55
     * @Param： [bucketName, fileName]
     * @return：java.lang.String
     **/
    public String getObjUrl(String bucketName, String fileName) throws Exception {
        return client.getPresignedObjectUrl(
                GetPresignedObjectUrlArgs.builder()
                        .bucket(bucketName)
                        .object(fileName)
                        .method(Method.GET)
                        .expiry(30, TimeUnit.SECONDS)
                        .build()
        );
    }

    /**
     * @MonthName：delete
     * @Description： 删除文件
     * @Author：tanyp
     * @Date：2023/5/26 15:56
     * @Param： [bucketName, fileName]
     * @return：void
     **/
    public void delete(String bucketName, String fileName) throws Exception {
        client.removeObject(RemoveObjectArgs.builder().bucket(bucketName).object(fileName).build());
    }

    @SneakyThrows
    public void createBucket(String bucketName) {
        if (!client.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build())) {
            client.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build());
            String sb = "{"Version": "2012-10-17","Statement": [{"Effect": "Allow","Principal": {"AWS": ["*"]},"Action": ["s3:GetBucketLocation"],"Resource": ["arn:aws:s3:::" + bucketName + ""]},{"Effect": "Allow","Principal": {"AWS": ["*"]},"Action": ["s3:ListBucket"],"Resource": ["arn:aws:s3:::" + bucketName + ""],"Condition": {"StringEquals": {"s3:prefix": ["*"]}}},{"Effect": "Allow","Principal": {"AWS": ["*"]},"Action": ["s3:GetObject"],"Resource": ["arn:aws:s3:::" + bucketName + "/**"]}]}";
            client.setBucketPolicy(SetBucketPolicyArgs.builder().bucket(bucketName).config(sb).build());
        }
    }

}

FileVo.java 实体类

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@Builder
@AllArgsConstructor
@NoArgsConstructor
public class FileVo {

    /**
     * 原文件名
     */
    private String oldFileName;

    /**
     * 新文件名
     */
    private String newFileName;

    /**
     * 文件路径
     */
    private String fileUrl;

}

动态创建 Bucket

如何设置桶的权限？

在MinIO中，可以通过设置桶策略来控制桶的访问权限。桶策略是一个JSON格式的文本文件，用于指定哪些实体（用户、组或IP地址）可以执行哪些操作（读、写、列举等）。

MinIO桶策略的基本结构如下所示：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": ["action1", "action2", ...],
            "Effect": "Allow|Deny",
            "Principal": {"AWS": ["arn:aws:iam::account-id:user/user-name"]},
            "Resource": ["arn:aws:s3:::bucket-name/object-prefix", ...]
        },
        ...
    ]
}

备注：

• • Version：指定策略语法版本（必需）。

• • Statement：指定一个或多个声明，每个声明包含一个或多个条件，用于定义访问规则。

• • Action：指定允许或拒绝的操作列表，如"s3:GetObject"表示允许读取对象。

• • Effect：指定允许或拒绝操作的结果（必需）。

• • Principal：指定允许或拒绝操作的主体，如IAM用户、组或角色。

• • Resource：指定允许或拒绝操作的资源（必需）。