SpringBoot集成Minio实战详解
Minio简介
介绍高性能分布式存储文件服务Minio：Minio是基于Go语言编写的对象存储服务，适合于存储大容量非结构化的数据，例如图片、音频、视频、日志文件、备份数据和容器/虚拟机镜像等，而一个对象文件可以是任意大小，从几kb到最大5T不等。区别于分布式存储系统，minio的特色在于简单、轻量级，对开发者友好！！！，认为存储应该是一个开发问题而不是一个运维问题。
1.安装minio
可以到官网去下载
链接: https://www.minio.org.cn/download.shtml
本文采用的是使用主流的安装方式：docker安装(docker的教程大家可以访问b站的教程进行学习，本文不作重点讲解)
链接: https://blog.csdn.net/ouyang_zhen/article/details/118961684
linux系统中敲入如下命令
docker search minio
docker pull minio/minio
docker run -d -p 9000:9000 --name=minio --restart=always -e "MINIO_ROOT_USER=admin" -e "MINIO_ROOT_PASSWORD=admin123456" -v /home/data:/data -v /home/config:/root/.minio minio/minio server /data --console-address ":9000" --address ":9090"
docker logs -f containerid
或者使用docker-compose启动
通过配置docker-compose.yml文件管理容器，通过docker-compose up -d 启动容器
docker-compose.yml文件
这里的9100是配置访问minio自带的web管理后台，9090是配置的服务器
version: "3.1"
services:
minio:
image: minio/minio:latest
container_name: minio
ports:
- "9100:9000"
- "9090:9090"
volumes:
- "./data:/data"
environment:
MINIO_ACCESS_KEY: "root"
MINIO_SECRET_KEY: "12345678"
command: server /data --console-address=":9000" --address=":9090"
logging:
driver: "json-file"
options:
max-size: "1m"
当出现如下图所示即代码运行成功，通过宿主机ip:9000访问，输入命令里的账号/密码登录即可：
启动成功后访问 ip+9000(你运行的端口号) 如下图所示例，输入你在命令行里的用户名和我密码
2.minio Ui界面的简单使用
3.minio结合springboot
项目目录结构：
修改配置文件
1，yml文件配置
2，minio配置类并注入容器进行管理
3，封装minio操作服务器的API的工具类，项目中封装了单文件上传、下载、删除、查看功能，桶的创建等
公司具体的存储业务，在次基础上根据公司业务来自行扩展
4，编写controller层，用postman进行简单的测试（测试类型：文本、文档、表格、音频、视频、图片）
yml配置：
spring:
# 配置文件上传大小限制
servlet:
multipart:
max-file-size: 200MB
max-request-size: 200MB
minio:
server: http://120.76.159.196
port: 9090
accessKey: root
secretKey: 12345678
bucket: test
urlprefix: /minio/
配置类：
/**
* @Author xiaozq
* @Date 2022/11/17 9:54
* <p>@Description: 注意：这里不能用@Data,需手动写gitter，setter
* reason：与@ConfigurationProperties一起用的时候，配置文件的值不能赋值给对应类属性，属性值均为null</p>
*/
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinioConfig {
private String server;
private int port;
private String accessKey;
private String secretKey;
// 桶名
private String bucket;
// 统一前缀
private String urlPrefix;
/**
* 创建minio连接对象
* @return
*/
@Bean
public MinioClient minioClient(){
return MinioClient.builder()
.endpoint(server,port,false)
.credentials(accessKey,secretKey)
.build();
}
public void setServer(String server) {
this.server = server;
}
public void setPort(int port) {
this.port = port;
}
public void setAccessKey(String accessKey) {
this.accessKey = accessKey;
}
public void setSecretKey(String secretKey) {
this.secretKey = secretKey;
}
public void setBucket(String bucket) {
this.bucket = bucket;
}
public void setUrlPrefix(String urlPrefix) { this.urlPrefix = urlPrefix; }
public String getUrlPrefix() {
return urlPrefix;
}
public String getServer() {
return server;
}
public int getPort() {
return port;
}
public String getAccessKey() {
return accessKey;
}
public String getSecretKey() {
return secretKey;
}
public String getBucket() {
return bucket;
}
}
自定义封装操作minio的api工具类：
**
* @Author xiaozq
* @Date 2022/8/5 10:42
* <p>@Description:</p>
*/
@Component
public class MinioTemplate {
@Autowired
private MinioClient minioClient;
@Value("${minio.bucket}")
public String bucketName;
@Value("${minio.urlprefix}")
public String urlprefix;
/**
* 判断bucket是否存在，不存在则创建
* @param name
*/
public void existBucket(String name){
try {
boolean exist = minioClient.bucketExists(BucketExistsArgs.builder().bucket(bucketName).build());
if(!exist){
minioClient.makeBucket(MakeBucketArgs.builder().bucket(name).build());
}
}catch (Exception e){
e.printStackTrace();
}
}
/**
* 创建存储bucket
* @param bucketName 存储bucket名称
* @return Boolean
*/
public Boolean makeBucket(String bucketName) {
try {
minioClient.makeBucket(MakeBucketArgs.builder().bucket(bucketName).build());
} catch (Exception e) {
e.printStackTrace();
return false;
}
return true;
}
/**
* 删除存储bucket
* @param bucketName 存储bucket名称
* @return Boolean
*/
public Boolean removeBucket(String bucketName) {
try {
minioClient.removeBucket(RemoveBucketArgs.builder()
.bucket(bucketName)
.build());
} catch (Exception e) {
e.printStackTrace();
return false;
}
return true;
}
/**
* 文件上传
* @param file
* @return
*/
public Map<String, String> upload(MultipartFile file) {
String filename = FileUtils.extractUploadFilename(file);
try {
InputStream inputStream = file.getInputStream();
// 上传到minio服务器
minioClient.putObject(PutObjectArgs.builder()
.bucket(this.bucketName)
.object(filename)
.stream(inputStream, -1L, 10485760L)
.build());
} catch (Exception e) {
e.printStackTrace();
}
// 返回地址
Map<String,String > resultMap = new HashMap<>();
resultMap.put("url",filename);
return resultMap;
}
/**
* 文件下载
* @param fileName 文件名
* @param delete 是否删除
* @throws IOException
*/
public void fileDownload(@RequestParam(name = "fileName") String fileName,
@RequestParam(defaultValue = "false") Boolean delete,
HttpServletResponse response) {
InputStream inputStream = null;
OutputStream outputStream = null;
try {
if (StringUtils.isBlank(fileName)) {
response.setHeader("Content-type", "text/html;charset=UTF-8");
String data = "文件下载失败";
OutputStream ps = response.getOutputStream();
ps.write(data.getBytes("UTF-8"));
return;
}
outputStream = response.getOutputStream();
// 获取文件对象
inputStream =minioClient.getObject(GetObjectArgs.builder().bucket(this.bucketName).object(fileName).build());
byte buf[] = new byte[1024];
int length = 0;
response.reset();
response.setHeader("Content-Disposition", "attachment;filename=" +
URLEncoder.encode(fileName.substring(fileName.lastIndexOf("/") + 1), "UTF-8"));
response.setContentType("application/octet-stream");
response.setCharacterEncoding("UTF-8");
// 输出文件
while ((length = inputStream.read(buf)) > 0) {
outputStream.write(buf, 0, length);
}
inputStream.close();
// 判断：下载后是否同时删除minio上的存储文件
if (BooleanUtils.isTrue(delete)) {
minioClient.removeObject(RemoveObjectArgs.builder().bucket(this.bucketName).object(fileName).build());
}
} catch (Throwable ex) {
response.setHeader("Content-type", "text/html;charset=UTF-8");
String data = "文件下载失败";
try {
OutputStream ps = response.getOutputStream();
ps.write(data.getBytes("UTF-8"));
}catch (IOException e){
e.printStackTrace();
}
} finally {
try {
outputStream.close();
if (inputStream != null) {
inputStream.close();
}}catch (IOException e){
e.printStackTrace();
}
}
}
/**
* 查看文件对象
* @param bucketName 存储bucket名称
* @return 存储bucket内文件对象信息
*/
public List<ObjectItem> listObjects(String bucketName) {
Iterable<Result<Item>> results = minioClient.listObjects(ListObjectsArgs.builder().bucket(bucketName).build());
List<ObjectItem> objectItems = new ArrayList<>();
try {
for (Result<Item> result : results) {
Item item = result.get();
ObjectItem objectItem = new ObjectItem();
objectItem.setObjectName(item.objectName());
objectItem.setSize(item.size());
objectItems.add(objectItem);
}
} catch (Exception e) {
e.printStackTrace();
return null;
}
return objectItems;
}
/**
* 批量删除文件对象
* @param bucketName 存储bucket名称
* @param objects 对象名称集合
*/
public Map<String, String> removeObjects(String bucketName, List<String> objects) {
Map<String,String > resultMap = new HashMap<>();
List<DeleteObject> dos = objects.stream().map(e -> new DeleteObject(e)).collect(Collectors.toList());
try {
minioClient.removeObjects(RemoveObjectsArgs.builder().bucket(bucketName).objects(dos).build());
resultMap.put("mes","删除成功");
}catch (Exception e){
e.printStackTrace();
resultMap.put("mes","网络异常，删除失败");
}
return resultMap;
}
}
上传文件名替换工具类：
public class FileUtils {
/**
* 编码文件名
* 日期路径 + UUID
* 示例：fileName=2022/11/18/统计报表1668758006562.txt
*/
public static final String extractUploadFilename(MultipartFile file)
{
String fileName = file.getOriginalFilename();
// 注意，这里需要加上 \\ 将 特殊字符 . 转意 \\. ,否则异常
String[] fileArray = fileName.split("\\.");
fileName = datePath() + "/" + fileArray[0]+System.currentTimeMillis()+"."+fileArray[1];
return fileName;
}
/**
* 日期路径 即年/月/日 如2018/08/08
*/
public static final String datePath() {
Date now = new Date();
return DateFormatUtils.format(now, "yyyy/MM/dd");
}
}
controller层：
@RestController
public class MinioController {
@Autowired
private MinioTemplate minioTemplate;
@Value("${minio.server}")
private String server;
@Value("${minio.port}")
private Integer port;
@Value("${minio.bucket}")
private String bucket;
/**
* 单文件上传
* @param file 文件
* @return
*/
@PostMapping("/uploadone")
public Object uploadOne(MultipartFile file) {
return minioTemplate.upload(file);
}
/**
* 单文件下载
* @param fileName 文件
* @param delete 下载完后是否删除, 请谨慎传参
*/
@GetMapping("/download")
public void download(@RequestParam(value = "fileName") String fileName,
@RequestParam(defaultValue = "false")Boolean delete, HttpServletResponse response) {
minioTemplate.fileDownload(fileName,delete,response);
}
/**
* 查看存储的文件列表
* @param bucket 桶
* @return
*/
@GetMapping("/list")
public Object fileList(@RequestParam(value = "bucket") String bucket) {
return minioTemplate.listObjects(bucket);
}
/**
* 删除文件
* @param bucket 桶
* @param list 文件名列表
* @return
*/
@DeleteMapping ("/remove")
public Object fileremove(@RequestParam String bucket,@RequestParam List<String> list) {
return minioTemplate.removeObjects(bucket,list);
}
}
接下来就是用postman测试，非常便利：测试存储文档、表格、日志、视频、音频、图片等上传、下载：
以上就是minio入门的所有内容
更多可参考官网文档：链接: https://min.io/docs/minio/kubernetes/upstream/
如果对源码感兴趣可以访问：链接: https://github.com/minio/minio
3203
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
