springboot minio上传 下载

Spring Boot与Minio结合可以实现文件的上传和下载。首先，需要在application.yaml中配置文件上传的大小限制和Minio的参数。接下来，引入Minio依赖并编写配置类和工具类。配置类需要注入Minio的参数，并使用@Bean注解将MinioClient实例化。工具类可以通过MinioClient实现文件的上传和下载操作。

相关问题

Springboot minio上传文件夹

Spring Boot 与 MinIO 结合可以方便地处理文件上传，包括整个文件夹。MinIO 是一个开源的对象存储服务器，适合做为云存储解决方案。在 Spring Boot 中，你可以使用第三方库如 `spring-cloud-storage` 或者直接 MinIO 官方提供的 SDK 来实现文件上传。

以下是简单的步骤：

1. **添加依赖**:
- 添加 `spring-cloud-starter-netflix-eureka-client` 如果你在微服务架构中，并且需要与 Eureka 注册中心交互。
- 添加 `spring-cloud-starter-minio` 或者 `minio-java` 作为 MinIO 的客户端支持。

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>
<dependency>
    <groupId>io.minio</groupId>
    <artifactId>minio</artifactId>
</dependency>

2. **配置 MinIO**:
- 配置 application.properties 或者 application.yml 文件，提供 MinIO 的 endpoint、access key 和 secret key 等信息。

spring:
  cloud:
    minio:
      endpoint: http://your-minio-server:9000
      accessKey: YOUR_ACCESS_KEY
      secretKey: YOUR_SECRET_KEY

3. **创建上传服务**:
- 使用 `@Service` 或 `@RestController` 创建一个上传方法，接受文件或文件夹路径，然后通过 MinIO SDK 将其上传到指定的 bucket（存储桶）。

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.multipart.MultipartFile;

@Service
public class FileUploader {
    private final MinioClient minioClient;

    public FileUploader(MinioClient minioClient) {
        this.minioClient = minioClient;
    }

    @PostMapping("/upload-folder")
    public void uploadFolder(@RequestParam("folderPath") String folderPath, MultipartFile[] files) {
        for (MultipartFile file : files) {
            if (file.getSize() > 0) {
                try {
                    minioClient.putObject(bucketName, file.getOriginalFilename(), file.getInputStream());
                } catch (Exception e) {
                    // handle exceptions
                }
            }
        }
    }
}

4. **处理文件夹上传**:
- 如果你想上传整个文件夹，你需要遍历目录，将每个子文件作为单独的请求上传。这通常不在 Web 层面上处理，更适合在批处理任务中。

springboot minio头像

### 用户头像上传与管理

在Spring Boot项目中集成MinIO服务用于用户头像的上传和管理是一项常见的需求。这不仅能够有效利用分布式对象存储的优势，还能简化应用程序的数据持久化逻辑。

#### 创建MinIO配置类

为了更好地管理和初始化`MinIOClient`实例，在应用启动时应创建一个专门的配置类[^2]：

import io.minio.MinioClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MinioConfig {

    @Bean
    public MinioClient minioClient() {
        return MinioClient.builder()
                .endpoint("http://localhost:9000") // 替换成实际地址
                .credentials("accessKey", "secretKey")
                .build();
    }
}

此配置允许后续组件轻松获取已配置好的`MinIOClient`实例，从而执行各种文件操作。

#### 封装头像处理业务逻辑

针对具体的业务场景——即用户的头像上传，建议开发相应的Service层来封装这些功能。下面是一个简单的例子展示如何接收前端发送来的图片并保存至MinIO服务器上[^4]：

@Service
public class AvatarService {

    private final MinioClient minioClient;

    @Autowired
    public AvatarService(MinioClient minioClient) {
        this.minioClient = minioClient;
    }

    /**
     * 处理用户上传的新头像
     */
    public String uploadAvatar(MultipartFile file, Long userId) throws Exception {
        try {
            // 构建唯一的文件名以防止重复覆盖
            String fileName = UUID.randomUUID().toString() + "_" + userId.toString();

            // 设置元数据以便于浏览器识别图像类型
            Map<String, String> metadata = new HashMap<>();
            metadata.put("Content-Type", file.getContentType());

            // 执行上传动作
            minioClient.putObject(
                    PutObjectArgs.builder()
                            .bucket("avatars") // 存储桶名称
                            .object(fileName)
                            .stream(file.getInputStream(), file.getSize(), ObjectWriteArgs.MIN_MULTIPART_SIZE)
                            .contentType(file.getContentType())
                            .metadata(metadata)
                            .build());
            
            return fileName; // 返回唯一标识符供后续查询或删除使用
            
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
    
    /**
     * 获取指定ID对应的用户头像URL链接
     */
    public URL getAvatarUrl(String avatarName) throws Exception{
        return minioClient.getObjectUrl("avatars", avatarName);  
    }
}

上述代码片段展示了两个核心方法：一个是负责接受来自HTTP请求中的多媒体附件(`MultipartFile`)参数，并将其转换成适合MinIO API的形式；另一个则是提供给外部调用者用来检索特定用户头像访问路径的方法。

#### 控制器接口定义

最后一步是在控制器(Controller)级别暴露RESTful风格API端点，使得前端Vue.js或其他框架可以直接发起AJAX请求完成整个流程:

@RestController
@RequestMapping("/api/avatars")
public class AvatarController {

    private final AvatarService avatarService;

    @PostMapping("/upload/{userId}")
    public ResponseEntity<?> handleUpload(@RequestParam MultipartFile file,
                                          @PathVariable Long userId){
        
        try {
            String savedFileName = avatarService.uploadAvatar(file, userId);

            URI location = ServletUriComponentsBuilder.fromCurrentContextPath()
                        .path("/{id}/view")
                        .buildAndExpand(savedFileName).toUri();

            return ResponseEntity.created(location).body(null);
                        
        }catch(Exception ex){
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(ex.getMessage());
        }
    }

    @GetMapping("/{fileName}/view")
    public ResponseEntity<byte[]> viewImage(@PathVariable String fileName)throws IOException{
        byte[] imageBytes=avatarService.getImageData(fileName);
        HttpHeaders headers=new HttpHeaders();
        headers.setContentType(MediaType.IMAGE_JPEG);
        return new ResponseEntity<>(imageBytes,headers,HttpStatus.OK);
    }
}

这段程序提供了两条主要路由：“POST /api/avatars/upload/:userId”用于提交新照片，“GET /api/avatars/:filename/view”则服务于显示现有记录的功能。