JAVA使用 MinIO Java SDK

JAVA使用 MinIO Java SDK

1. 添加依赖

在使用 MinIO Java SDK 之前，你需要在你的java项目中添加对应的依赖。如果你使用的是 Maven，那么可以在 pom.xml 中添加如下依赖：

<dependency>
  <groupId>io.minio</groupId>
  <artifactId>minio</artifactId>
  <version>8.2.2</version>
</dependency>

如果使用的是 Gradle，那么可以在 build.gradle 中添加：

implementation 'io.minio:minio:8.2.2'

2. 在minio中创建accessKey和secretKey

以下方式选择一种创建accessKey和secretKey

方式一：

使用管理员账户 初始管理员 Access Key 和 Secret

方式二：

创建新用户：
在用户管理界面，点击“Create User”按钮。
输入新用户的用户名。
分配权限：
在创建用户时，可以选择为用户分配特定的策略（Policy），例如“只读”或“完全访问”。
创建用户后，点击“Create”保存。

3.创建桶

4.结合springboot实现文件上传

1. 使用 Spring Boot 的 @ConfigurationProperties 注解来自动绑定配置属性到一个 Java 类中
2. 配置yml（注意配置bucketName需要配置与创建得桶名字相同 例如：bucketName: public-test）
3. 注入MinioClient 客户端
4. 实现文件上传

@Component
@ConfigurationProperties(prefix = "minio")
public class MinioPropertiesConfig {

    /** 客户端连接到 MinIO 服务器的 URL */
    private String endpoint;

    /** accessKey */
    private String accessKey;

    /** secretKey */
    private String secretKey;

    /** #存储桶名称 */
    private  String bucketName;

    public String getEndpoint() {
        return endpoint;
    }

    public void setEndpoint(String endpoint) {
        this.endpoint = endpoint;
    }

    public String getAccessKey() {
        return accessKey;
    }

    public void setAccessKey(String accessKey) {
        this.accessKey = accessKey;
    }

    public String getSecretKey() {
        return secretKey;
    }

    public void setSecretKey(String secretKey) {
        this.secretKey = secretKey;
    }

    public String getBucketName() {
        return bucketName;
    }

    public void setBucketName(String bucketName) {
        this.bucketName = bucketName;
    }
}

yml配置

# minio相关配置
minio:
  # minio地址+端口号
  endpoint: http://localhost:9000
  # minio用户名
  accessKey: kFlZJ9ejkyDWOrluvhoj
  # minio密码
  secretKey: KAPLLdt8JcSNidRRWpF989OfBMCcPbrN4MuHMKTt
  # 存储桶名称
  bucketName: public-test

注入MinioClient

@Configuration
public class MinioConfig {

    @Autowired
    private MinioPropertiesConfig minioProperties;


    @Bean
    public MinioClient minioClient(){
        MinioClient minioClient = MinioClient.builder().
                endpoint(minioProperties.getEndpoint()).
                credentials(minioProperties.getAccessKey(), 
                minioProperties.getSecretKey()).
                build();
        return minioClient;
    }

}

controller代码

    @Autowired
    private MinioClient minioClient;

    @Autowired
    private MinioPropertiesConfig minioPropertiesConfig;
    @PostMapping("/test")
    public String test(MultipartFile file) throws ServerException, InsufficientDataException, ErrorResponseException, IOException, NoSuchAlgorithmException, InvalidKeyException, InvalidResponseException, XmlParserException, InternalException {
        Date date = new Date(System.currentTimeMillis());
        SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
        String format = dateFormat.format(date);
        
        String uuid = UUID.randomUUID().toString();

       // 构建文件名，格式为 日期/UUID@原始文件名。
        // 例如：2024-09-01/123e4567-e89b-12d3-a456-426614174000@example.txt。
        String fileName = format+"/"+uuid+"@"+file.getOriginalFilename();

        InputStream inputStream = file.getInputStream();
        minioClient.putObject(
                PutObjectArgs.builder()
                        .bucket(minioPropertiesConfig.getBucketName())
                        .object(fileName)
                        .stream(inputStream, file.getSize(), -1)
                        .contentType(file.getContentType())
                        .build()
        );


        inputStream.close();
        return minioPropertiesConfig.getEndpoint()+"/"+
                minioPropertiesConfig.getBucketName()+"/"+fileName;
    }

付一些常用方法：也可参考官网：https://min.io/docs/minio/linux/developers/java/minio-java.html

判断桶是否存在不存在创建创建桶

// 检查指定的存储桶是否存在于 MinIO 服务器上
boolean b = minioClient.bucketExists(
    BucketExistsArgs.builder()
        .bucket("test")  // 指定存储桶名称
        .build()
);

// 如果存储桶不存在，则创建该存储桶
if (!b) {
    minioClient.makeBucket(
        MakeBucketArgs.builder()
            .bucket("test")  // 指定存储桶名称
            .build()
    );
}

MinIO 客户端上传一个本地文件到 MinIO 服务器

minioClient.uploadObject(
    UploadObjectArgs.builder()
        .bucket("my-bucketname")  // 指定存储桶名称
        .object("my-objectname")  // 指定对象名称
        .filename("C://my-video.avi")  // 指定本地文件路径
        .contentType("video/mp4")  // 指定内容类型
        .build()  // 构建最终的 UploadObjectArgs 对象
);

常见问题

1. tomcat 删除临时文件失败，原因是没有正常关闭流导致