一、简述
multipart格式的数据会将一个表单拆分为多个部分(part),每个部分对应一个输入域。在一般的表单输入域中,它所对应的部分中会放置文本型数据,但是如果上传文件的话,它所对应的部分可以是二进制。类似这样:
二、配置multipart解析器
尽管multipart请求看起来很复杂,但在Spring MVC中处理它们却很容易。在编写控制器方法处理文件上传之前,我们必须要配置一个multipart解析器,通过它来告诉DispatcherServlet该如何读取multipart请求。
Spring 内置了两个MultipartResolver的实现:
- CommonsMultipartResolver:使用Jakarta Commons FileUpload解析multipart请求;
- StandardServletMultipartResolver:依赖于Servlet 3.0对multipart请求的支持(始于Spring 3.1)。
1、StandardServletMultipartResolver的配置:
(1) 声明Bean:
<bean id="multipartResolver" class="org.springframework.web.multipart.support.StandardServletMultipartResolver
@Bean(name = "multipartResolver") public StandardServletMultipartResolver getStandardServletMultipartResolver(){ return new StandardServletMultipartResolver(); }
tips:multipart解析器的命名一定要是 multipartResolver ,否则会报错。
(2) 配置上传参数:
* web.xml 配置
<servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:applicationContext.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> <multipart-config> <!--上传到/tmp/upload 目录--> <location>/tmp/upload</location> <!--文件大小为2M--> <max-file-size>2097152</max-file-size> <!--整个请求不超过4M--> <max-request-size>4194304</max-request-size> <!--所有文件都要写入磁盘--> <file-size-threshold>0</file-size-threshold> </multipart-config> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>
* 配置类中配置
@Override protected void customizeRegistration(ServletRegistration.Dynamic registration) { //上传到/tmp/upload 目录,文件大小为2M,整个请求不超过4M,而且所有文件都要写入磁盘 registration.setMultipartConfig(new MultipartConfigElement("E:\\upload_ftp",2097152,4194304,0)); }
2、CommonsMultipartResolver的配置:
(1) 声明Bean 和 配置上传参数
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <!--设置上传目录/tmp/upload;最大的文件容量设置为2M;最大的内存大小设置为0,表示所有文件都会写入磁盘中;无法设定multipart请求整体的最大容量--> <property name="uploadTempDir" value="/tmp/upload"/> <property name="maxUploadSize" value="2097152"/> <property name="maxInMemorySize" value="0"/> </bean>
3、区别:
(1) CommonsMultipartResolver 相比较 StandardServletMultipartResolver 来说 就是无法设定multipart请求整体的最大容量。
(2) CommonsMultipartResolver不会强制要求设置临时文件路径。默认情况下,这个路径就是Servlet容器的临时目录。 StandardServletMultipartResolver 必须设置临时文件路径才能正常执行。(以上所述上传目录均为临时文件路径)
三、SpringMVC 处理请求
1、前端Form 表单
<form action="/picture" method="post" enctype="multipart/form-data"> <input type="file" name="picture"> <input type="submit"> </form>
tips:需要设置 enctype="multipart/form-data",以告诉SpringMVC 这是一个Multipart 请求。
2、后端MVC接受请求
@RequestMapping(value = "/picture",method = RequestMethod.POST) public String getHome(@RequestPart("picture") MultipartFile picture) throws IOException { String name = picture.getName(); byte[] bytes = picture.getBytes(); picture.transferTo(new File("/"+picture.getOriginalFilename())); //这里保存到文件系统的时候要用相对路径,比如这里配置的是 /。以配置的上传目录为基准。即文件路径 E:/upload_ftp/ 是保存的目录 return "home"; }
tips:(1) @RequestPart("picture") :当注册表单提交的时候,picture属性将会给定一个byte数组,这个数组中包含了请求中对应part的数据(通过@RequestPart指定)。如果用户提交表单的时候没有选择文件,那么这个数组会是空(而不是null)。所以说我们甚至可以用byte[]数组接收Multipart请求而不用 MultipartFile 也是可以的。
(2) MultipartFile :用MultipartFile方法接收为我们提供了很多的方法以便进行接下来的工作...
3、以Part的形式接受上传的文件
就主体来言,Part接口与MultipartFile并没有太大的差别。 在很多情况下,Part方法的名称与MultipartFile方法的名称是完全相同的。有一些比较类似,但是稍有差异,比如getSubmittedFileName()对应于getOriginalFilename()。类似地,write()对应于transferTo(),借助该方法我们能够将上传的文件写入文件系统中。
值得一提的是,如果在编写控制器方法的时候,通过Part参数的形式接受文件上传,那么就没有必要设置MultipartResolver 了。只有使用MultipartFile的时候,我们才需要MultipartResolver。
@RequestMapping(value = "/picture",method = RequestMethod.POST) public String getHome(@RequestPart("picture") Part picture) throws IOException { picture.write("/"+picture.getSubmittedFileName()); return "home"; }