minio的一个基础使用案例：用户头像上传

一、minio下载安装（Windows）

1. 下载minio服务端和客户端

minio下载地址

2. 手动搭建目录

/minio/binmc.exeminio.exe/data/logs

• 手动创建minio应用程序目录，如：E:\minio\bin
• 手动创建minio数据目录，如：E:\minio\data
• 手动创建minio日志目录，如：E:\minio\logs
• 然后将下载的mc.exe文件和minio.exe文件放入E:\minio\bin目录下

3. 启动

• 在bin目录下打开cmd

到bin目录下后，在地址栏输入cmd，然后回车

• 设置用户名

setx MINIO_ROOT_USER minioadmin

• 设置用户密码

setx MINIO_ROOT_PASSWORD minioadmin

• 启动minio服务

E:\minio\bin\minio.exe server E:\minio\data --console-address ":9001" --address ":9000" > E:\minio\logs\minio.log

4. 访问minio控制台

• 在浏览器输入服务器Ip + 9001端口号打开登录页面，然后使用前面步骤中设置的用户名和密码登录控制台

• 建立一个新的bucket
  

• 修改桶的访问权限为public
  

二、案例需求分析

• 例如在添加用户和修改用户的时候，此时可以在表单页面点击"+"号，然后选择要上传的用户图像。
  

• 选择完毕以后，那么此时就会请求后端上传文件接口，将图片的二进制数据传递到后端

• 后端需要将数据图片存储起来，然后给前端返回图片的访问地址，然后前端需要将图片的访问地址设置给sysUser用户数据模型

• 当用户点击提交按钮的时候，那么此时就会将表单进行提交，后端将数据保存起来即可

三、后端接口开发

基本目录结构

/java
----/controller
--------FileUploadController.java
----/properties
--------MinioProperties.java
----/service
--------/impl
------------FileUploadServiceImpl.java
--------FileUploadService.java
----ManagerApplication.java
/resources
----application-dev.yml

• 在application-dev.yml中添加minio相关配置

# 自定义配置
project:minio:endpointUrl: http://127.0.0.1:9000accessKey: minioadminsecureKey: minioadminbucketName: b2c-e-commerce

• 新建MinioProperties.java，minio所需参数实体类

@Data
@ConfigurationProperties(prefix = "project.minio")
public class MinioProperties {private String endpointUrl;private String accessKey;private String secureKey;private String bucketName;
}

• 修改启动类ManagerApplication，添加@EnableConfigurationProperties注解，激活配置属性绑定功能

@EnableConfigurationProperties(value = { MinioProperties.class})

• service层接口及实现类

基本思路：

1. 在fileUpload方法中，首先根据minioProperties创建一个MinioClient实例，用于与MinIO服务器交互。

2. 检查指定的桶（bucket）是否存在。如果不存在，则通过makeBucket方法创建一个新的桶。

3. 生成存储对象的名称：结合当前日期（格式为"yyyyMMdd"）和一个随机UUID作为前缀，再加上原始文件名，确保文件名的唯一性。

4. 使用PutObjectArgs构建上传对象的参数，包括桶名、文件输入流（从MultipartFile获取）、文件大小和对象名称（即文件路径）。

5. 调用minioClient.putObject执行文件上传操作。
   最后，返回文件在MinIO服务器上的访问URL，以便用户可以访问上传的文件。

FileUploadService.java

public interface FileUploadService {String fileUpload(MultipartFile multipartFile);
}

FileUploadServiceImpl.java

@Service
public class FileUploadServiceImpl implements FileUploadService {@Autowiredprivate MinioProperties minioProperties ;@Overridepublic String fileUpload(MultipartFile multipartFile) {try {// 创建一个Minio的客户端对象MinioClient minioClient = MinioClient.builder().endpoint(minioProperties.getEndpointUrl()).credentials(minioProperties.getAccessKey(), minioProperties.getSecureKey()).build();// 判断桶是否存在boolean found = minioClient.bucketExists(BucketExistsArgs.builder().bucket(minioProperties.getBucketName()).build());if (!found) {       // 如果不存在，那么此时就创建一个新的桶minioClient.makeBucket(MakeBucketArgs.builder().bucket(minioProperties.getBucketName()).build());} else {  // 如果存在打印信息System.out.println("Bucket 'b2c-e-commerce' already exists.");}// 设置存储对象名称String dateDir = DateUtil.format(new Date(), "yyyyMMdd");String uuid = UUID.randomUUID().toString().replace("-", "");//20230801/443e1e772bef482c95be28704bec58a901.jpgString fileName = dateDir+"/"+uuid+multipartFile.getOriginalFilename();System.out.println(fileName);PutObjectArgs putObjectArgs = PutObjectArgs.builder().bucket(minioProperties.getBucketName()).stream(multipartFile.getInputStream(), multipartFile.getSize(), -1).object(fileName).build();minioClient.putObject(putObjectArgs) ;return minioProperties.getEndpointUrl() + "/" + minioProperties.getBucketName() + "/" + fileName ;} catch (Exception e) {throw new RuntimeException(e);}}
}

• controller层

@RestController
@RequestMapping("/admin/system")
public class FileUploadController {@Autowiredprivate FileUploadService fileUploadService ;@PostMapping(value = "/fileUpload")public Result<String> fileUploadService(@RequestParam(value = "file") MultipartFile multipartFile) {String fileUrl = fileUploadService.fileUpload(multipartFile) ;return Result.build(fileUrl , ResultCodeEnum.SUCCESS) ;}}