HTML5 FormData 方法介绍以及实现文件上传---java版本

Java版本使用formData上传图片和表单参数,这主要是我亲身使用的,为了以后再次查看方便,也为了给广大我这种低级的程序员方便,所以将代码保存在此。我这段代码的业务比较复杂,你可以只查看重点部分(红色标出)。

FormData 上传文件实例

首先看一下formData的基本用法:FormData对象,可以把所有表单元素的name与value组成一个queryString,提交到后台。只需要把 form 表单作为参数传入 FormData 构造函数即可:

var form = document.getElementById("form1");
var fd = new FormData(form);



  • 这样就可以直接通过ajax 的 send() 方法将 fd 发送到后台。

以下创建了一个表单 form,表单中除了普通的数据外,还有文件上传,我们直接将 form对象作为参数传入FormData对象:

<form  id="appUserForm" name="appUserForm" >
		<input type="hidden" name="USER_ID" id="user_id" value="${pd.USER_ID}"/>
		<div id="zhongxin" style="padding-top: 13px;"><table id="basic" class="table table-striped table-bordered table-hover" style="width:800px">
	     	<tr>
			<td style="width:79px;text-align: right;padding-top: 13px;">姓名:</td>
			<td><input type="text" name="NAME" id="name"  value="${pd.NAME }" placeholder="这里输入姓名" title="姓名" style="width:98%;" /></td>
		</tr>
		<tr>
			td style="width:79px;text-align: right;padding-top: 13px;">用户名:</td>
			<td><input type="text" name="USERNAME" id="loginname" value="${pd.USERNAME }" placeholder="这里输入用户名" title="用户名" style="width:98%;" /></td>
		</tr>
		<tr>
			<td style="width:79px;text-align: right;padding-top: 13px;">手机号:</td>
			<td><input type="tel" name="PHONE" id="PHONE" value="${pd.PHONE }" placeholder="这里输入手机号" title="手机号" style="width:98%;" /></td>
		</tr>
	</table>						
	<table id="photo" class="table table-striped table-bordered table-hover" style="display:none">
		<tr>
			<td style="width:75px;text-align: right;padding-top: 13px;">上传头像:</td>
	        	<td class="center">
		        <input type="file" id="file" name="photo"/>
			</td>
		</tr>
	</table>
	 <table id="saveAndCancel" class="table table-striped table-bordered table-hover" style="margin-top:-22px;width:800px">
		<tr>
			<td class="center" colspan="6">
			<a class="btn btn-mini btn-primary" onclick="save()">保存</a>
			<a class="btn btn-mini btn-danger" onclick="javascript:window.location.href='<%=basePath%>happuser/listUsers.do'">取消</a>
			</td>
	      </tr>
	</table>
	</div>
	<div id="zhongxin2" class="center" style="display:none"><br/><br/><br/><br/><br/><img src="static/images/jiazai.gif" /><br/><h4 class="lighter block green">提交中...</h4></div>
</form>

  • 上述代码创建一个form,简单的填写一些信息,以及选择一张图片作为头像,设置一个div来存放返回的结果。(图片忽略不看)

这里写图片描述

为了简便,我们还是采用jquery封装的ajax来向后台传输数据:

function save(){
       var typeVal = $("#type").val();
       var form=document.getElementById("appUserForm");
       var formData=new FormData(form);
       formData.append("valueType",typeVal);
       formData.append("start_time1",$("#start_time1").val());
       formData.append("start_time2",$("#start_time2").val());
     	$.ajax({
		url: '<%=basePath%>happuser/editU.do',
		type: "POST",
	    	data: formData,
	    	processData: false,  // 告诉jQuery不要去处理发送的数据
	        contentType: false,   // 告诉jQuery不要去设置Content-Type请求头
		success: function(response,status,xhr){
			$("#zhongxin").hide(); 
		        $("#zhongxin2").show(); 
			window.location.href='<%=basePath%>happuser/listUsers.do';
		     },
		error: function(response,status,xhr){	
		        console.log("upload  error");
		     }
     	}); 
	}



