SpringBoot实现本地存储文件上传及提供HTTP访问服务的方法
笔者计划为大家介绍分布式文件系统,用于存储应用的图片、word、excel、pdf等文件。在开始介绍分布式文件系统之前,为大家介绍一下使用本机存储来存放文件资源。
二者的核心实现过程是一样的:
- 上传文件,保存文件(本节是本地磁盘)
- 返回文件HTTP访问服务路径给前端,进行上传之后的效果展示
一、复习
服务端接收上传的目的是提供文件的访问服务,那么对于SpringBoot而言,有哪些可以提供文件访问的静态资源目录呢?
- classpath:/META-INF/resources/,
- classpath:/static/,
- classpath:/public/,
- classpath:/resources/
这是之前我们为大家介绍的内容,从这里看出这里的静态资源都在classpath下。那么就出现问题:
- 应用的文件资源不能和项目代码分开存储(你见过往github上传代码,还附带项目文件数据的么?)
- 项目打包困难,当上传的文件越来越多,项目的打包jar越来越大。
- 代码与文件数据不能分开存储,就意味着文件数据的备份将变得复杂
二、文件上传目录自定义配置
怎么解决上述问题?别忘记了springboot为我们提供了使用spring.resources.static-locations配置自定义静态文件的位置。
web:
upload-path:D:/data/
spring:
resources:
static-locations:classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/,file:${web.upload-path}
- 配置web.upload-path为与项目代码分离的静态资源路径,即:文件上传保存根路径
- 配置spring.resources.static-locations,除了带上SpringBoot默认的静态资源路径之外,加上file:${web.upload-path}指向外部的文件资源上传路径。该路径下的静态资源可以直接对外提供HTTP访问服务。
三、文件上传的Controller实现
详情看代码注释
@RestController
publicclassFileUploadController{
//绑定文件上传路径到uploadPath
@Value("${web.upload-path}")
privateStringuploadPath;
SimpleDateFormatsdf=newSimpleDateFormat("yyyy/MM/dd/");
@PostMapping("/upload")
publicStringupload(MultipartFileuploadFile,
HttpServletRequestrequest){
//在uploadPath文件夹中通过日期对上传的文件归类保存
//比如:/2019/06/06/cf13891e-4b95-4000-81eb-b6d70ae44930.png
Stringformat=sdf.format(newDate());
Filefolder=newFile(uploadPath+format);
if(!folder.isDirectory()){
folder.mkdirs();
}
//对上传的文件重命名,避免文件重名
StringoldName=uploadFile.getOriginalFilename();
StringnewName=UUID.randomUUID().toString()
+oldName.substring(oldName.lastIndexOf("."),oldName.length());
try{
//文件保存
uploadFile.transferTo(newFile(folder,newName));
//返回上传文件的访问路径
StringfilePath=request.getScheme()+"://"+request.getServerName()
+":"+request.getServerPort()+format+newName;
returnfilePath;
}catch(IOExceptione){
thrownewCustomException(CustomExceptionType.SYSTEM_ERROR);
}
}
}
四、写一个模拟的文件上传页面,进行测试
把该upload.html文件放到classpath:public目录下,对外提供访问。
Title