springboot使用minio

### 如何在 Spring Boot 中集成和使用 MinIO 进行对象存储

#### 添加依赖项
为了使应用程序能够连接到 MinIO 并执行操作，需向 `pom.xml` 文件中添加必要的依赖项。对于 Spring Boot 应用来说，推荐的方式是通过引入特定的 Starter 来简化配置过程。

<dependency>
    <groupId>com.github.xiaocydx</groupId>
    <artifactId>spring-boot-starter-minio</artifactId>
    <version>${latest.version}</version>
</dependency>

此段代码展示了如何利用 Maven 的方式来增加对 MinIO 支持所需的库文件[^2]。

#### 初始化 MinIO 客户端实例
完成上述依赖设置之后，在 Java 类里初始化 MinIO Client 对象以便后续调用其 API 方法：

import io.minio.MinioClient;
// ...
@Bean
public MinioClient minioClient() {
    return MinioClient.builder()
            .endpoint("http://localhost:9000") // 替换成实际的服务地址
            .credentials("minioadmin", "minioadmin") // 使用环境变量或更安全的方法管理凭证
            .build();
}

这段代码片段说明了怎样构建一个用于访问 MinIO 服务器的客户端实例[^1]。

#### 实现上传功能
下面给出了一种简单的文件上传方法作为例子，该函数接收输入流形式的数据并将其保存至指定桶内：

public void uploadFile(String bucketName, String objectName, InputStream inputStream) throws Exception{
    boolean isExist = minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build());
    if (!isExist){
        minioClient.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build());
    }
    
    PutObjectArgs args = PutObjectArgs.builder()
                .bucket(bucketName)
                .object(objectName)
                .stream(inputStream, -1, 10485760)// 设置分片大小，默认为5MB
                .contentType("application/octet-stream")
                .build();

    minioClient.putObject(args);
}

这里定义了一个名为 `uploadFile()` 的方法，它负责检查目标桶是否存在以及创建新桶（如果不存在），最后把接收到的内容存入相应的路径下[^3]。

#### Docker部署MinIO服务
除了编写业务逻辑外，还需要确保有一个可用的 MinIO 服务正在运行。一种常见的做法就是借助 Docker 快速搭建测试环境。具体命令如下所示：

docker run -d \
  --name master-minio \
  -p 8341:8341 \
  -p 9000:9000 \
  -p 9001:9001 \
  -e TZ=Asia/Shanghai \
  -e MINIO_ROOT_USER=masterminio \
  -e MINIO_ROOT_PASSWORD=masterminio \
  -v /path/to/data:/data \
  quay.io/minio/minio server /data --console-address ":8341"

这条指令会启动一个新的容器，并映射好对应的端口与本地目录，方便日后管理和维护[^4]。