XMLHttpRequest Level 2添加了一个新的接口FormData.利用FormData对象,我们可以通过JavaScript用一些键值对来模拟一系列表单控件,我们还可以使用XMLHttpRequest的send()方法来异步的提交这个"表单".比起普通的ajax,使用FormData的最大优点就是我们可以异步上传一个二进制文件
想得到一个FormData对象:
var formdata = new FormData();
方案1:创建一个空的FormData对象,然后再用append方法逐个添加键值对:
var formdata = new FormData();
formdata.append("name", "呵呵");
formdata.append("url", "http://www.baidu.com/");
方案2:取得form元素对象,将它作为参数传入FormData对象中!
var formobj = document.getElementById("form");
var formdata = new FormData(formobj);
方案3:利用form元素对象的getFormData方法生成它!
var formobj = document.getElementById("form");
var formdata = formobj.getFormData()
Method
本方法用于向已存在的键添加新的值,如该键不存在,新建之。
语法
formData.append(name, value);
formData.append(name, value, filename);
注:通过FormData.append()方法赋给字段的值若是数字会被自动转换为字符(字段的值可以是一个Blob对象,一个File对象,或者一个字符串,剩下其他类型的值都会被自动转换成字符串).
参数解释
name
键 (key), 对应表单域
value
表单域的值
filename (optional)
The filename reported to the server (a USVString), when a Blob or File is passed as the second parameter. The default filename for Blob objects is "blob".
将一对键和值从FormData对象中删除。
formData.delete(username);
返回给定键的第一个值
formData.append('username','Justin');formData.append('username','Chris');formData.get(username);// "Justin"
返回给定键的所有值
formData.append('username','Justin');formData.append('username','Chris');formData.getAll(username);// ["Justin", "Chris"]
检查是否包含给定键,返回true或false
formData.has(username);
设置给定键的值
formData.set(name, value);
formData.set(name, value, filename);
Ajax通过FormData上传文件
HTML代码
upload
javascript代码
$.ajax({ url:'/upload', type:'POST', cache:false, data:newFormData($('#uploadForm')[0]), processData:false, contentType:false}).done(function(res){}).fail(function(res){});
这里要注意几点:
processData设置为false。因为data值是FormData对象,不需要对数据做处理。
标签添加enctype="multipart/form-data"属性。
cache设置为false,上传文件不需要缓存。
contentType设置为false,不设置contentType值,因为是由表单构造的FormData对象,且已经声明了属性enctype="multipart/form-data",所以这里设置为false。
上传后,服务器端代码需要使用从查询参数名为file获取文件输入流对象,因为中声明的是name="file"。
如果不是用表单构造FormData对象又该怎么做呢?
2.使用FormData对象添加字段方式上传文件
HTML代码
upload
这里没有标签,也没有enctype="multipart/form-data"属性。
javascript代码
varformData =newFormData();formData.append('file', $('#file')[0].files[0]);$.ajax({ url:'/upload', type:'POST', cache:false, data: formData, processData:false, contentType:false}).done(function(res){}).fail(function(res){});
这里有几处不一样:
append()的第二个参数应是文件对象,即$('#file')[0].files[0]。
contentType也要设置为‘false’。
从代码$('#file')[0].files[0]中可以看到一个标签能够上传多个文件,
只需要在里添加multiple或multiple="multiple"属性。
从Servlet 3.0开始,可以通过request.getPart()或request.getPars()两个接口获取上传的文件。