您的位置:首页 > 编程语言 > Java开发

SpringMVC 中文件上传 MultipartResolver

2016-03-08 09:27 549 查看
原文链接:http://exceptioneye.iteye.com/blog/1314958

基于前面文章的基础上。

一、准备

    需要的jar

    



 二、配置

  1、  spmvc-servlet.xml

   

Xml代码  


<?xml version="1.0" encoding="UTF-8" ?>  

<beans xmlns="http://www.springframework.org/schema/beans"  

        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  

        xmlns:context="http://www.springframework.org/schema/context"  

        xmlns:mvc="http://www.springframework.org/schema/mvc"  

        xmlns:util="http://www.springframework.org/schema/util"   

        xsi:schemaLocation="  

          http://www.springframework.org/schema/beans  

          http://www.springframework.org/schema/beans/spring-beans-3.0.xsd  

          http://www.springframework.org/schema/context  

          http://www.springframework.org/schema/context/spring-context-3.0.xsd  

          http://www.springframework.org/schema/mvc      

          http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd  

          http://www.springframework.org/schema/util   

          http://www.springframework.org/schema/util/spring-util-3.0.xsd">  

       

    <!-- 默认的注解映射的支持 ,它会自动注册DefaultAnnotationHandlerMapping 与AnnotationMethodHandlerAdapter-->   

    <mvc:annotation-driven />  

      

    <!-- 自动扫描注解的Controller -->  

    <context:component-scan base-package="com.wy.controller" />  

      

    <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter" />  

      

    <!-- 映射处理器 -->  

    <bean id="simpleUrlMapping"  

        class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">  

        <property name="mappings">  

            <props>  

                <prop key="/fileUploadController.do">fileUploadController</prop>  

            </props>  

        </property>  

    </bean>  

      

    <!-- ParameterMethodNameResolver 解析请求参数,并将它匹配Controller中的方法名 -->  

    <bean id="parameterMethodNameResolver"  

        class="org.springframework.web.servlet.mvc.multiaction.ParameterMethodNameResolver">  

        <property name="paramName" value="action" />  

    </bean>  

      

    <bean id="fileUploadController"  

        class="com.wy.controller.FileUploadController">  

        <property name="methodNameResolver"  

            ref="parameterMethodNameResolver">  

        </property>  

    </bean>  

      

    <!-- 文件上传表单的视图解析器 -->  

    <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="204800" />    

    </bean>    

       

</beans>            

 

2、Controller

  使用两种方式:

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

      使用第二种方式时要注意:操作方法中对应的方法参数前两位必须是request,response对象并且都要加上,否则会出现 No request handling method with name 'insert' in class  "ClassName",页面显示为404错误

这个问题出现在使用多操作控制器情况下,相关的操作方法中对应的方法参数前两位必须是request,response对象,必须要有,否则会报如上异常。


 

Java代码  


package com.wy.controller;  

  

import java.util.List;  

  

import javax.servlet.http.HttpServletRequest;  

import javax.servlet.http.HttpServletResponse;  

import javax.servlet.http.HttpSession;  

  

import org.springframework.stereotype.Controller;  

import org.springframework.util.MultiValueMap;  

import org.springframework.web.bind.annotation.RequestMapping;  

import org.springframework.web.bind.annotation.RequestMethod;  

import org.springframework.web.bind.annotation.RequestParam;  

import org.springframework.web.multipart.MultipartFile;  

import org.springframework.web.multipart.MultipartHttpServletRequest;  

import org.springframework.web.servlet.ModelAndView;  

import org.springframework.web.servlet.mvc.multiaction.MultiActionController;  

  

@Controller  

@RequestMapping("/fileUploadController")  

public class FileUploadController extends MultiActionController {  

  

    /** 

     * 1、文件上传 

     * @param request 

     * @param response 

     * @return 

     */  

    public ModelAndView uploadFiles(HttpServletRequest request, HttpServletResponse response) {  

        ModelAndView mav = new ModelAndView();  

        // 转型为MultipartHttpRequest  

        MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request;  

        // 获得上传的文件(根据前台的name名称得到上传的文件)  

        MultiValueMap<String, MultipartFile> multiValueMap = multipartRequest.getMultiFileMap();  

        List<MultipartFile> file = multiValueMap.get("clientFile");  

        //MultipartFile file = multipartRequest.getFile("clientFile");  

        if(!file.isEmpty()){  

            //在这里就可以对file进行处理了,可以根据自己的需求把它存到数据库或者服务器的某个文件夹  

            System.out.println("================="+file.get(0).getName() + file.get(0).getSize());  

        }  

           

        return mav;  

    }  

  

    /** 

     *  

     * @param name 

     * @param file 

     * @param session 

     * @return 

     */  

    @RequestMapping(value="/uploadFile", method=RequestMethod.POST)     

    public String uploadFile(@RequestParam("fileName") String fileName,     

            @RequestParam("clientFile") MultipartFile clientFile, HttpSession session){     

        if (!clientFile.isEmpty()) {  

            //在这里就可以对file进行处理了,可以根据自己的需求把它存到数据库或者服务器的某个文件夹  

            System.out.println("================="+clientFile.getSize());     

        }     

        return "";     

    }    

  

}  

 

3、试图

   upload.jsp

  

Html代码  


<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>  

<%  

    String path = request.getContextPath();  

    String basePath = request.getScheme() + "://"  

            + request.getServerName() + ":" + request.getServerPort()  

            + path + "/";  

%>  

  

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">  

<html>  

    <head>  

        <title>file upload test</title>  

    </head>  

    <body>  

  

        <form method="post" action="<%=path %>/fileUploadController/uploadFile" enctype="multipart/form-data">  

            文件名: <input type="text" name="fileName" /><br/>  

                     

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

            <input type="submit" value="上传文件 "/>  

        </form>  

    </body>  

</html>  

 

  

=================转载http://zachary-guo.iteye.com/blog/1294443====================

 

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

Html代码  


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

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

  <input type="submit" value="Upload" />  

</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代码  


public MultipartHttpServletRequest resolveMultipart(final HttpServletRequest request) throws MultipartException {  

  Assert.notNull(request, "Request must not be null");  

  if (this.resolveLazily) {  

    return new DefaultMultipartHttpServletRequest(request) {  

      @Override  

      protected void initializeMultipart() {  

        MultipartParsingResult parsingResult = parseRequest(request);  

        setMultipartFiles(parsingResult.getMultipartFiles());  

        setMultipartParameters(parsingResult.getMultipartParameters());  

      }  

    };  

  }  

  else {  

    MultipartParsingResult parsingResult = parseRequest(request);  

    return new DefaultMultipartHttpServletRequest(  

        request, parsingResult.getMultipartFiles(), parsingResult.getMultipartParameters());  

  }  

}  

        暂且不管 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代码  


/** 

 * Obtain the MultipartFile Map for retrieval, 

 * lazily initializing it if necessary. 

 * @see #initializeMultipart() 

 */  

protected MultiValueMap<String, MultipartFile> getMultipartFiles() {  

  if (this.multipartFiles == null) {  

    initializeMultipart();  

  }  

  return this.multipartFiles;  

}  

  

/** 

 * Lazily initialize the multipart request, if possible. 

 * Only called if not already eagerly initialized. 

 */  

protected void initializeMultipart() {  

  throw new IllegalStateException("Multipart request not initialized");  

}  

        我们来分析一下以上代码。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 类型的请求,但后续又不操作文件,就没有在请求一来就做文件解析操作吧。

 
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: