使用ajax异步提交form表单以及文件上传

Posted by sqq5682 on April 5, 2019

使用ajax请求数据,很多人都会,比如说:

	$.post(path,{data:data},function(data){
	...
	},"json");

又或者是这样的ajax

	$.ajax({
		url:"${pageContext.request.contextPath}/public/testupload",
		type:"post",
		data:{username:username},
		success:function(data){
			window.clearInterval(timer);
			console.log("over..");
		},
		error:function(e){
			alert("错误!!");
			window.clearInterval(timer);
		}
	});

同样的,很多人也会。但是写的越多就越会发现,这样子虽然可以避免刷新页面,但是我们要写大量的js来到得数据:

	var username = $("#username").val();
	var password = $("#password").val();
	...

如果数量少的话,那还没有什么,但是如果数据十分大的话,那就十分的麻烦,那有没有什么简单的方法呢?答案肯定有的!下面介绍两种方法,可以极大的提高开发人员的效率。

解决方法

方法一:使用FormData对象

FormData对象是html5的一个对象,目前的一些主流的浏览器都已经兼容。额,如果你说ie8什么的,那我们还是来谈谈今天的天气吧,我没听见。呵呵,开个玩笑,不支持FormData的,可以使用方法二,下面会介绍。接着说FormData,它是一个html5的javascript对象,非常的强大。

FormData可以凭空创建一个对象,然后往这个对象里面添加数据,然后直接提交,不需要写一行html代码,如下:

	var form = new FormData();
	form.append("username","zxj");
	form.append("password",123456);
	var req = new XMLHttpRequest();
	req.open("post", "${pageContext.request.contextPath}/public/testupload", false);
	req.send(form);

这样就可以向浏览器发送表单数据了,或者也可以使用Jquery这样发送:

	var form = new FormData();
	form.append("username","zxj");
	form.append("password",123456);
	$.ajax({
		url:"${pageContext.request.contextPath}/public/testupload",
		type:"post",
		data:form,
		processData:false,
		contentType:false,
		success:function(data){
			window.clearInterval(timer);
			console.log("over..");
		}
	});

这样也可以直接发送数据到后台。

你以为这就完了?不!这才刚开始呢!!

其次FormData还支持直接从html中的表单生成数据,就是在html页面中已经有数据了,然后FormData可以直接把这个表单的数据写入这个对象,然后直接提交给后台,代码如下,先给出html代码:

	<form id="tf"><input type="file" name="img" />
	<input type="text" name="username" />
	<input onclick="test();" type="button" value="提" />
	.............</form>

大家注意到没有,里面可是有文件的哦!

没错,FormData还支持困扰众多开发者已久的ajax的上传文件,以前我们上传文件,需要写一个表单直接刷新提交,但是这里不需要,下面给出提交代码:

	function test(){
		var form = new FormData(document.getElementById("tf"));
		// var req = new XMLHttpRequest();
		// req.open("post", "${pageContext.request.contextPath}/public/testupload", false);
		// req.send(form);
		$.ajax({
			url:"${pageContext.request.contextPath}/public/testupload",
			type:"post",
			data:form,
			processData:false,
			contentType:false,
			success:function(data){
				window.clearInterval(timer);
				console.log("over..");
			},
			error:function(e){
				alert("错误!!");
				window.clearInterval(timer);
			}
		});
		get();//此处为上传文件的进度条
	}

就是这么简单,使用FormData,在构造这个对象的时候,把表单的对象,作为一个参数放进去,就可以了,然后FormData,就会得到这个表单对象里面的所有的参数,甚至我们在表单中,都不需要声明enctype =”multipart/form-data” ,就可以直接提交。

使用FormData,第一是在提交表单的时候,不需要写大量的js来获得表单数据,直接把表单对象构造就行了。第二就是可以直接异步上传文件,简单牛逼爆了!

注意:使用FormData提交的时候,大家会注意到表单提交的是request payload,具体有兴趣的同学可以自己百度,它不是之前的Form data提交的,所以后台也是要经过处理的,比如springMVC就需要配置

<!-- 配置nultipartresolver,注意:id名必须这样写,不然会报错 -->

不然会接收不到数据,当然,后台的话,我们这里就先不管。

方法二:使用jquery.form.js

Jquery.form.js是一个强大的表单插件,其大量的提供了表单操作的各种简便的方法,下面给出一些Jquery.form.js的说明:

ajaxForm 增加所有需要的事件监听器,为ajax提交表单做准备。ajaxForm并不能提交表单。在document的ready函数中,使用ajaxForm来为ajax提交表单进行准备。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个Options对象。 $("#formid").ajaxForm();
ajaxSubmit 使用ajax提交表单。 接受0个或1个参数。参数可以是一个回调函数,也可以是一个Options对象。 $("#formid").ajaxSubmit(); 或 $("#formid").submit(function(){ $(this).ajaxSubmit(); return false; });
formSerialize 将表单串行化(或序列化)为一个查询字符串。这个方法将返回以下格式的字符串:name1=value1&name2=value2。 $("#formid").formSerialize();
fieldSerialize 将表单的字段元素串行化(或序列化)为一个查询字符串。当只有部分表单字段需要进行串行化(或序列化)时,使用这个就很方便了。返回以下格式的字符串:name=value1&name2=value2。 $("#formid .specialFields").fieldSerialize();
fieldValue 返回匹配插入数组中的表单元素值。该方法以数组的形式返回数据。如果元素值被判定可能无效,则数组为空。 $("#formid :password").fieldValue();
resetForm 将表单恢复到初始状态。 $("#formid").resetForm();
clearForm 清除表单元素。该方法将所有的text、password、textarea置空,清除select元素中的选定,以及所有radio按钮和checkbox按钮重置为非选定状态。 $("#formid").clearForm();
clearFields 清除字段元素。只有部分表单元素需要清除时方便使用。 $("#formid .specialFields").clearFields();
Options对象

ajaxForm和ajaxSubmit都支持众多的选项参数,这些选项参数可以使用一个Options对象来提供。

target 指明页面中由服务器响应进行更新的元素。元素的值可能被指定为一个jQuery选择器字符串、一个jquery对象、一个DOM元素。 默认值:null
url 指定提交表单数据的URL。 默认值:表单的action属性值
type 指定提交表单数据的方法(method):“GET”或“POST”。 默认值:GET
beforeSubmit 表单提交前被调用的回调函数。如果回调函数返回false表单将不被提交。回调函数带三个调用参数:数组形式的表单数据,jQuery表单对象,以及传入ajaxForm/ajaxSubmit中的Options对象。 默认值:null
success 表单成功提交后调用的回调函数。然后dataType选项值决定传回responseText还是responseXML的值。 默认值:null
dataType 返回的数据类型:null、"xml"、"script"、"json"其中之一。 默认值:null
resetForm 表示如果表单提交成功是否进行重置。 默认值:null
clearForm 表示如果表单提交成功是否清除表单数据。 默认值:null

那么现在来说一些它的主要用法吧!

它也支持对一个表单的ajax提交,而且提交方式更为简便,如下:

	<form id="tf"><input type="file" name="img" />
	<input type="text" name="username" />
	<input onclick="test();" type="button" value="提" /></form>

下面使用jquery.form.js的表单插件来提交表单

	$("#tf").ajaxSubmit();

额,就是这么简单,你也不要问我为什么就是这么简单,然后它就是会把整个表单,作为一个ajax来提交,同样的,它也支持文件上传!一些其它的用法,请参照前面给出的说明就可以了!

转自http://www.cnblogs.com/zhuxiaojie/p/4783939.html