Spring Boot结合MinIO实现文件上传下载

在现代微服务架构中，对象存储服务是管理分布式系统中的文件和媒体资产的流行选择。MinIO是一个高性能的分布式对象存储服务，它与Amazon S3 API兼容，支持存储无限量的数据。在这篇博客文章里，我们将详细讨论如何在Spring Boot应用中使用MinIO进行文件上传和下载。

📍什么是MinIO?

MinIO是一个开源对象存储服务器，具有Amazon S3兼容的API。它可以部署在云服务或本地服务器中，用于存储大量非结构化数据。

📍Spring Boot集成MinIO使用

要在Spring Boot项目中集成MinIO，首先需要添加相关的依赖。在项目的pom.xml文件中添加以下依赖：

<dependencies>
    <dependency>
        <groupId>io.minio</groupId>
        <artifactId>minio</artifactId>
        <version>8.0.3</version>
    </dependency>
    ...
</dependencies>

之后，我们需要在application.properties或application.yml中配置MinIO的参数：

minio.url=http://127.0.0.1:9000
minio.access.name=[YourAccessKey]
minio.access.secret=[YourSecretKey]
minio.bucket.name=[YourBucketName]

文件上传
创建一个用于文件上传的Controller：

@RestController
@RequestMapping("/files")
public class FileController {

    @Autowired
    private MinioClient minioClient;

    @PostMapping("/upload")
    public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
        String bucketName = "YOUR_BUCKET_NAME";
        try {
            // 检查存储桶是否存在
            boolean isExist = minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build());
            if(!isExist) {
                minioClient.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build());
            }
            
            // 上传文件
            minioClient.putObject(
                PutObjectArgs.builder().bucket(bucketName).object(file.getOriginalFilename()).stream(
                    file.getInputStream(), file.getSize(), -1)
                    .contentType(file.getContentType())
                    .build());
            return new ResponseEntity<>("File uploaded successfully", HttpStatus.OK);
        } catch (Exception e) {
            return new ResponseEntity<>(e.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }
}

文件下载
同样地，我们创建一个用于文件下载的Controller方法：

@GetMapping("/download/{fileName}")
public ResponseEntity<InputStreamResource> downloadFile(@PathVariable String fileName) {
    String bucketName = "YOUR_BUCKET_NAME";
    try {
        // 获取文件
        InputStream file = minioClient.getObject(GetObjectArgs.builder().bucket(bucketName).object(fileName).build());
        InputStreamResource resource = new InputStreamResource(file);

        // 获取文件的内容类型
        String contentType = minioClient.statObject(StatObjectArgs.builder().bucket(bucketName).object(fileName).build()).contentType();

        return ResponseEntity.ok()
            .contentType(MediaType.parseMediaType(contentType))
            .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + fileName + "\"")
            .body(resource);
    } catch (Exception e) {
        return ResponseEntity.status(HttpStatus.EXPECTATION_FAILED).body(null);
    }
}

📍结语

通过这篇博客，你应该能够理解如何在Spring Boot应用中利用MinIO来实现文件的上传和下载功能。MinIO以其简单的搭建过程，以及对Amazon S3 API的兼容性，让它成为业界广泛使用的对象存储解决方案。正因为如此，它可以轻松地与Spring Boot等现代应用框架集成，实现高效的文件管理系统。
本文提供的代码只是实现文件上传下载的起点。在生产环境中，你可能还需要考虑错误处理、文件加密、访问策略等高级特性。MinIO和Spring Boot强大的扩展性将使你能够满足各种严苛的业务需求。