经过传统的form表单提交的方式上传文件:
- <form id= "uploadForm" action= "http://localhost:8080/cfJAX_RS/rest/file/upload" method= "post" enctype ="multipart/form-data">
- <h1 >测试经过Rest接口上传文件 </h1>
- <p >指定文件名: <input type ="text" name="filename" /></p>
- <p >上传文件: <input type ="file" name="file" /></p>
- <p >关键字1: <input type ="text" name="keyword" /></p>
- <p >关键字2: <input type ="text" name="keyword" /></p>
- <p >关键字3: <input type ="text" name="keyword" /></p>
- <input type ="submit" value="上传"/>
- </form>
不过传统的form表单提交会致使页面刷新,可是在有些状况下,咱们不但愿页面被刷新,这种时候咱们都是使用Ajax的方式进行请求的。javascript
Ajax的方式进行请求:
- $.ajax({
- url : "http://localhost:8080/STS/rest/user",
- type : "POST",
- data : $( '#postForm').serialize(),
- success : function(data) {
- $( '#serverResponse').html(data);
- },
- error : function(data) {
- $( '#serverResponse').html(data.status + " : " + data.statusText + " : " + data.responseText);
- }
- });
一般咱们提交(使用submit button)时,会把form中的全部表格元素的name与value组成一个queryString,提交到后台。这用jQuery的方法来讲,就是serialize。html
经过$('#postForm').serialize()能够对form表单进行序列化,从而将form表单中的全部参数传递到服务端。
可是上述方式,只能传递通常的参数,上传文件的文件流是没法被序列化并传递的。
不过现在主流浏览器都开始支持一个叫作FormData的对象,有了这个FormData,咱们就能够轻松地使用Ajax方式进行文件上传了。
关于FormData及其用法
FormData是什么呢?咱们来看看Mozilla上的介绍。
XMLHttpRequest Level 2添加了一个新的接口
FormData .利用
FormData对象 ,咱们能够经过JavaScript用一些键值对来模拟一系列表单控件,咱们还可使用XMLHttpRequest的
send() 方法来异步的提交这个"表单".比起普通的ajax,使用
FormData 的最大优势就是咱们能够异步上传一个二进制文件.
|
Constructorjava
FormData()ajax
想获得一个FormData对象:segmentfault
var formdata = new FormData(); |
W3c草案提供了三种方案来获取或修改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方法生成它!app
var formobj = document.getElementById( "form" ); |
var formdata = formobj.getFormData() |
Method
FormData.append
本方法用于向已存在的键添加新的值,如该键不存在,新建之。异步
语法
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.delete
将一对键和值从 FormData 对象中删除。
formData.delete(username);
FormData.get
返回给定键的第一个值
formData.append('username', 'Justin'); formData.append('username', 'Chris'); formData.get(username);
FormData.getAll
返回给定键的全部值
formData.append('username', 'Justin'); formData.append('username', 'Chris'); formData.getAll(username);
FormData.has
检查是否包含给定键,返回 true
或 false
formData.has(username);
FormData.set
设置给定键的值
formData.set(name, value);
formData.set(name, value, filename);
浏览器兼容状况
来自 MDN:
Desktop
Feature |
Chrome |
Firfox(Gecko) |
Intenet Explorer |
Opera |
Safari |
Basic support |
7+ |
4.0(2.0) |
10+ |
12+ |
5+ |
append with filename |
(Yes) |
22.0(22.0) |
? |
? |
? |
delete, get, getAll, has, set |
Behind Flag |
Not supported |
Not supported |
(Yes) |
Not supported |
Mobile
Feature |
Android |
Chrome Android |
Firfox Mobile (Gecko) |
Firfox OS (Gecko) |
IE Mobile |
Opera Mobile |
Safari Mobile |
Basic support |
3.0 |
? |
4.0(2.0) |
1.0.1 |
? |
12+ |
? |
append with filename |
? |
? |
22.0(22.0) |
1.2 |
? |
? |
? |
delete, get, getAll, has, set |
(Yes) |
(Yes) |
Not supported |
Not supported |
Not supported |
(Yes) |
Not supported |
Ajax经过FormData上传文件
1.使用<form>表单初始化FormData对象方式上传文件
HTML代码
<form id="uploadForm" enctype="multipart/form-data"> <input id="file" type="file" name="file"/> <button id="upload" type="button">upload</button> </form>
javascript代码
$.ajax({
url: '/upload', type: 'POST', cache: false, data: new FormData($('#uploadForm')[0]), processData: false, contentType: false }).done(function(res) { }).fail(function(res) {});
这里要注意几点:
processData
设置为false
。由于data
值是FormData
对象,不须要对数据作处理。
<form>
标签添加enctype="multipart/form-data"
属性。
cache
设置为false
,上传文件不须要缓存。
contentType
设置为false,不设置contentType值,
由于是由<form>
表单构造的FormData
对象,且已经声明了属性enctype="multipart/form-data"
,因此这里设置为false。
上传后,服务器端代码须要使用从查询参数名为file
获取文件输入流对象,由于<input>
中声明的是name="file"
。
若是不是用<form>
表单构造FormData
对象又该怎么作呢?
2.使用FormData对象添加字段方式上传文件
HTML代码
<div id="uploadForm"> <input id="file" type="file"/> <button id="upload" type="button">upload</button> </div>
这里没有<form>
标签,也没有enctype="multipart/form-data"
属性。
javascript代码
var formData = new FormData(); 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]
中能够看到一个<input type="file">
标签可以上传多个文件,
只须要在<input type="file">
里添加multiple
或multiple="multiple"
属性。
3.服务器端读文件
从Servlet 3.0
开始,能够经过 request.getPart()
或 request.getPars()
两个接口获取上传的文件。