SpringMVC结合ajaxfileupload.js实现文件无刷新上传
直接看代码吧,注释都在里面
首先是web.xml
1 <?xml version="1.0" encoding="UTF-8"?> 2 <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 3 http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> 4 <servlet> 5 <description>配置SpringMVC的前端控制器</description> 6 <servlet-name>upload</servlet-name> 7 <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> 8 <init-param> 9 <param-name>contextConfigLocation</param-name> 10 <param-value>classpath:applicationContext.xml</param-value> 11 </init-param> 12 <load-on-startup>1</load-on-startup> 13 </servlet> 14 <servlet-mapping> 15 <servlet-name>upload</servlet-name> 16 <url-pattern>/</url-pattern> 17 </servlet-mapping> 18 19 <filter> 20 <description>解决参数传递过程中的乱码问题</description> 21 <filter-name>CharacterEncodingUTF8</filter-name> 22 <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> 23 <init-param> 24 <param-name>encoding</param-name> 25 <param-value>UTF-8</param-value> 26 </init-param> 27 </filter> 28 <filter-mapping> 29 <filter-name>CharacterEncodingUTF8</filter-name> 30 <url-pattern>/*</url-pattern> 31 </filter-mapping> 32 </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
1 <%@ page language="java" pageEncoding="UTF-8"%> 2 <!-- 此处不能简写为<script type="text/javascript" src=".."/> --> 3 <script type="text/javascript" src="<%=request.getContextPath()%>/js/jquery-1.10.2.min.js"></script> 4 <script type="text/javascript" src="<%=request.getContextPath()%>/js/ajaxfileupload.js"></script> 5 6 <script type="text/javascript"> 7 function ajaxFileUpload(){ 8 //开始上传文件时显示一个图片,文件上传完成将图片隐藏 9 //$("#loading").ajaxStart(function(){$(this).show();}).ajaxComplete(function(){$(this).hide();}); 10 //执行上传文件操作的函数 11 $.ajaxFileUpload({ 12 //处理文件上传操作的服务器端地址(可以传参数,已亲测可用) 13 url:'${pageContext.request.contextPath}/test/fileUpload?uname=玄玉', 14 secureuri:false, //是否启用安全提交,默认为false 15 fileElementId:'myBlogImage', //文件选择框的id属性 16 dataType:'text', //服务器返回的格式,可以是json或xml等 17 success:function(data, status){ //服务器响应成功时的处理函数 18 data = data.replace(/<pre.*?>/g, ''); //ajaxFileUpload会对服务器响应回来的text内容加上<pre style="....">text</pre>前后缀 19 data = data.replace(/<PRE.*?>/g, ''); 20 data = data.replace("<PRE>", ''); 21 data = data.replace("</PRE>", ''); 22 data = data.replace("<pre>", ''); 23 data = data.replace("</pre>", ''); //本例中设定上传文件完毕后,服务端会返回给前台[0`filepath] 24 if(data.substring(0, 1) == 0){ //0表示上传成功(后跟上传后的文件路径),1表示失败(后跟失败描述) 25 $("img[id='uploadImage']").attr("src", data.substring(2)); 26 $('#result').html("图片上传成功<br/>"); 27 }else{ 28 $('#result').html('图片上传失败,请重试!!'); 29 } 30 }, 31 error:function(data, status, e){ //服务器响应失败时的处理函数 32 $('#result').html('图片上传失败,请重试!!'); 33 } 34 }); 35 } 36 </script> 37 38 <div id="result"></div> 39 <img id="uploadImage" src="http://www.firefox.com.cn/favicon.ico"> 40 41 <input type="file" id="myBlogImage" name="myfiles"/> 42 <input type="button" value="上传图片" onclick="ajaxFileUpload()"/> 43 44 <!-- 45 AjaxFileUpload简介 46 官网:http://phpletter.com/Our-Projects/AjaxFileUpload/ 47 简介:jQuery插件AjaxFileUpload能够实现无刷新上传文件,并且简单易用,它的使用人数很多,非常值得推荐 48 注意:引入js的顺序(它依赖于jQuery)和页面中并无表单(只是在按钮点击的时候触发ajaxFileUpload()方法) 49 常见错误及解决方案如下 50 1)SyntaxError: missing ; before statement 51 --检查URL路径是否可以访问 52 2)SyntaxError: syntax error 53 --检查处理提交操作的JSP文件是否存在语法错误 54 3)SyntaxError: invalid property id 55 --检查属性ID是否存在 56 4)SyntaxError: missing } in XML expression 57 --检查文件域名称是否一致或不存在 58 5)其它自定义错误 59 --可使用变量$error直接打印的方法检查各参数是否正确,比起上面这些无效的错误提示还是方便很多 60 -->
最后是处理文件上传的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 }
不定期会发布一些实用的Java开发文章