【实战指南】Spring Boot集成Minio：快速实现对象存储服务

在Spring Boot中集成Minio可以让你的应用程序具备对象存储的功能，这非常适合处理大量的非结构化数据。

1. 添加依赖

在你的pom.xml或build.gradle文件中添加Minio的Java SDK依赖。

对于Maven:

<dependency>
    <groupId>io.minio</groupId>

    <artifactId>minio</artifactId>

    <version>8.2.1</version> <!-- 确保使用最新版本 -->
</dependency>

对于Gradle:

implementation 'io.minio:minio:8.2.1'

2. 配置Minio

在application.properties或application.yml中添加Minio的配置信息：

minio.endpoint=http://localhost:9000
minio.access-key=minioadmin
minio.secret-key=minioadmin
minio.bucket-name=mybucket

3. 创建Minio客户端

在你的Spring Boot应用中创建一个Minio客户端的bean。这通常在配置类中完成：

@Configuration
public class MinioConfig {

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

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

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

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

4. 编写上传和下载文件的方法

使用上面创建的MinioClient bean来实现文件上传和下载的方法。例如，上传文件：

@Service
public class FileService {

    @Autowired
    private MinioClient minioClient;

    @Value("${minio.bucket-name}")
    private String bucketName;

    public void uploadFile(MultipartFile file) throws IOException, NoSuchAlgorithmException, InsufficientDataException,
        InvalidBucketNameException, ErrorResponseException, InternalException, InvalidKeyException, InvalidResponseException,
        XmlParserException, ServerException {
        // Check if the bucket exists and create it if not.
        boolean isExist = minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build());
        if (!isExist) {
            minioClient.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build());
        }

        // Upload the file.
        minioClient.putObject(PutObjectArgs.builder()
            .bucket(bucketName)
            .object(file.getOriginalFilename())
            .stream(file.getInputStream(), file.getSize(), -1)
            .contentType(file.getContentType())
            .build());
    }
}

下载文件：

public InputStream downloadFile(String fileName) throws NoSuchAlgorithmException, InsufficientDataException,
    InvalidBucketNameException, ErrorResponseException, InternalException, InvalidKeyException, InvalidResponseException,
    IOException, XmlParserException, ServerException {
    return minioClient.getObject(GetObjectArgs.builder()
        .bucket(bucketName)
        .object(fileName)
        .build());
}

5. 处理异常

确保你有适当的异常处理机制，因为Minio的操作可能会抛出各种异常。

6. 测试

最后，测试你的上传和下载功能，以确保一切按预期工作。

如果你使用的是加密的Minio实例，还需要在配置中添加相应的SSL设置。