經過傳統的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()
兩個接口獲取上傳的文件。