基于前面文章的基础上。

一、准备

    需要的jar

    

 二、配置

  1、  spmvc-servlet.xml

Xml代码  

1. <?xml version="1.0" encoding="UTF-8" ?>  
2. <beans xmlns="http://www.springframework.org/schema/beans"  
3.         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.         xmlns:context="http://www.springframework.org/schema/context"  
5.         xmlns:mvc="http://www.springframework.org/schema/mvc"  
6.         xmlns:util="http://www.springframework.org/schema/util"   
7.         xsi:schemaLocation="  
8.           http://www.springframework.org/schema/beans  
9.           http://www.springframework.org/schema/beans/spring-beans-3.0.xsd  
10.           http://www.springframework.org/schema/context  
11.           http://www.springframework.org/schema/context/spring-context-3.0.xsd  
12.           http://www.springframework.org/schema/mvc      
13.           http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd  
14.           http://www.springframework.org/schema/util   
15.           http://www.springframework.org/schema/util/spring-util-3.0.xsd">  
16.        
17.     <!-- 默认的注解映射的支持 ,它会自动注册DefaultAnnotationHandlerMapping 与AnnotationMethodHandlerAdapter-->   
18.     <mvc:annotation-driven />  
19.       
20.     <!-- 自动扫描注解的Controller -->  
21.     <context:component-scan base-package="com.wy.controller" />  
22.       
23.     <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />  
24.       
25.     <!-- 映射处理器 -->  
26.     <bean id="simpleUrlMapping"  
27.         class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">  
28.         <property name="mappings">  
29.             <props>  
30.                 <prop key="/fileUploadController.do">fileUploadController</prop>  
31.             </props>  
32.         </property>  
33.     </bean>  
34.       
35.     <!-- ParameterMethodNameResolver 解析请求参数，并将它匹配Controller中的方法名 -->  
36.     <bean id="parameterMethodNameResolver"  
37.         class="org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver">  
38.         <property name="paramName" value=http://www.mamicode.com/"action" />  
39.     </bean>  
40.       
41.     <bean id="fileUploadController"  
42.         class="com.wy.controller.FileUploadController">  
43.         <property name="methodNameResolver"  
44.             ref="parameterMethodNameResolver">  
45.         </property>  
46.     </bean>  
47.       
48.     <!-- 文件上传表单的视图解析器 -->  
49.     <bean id="multipartResolver"    
50.         class="org.springframework.web.multipart.commons.CommonsMultipartResolver">    
51.         <!-- one of the properties available; the maximum file size in bytes -->    
52.         <property name="maxUploadSize" value=http://www.mamicode.com/"204800" />    
53.     </bean>    
54.        
55. </beans>            

2、Controller

  使用两种方式：

       一种是基于注解的，另一种传统的方式HttpServletRequest

      使用第二种方式时要注意：操作方法中对应的方法参数前两位必须是request,response对象并且都要加上，否则会出现 No request handling method with name ‘insert‘ in class  "ClassName"，页面显示为404错误
这个问题出现在使用多操作控制器情况下，相关的操作方法中对应的方法参数前两位必须是request,response对象，必须要有，否则会报如上异常。

Java代码  