上述代码中的editU.do是服务器端的文件,接收ajax请求,并将接收结果返回,具体代码如下:

 /**
	 * 修改用户
	 * 
	 * @param out
	 * @return
	 * @throws Exception
	 */
	@RequestMapping(value = "/editU")
	public ModelAndView editU(PrintWriter out,HttpServletRequest request, @RequestParam(value = "photo", required = false) MultipartFile file) throws Exception {
		if (!Jurisdiction.buttonJurisdiction(menuUrl, "edit")) {
			return null;
		} // 校验权限
		logBefore(logger, Jurisdiction.getUsername() + "修改用户");
		ModelAndView mv = this.getModelAndView();
		PageData pd = new PageData();
		pd = this.getPageData();
		String valueType = (String) request.getParameter("valueType");
		if (valueType == "1" || "1".equals(valueType)) {
			pd.put("START_TIME", (String) request.getParameter("start_time1"));
			pd.put("END_TIME", (String) request.getParameter("END_TIME"));
		}
		if (valueType == "2" || "2".equals(valueType)) {
			pd.put("START_TIME", (String) request.getParameter("start_time2"));
			pd.put("END_TIME", (String) request.getParameter("END_TIME"));
		}
		if (valueType == null || "".equals(valueType)) {
			pd.put("START_TIME", null);
			pd.put("END_TIME", null);
			pd.put("type", null);
		}
		pd.put("USER_ID", (String) request.getParameter("USER_ID"));
		PageData pageData = appuserService.findByUiId(pd);
		pd.put("STATUS", pageData.get("STATUS"));
		
		pd.put("USERNAME", (String) request.getParameter("USERNAME"));
		pd.put("NAME", (String) request.getParameter("NAME"));
		pd.put("PHONE", (String) request.getParameter("PHONE"));
		pd.put("id_type", (String) request.getParameter("id_type"));
		pd.put("id_number", (String) request.getParameter("id_number"));
		pd.put("gender", (String) request.getParameter("gender"));
		pd.put("birthday", (String) request.getParameter("birthday"));
		pd.put("birthplace", (String) request.getParameter("birthplace"));
		pd.put("EMAIL", (String) request.getParameter("EMAIL"));
		pd.put("address", (String) request.getParameter("address"));
		pd.put("type", (String) request.getParameter("type"));
		pd.put("status_in_school", (String) request.getParameter("status_in_school"));
		pd.put("position", (String) request.getParameter("position"));
		pd.put("NUMBER", (String) request.getParameter("NUMBER"));
		   String headImg = null;// 用户保存用户头像文件名  
		    if (file != null && !file.isEmpty()) {  
		        headImg = file.getOriginalFilename();  
		        // 构建上传目录及文件对象,不存在则自动创建  
		        String path = request.getSession().getServletContext().getRealPath("uploadFiles\\headImg");  
		        File imgFile = new File(path, headImg);  
		        pd.put("photo", imgFile.toString());
		        // 保存文件  
		        try {  
		            file.transferTo(imgFile);  
		        } catch (Exception e) {  
		            e.printStackTrace();  
		        }  
		    }  
		appuserService.editU(pd);
		mv.addObject("msg", "success");
		mv.setViewName("save_result");
		return mv;
	}



