Spring MVC 为文件上传提供了直接支持，这种支持是通过即插即用的 MultipartResolver 实现的。Spring 使用 Jakarta Commons FileUpload 技术实现了一个 MultipartResolver 实现类：CommonsMultipartResolver。
在 Spring MVC 上下文中默认没有装配 MultipartResolver，因此默认情况下不能处理文件的上传工作。如果想使用 Spring 的文件上传功能，则需要先在上下文中配置 MultipartResolver。
1.配置 MultipartResolver
下面使用 CommonsMultipartResolver 配置一个 MultipartResolver 解析器。
<!-- 文件上传 --> <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" p:defaultEncoding="UTF-8"//①请求的编码格式，默认为ISO-8859-1 p:maxUploadSize="5000000"//②上传文件的大小上限，单位为字节（5MB） p:uploadTempDir="file://d:/temp"/>//③上传文件的临时路径
defaultEncoding 必须和用户 JSP 的 pageEncoding 属性一致，以便正确读取表单的内容。uploadTempDir 是文件上传过程中所使用的临时目录，文件上传完成后，临时目录中的临时文件会被自动清除。
为了让 CommonsMultipartResolver 正常工作，必须先将 Jakarta Commons FileUpload 及 Jakarta Commons io 的类包添加到类路径下。
2.编写控制器和文件上传表单页面
在 UserController 中添加一个用于处理用户头像上传的方法，如下面代码所示。
@Controller @RequestMapping("/user") public class UserController { @RequestMapping(value = "/uploadPage")//① public String updatePage() { return "uploadPage"; } @RequestMapping(value = "/upload") public String updateThumb(@RequestParam("name") String name, @RequestParam("file") MultipartFile file) throws Exception{ //②上传的文件自动绑定到MultipartFile中 if (!file.isEmpty()) { file.transferTo(new File("d:/temp/"+file.getOriginalFilename())); return "redirect:success.html"; }else{ return "redirect:fail.html"; } } }
Spring MVC 会将上传文件绑定到 MultipartFile 对象中。MultipartFile 提供了获取上传文件内容、文件名等方法，通过其 transferTo() 方法还可将文件存储到硬件中，具体说明如下。
- byte[] getBytes()：获取文件数据。
- String getContentType()：获取文件 MIME 类型，如 image/pjpeg、text/plain 等。
- InputStream getInputStream()：获取文件流。
- String getName()：获取表单中文件组件的名字。
- String getOriginalFilename()：获取上传文件的原名。
- long getSize()：获取文件的字节大小，单位为 Byte.
- boolean isEmpty()：是否有上传的文件。
- void transferTo(File dest)：可以使用该文件将上传文件保存到一个目标文件中。
负责上传文件的表单和一般表单有一些区别，表单的编码类型必须是 multipart/form-data 类型。
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <html> <head> <title>请上传用户头像</title> </head> <body> <h1> 请选择上传的头像文件 </h1> <form method="post" action="<c:url value="/user/upload.html"/>" enctype="multipart/form-data">//指定表单内容类型，以便支持文件上传 <input type="text" name="name" /> <input type="file" name="file" />//②上传文件的组件名 <input type="submit" /> </form> </body> </html>