一、SpringMVC 的文件上传
1、Spring MVC 为文件上传提供了直接的支持，这种支持是通过即插即用的 MultipartResolver 实现的。
2、Spring 用 Jakarta Commons FileUpload 技术实现了一个 MultipartResolver 实现类：CommonsMultipartResolver
3、SpringMVC 上下文中默认没有装配 MultipartResolver，因此默认情况下不能处理文件的上传工作，如果想要使用 Spring 的文件上传功能，需要在上下文中配置 MultipartResolver。
MultipartFile 接口：
继承结构：
4、配置 MultipartResolver
其中有两个常用属性：
defaultEncoding：必须和用户 JSP 的 pageEncoding 属性一致，以便于正确解析表单的内容；
maxUploadSize：设置上传文件的最大文件的大小（单位是字节）；
注意：为了让 CommonsMultipartResolver 正确工作，必须先将 Jakarta Commons FileUpload 及 Jakarta Commons io 的类包添加到类路径下。
二、文件上传示例
1、导入 jar 包
commons-fileupload-1.2.1.jar
commons-io-2.0.jar
Maven 方式：
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.1</version>
</dependency>
2、配置文件解析器
在SpringMVC中配置一个文件上传解析器：
<!-- 配置文件上传解析器，id必须是 multipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--设置上传文件的最大值-->
<property name="maxUploadSize" value="#{1024*1024*1024}"/>
<!--设置默认编码-->
<property name="defaultEncoding" value="utf-8"/>
</bean>
配置文件上传解析器，id必须是"multipartResolver"，否则会报错误：
java.lang.IllegalArgumentException: Expected MultipartHttpServletRequest: is a MultipartResolver configured
3、页面表单
<form action="${ctp}/upload" method="post" enctype="multipart/form-data">
用户头像：<input type="file" name="headerImg" /><br>
用户名称：<input type="text" name="userName" /><br>
<input type="submit" value="提交">
</form>
4、控制器方法
@RequestMapping(value = "/upload")
public String upload(@RequestParam(value = "userName", required = false) String userName,
@RequestParam(value = "headerImg") MultipartFile uploadFile,
Model model) {
System.out.println("上传的文件的信息:" + uploadFile);
System.out.println(uploadFile.getName());
System.out.println(uploadFile.getOriginalFilename());
//文件保存
File localFile = new File("H:\\111学习\\" + uploadFile.getOriginalFilename());
try {
uploadFile.transferTo(localFile);
model.addAttribute("msg", "文件上传成功!");
} catch (IOException e) {
model.addAttribute("msg", "文件上传失败!" + e.getMessage());
}
return "forward:/index.jsp";
}
5、小结
（1）文件上传表单准备， enctype="multipart/form-data"
（2）导入 commons-fileupload
（3）只要在 SpringMVC 配置文件中，配置一个文件上传解析器 MultipartResolver
（4）文件上传请求处理
只需要在处理器入参写一个@RequestParam(value = "headerImg") MultipartFile uploadFile 封装当前文件的信息，可以直接保存
三、多文件上传
当有多个 File 需要上传时，可以使用数组来接收：
页面表单：
<form action="${ctp}/uploadFiles" method="post" enctype="multipart/form-data">
用户头像：<input type="file" name="headerImg" /><br>
用户头像：<input type="file" name="headerImg" /><br>
用户头像：<input type="file" name="headerImg" /><br>
用户头像：<input type="file" name="headerImg" /><br>
用户名称：<input type="text" name="userName" /><br>
<input type="submit" value="提交">
</form>
控制器方法：
/**
* 多文件上传
* @param userName
* @param uploadFile
* @param model
* @return
*/
@RequestMapping(value = "/uploadFiles")
public String uploadFiles(@RequestParam(value = "userName", required = false) String userName,
@RequestParam(value = "headerImg") MultipartFile[] uploadFile,
Model model) {
System.out.println("上传的文件的信息:" + uploadFile);
for (MultipartFile multipartFile : uploadFile) {
if (!multipartFile.isEmpty()) {
//获取上传文件的名称
String fileName = multipartFile.getOriginalFilename();
//使用 UUID 或时间戳来给文件命名，防止重名
String finalFileName = UUID.randomUUID() +fileName.substring(fileName.lastIndexOf("."));
//设置文件保存的位置
String path = "H:\\111学习" + File.separator + finalFileName;
File newFile = new File(path);
try {
//将文件从原处复制到目标处
multipartFile.transferTo(newFile);
model.addAttribute("msg", "文件上传成功!");
} catch (IOException e) {
model.addAttribute("msg", "文件上传失败!" + e.getMessage());
}
}
}
return "forward:/index.jsp";
}
如果表单里面的 file 的name 值不一样，可以在入参再写一个 MultipartFile 进行接收即可。