通過傳統的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的方式進行請求的。
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。
通過 $( '#postForm' ).serialize() 可以對form表單進行序列化,從而將form表單中的所有參數傳遞到服務端。 但是上述方式,只能傳遞一般的參數, 上傳檔案的檔案流是無法被序列化並傳遞的。 不過如今主流瀏覽器都開始支援一個叫做FormData的對象,有了這個FormData,我們就可以輕鬆地使用Ajax方式進行檔案 上傳 了。
關於FormData及其用法 FormData是什麼呢。我們來看看Mozilla上的介紹。
XMLHttpRequest Level 2添加了一個新的介面 FormData.利用 FormData對象,我們可以通過JavaScript用一些索引值對來類比一系列表單控制項,我們還可以使用XMLHttpRequest的 send()方法來非同步提交這個"表單".比起普通的ajax,使用 FormData的最大優點就是我們可以非同步上傳一個二進位檔案. 所有主流瀏覽器的較新版本都已經支援這個對象了,比如Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+。 參見: https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest/FormData |
Constructor
FormData()
想得到一個FormData對象:
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方法產生它。
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); // "Justin"
FormData.getAll
返回給定鍵的所有值
formData.append('username', 'Justin');formData.append('username', 'Chris');formData.getAll(username); // ["Justin", "Chris"]
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 |
2015年06月04日發布
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代碼
<