文章目录
- 一、minio下载安装（Windows）
- 二、案例需求分析
- 三、后端接口开发
一、minio下载安装（Windows）
1. 下载minio服务端和客户端
minio下载地址
2. 手动搭建目录
/minio
/bin
mc.exe
minio.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:9000
accessKey: minioadmin
secureKey: minioadmin
bucketName: 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层接口及实现类
基本思路：
-
在fileUpload方法中，首先根据
minioProperties创建一个MinioClient实例，用于与MinIO服务器交互。 -
检查指定的桶（bucket）是否存在。如果不存在，则通过makeBucket方法创建一个新的桶。
-
生成存储对象的名称：结合当前日期（格式为"yyyyMMdd"）和一个随机UUID作为前缀，再加上原始文件名，确保文件名的唯一性。
-
使用PutObjectArgs构建上传对象的参数，包括桶名、文件输入流（从MultipartFile获取）、文件大小和对象名称（即文件路径）。
-
调用
minioClient.putObject执行文件上传操作。
最后，返回文件在MinIO服务器上的访问URL，以便用户可以访问上传的文件。
FileUploadService.java
public interface FileUploadService {
String fileUpload(MultipartFile multipartFile);
}
FileUploadServiceImpl.java
@Service
public class FileUploadServiceImpl implements FileUploadService {
@Autowired
private MinioProperties minioProperties ;
@Override
public 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.jpg
String 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 {
@Autowired
private 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) ;
}
}
