SpringMVC结合jquery.form.js实现异步文件上传与参数封装

作者：异步漫步时间：2026-10-30 07:30:51浏览：114

本文详解如何在SpringMVC中利用jquery.form.js框架实现异步文件上传，并解决同时封装普通表单参数的问题。重点分析html表单enctype配置、CommonsMultipartResolver设置，以及避免使用@RequestBody导致的415错误，提供正确的Controller参数接收方式。

SpringMVC与jquery.form.js异步文件上传基础

上一篇 Bootstrap自定义文件上传下载样式（https://www.jb51.net/article/85156.htm）已经有一段时间了，一直在考虑怎么样给大家提交一篇完美的逻辑处理功能。现在我结合自己的实际工作给大家分享一下。使用的技术有jquery.form.js框架，以及springmvc框架。主要实现异步文件上传的同时封装对象，以及一些注意事项。功能本身是很简单的，但是涉及到一些传递参数类型的问题。例如：jquery的ajax方法与jquery.form.js中的ajaxSubmit方法的参数，具体细节将在下一篇博客中分享。重点： html表格三要素： action="fileUpload/fileUpload" method="post" enctype="multipart/form-data"; 1. 最简单的表单直接提交 html代码：

简单表单直接提交实现


<body>
 <form action="fileUpload/fileUpload" method="post" enctype="multipart/form-data">
 <input type="text" name="password">
 <input type="file" name="file">
 <input type="text" name="username">
 <input type="submit" value="submit">
 </form>
 <button id="button">提交</button>
</body>

对应的Java后端处理代码如下：


@Controller
@RequestMapping("/fileUpload")
public class FileUpload {

 @RequestMapping("/fileUpload")
 @ResponseBody
 public String FileUpload1(@RequestParam("file")MultipartFile file/*, @RequestParam("username")String username*/){
 System.out.println("------------------------------- "+ file.getSize());
 if(!file.isEmpty()){
 System.out.println("Process file: "+file.getOriginalFilename() );
 try {
 FileUtils.copyInputStreamToFile(file.getInputStream(), new File("c:\\temp\\imooc\\", System.currentTimeMillis()+ file.getOriginalFilename()));
 } catch (IOException e) {
 
 e.printStackTrace();
 }
 }
 return "NewFile";
 }
}

接下来是SpringMVC的具体配置，包括文件上传解析器的设置。准备工作阶段，需要将Jakarta Commons FileUpload及Jakarta Commons IO的JAR包放入lib目录。具体使用的包版本为commons-fileupload-1.1.1.jar和commons-io-1.3.2.jar。随后，必须在spring-servlet.xml文件中配置multipartResolver，若不进行此配置，文件上传功能将无法正常使用。

SpringMVC文件上传配置


<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> 
 <property name="maxUploadSize"><value>100000</value></property> 
 <property name="defaultEncoding"><value>UTF-8</value></property> 
</bean>

页面部分的实现如下：请注意Form表单的写法以及文件上传组件的具体写法。

页面Form与组件写法


 <form action="uploadPosdetailFile.html" method="post" ENCTYPE="multipart/form-data">
 <div class="form" >
 <p>
 <span class="req"><input id="startDateTxt" name="startDateTxt" class="field size4" title="Enter the date" /></span>
 <label>Start Date: <span>(Date format:MM/dd/yyyy,eg:01/01/2014)</span></label>
 </p>
 
 <p>
 <span class="req"><input id="endDateTxt" name="endDateTxt" class="field size4" title="Enter the date" /></span>
 <label>End Date: <span>(Date format:MM/dd/yyyy,eg:12/25/2014)</span></label>
 </p>
 
 <p>
 <span class="req"><input type="file" name="uploadFileCtrl" class="field size4" title="Choose the file" /></span>
 <label>Upload file: <span>(click browse to choose)</span></label>
 </p>
 </div>
 
 <div class="buttons">
 <input id="queryBtn" type="Submit" class="button" value="Submit" />
 </div>
 
 </form>

在控制器中编写处理代码时，需特别注意参数与页面控件名称的对应关系：

控制器参数对应关系


 @RequestMapping(value="/uploadPosdetailFile")
 public String uploadPosdetailFile(@RequestParam("startDateTxt") String startDateTxt, 
   @RequestParam("endDateTxt") String endDateTxt,
   @RequestParam("uploadFileCtrl") MultipartFile file,HttpServletRequest request,HttpServletResponse response){
 try {
 System.out.println("@@@@@@@@@1.startDateTxt="+startDateTxt);
 System.out.println("@@@@@@@@@2.endDateTxt="+endDateTxt);
 System.out.println("@@@@@@@@@3.file="+file.getOriginalFilename());// 得到上传文件的文件名
 
 if(file.isEmpty()==false){
 InputStream is=file.getInputStream();
 InputStreamReader isr = new InputStreamReader(is);

  BufferedReader br=new BufferedReader(isr); 

  String s;
  while((s=br.readLine())!=null ){
  System.out.println(s);
  }

 br.close();
 isr.close();
 is.close();
 }
 
 
 return "/pages/posdetail/uploadposdetailresult/index.jsp";
 } catch (Exception e) {
 e.printStackTrace();
 logger.error(e);
 
 request.setAttribute("error", e.getClass());
 request.setAttribute("reason", e.getMessage());
 StackTraceElement[] arr=e.getStackTrace();
 request.setAttribute("stackTraceElements", arr);
 
 return "pages/error/index.jsp";
 }
 }

第二种方式是使用jquery.form.js提供的ajaxSubmit方法。 HTML代码与Java代码保持与第一种方式相同，只需为id为button的按钮添加点击事件即可：

使用ajaxSubmit方法


$("#button").click(function(){
 var hideForm = $('form'); 
 var options = { 
 dataType : "json", 
 /*data: {'file': $("input[type=file]").val(), "username": '123', password: "123"},*/
 beforeSubmit : function() { 
 alert("正在上传"); 
 }, 
 success : function(result) { 
 alert('成功上传！'); 
 
 }, 
 error : function(result) { 
  
 } 
 }; 
 hideForm.ajaxSubmit(options); 
 });

第三种情况是，在后台使用一个User对象来接收username和password字段。

后台对象封装与常见错误


<form action="fileUpload/fileUpload" method="post" enctype="multipart/form-data">
 <input type="file" name="file">
 <input type="submit" value="submit">
</form>

有些开发者可能会尝试以下步骤：将表单数据封装为一个JSON对象，并在上述JS代码中添加data参数。 data:{'file': $("input[type=file]").val(), 'user':{"username": '123', password: "123"}} 这种做法实际上是多余的，此时发送的请求详情如图所示：

SpringMVC与jquery.form.js异步文件上传基础

此时页面会报错415。 ---------------------------------------------------------------- 最合理的代码结构应该是：HTML代码与第一种方式相同，JS代码与第二种方式相同，Java代码如下： public String FileUpload1(@RequestParam("file")MultipartFile file, User user){ 此外，User对象前不能添加@RequestBody注解。

更多精彩内容，请点击《jQuery上传操作汇总》，《spring上传下载专题》进行深入学习和研究。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。

作者最新文章

D3.js 比例尺与坐标轴的配置详解

2026-11-05 16:54:46

JavaScript怎么遍历对象的Symbol键和不可枚举属性

2026-11-05 13:13:39

封装一个健壮的JS字符串判空工具函数

2026-11-05 12:16:14

JavaScript合并数组的三种常用方法：concat、扩展运算符与push

2026-11-05 11:22:29

JavaScript立即执行函数(IIFE)是什么及基本语法

2026-11-05 10:51:19