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

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 {@Resourceprivate MinioService minioService;@Testvoid contextLoads(){minioService.testMinIOClient();}@Resourceprivate MinioClient minioClient;@Testpublic 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）