http://docs.spring.io/spring/docs/current/spring-framework-reference/html/mvc.html#mvc-multipart

1、简介

Spring内置的multipart支持会处理web应用中的文件上传。你可以启用该支持 -- 通过可插拔的MultipartResolver对象们，它们都是定义在 org.springframework.web.multipart 包中。Spring提供了一个MultipartResolver实现，配合Commons FileUpload使用，或者配合Servlet 3.0 multipart 请求解析使用。

默认，Spring不会处理multipart，因为一些开发者希望由自己来处理它们。你可以让Spring来处理 -- 通过在web应用的context中添加一个multipart resolver。每个请求都会被检查，以查看其是否包含一个multipart。如果没有，就放行。如果有，在你的上下文中声明的MultipartResolver会被用来处理它。之后，你就可以像对待其他attribute一样来对待在你请求中的multipart attribute。

2、结合Commons FileUpload来使用MultipartResolver

下例示意了如何使用CommonsMultipartResolver：

<bean id="multipartResolver"

        class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

    <!-- one of the properties available; the maximum file size in bytes -->

    <property name="maxUploadSize" value="100000"/>

</bean>

当然，你还要将需要的jars放到你的classpath内，这样才能使其正常工作。在该例中，你需要使用 commons-fileupload.jar 。

当Spring DispatcherServlet 探测到一个multi-part请求时，它会激活已声明的resolver，并将请求交给它。该resolver会将当前的HttpServletRequest封装进一个MultipartHttpServletRequest，后者支持multipart file uploads。通过使用MultipartHttpServletRequest，你可以在controllers中获取包含在该请求中的multiparts的信息，还可以实际访问到这些multipart files。

3、结合Servlet 3.0 来使用MultipartResolver

为了使用基于Servlet 3.0 的multipart解析，你需要给DispatcherServlet标记一个”multipart-config”部分 -- 在xml中，或者，在编码式Servlet注册中标记一个javax.servlet.MultipartConfigElement，或者，在自定义Servlet class情况下，使用javax.servlet.annotation.MultipartConfig注解。 配置设置，例如最大尺寸或者存储位置，需要在该Servlet注册级别上应用，因为Servlet 3.0 不允许这些设置由MultipartResolver来完成！

一旦Servlet 3.0 multipart解析被启用了，你就可以将StandardServletMultipartResolver添加到你的Spring配置中：

<bean id="multipartResolver"

        class="org.springframework.web.multipart.support.StandardServletMultipartResolver">

</bean>

4、处理form中的文件上传

首先，创建一个form带有file input，允许用户上传。encoding attribute （enctype=”multipart/form-data”）会告诉浏览器将forms以multipart request形式编码：

<html>

    <head>

        <title>Upload a file please</title>

    </head>

    <body>

        <h1>Please upload a file</h1>

        <form method="post" action="/form" enctype="multipart/form-data">

            <input type="text" name="name"/>

            <input type="file" name="file"/>

            <input type="submit"/>

        </form>

    </body>

</html>

下一步就是创建一个controller来处理该文件上传。 如下：

@Controller

public class FileUploadController {

    @PostMapping("/form")

    public String handleFormUpload(@RequestParam("name") String name,

            @RequestParam("file") MultipartFile file) {

        if (!file.isEmpty()) {

            byte[] bytes = file.getBytes();

            // store the bytes somewhere

            return "redirect:uploadSuccess";

        }

        return "redirect:uploadFailure";

    }

}

注意@RequestParam 参数会映射到form中声明的input元素。在该例中，没有涉及byte[]，但你仍然可以将其保存到数据库、文件系统等等。

当使用Servlet 3.0 multipart 解析时，你还可以使用javax.servlet.http.Part：

@Controller

public class FileUploadController {

    @PostMapping("/form")

    public String handleFormUpload(@RequestParam("name") String name,

            @RequestParam("file") Part file) {

        InputStream inputStream = file.getInputStream();

        // store bytes from uploaded file somewhere

        return "redirect:uploadSuccess";

    }

}

5、处理来自编码式客户端的文件上传请求

multipart请求还可以来自非浏览器的客户端 -- 在REST风格式服务场景中。所有上述例子和配置均适用于这种情况。 然而，不同于浏览器，编码式客户端也可以发送特定内容类型的更加复杂的数据 -- 例如，一个multipart请求带有一个文件和JSON格式的数据：

POST /someUrl

Content-Type: multipart/mixed

--edt7Tfrdusa7r3lNQc79vXuhIIMlatb7PQg7Vp

Content-Disposition: form-data; name="meta-data"

Content-Type: application/json; charset=UTF-8

Content-Transfer-Encoding: 8bit

{

    "name": "value"

}

--edt7Tfrdusa7r3lNQc79vXuhIIMlatb7PQg7Vp

Content-Disposition: form-data; name="file-data"; filename="file.properties"

Content-Type: text/xml

Content-Transfer-Encoding: 8bit

... File Data ...

你可以使用@RequestParam(“meta-data”) String metadata 来访问 "meta-data"部分。然而，你可能倾向于接收一个强类型的对象 -- 由请求中的JSON格式数据初始化而成的，非常类似于@RequestBody使用HttpMessageConverter将一个non-multipart请求的请求体转成目标对象。

此时，你可以使用@RequestPart注解来代替@RequestParam注解。它允许你再来关注一个经过HttpMessageConverter的特定的multipart内容其'Content-Type' header部分。

@PostMapping("/someUrl")

public String onSubmit(@RequestPart("meta-data") MetaData metadata,

        @RequestPart("file-data") MultipartFile file) {

    // ...

}

