[7-01-03].SpringBoot3集成MinIo

news2025/4/22 14:48:37

MinIO学习大纲

一、Spingboot整合MinIo

第1步：搭建SpringBoot项目：

在这里插入图片描述

第2步：引入minio依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.jianqun</groupId>
    <artifactId>jianqun-SpringBoot-All</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>


    <parent>
        <artifactId>spring-boot-starter-parent</artifactId>
        <groupId>org.springframework.boot</groupId>
        <version>3.2.4</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
        <dependency>
            <groupId>io.minio</groupId>
            <artifactId>minio</artifactId>
            <version>8.5.9</version>
        </dependency>
    </dependencies>

</project>

第3步：创建MinIoClient客户端：

1.连接minio服务器,创建客户端连接
2.在service层注入MinIo组件：

第4步：编写单元测试：

注入minio客户端组件，进行单元测试

二、SpringBoot集成MinIO开发MinioClient线程安全问题

不存在线程安全问题

三、MinIO中的Bucket和Object解读

Bucket 是存储Object的逻辑空间，每个Bucket之间的数据是相互隔离的，对用户而言，相当于存放文件的顶层文件夹；
Object 是存储到MinIO的基本对象，对用户而言，相当于文件；

四、SpringBoot集成MinIO - Bucket操作:

4.1.API介绍：

bucketExists() : 用于检查指定的存储桶是否存在，返回布尔值，表示存储桶是否存在
makeBucket() : 用于创建一个新的存储桶（bucket），需要指定存储桶的名称
listBuckets(): 用于列出用户有权访问的所有存储桶，返回存储桶的列表
removeBucket() : 用于删除一个已存在的存储桶（bucket），删除失败会抛出异常

4.2.使用bucketExists() 案例：

a.编码实现：

package com.jianqun;


import com.jianqun.service.MinioService;
import io.minio.BucketExistsArgs;
import io.minio.MinioClient;
import io.minio.errors.*;
import jakarta.annotation.Resource;
import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

import java.io.IOException;
import java.security.InvalidKeyException;
import java.security.NoSuchAlgorithmException;

@SpringBootTest
public class TestMinio {
    @Resource
    private MinioService minioService;

    @Test
    void contextLoads(){
        minioService.testMinIOClient();
    }


    @Resource
    private MinioClient minioClient;

    @Test
    public void testApi() throws Exception{
        // boolean isBucketExists = minioClient.bucketExists(BucketExistsArgs.builder().bucket("myFile").build()); //桶的名称有错误，不符合命名规则
        boolean isBucketExists = minioClient.bucketExists(BucketExistsArgs.builder().bucket("myfile").build());
        System.out.println("myfile目录是否存在" + isBucketExists);
    }
}

b.踩坑说明：

1.在我的测试方法中，我的桶名称一开始是myFile,执行测试方法的时候报错了
2.报错内容如下，其原因是桶名称不符合存Amazon S3 的命名规范
3.Amazon S3 对存储桶名称有一些严格的命名规则，以下是这些规则的简要说明：
- 长度限制：存储桶名称的长度必须在 3 到 63 个字符之间
- 字符限制：存储桶名称只能包含小写字母、数字、点（.）和连字符（-）
- 起始和结束字符：存储桶名称必须以字母或数字开头和结尾
- 点号限制：存储桶名称中的点号不能连续出现（例如 …），也不能直接与连字符相邻（例如 .- 或 -.）
- IP 地址格式：存储桶名称不能格式化为 IP 地址（例如 192.168.1.1）