`

Spring MVC中使用FileUpload功能

springfileupload 
阅读更多

转自：http://dakulaliu.iteye.com/blog/236235 

先让我们来看一段摘自《Spring 2.5 Reference 中文版》(http://www.redsaga.com/spring_ref/2.5/spring-reference.pdf)的一段关于FileUpload的开场描述： 
  "Spring支持web应用中的分段文件上传。这种支持是由即插即用的MultipartResolver来实现。这些解析器都定义在org.springframework.web.multipart包里。Sprig提供了现成的MultipartResolver可以支持Commons FileUpload(http://jakarta.apache.org/commons/fileupload)和COS FileUpload(http://www.servlets.ocm/cos)。" 

是的，Spring通过配置一个分段上传解析器来完成对文件上传的解析和封装工作，那么Spring是如何完成这一工作的呢： 

首先，DispatcherServlet必须找到一个文件上传解析器的实例，使用这个实例来检查本次请求的HttpServletRequest是否是一个分段文件上传的Request,通过下面的Spring 源码可以看到，首先必须保证有一个MultipartResolver的实例，并且由该类的Resolver的isMultipart方法来验证，本次Request是否为文件上传的Request.如果以上条件都满足，那么Spring将其转换为一个继承自HttpServletRequest的MultipartHttpServletRequest返回，这样在你的Controller中就可以使用这个经过转换的request，从中取到MultipartFile信息。 

Java代码  收藏代码
  1. protected HttpServletRequest checkMultipart(HttpServletRequest request) throws MultipartException {  
  2.     if (this.multipartResolver != null && this.multipartResolver.isMultipart(request)) {  
  3.         if (request instanceof MultipartHttpServletRequest) {  
  4.             logger.debug("Request is already a MultipartHttpServletRequest - if not in a forward, " +  
  5.                     "this typically results from an additional MultipartFilter in web.xml");  
  6.         }  
  7.         else {  
  8.             return this.multipartResolver.resolveMultipart(request);  
  9.         }  
  10.     }  
  11.     // If not returned before: return original request.  
  12.     return request;  
  13. }  


由以上分析可以看出，我们必须配置一个MultipartResolver，在这里我们使用支持Commons FileUpload的CommonsMultipartResolver: 

Java代码  收藏代码
  1. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" p:defaultEncoding="utf-8"/>  


而且我们可以在该Resolver中定义文件上传的最大长度： 

Java代码  收藏代码
  1. <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" p:defaultEncoding="utf-8" p:maxUploadSize="100000"/>  


当用户选择的上传文件大于maxUploadSize值的时候，commons fileupload会抛出一个异常MaxUploadSizeExceededException表示用户上传的文件超出了最大限制。 

当然，我们可以通过Spring MVC中的ExceptionResolver来针对该异常定义一个显示错误的View，但针对有可能存在的多个文件上传Controller中都会发生文件大小超长这个异常的情况，除了我们自定义一个粒度更细的ExceptionResolver，我们还可以把上传文件合法性判断挪到用户自己的Controller中来做。而且我个人更偏向于后一种做法。 

除了Spring Configuration之外，我们还需要准备一个页面上传的jsp文件供View视图使用： 

Java代码  收藏代码
  1. <%@ page language="java" contentType="text/html; charset=UTF-8"  
  2.     pageEncoding="UTF-8"%>  
  3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">  
  4.   
  5. <html>  
  6.     <head>  
  7.         <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">  
  8.         <title>Insert title here</title>  
  9.     </head>  
  10.       
  11.     <body style="text-align:left">  
  12.         <% if(request.getAttribute("success") != null) {%>  
  13.             Upload Successfully!!!<br/>  
  14.         <% }%>  
  15.         <form id="loginform" name="loginform" method="POST" enctype="multipart/form-data">  
  16.             <table width="100%" border="0" cellspacing="0" cellpadding="0">  
  17.                 <tr>  
  18.                     <td height="30" align="right">Choose File</td>  
  19.                     <td align="left">  
  20.                         <input name="imageFile" type="file"/>  
  21.                     </td>  
  22.                 </tr>  
  23.                 <tr>  
  24.                     <td align="center" colspan="2">  
  25.                         <input type="submit" value="submit" name="submit" />  
  26.                     </td>  
  27.                 </tr>  
  28.             </table>  
  29.         </form>  
  30.     </body>  
  31. </html>  


注意：在文件上传Form表单中，一定要将enctype设置为"multipart/form-data"因为只有这样才能使Spring知道这是一个文件上传的请求。 

细心的读者也许能发现Form表单中action为默认值也就是说post到和上传页面同样的URL，因此我们定义了一个Controller分别来处理这个请求的GET和POST请求。下面让我们来看看这个Controller: 

1.我们通过@Controller声明这个类为Spring组件，告知Spring容器在初始化的时候需要加载该类实例到Spring Context Container中。 
2.通过@RequestMapping("/sec_upload.do")将sec_upload.do的请求指向该Controller处理。 

Java代码  收藏代码
  1. @Controller  
  2. @RequestMapping("/sec_upload.do")  
  3. public class UploadController {  
  4.     //...  
  5. }  


3.定义一个处理GET请求的方法，该方法简单的将选择文件Form表单页展现给用户： 

Java代码  收藏代码
  1. @RequestMapping(method = RequestMethod.GET)  
  2.     public String handleUploadShow() {  
  3.         return "uploadView";  
  4.     }  


4.定义一个处理POST请求的方法，该方法进行用户文件上传处理： 

Java代码  收藏代码
  1. @RequestMapping(method = RequestMethod.POST)  
  2.     public String handleUploadProcess(  
  3.             @RequestParam("imageFile") MultipartFile file, Model model)  
  4.             throws Exception {  
  5.         //具体的业务逻辑操作。。。  
  6.         model.addAttribute("success", "true");  
  7.         return "uploadView";  
  8.     }  


通过@RequestParam("imageFile")注解，Spring会将request请求中的imageFile的文件信息自动绑定到MultipartFile对象。 

上面的Controller方法解决的文件绑定的问题，但假设我们的Form表单中除了文件选择框还有其他一些用户填写的信息，那么我们怎么处理呢？仿照上面的方法，我们可以为多个参数提供多个@RequestParam注解来完成数据绑定工作，但我们也可以通过MultipartHttpServletRequest对象来获取这些信息，因为在DispatcherServlet中Spring已经将一个普通的HttpServletRequest转换为了一个MultipartHttpServletRequest： 

Java代码  收藏代码
  1. @RequestMapping(method = RequestMethod.POST)  
  2. public String handleAnotherUploadProcess(  
  3.         MultipartHttpServletRequest request, Model model) throws Exception {  
  4.     MultipartFile file = request.getFile("imageFile");  
  5.     //request.getParameter("xxx");  
  6.     //request.getContentType();  
  7.     //request.getContentLength();  
  8.     //some other processing...  
  9.     model.addAttribute("success", "true");  
  10.     return "uploadView";  
  11. }  



这种方式还是需要我们不断的通过request.getParameter("xxx")方式来获得参数，了解Spring MVC的同学可能想到了，使用CommandObject绑定-回答正确。假设我们定义了一个POJO对象： 

Java代码  收藏代码
  1. public class BoUploadFile {  
  2.     private MultipartFile imageFile;  
  3.   
  4.     public MultipartFile getImageFile() {  
  5.         return imageFile;  
  6.     }  
  7.   
  8.     public void setImageFile(MultipartFile imageFile) {  
  9.         this.imageFile = imageFile;  
  10.     }  
  11.   
  12.     private String name;  
  13.   
  14.     public String getName() {  
  15.         return name;  
  16.     }  
  17.   
  18.     public void setName(String name) {  
  19.         this.name = name;  
  20.     }  
  21. }  


这个对象中不仅包括需要封装的上传文件信息，还包括其他一些用户输入的普通信息。那么有了这个封装对象，我们的Controller可以变成如下的样子： 

Java代码  收藏代码
  1. @RequestMapping(method = RequestMethod.POST)  
  2. public String handleThirdUploadProcess(BoUploadFile uploadFile, Model model) throws Exception{  
  3.     MultipartFile file = uploadFile.getImageFile();  
  4.     //这里你可以通过uploadFile.getName()...等等获取用户输入的其他普通信息了。  
  5.     model.addAttribute("success", "true");  
  6.     return "uploadView";  
  7. }  



5.自定义一个文件验证类，来验证文件的合法性。 

Java代码  收藏代码
  1. /** 
  2.  * 用户文件上传验证类 
  3.  *  
  4.  * @author Jacky Lau created at 2008-8-27 
  5.  * @since 1.0 
  6.  * @version 1.0 
  7.  */  
  8. public class MultipartFileValidator {  
  9.   
  10.     private final static long MAX_SIZE = 1024 * 1024;  
  11.   
  12.     /** 
  13.      * 文件大小上限 
  14.      */  
  15.     private long maxSize = MAX_SIZE;  
  16.   
  17.     /** 
  18.      * 可接受的文件content-type 
  19.      */  
  20.     private String[] allowedContentTypes;  
  21.   
  22.     @PostConstruct  
  23.     public void afterPropertiesSet() {  
  24.         Assert  
  25.                 .notEmpty(allowedContentTypes,  
  26.                         "The content types allowed to be uploaded must contain one at least!");  
  27.     }  
  28.   
  29.     /** 
  30.      * 验证上传文件是否合法，如果不合法那么会抛出异常 
  31.      *  
  32.      * @param file 
  33.      *            用户上传的文件封装类 
  34.      */  
  35.     public void validate(MultipartFile file) {  
  36.         Assert.notNull(file, "The multipart file is null!");  
  37.         if (file.getSize() > maxSize)  
  38.             throw new FileOutOfMaxLengthException("error.upload.outmaxlen",  
  39.                     new Object[] { maxSize },  
  40.                     "The file uploaded is out of max file size!");  
  41.         if (!ArrayUtils.contains(allowedContentTypes, file.getContentType()))  
  42.             throw new ContentTypeNotSupportException("error.upload.content.notsupported", null,  
  43.                     "The content type '"+file .getContentType()+"' is not a valid content type !");  
  44.     }  
  45.   
  46.     /** 
  47.      * 设置文件上传大小上限 
  48.      *  
  49.      * @param maxSize 
  50.      *            文件上传大小上限 
  51.      */  
  52.     public void setMaxSize(long maxSize) {  
  53.         this.maxSize = maxSize;  
  54.     }  
  55.   
  56.     /** 
  57.      * 设置可接受的文件content-type数组 
  58.      *  
  59.      * @param allowedContentTypes 
  60.      *            可接受的文件content-type数组 
  61.      */  
  62.     public void setAllowedContentTypes(String[] allowedContentTypes) {  
  63.         this.allowedContentTypes = allowedContentTypes;  
  64.     }  
  65.   
  66. }  



这样我们可以通过这个validator判断上传的文件是否超出了最大限制，文件格式是否正确等判断。我们可以通过配置文件配置该验证器，在这里为了方便起见在类中我用以下方式来初始化该验证器： 

Java代码  收藏代码
  1. private MultipartFileValidator validator;  
  2.   
  3. @PostConstruct  
  4. public void init() {  
  5.     validator = new MultipartFileValidator();  
  6.     validator.setAllowedContentTypes(new String[] { "image/jpeg",  
  7.             "image/pjpeg" });  
  8. }  



至此，我们已经完成了文件上传的开发，可以看出这和普通的Controller开发没有任何区别，简单而且灵活。以下是该Controller的全部代码： 

Java代码  收藏代码
  1. @Controller  
  2. @RequestMapping("/sec_upload.do")  
  3. public class UploadController {  
  4.   
  5.     private MultipartFileValidator validator;  
  6.   
  7.     @PostConstruct  
  8.     public void init() {  
  9.         validator = new MultipartFileValidator();  
  10.         validator.setAllowedContentTypes(new String[] { "image/jpeg",  
  11.                 "image/pjpeg" });  
  12.     }  
  13.   
  14.     @RequestMapping(method = RequestMethod.GET)  
  15.     public String handleUploadShow() {  
  16.         return "uploadView";  
  17.     }  
  18.   
  19.     @RequestMapping(method = RequestMethod.POST)  
  20.     public String handleUploadProcess(  
  21.             @RequestParam("imageFile") MultipartFile file, Model model)  
  22.             throws Exception {  
  23.         validator.validate(file);  
  24.         String path = "d:\\temp\\ftp\\" + file.getOriginalFilename();  
  25.         String resizePath = "d:\\temp\\ftp\\resize\\"  
  26.                 + file.getOriginalFilename();  
  27.         FileHelper.save(path, file.getBytes());  
  28.         if (ImageHelper.isJpg(ImageHelper.getImageType(path)))  
  29.             ImageHelper.resizeJPG(path, resizePath, 120, 118);  
  30.         model.addAttribute("success", "true");  
  31.         return "uploadView";  
  32.     }  
  33. }  



在以后的文章中，我会对Spring进行上传文件特殊处理做一些探究，比如用户上传一个csv的通讯录文件，那么通过Spring的属性编辑器一个custom的Editor来进行数据转换，可以将CSV中的信息转换成其他你所需要的信息：比如从CSV文件中抽取邮件地址放到一个字符串数组中，让你可以进行后续的业务逻辑操作。。。 

本文章的第二部分：http://dakulaliu.iteye.com/blog/260122

分享到：
| hibernate主键自动生成
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    Spring MVC所需jar包

    5. **JSTL（JavaServer Pages Standard Tag Library）**：`jstl.jar` 和 `javax.servlet.jsp.jstl.jar` 用于在 JSP 页面中使用标准标签库，简化页面逻辑，提高开发效率。 6. **Apache Commons**：Spring MVC 开发中...

    Spring MVC 文件上传下载 后端 - Java.zip

    - **@RequestParam**：在Controller方法参数中使用`@RequestParam`注解接收上传的文件，例如`@RequestParam("file") MultipartFile file`。 - **验证与存储**：在处理文件上传时，通常需要验证文件大小、类型等，...

    Spring MVC 4.2.4.RELEASE 中文文档

    HTTP 缓存支持是关于如何在 Spring MVC 中使用 HTTP 缓存控制头，如 Cache-Control、ETag 和 Last-Modified，以及如何对静态资源进行缓存处理。控制器类名-处理器映射 ControllerClassNameHandlerMapping 是一种基于...

    spring mvc框架需要用到的jar包

    以下将详细阐述这些关键jar包的作用及其在Spring MVC中的重要性。 1. **spring-webmvc.jar**：这是Spring MVC的核心库，包含了处理HTTP请求、控制器注解、视图解析等核心功能。它提供了一个DispatcherServlet，它是...

    Expert Spring MVC

    《Expert Spring MVC and Web Flow》这本书还介绍了 Spring MVC 与 Spring Web Flow 的结合使用，Spring Web Flow 是一个用于构建复杂 Web 应用程序的框架，它可以处理复杂的交互式对话流程。 - **Web Flow** 提供...

    Spring mvc工程所需jar包资源

    这个压缩包中包含的jar包资源是构建和运行Spring MVC项目所必需的依赖库。 1. **Spring Framework**: Spring的核心框架，包括IoC（Inversion of Control，控制反转）和AOP（Aspect Oriented Programming，面向切面...

    关于Spring MVC项目（maven）中通过fileupload上传文件

    在本场景中，我们关注的是使用Maven构建的Spring MVC项目，并涉及到`commons-fileupload`和`commons-io`这两个库，它们是Java中处理文件上传的核心工具。以下是关于这个主题的详细知识点： 1. **Spring MVC**： ...

    spring mvc上传文件

    在本文中，我们将深入探讨如何使用Spring MVC框架与Ajax技术结合来实现文件上传的功能。Spring MVC是Spring框架的一部分，提供了一种模型-视图-控制器（MVC）架构模式，用于构建Web应用程序。Ajax（Asynchronous ...

    spring mvc 上传文件显示进度

    当你在表单中使用`&lt;input type="file" /&gt;`时，服务器端的Controller可以通过MultipartFile接收上传的文件。 1. **创建前端界面**： 在HTML页面中，添加一个用于选择文件的input元素，以及一个用于显示进度条的元素...

    springmvc_jpbm5_document.zip_spring mvc

    6. **dwz+jquery+fileupload+springmvc实现文件上传及图片预览**：这是更复杂的应用，结合了DWZ（一个前端框架）、jQuery的Fileupload插件和Spring MVC，实现了文件上传并提供实时图片预览的功能。 7. **springMVC+...

    Spring Mvc 应用Jar包

    - 压缩包中可能包含了`commons-fileupload.jar`和`commons-io.jar`：这两个Apache Commons库提供了处理HTTP请求中文件上传的功能，Spring MVC通过它们来支持文件上传操作。 4. **日志库** - 虽然提到无需导入...

    Spring MVC 文件上传下载

    Spring MVC 是一个强大的 web 应用开发框架，它提供了丰富的功能来处理用户请求，包括文件上传和下载。本文将深入探讨如何使用 Spring MVC 实现文件的上传与下载。 首先，要实现文件上传，我们需要引入一些必要的...

    spring MVC uploadify

    在本文中，我们将深入探讨如何利用Spring MVC的`multipartResolver`与第三方库uploadify协同工作，实现图片文件的上传和预览功能。 首先，`multipartResolver`是Spring MVC用来解析multipart请求的接口。默认情况下...

    spring mvc小例子

    - **CommonsMultipartFile**: Apache Commons FileUpload 和 Spring MVC 结合使用的类，用于处理多部分表单数据（文件上传）。 - **MultipartFile**: Spring MVC 提供的接口，用于暂时存储上传的文件信息。 - `@...

    Spring_MVC_4.2.4_RELEASE_中文文档.pdf

    Spring MVC支持multipart文件上传，通过`MultipartResolver`接口和Apache Commons FileUpload库实现。异常处理确保了在上传过程中出现问题时的正确响应。 10. **Web安全**： Spring MVC提供了“约定优于配置”的...

    Spring MVC 需要的jar包

    在Spring MVC中，开发者可以将业务逻辑、数据处理和用户界面分离，从而实现更清晰的代码组织和更高的可测试性。为了能够使用Spring MVC，我们需要在项目的`WEB-INF/lib`目录下引入一系列的JAR包。以下是一些关键的...

    spring MVC 上传 &下载

    Spring MVC框架提供了强大的支持来处理这类操作，它利用了Apache Commons FileUpload库来实现文件的上传功能。下面将详细介绍如何在Spring MVC环境中配置和实现文件上传。 #### 二、Spring MVC文件上传配置 为了使...

    spring mvc所需jar包

    在 Spring MVC 中，开发者可以利用 Spring 提供的强大功能，如依赖注入、AOP（面向切面编程）等，来实现灵活且可扩展的 Web 应用。为了开始一个 Spring MVC 项目，我们需要一系列的 jar 包来支持框架的运行。以下是...

    spring MVC框架所需的所有jar包。(完整版)

    3. **spring-context-support.jar**：此jar包提供了对邮件服务、缓存、任务调度和消息传递（例如JMS）的支持，这些都是在Web环境中经常使用的功能。 4. **spring-beans.jar**：包含了Spring的bean容器和依赖注入...

    spring mvc+ajax 文件上传

    - 在Spring MVC的Controller中，定义一个处理文件上传的@RequestMapping注解的方法。这个方法通常会接受一个MultipartFile类型的参数，Spring MVC框架会自动处理上传的文件。 - 为了处理`multipart/form-data`类型...

Magicbox
Global site tag (gtag.js) - Google Analytics