填写好信息后,点击 submit,页面中能得到以下效果,去服务器端对应的文件夹下也能发现上传的图片。(图片忽略不看

这里写图片描述

如果你是原生 JavaScript 爱好者,当然一样能实现以上功能,下面是简单的JavaScript实现代码:

function fsubmit() {
    var form=document.getElementById("form1");
    var formData=new FormData(form);
    alert(formData.name);
    var oReq = new XMLHttpRequest();
    oReq.onreadystatechange=function(){
      if(oReq.readyState==4){
        if(oReq.status==200){
            console.log(typeof oReq.responseText);
            var json=JSON.parse(oReq.responseText);
            var result = '';
            result +="个人信息:<br/>name:"+json['name']+"<br/>gender:"+json['gender']+"<br/>number:"+json['number'];
             result += '<br/>头像:<img src="' + json['photo'] + '" height="50" style="border-radius: 50%;" />';

             $('#result').html(result);
        }
      }
    };
    oReq.open("POST", "server.php");
    oReq.send(formData); 
    return false;
}



FormData 对象方法介绍

FormData 除了上面的创建新对象时直接将 form 作为参数传入外,还有其他的功能。网上大部分关于 FormData 介绍的文章都只提到了append()方法,那么FormData 对象到底有些什么方法呢?我们console 一下就知道:

这里写图片描述

console 之后我们有重大的发现,FormData 对象竟然有这么方法,所以还是自己测试才能发现真相,下面就对这些方法一一进行讲解:

1、append()

append()方法用于向 FormData 对象中添加键值对:

fd.append('key1',"value1");
fd.append('key2',"value2");

  • fd是 FormData 对象,可以新建的空的对象,也可以是已经包含 form 表单或其他键值对。

2、set()

设置对应的键 key 对应的值 value(s)

fd.set('key1',"value1");
fd.set('key2',"value2");

看起来跟append() 方法有点类似,这两者的区别就是,当指定的 key 值存在时,append()方法是将新增的添加的所以的键值对最后,而set()方法将会覆盖前面的设置的键值对。还是通过实例来对比,我们在前面的 form 的基础上 append() 或 set() 新的键值对:

fd.append('name',"will");

  • 有两个key为name的键值对: 

这里写图片描述

fd.set('name',"will");

  • 只有一个key为name的键值对: 

这里写图片描述

以上就是 append() 和 set() 的区别。如果设置的key值不存在,那么两者的效果是一样的。

3、delete()

接收一个参数,表示你要删除的 key 值的名字,如果有多个相同 key 值,会一并删除:

fd.append('name','will');
fd.delete('name');

  • form 中的 name 信息以及通过append() 新增的name 的信息都被删除了。

4、get() 和 getAll()

接收一个参数,表示需要查找的 key 的名称,返回第一个该 key 对应的 value 值。如果有多个相同的 key, 而且要返回所有的这个 key 对应的 value 值。

同样以上面的 form 表单为基础:

fd.append('name','will');
console.log(fd.get('name')); // sean
fd.append('name','will');
console.log(fd.getAll('name')); // ["sean", "will"]

5、has()

该方法也接收一个参数,同样是 key 的名称,返回一个Boolean 值, 用来判断FormData 对象是否含有该 key。以上面的form为例:

console.log(fd.has('name')); // true
console.log(fd.has('Name')); // false

  • 6、keys()

该方法不需要接收参数,返回一个迭代器,通过这个迭代器,我们可以遍历FormData 对象中所有的 key。以上面的form为例:

for (var key of fd.keys()) {
           console.log(key); 
        }

  • 结果为:
  • name
    gender
    number
    photo


  • 7、values()

有遍历 key 的迭代,当然也就少不了遍历 value 的迭代器了。values()就是遍历value 的迭代器,用法与 keys() 类似:

for (var value of fd.values()) {
           console.log(value); 
        }

  • 结果:

这里写图片描述

8、entries()

有遍历 key 的迭代器,也有遍历 value 的迭代器,为何不搞一个两者一起的呢!entries()就是返回一个包含键值对的迭代器:

for(var pair of fd.entries()) {
           console.log(pair[0]+ ', '+ pair[1]); 
        }

  • 结果:

这里写图片描述

FormData兼容性问题

由于 FormData 是 XMLHttpRequest Level 2 新增的接口,现在 低于IE10 的IE浏览器不支持 FormData ,至于 上面介绍的 FormData 对象的方法经过测试,在 IE 浏览器中都不支持,具体的各大浏览器的支持情况可以参照下图:

这里写图片描述

猜你喜欢

转载自blog.csdn.net/liuchangjie0112/article/details/79549355