- 微服务系列:分布式文件存储之 MinIO 搭建指南
MinIO
的对象存储服务,这篇文章我们会学习一下在实战 Java 项目中如何集成 MinIO
去使用。话不多说,开始今天的学习。
项目集成 1. 引入依赖
io.minio
minio
8.2.2
org.springframework.boot
spring-boot-starter-web
2. 配置文件
# Tomcat
server:
port: 9300
# Minio配置
minio:
url: http://localhost:9000
accessKey: minioadmin
secretKey: minioadmin
bucketName: test
【微服务系列|微服务系列(分布式文件存储之 Spring Boot 集成 MinIO)】minio 下的参数分别是 minio 服务地址,用户名,密码,存储桶名称
注意:最好是再配置一下允许的上传文件大小,Spring Boot 的默认上传文件大小是 1M
spring:
# 配置文件上传大小限制
servlet:
multipart:
max-file-size: 100MB
max-request-size: 100MB
3. 配置类
/**
* Minio 配置信息
*
* @author ruoyi
*/
@Configuration
@ConfigurationProperties(prefix = "minio")
public class MinioConfig
{
/**
* 服务地址
*/
private String url;
/**
* 用户名
*/
private String accessKey;
/**
* 密码
*/
private String secretKey;
/**
* 存储桶名称
*/
private String bucketName;
// 省略 get、set 方法@Bean
public MinioClient getMinioClient()
{
return MinioClient.builder().endpoint(url).credentials(accessKey, secretKey).build();
}
}
配置类用来读取 yml 文件中的 minio 配置,并且初始化
MinioClient
到 Spring
容器。4. 文件上传类
- 首先是 service 层
public interface ISysFileService
{
/**
* 文件上传接口
*
* @param file 上传的文件
* @return 访问地址
* @throws Exception
*/
public String uploadFile(MultipartFile file) throws Exception;
}@Service
public class MinioSysFileServiceImpl implements ISysFileService
{
@Autowired
private MinioConfig minioConfig;
@Autowired
private MinioClient client;
/**
* 本地文件上传接口
* @param file 上传的文件
* @return 访问地址
* @throws Exception
*/
@Override
public String uploadFile(MultipartFile file) throws Exception
{
String fileName = file.getOriginalFilename();
PutObjectArgs args = PutObjectArgs.builder()
.bucket(minioConfig.getBucketName())
.object(fileName)
.stream(file.getInputStream(), file.getSize(), -1)
.contentType(file.getContentType())
.build();
client.putObject(args);
return minioConfig.getUrl() + "/" + minioConfig.getBucketName() + "/" + fileName;
}
}
- 然后是 controller 层
/**
* 文件请求处理
*/
@RestController
public class SysFileController
{
@Autowired
private ISysFileService sysFileService;
/**
* 文件上传请求
*/
@PostMapping("upload")
public Map upload(MultipartFile file)
{
Map map = new HashMap<>();
try
{
// 上传并返回访问地址
String url = sysFileService.uploadFile(file);
map.put("status", "success");
map.put("data", url);
return map;
}
catch (Exception e)
{
log.error("上传文件失败", e);
map.put("status", "error");
map.put("msg", e.getMessage());
return map;
}
}
}
Spring Boot
项目集成起来也是非常简单,下面我们来测试一波。启动测试 打开
postman
使用 form-data
格式发送文件上传请求,返回成功文章图片
浏览器访问返回的文件 url
文章图片
然后再去我们的 MinIO 控制台看一下
文章图片
测试成功。
补充 存储桶命名要求
存储桶的命名需符合以下一个或多个规则
- 存储桶名称的长度介于 3 和 63 个字符之间,并且只能包含小写字母、数字、句点和短划线。
- 存储桶名称中的每个标签必须以小写字母或数字开头。
- 存储桶名称不能包含下划线、以短划线结束、包含连续句点或在句点旁边使用短划线。
- 存储桶名称不能采用 IP 地址格式 (198.51.100.24)。
- 存储桶用作可公开访问的 URL,因此您选择的存储桶名称必须具有全局唯一性。如果您选择的名称已被其他一些帐户用于创建存储桶,则必须使用其他名称。
推荐阅读
- #|【Spring Cloud】新闻头条微服务项目(FreeMarker模板引擎实现文章静态页面生成)
- #|【Spring Cloud】新闻头条微服务项目(使用JWT+MD5+Salt进行登录验证)
- #|【Spring Cloud】新闻头条微服务项目(环境搭建及框架准备)
- 嵌入式软硬件|嵌入式软件组件经典架构与存储器分类
- 资料参考|JAVA细说Spring——AOP详解(AOP概览)
- Java毕业设计项目实战篇|java mysql图书馆管理系统源码
- 笔记|基于Java+SpringMVC+MySql+Layui+H5网站后台管理系统
- springboot|Spring Security跨站请求伪造(CSRF)
- 后端|马老师力荐(腾讯 SpringBoot 高阶笔记,限时开源)