注意MultipartFile 可以被@RequestParam或@RequestPart任意访问。然而， @RequestPart(“meta-data”) MetaData在这里，是读取其'Content-Type' header部分的JSON内容，并使用MappingJackson2HttpMessageConverter来转换的。

Spring 4 官方文档学习（十一）Web MVC 框架之multipart（文件上传）支持的更多相关文章

  1. Spring 4 官方文档学习（十一）Web MVC 框架之配置Spring MVC

    内容列表: 启用MVC Java config 或 MVC XML namespace 修改已提供的配置 类型转换和格式化 校验 拦截器 内容协商 View Controllers View Reso ...

  2. Spring 4 官方文档学习（十一）Web MVC 框架之resolving views 解析视图

    接前面的Spring 4 官方文档学习(十一)Web MVC 框架,那篇太长,故另起一篇. 针对web应用的所有的MVC框架,都会提供一种呈现views的方式.Spring提供了view resolv ...

  3. Spring 4 官方文档学习（十一）Web MVC 框架

    介绍Spring Web MVC 框架 Spring Web MVC的特性 其他MVC实现的可插拔性 DispatcherServlet 在WebApplicationContext中的特殊的bean ...

  4. Spring 4 官方文档学习（十二）View技术

    关键词:view technology.template.template engine.markup.内容较多,按需查用即可. 介绍 Thymeleaf Groovy Markup Template ...

  5. Spring Boot 官方文档学习（一）入门及使用

    个人说明:本文内容都是从为知笔记上复制过来的,样式难免走样,以后再修改吧.另外,本文可以看作官方文档的选择性的翻译(大部分),以及个人使用经验及问题. 其他说明:如果对Spring Boot没有概念, ...

  6. Spring boot官方文档学习(一)

    个人说明:本文内容都是从为知笔记上复制过来的,样式难免走样,以后再修改吧.另外,本文可以看作官方文档的选择性的翻译(大部分),以及个人使用经验及问题. 其他说明:如果对Spring Boot没有概念, ...

  7. Spring Framework 官方文档学习（四）之Validation、Data Binding、Type Conversion（二）

    接前一篇 Spring Framework 官方文档学习(四)之Validation.Data Binding.Type Conversion(一) 本篇主要内容:Spring Type Conver ...

  8. Spring Framework 官方文档学习（四）之Validation、Data Binding、Type Conversion

    本篇太乱,请移步: Spring Framework 官方文档学习(四)之Validation.Data Binding.Type Conversion(一) 写了删删了写,反复几次,对自己的描述很不 ...

  9. Spring Framework 官方文档学习（四）之Validation、Data Binding、Type Conversion（一）

    题外话:本篇是对之前那篇的重排版.并拆分成两篇,免得没了看的兴趣. 前言 在Spring Framework官方文档中,这三者是放到一起讲的,但没有解释为什么放到一起.大概是默认了读者都是有相关经验的 ...

  10. Spring 4 官方文档学习（十一）Web MVC 框架之编码式Servlet容器初始化

    在Servlet 3.0+ 环境中,你可以编码式配置Servlet容器,用来代替或者结合 web.xml文件.下面是注册DispatcherServlet : import org.springfra ...

随机推荐

  1. C#趣味程序---车牌号推断

    甲说前两位同样,乙说后两位同样,丙说四位的车牌号刚好是一个数的平方.这个车牌号是多少? using System; namespace ConsoleApplication1 { class Prog ...

  2. 常用IP核

    前言 记录自己用到的模块,随时补充. 主要分类: 一.常用模块 1-FIFO FIFO分为两种,一是输入输出时钟相同(Common clock)的 fifo ;二是输入输出时钟不相同(Independ ...

  3. HDU 3395 Special Fish 最“大”费用最大流

    求最大费用能够将边权取负以转化成求最小费用. 然而此时依旧不正确.由于会优先寻找最大流.可是答案并不一定出如今满流的时候.所以要加一些边(下图中的红边)使其在答案出现时满流. 设全部边的流量为1,花费 ...

  4. [svc][op]vim自动添加注释

    我想了下,要做好一件事, 1,首先喜欢它最才有动机去了解它 2,道听途说about那东西的,会去了解并去玩转 3,兴趣需要培养 一 添加vim头部信息. 系统:C67 追加以下代码到 /etc/vim ...

  5. protobuf c++入门

    1.在.proto文件中定义消息格式 2.使用protobuf编译器 3.使用c++ api来读写消息   0.为何使用protobuf?   1.原始内存数据结构,可以以二进制方式sent/save ...

  6. centos 中 修复 win 7 引导

    1. 我们可以清楚的看到 /boot/grub2/grub.cfg里面的话,里面说到:不要编辑这个文件,这个文件是由grub2-mkconfig 自动产生的(当然你也可以手动),修改这个文件虽然可以达 ...

  7. Spring Boot干货系列：（二）配置文件解析

    Spring Boot干货系列:(二)配置文件解析 2017-02-28 嘟嘟MD 嘟爷java超神学堂   前言 上一篇介绍了Spring Boot的入门,知道了Spring Boot使用“习惯优于 ...

  8. Python2 获取两日期之间的每一天

    import datetime def getEveryDay(begin_date,end_date): date_list = [] begin_date = datetime.datetime. ...

  9. mproxy: c 语言实现的一个最小的http代理，支持FQ

    https://github.com/examplecode/mproxy mproxy 使用说明 这是一个微型的http代理服务器实现,使用c语言实现,核心代码量不足500行,不依赖任何第三方的库( ...

  10. php array_diff分析

    前段时间和一个人聊天,聊到怎么用一个方法一次对两个数组取差集,我说使用array_diff倒是可以做到这个,但是不能只用一次,得两次.然后他就开始跟我讲他理解的array_diff的底层原理:“首先p ...