Spring Boot 对文件上传做了简化,基本做到了零配置,我们只需要在项目中添加 spring-boot-starter-web 依赖即可。
一、单文件上传
1,代码编写
(1)首先在 static 目录中创建一个 upload.html 文件,内容如下:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <form action="/upload" method="post" enctype="multipart/form-data"> <input type="file" name="uploadFile" value="请选择文件"> <input type="submit" value="上传"> </form> </body> </html>
(2)接着创建文件上传处理接口 FileUploadController.java,内容如下:
import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; import javax.servlet.http.HttpServletRequest; import java.io.File; import java.io.IOException; import java.text.SimpleDateFormat; import java.util.Date; import java.util.UUID; @RestController public class FileUploadController { SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd/"); @PostMapping("/upload") public String upload(MultipartFile uploadFile, HttpServletRequest req) { // 上传的文件将保存在项目运行目录下的 uploadFile 文件夹, String realPath = req.getSession().getServletContext().getRealPath("/uploadFile/"); System.out.println(realPath); // 并且在 uploadFile 文件夹中通过日期对上传的文件归类保存 String format = sdf.format(new Date()); File folder = new File(realPath + format); if (!folder.isDirectory()) { folder.mkdirs(); } // 对上传的文件重命名,避免文件重名 String oldName = uploadFile.getOriginalFilename(); String newName = UUID.randomUUID().toString() + oldName.substring(oldName.lastIndexOf("."), oldName.length()); try { // 文件保存 uploadFile.transferTo(new File(folder, newName)); // 返回上传文件的访问路径 String filePath = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/uploadFile/" + format + newName; return filePath; } catch (IOException e) { e.printStackTrace(); } return "上传失败!"; } }
2,运行测试
(1)我们使用浏览器访问 upload.html 页面并选择文件上传:
(2)上传成功后会返回上传文件的访问路径:
(3)使用这个访问路径我们就可以看到刚刚上传的文件:
附:常用参数配置
(1)如果我们需要对图片上传的细节进行配置,也是可以的。比如我们可以在 application.properties 文件中添加如下配置:
spring.servlet.multipart.enabled=true
spring.servlet.multipart.file-size-threshold=0
spring.servlet.multipart.location=D:\\workspace
spring.servlet.multipart.max-file-size=1MB
spring.servlet.multipart.max-request-size=10MB
spring.servlet.multipart.resolve-lazily=false
yml版本
spring:
servlet:
multipart:
enabled:true
file-size-threshold:''
location:D:\\workspace
max-file-size:1MB
max-request-size:10MB
resolve-lazily:false
(2)上面几个参数作用如下:
- spring.servlet.multipart.enabled:表示是否开启文件上传支持,默认为 true
- spring.servlet.multipart.file-size-threshold:表示文件写入磁盘的阀值,默认为 0
- spring.servlet.multipart.location:表示上传文件的临时保存位置
- spring.servlet.multipart.max-file-size:表示上传的单个文件的最大大小,默认为 1MB
- spring.servlet.multipart.max-request-size:表示多文件上传时文件的总大小,默认为 10MB
- spring.servlet.multipart.resolve-lazily:表示文件是否延迟解析,默认为 false