1. package com.wy.controller;  
2.   
3. import java.util.List;  
4.   
5. import javax.servlet.http.HttpServletRequest;  
6. import javax.servlet.http.HttpServletResponse;  
7. import javax.servlet.http.HttpSession;  
8.   
9. import org.springframework.stereotype.Controller;  
10. import org.springframework.util.MultiValueMap;  
11. import org.springframework.web.bind.annotation.RequestMapping;  
12. import org.springframework.web.bind.annotation.RequestMethod;  
13. import org.springframework.web.bind.annotation.RequestParam;  
14. import org.springframework.web.multipart.MultipartFile;  
15. import org.springframework.web.multipart.MultipartHttpServletRequest;  
16. import org.springframework.web.servlet.ModelAndView;  
17. import org.springframework.web.servlet.mvc.multiaction.MultiActionController;  
18.   
19. @Controller  
20. @RequestMapping("/fileUploadController")  
21. public class FileUploadController extends MultiActionController {  
22.   
23.     /** 
24.      * 1、文件上传 
25.      * @param request 
26.      * @param response 
27.      * @return 
28.      */  
29.     public ModelAndView uploadFiles(HttpServletRequest request, HttpServletResponse response) {  
30.         ModelAndView mav = new ModelAndView();  
31.         // 转型为MultipartHttpRequest  
32.         MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request;  
33.         // 获得上传的文件（根据前台的name名称得到上传的文件）  
34.         MultiValueMap<String, MultipartFile> multiValueMap = multipartRequest.getMultiFileMap();  
35.         List<MultipartFile> file = multiValueMap.get("clientFile");  
36.         //MultipartFile file = multipartRequest.getFile("clientFile");  
37.         if(!file.isEmpty()){  
38.             //在这里就可以对file进行处理了，可以根据自己的需求把它存到数据库或者服务器的某个文件夹  
39.             System.out.println("================="+file.get(0).getName() + file.get(0).getSize());  
40.         }  
41.            
42.         return mav;  
43.     }  
44.   
45.     /** 
46.      *  
47.      * @param name 
48.      * @param file 
49.      * @param session 
50.      * @return 
51.      */  
52.     @RequestMapping(value=http://www.mamicode.com/"/uploadFile", method=RequestMethod.POST)     
53.     public String uploadFile(@RequestParam("fileName") String fileName,     
54.             @RequestParam("clientFile") MultipartFile clientFile, HttpSession session){     
55.         if (!clientFile.isEmpty()) {  
56.             //在这里就可以对file进行处理了，可以根据自己的需求把它存到数据库或者服务器的某个文件夹  
57.             System.out.println("================="+clientFile.getSize());     
58.         }     
59.         return "";     
60.     }    
61.   
62. }  

3、视图

   upload.jsp

Html代码  

1. <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  
2. <%  
3.     String path = request.getContextPath();  
4.     String basePath = request.getScheme() + "://"  
5.             + request.getServerName() + ":" + request.getServerPort()  
6.             + path + "/";  
7. %>  
8.   
9. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  
10. <html>  
11.     <head>  
12.         <title>file upload test</title>  
13.     </head>  
14.     <body>  
15.   
16.         <form method="post" action="<%=path %>/fileUploadController/uploadFile" enctype="multipart/form-data">  
17.             文件名: <input type="text" name="fileName" /><br/>  
18.             &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;  
19.             <input type="file" name="clientFile" /><br/>  
20.             <input type="submit" value=http://www.mamicode.com/"上传文件 "/>  
21.         </form>  
22.     </body>  
23. </html>  

  HTML 页面中的表单最初所采用 application/x-www-form-urlencode 编码方式，并不满足文件上传的需要，所以，RFC 1867 在此基础上增加了新的 multipart/form-data 编码方式以支持基于表单的文件上传。通常情况下，按照如下形式声明表单以及表单中的元素：

Html代码  

1. <form action="..." method="post" enctype="multipart/form-data">  
2.   <input type="file" name="tile2upload" />  
3.   <input type="submit" value=http://www.mamicode.com/"Upload" />  
4. </form>  

        客户端浏览器将按照 RFC 1867 所规定的格式，对提交表单内容进行编码，服务器端只需要根据 RFC 1867 规定的格式对请求中的信息进行解码，就可以获得客户端表单提交的数据，包括上传的文件。 

        既然 RFC 1867 所规定的规则是一定的，所以，我们没有必要每次都根据这一规则分析每一次请求中的信息。既然是通用的逻辑，当然也就有通用的类库，比如早期的 jsp smart upload 和 Oreilly 的 COS 类库，以及现在使用最多的 Commons FileUpload 类库。实际开发中，我们只需要使用这些专门针对表单的文件上传处理类库即可。 

        在实际基于表单的文件上传功能的时候，Spring MVC 框架底层实际上也是使用了以上几种类库。只不过，通过 org.springframework.web.multipart.MultipartResolver 接口的抽象，Spring MVC 将具体选用哪一种类库的权利留给了我们。 

        MultipartResolver 位于 HandlerMapping 之前，请求一来就交由它来处理。当 Web 请求到达 DispatcherServlet 并等待处理的时候，DispatcherServlet 首先会检查能否从自的 WebApplicationContext 中找到一个名称为 multipartResolver(由 DispatcherServlet 的常量 MULTIPART_RESOLVER_BEAN_NAME 所决定)的 MultipartResolver 实例。如果能够获得一个 MultipartResolver 的实例，DispatcherServlet 将调用 MultipartResolver 的 isMultipart(request) 方法检查当前 Web 请求是否为 multipart类型。如果是，DispatcherServlet 将调用 MultipartResolver 的 resolveMultipart(request) 方法，对原始 request 进行装饰，并返回一个 MultipartHttpServletRequest 供后继处理流程使用(最初的 HttpServletRequest 被偷梁换柱成了 MultipartHttpServletRequest)，否则，直接返回最初的 HttpServletRequest。来看看 UML 类图： 

        MultipartRequest 毕竟是接口，接口就是接口，总得有人实现。AbstractMultipartHttpServletRequest 这个抽象类持有 MultiValueMap<String, MultipartFile> multipartFiles 这样一个实例变量，有了这个 map，把 MultipartRequest 接口里的方法逐一实现就不是难事了。现在的问题是，multipartFiles 从哪来的？不可能像孙悟空似的从石缝里蹦出来吧。。。。。 

        再回到 MultipartResolver。MultipartResolver 的 isMultipart(request) 方法好实现，当判断出当前的 request 是 multipart 类型的请求，它将调用 MultipartResolve 的 resolveMultipart(request)。这里的 request 就是原始的 HttpServletRequest 对象，奇迹就出现在这里。以 CommonsMultipartResolver 为例，当调用 resolveMultipart(request) 时，看看它是如何创建 MultipartRequest 的：

Java代码  

1. public MultipartHttpServletRequest resolveMultipart(final HttpServletRequest request) throws MultipartException {  
2.   Assert.notNull(request, "Request must not be null");  
3.   if (this.resolveLazily) {  
4.     return new DefaultMultipartHttpServletRequest(request) {  
5.       @Override  
6.       protected void initializeMultipart() {  
7.         MultipartParsingResult parsingResult = parseRequest(request);  
8.         setMultipartFiles(parsingResult.getMultipartFiles());  
9.         setMultipartParameters(parsingResult.getMultipartParameters());  
10.       }  
11.     };  
12.   }  
13.   else {  
14.     MultipartParsingResult parsingResult = parseRequest(request);  
15.     return new DefaultMultipartHttpServletRequest(  
16.         request, parsingResult.getMultipartFiles(), parsingResult.getMultipartParameters());  
17.   }  
18. }  

        暂且不管 resolveLazily 为何意。假设 resolveLazily 为 false，我们看 else 的片段。由于是 CommonsMultipartResolver，它的 parseRequest 方法将从原始的 HttpServletRequest 中解析出文件，得到基于 Commons FileUpload API 的 FileItem 对象。Spring 在这里封装了一下，对于 MultipartResolver 而言，它看到的就是 MultipartFile。注意最后的 return，它将构建一个 DefaultMultipartHttpServletRequest，也就是 MultipartRequest。它将 MultipartFile 和 MultipartParameter 作为构造函数的参数传入，在这个构造函数里，有 setMultipartFiles 这句话。这个方法正是 AbstractMultipartHttpServletRequest 里的方法，这样，AbstractMultipartHttpServletRequest 的实例变量 multipartFiles 就有正规来源了吧，即解决了上面我们提到的疑问。然去实现 MultipartRequest 接口里的方法就是轻而易举的事了。 

        再来看看 resolveLazily。request 被装饰了一下，后续处理上传的文件，通过 multipartRequest.getFile(name) 就可以拿到文件。MultipartRequest 接口里定义的方法全在 AbstractMultipartHttpServletRequest 类里给实现了，而它之所以能实现，因为它持有了 multipartFiles。虽说是实例变量，但拿到该变量，还是要通过方法得到的。我们来看看 AbstractMultipartHttpServletRequest 里是如何得到 multipartFiles 的：

Java代码  

1. /** 
2.  * Obtain the MultipartFile Map for retrieval, 
3.  * lazily initializing it if necessary. 
4.  * @see #initializeMultipart() 
5.  */  
6. protected MultiValueMap<String, MultipartFile> getMultipartFiles() {  
7.   if (this.multipartFiles == null) {  
8.     initializeMultipart();  
9.   }  
10.   return this.multipartFiles;  
11. }  
12.   
13. /** 
14.  * Lazily initialize the multipart request, if possible. 
15.  * Only called if not already eagerly initialized. 
16.  */  
17. protected void initializeMultipart() {  
18.   throw new IllegalStateException("Multipart request not initialized");  
19. }  

        我们来分析一下以上代码。multipartFiles 会为 null 吗？为什么要做这样的判断？不是之前通过 DefaultMultipartHttpServletRequest 的构造函数传入了吗？这里就是 resolveLazily 的作用了。如果非延迟解析，则的确会通过 DefaultMultipartHttpServletRequest 的构造函数传入 multipartFiles。如果为延迟解析，则不会传入 multipartFiles，那么它当然就有可能为 null 了。multipartFiles 为 null 就会调用 initializeMultipart 来初始化(谁让它延迟呢)。resolveLazily 为 true 时，构造的 DefaultMultipartHttpServletRequest 的对象覆写了 AbstractMultipartHttpServletRequest 的 initializeMultipart 方法，它从原始请求中解析文件。思考一个问题：resolveLazily 为 true，直接构造 DefaultMultipartHttpServletRequest 而不覆写 initializeMultipart 会有什么后果？

        我认为，resolveLazily 为 false 时，请求一旦被 MultipartResolver 接手，它就会解析请求中的文件，而不必等待后续 controoler 主动从 MultipartRequest 中 getFile。 resolveLazily 为 true 时，只有等后续的 controller 主动调用 MultipartRequest.getFile 才会从原始请求中解析文件。Spring 这样处理，可能是考虑效率问题吧。也许是 multipart 类型的请求，但后续又不操作文件，就没有在请求一来就做文件解析操作吧。