SpringMVC结合ajaxfileupload.js实现文件无刷新上传

Posted 2020-10-09 DamonWong

完整版见https://jadyer.github.io/2012/05/17/springmvc-annotation/

直接看代码吧，注释都在里面

首先是web.xml

<?xml version="1.0" encoding="UTF-8"?>  
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee   
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  
    <servlet>  
        <description>配置SpringMVC的前端控制器</description>  
        <servlet-name>upload</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>  
    </servlet>  
    <servlet-mapping>  
        <servlet-name>upload</servlet-name>  
        <url-pattern>/</url-pattern>  
    </servlet-mapping>  
      
    <filter>  
        <description>解决参数传递过程中的乱码问题</description>  
        <filter-name>CharacterEncodingUTF8</filter-name>  
        <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>  
        <init-param>  
            <param-name>encoding</param-name>  
            <param-value>UTF-8</param-value>  
        </init-param>  
    </filter>  
    <filter-mapping>  
        <filter-name>CharacterEncodingUTF8</filter-name>  
        <url-pattern>/*</url-pattern>  
    </filter-mapping>  
</web-app>  

下面是位于//src//applicationContext.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:mvc="http://www.springframework.org/schema/mvc"  
 5     xmlns:context="http://www.springframework.org/schema/context"  
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans   
 7                         http://www.springframework.org/schema/beans/spring-beans-3.2.xsd  
 8                         http://www.springframework.org/schema/mvc  
 9                         http://www.springframework.org/schema/mvc/spring-mvc-3.2.xsd  
10                         http://www.springframework.org/schema/context   
11                         http://www.springframework.org/schema/context/spring-context-3.2.xsd">  
12     <!-- 启动Spring的组件自动扫描机制(Spring会自动扫描base-package指定的包中的类和子包里面类) -->  
13     <!-- 此处可参考我的文章http://blog.csdn.net/jadyer/article/details/6038604 -->  
14     <context:component-scan base-package="com.jadyer"/>  
15       
16     <!-- 启动SpringMVC的注解功能,它会自动注册HandlerMapping、HandlerAdapter、ExceptionResolver的相关实例 -->  
17     <mvc:annotation-driven/>  
18       
19     <!-- 由于web.xml中设置SpringMVC拦截所有请求,所以在读取静态资源文件时就会读不到 -->  
20     <!-- 通过此配置即可指定所有请求或引用"/js/**"的资源,都会从"/js/"中查找 -->  
21     <mvc:resources mapping="/js/**" location="/js/"/>  
22     <mvc:resources mapping="/upload/**" location="/upload/"/>  
23       
24     <!-- SpringMVC上传文件时,需配置MultipartResolver处理器 -->  
25     <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">  
26         <!-- 指定所上传文件的总大小不能超过800KB......注意maxUploadSize属性的限制不是针对单个文件,而是所有文件的容量之和 -->  
27         <property name="maxUploadSize" value="800000"/>  
28     </bean>  
29       
30     <!-- SpringMVC在超出上传文件限制时,会抛出org.springframework.web.multipart.MaxUploadSizeExceededException -->  
31     <!-- 该异常是SpringMVC在检查上传的文件信息时抛出来的,而且此时还没有进入到Controller方法中 -->  
32     <bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">  
33         <property name="exceptionMappings">  
34             <props>  
35                 <!-- 遇到MaxUploadSizeExceededException异常时,自动跳转到/WEB-INF/jsp/error_fileupload.jsp页面 -->  
36                 <prop key="org.springframework.web.multipart.MaxUploadSizeExceededException">error_fileupload</prop>  
37             </props>  
38         </property>  
39     </bean>  
40       
41     <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">  
42         <property name="prefix" value="/WEB-INF/jsp/"/>  
43         <property name="suffix" value=".jsp"/>  
44     </bean>  
45 </beans>  

下面是上传文件内容过大时的提示页面//WEB-INF//jsp//error_fileupload.jsp

1 <%@ page language="java" pageEncoding="UTF-8"%>  
2 <h1>文件过大，请重新选择</h1> 

下面是用于选择文件的上传页面index.jsp

<%@ page language="java" pageEncoding="UTF-8"%>  
<!-- 此处不能简写为<script type="text/javascript" src=".."/> -->  
<script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery-1.10.2.min.js"></script>  
<script type="text/javascript" src="<%=request.getContextPath()%>/js/ajaxfileupload.js"></script>  
  
<script type="text/javascript">  
function ajaxFileUpload(){  
    //开始上传文件时显示一个图片,文件上传完成将图片隐藏  
    //$("#loading").ajaxStart(function(){$(this).show();}).ajaxComplete(function(){$(this).hide();});  
    //执行上传文件操作的函数  
    $.ajaxFileUpload({  
        //处理文件上传操作的服务器端地址(可以传参数,已亲测可用)  
        url:‘${pageContext.request.contextPath}/test/fileUpload?uname=玄玉‘,  
        secureuri:false,                           //是否启用安全提交,默认为false   
        fileElementId:‘myBlogImage‘,               //文件选择框的id属性  
        dataType:‘text‘,                           //服务器返回的格式,可以是json或xml等  
        success:function(data, status){            //服务器响应成功时的处理函数  
            data = data.replace(/<pre.*?>/g, ‘‘);  //ajaxFileUpload会对服务器响应回来的text内容加上<pre style="....">text</pre>前后缀  
            data = data.replace(/<PRE.*?>/g, ‘‘);  
            data = data.replace("<PRE>", ‘‘);  
            data = data.replace("</PRE>", ‘‘);  
            data = data.replace("<pre>", ‘‘);  
            data = data.replace("</pre>", ‘‘);     //本例中设定上传文件完毕后,服务端会返回给前台[0`filepath]  
            if(data.substring(0, 1) == 0){         //0表示上传成功(后跟上传后的文件路径),1表示失败(后跟失败描述)  
                $("img[id=‘uploadImage‘]").attr("src", data.substring(2));  
                $(‘#result‘).html("图片上传成功<br/>");  
            }else{  
                $(‘#result‘).html(‘图片上传失败，请重试！！‘);  
            }  
        },  
        error:function(data, status, e){ //服务器响应失败时的处理函数  
            $(‘#result‘).html(‘图片上传失败，请重试！！‘);  
        }  
    });  
}  
</script>  
  
<div id="result"></div>  
<img id="uploadImage" src="http://www.firefox.com.cn/favicon.ico">  
  
<input type="file" id="myBlogImage" name="myfiles"/>  
<input type="button" value="上传图片" onclick="ajaxFileUpload()"/>  
  
<!--   
AjaxFileUpload简介  
官网:http://phpletter.com/Our-Projects/AjaxFileUpload/  
简介:jQuery插件AjaxFileUpload能够实现无刷新上传文件,并且简单易用,它的使用人数很多,非常值得推荐  
注意:引入js的顺序(它依赖于jQuery)和页面中并无表单(只是在按钮点击的时候触发ajaxFileUpload()方法)  
常见错误及解决方案如下  
1)SyntaxError: missing ; before statement  
  --检查URL路径是否可以访问  
2)SyntaxError: syntax error  
  --检查处理提交操作的JSP文件是否存在语法错误  
3)SyntaxError: invalid property id  
  --检查属性ID是否存在  
4)SyntaxError: missing } in XML expression  
  --检查文件域名称是否一致或不存在  
5)其它自定义错误  
  --可使用变量$error直接打印的方法检查各参数是否正确,比起上面这些无效的错误提示还是方便很多  
 -->  

最后是处理文件上传的FileUploadController.java

  1 package com.jadyer.controller;  
  2   
  3 import java.io.File;  
  4 import java.io.IOException;  
  5 import java.io.PrintWriter;  
  6   
  7 import javax.servlet.http.HttpServletRequest;  
  8 import javax.servlet.http.HttpServletResponse;  
  9   
 10 import org.apache.commons.io.FileUtils;  
 11 import org.springframework.stereotype.Controller;  
 12 import org.springframework.web.bind.annotation.RequestMapping;  
 13 import org.springframework.web.bind.annotation.RequestParam;  
 14 import org.springframework.web.multipart.MultipartFile;  
 15   
 16 /** 
 17  * SpringMVC中的文件上传 
 18  * 1)由于SpringMVC使用的是commons-fileupload实现,所以先要将其组件引入项目中 
 19  * 2)在SpringMVC配置文件中配置MultipartResolver处理器(可在此加入对上传文件的属性限制) 
 20  * 3)在Controller的方法中添加MultipartFile参数(该参数用于接收表单中file组件的内容) 
 21  * 4)编写前台表单(注意enctype="multipart/form-data"以及<input type="file" name="****"/>) 
 22  * PS:由于这里使用了ajaxfileupload.js实现无刷新上传,故本例中未使用表单 
 23  * --------------------------------------------------------------------------------------------- 
 24  * 这里用到了如下的jar 
 25  * commons-io-2.4.jar 
 26  * commons-fileupload-1.3.jar 
 27  * commons-logging-1.1.2.jar 
 28  * spring-aop-3.2.4.RELEASE.jar 
 29  * spring-beans-3.2.4.RELEASE.jar 
 30  * spring-context-3.2.4.RELEASE.jar 
 31  * spring-core-3.2.4.RELEASE.jar 
 32  * spring-expression-3.2.4.RELEASE.jar 
 33  * spring-jdbc-3.2.4.RELEASE.jar 
 34  * spring-oxm-3.2.4.RELEASE.jar 
 35  * spring-tx-3.2.4.RELEASE.jar 
 36  * spring-web-3.2.4.RELEASE.jar 
 37  * spring-webmvc-3.2.4.RELEASE.jar 
 38  * --------------------------------------------------------------------------------------------- 
 39  * @create Sep 14, 2013 5:06:09 PM 
 40  * @author 玄玉<http://blog.csdn.net/jadyer> 
 41  */  
 42 @Controller  
 43 @RequestMapping("/test")  
 44 public class FileUploadController {  
 45     /** 
 46      * 这里这里用的是MultipartFile[] myfiles参数,所以前台就要用<input type="file" name="myfiles"/> 
 47      * 上传文件完毕后返回给前台[0`filepath],0表示上传成功(后跟上传后的文件路径),1表示失败(后跟失败描述) 
 48      */  
 49     @RequestMapping(value="/fileUpload")  
 50     public String addUser(@RequestParam("uname") String uname, @RequestParam MultipartFile[] myfiles, HttpServletRequest request, HttpServletResponse response) throws IOException{  
 51         //可以在上传文件的同时接收其它参数  
 52         System.out.println("收到用户[" + uname + "]的文件上传请求");  
 53         //如果用的是Tomcat服务器，则文件会上传到\\%TOMCAT_HOME%\\webapps\\YourWebProject\\upload\\文件夹中  
 54         //这里实现文件上传操作用的是commons.io.FileUtils类,它会自动判断/upload是否存在,不存在会自动创建  
 55         String realPath = request.getSession().getServletContext().getRealPath("/upload");  
 56         //设置响应给前台内容的数据格式  
 57         response.setContentType("text/plain; charset=UTF-8");  
 58         //设置响应给前台内容的PrintWriter对象  
 59         PrintWriter out = response.getWriter();  
 60         //上传文件的原名(即上传前的文件名字)  
 61         String originalFilename = null;  
 62         //如果只是上传一个文件,则只需要MultipartFile类型接收文件即可,而且无需显式指定@RequestParam注解  
 63         //如果想上传多个文件,那么这里就要用MultipartFile[]类型来接收文件,并且要指定@RequestParam注解  
 64         //上传多个文件时,前台表单中的所有<input type="file"/>的name都应该是myfiles,否则参数里的myfiles无法获取到所有上传的文件  
 65         for(MultipartFile myfile : myfiles){  
 66             if(myfile.isEmpty()){  
 67                 out.print("1`请选择文件后上传");  
 68                 out.flush();  
 69                 return null;  
 70             }else{  
 71                 originalFilename = myfile.getOriginalFilename();  
 72                 System.out.println("文件原名: " + originalFilename);  
 73                 System.out.println("文件名称: " + myfile.getName());  
 74                 System.out.println("文件长度: " + myfile.getSize());  
 75                 System.out.println("文件类型: " + myfile.getContentType());  
 76                 System.out.println("========================================");  
 77                 try {  
 78                     //这里不必处理IO流关闭的问题,因为FileUtils.copyInputStreamToFile()方法内部会自动把用到的IO流关掉  
 79                     //此处也可以使用Spring提供的MultipartFile.transferTo(File dest)方法实现文件的上传  
 80                     FileUtils.copyInputStreamToFile(myfile.getInputStream(), new File(realPath, originalFilename));  
 81                 } catch (IOException e) {  
 82                     System.out.println("文件[" + originalFilename + "]上传失败,堆栈轨迹如下");  
 83                     e.printStackTrace();  
 84                     out.print("1`文件上传失败，请重试！！");  
 85                     out.flush();  
 86                     return null;  
 87                 }  
 88             }  
 89         }  
 90         //此时在Windows下输出的是[D:\Develop\apache-tomcat-6.0.36\webapps\AjaxFileUpload\\upload\愤怒的小鸟.jpg]  
 91         //System.out.println(realPath + "\\" + originalFilename);  
 92         //此时在Windows下输出的是[/AjaxFileUpload/upload/愤怒的小鸟.jpg]  
 93         //System.out.println(request.getContextPath() + "/upload/" + originalFilename);  
 94         //不推荐返回[realPath + "\\" + originalFilename]的值  
 95         //因为在Windows下<img src="file:///D:/aa.jpg">能被firefox显示,而<img src="D:/aa.jpg">firefox是不认的  
 96         out.print("0`" + request.getContextPath() + "/upload/" + originalFilename);  
 97         out.flush();  
 98         return null;  
 99     }  
100 }  

 

注：本文参考：http://blog.csdn.net/jadyer/article/details/11693705