通過Ajax方式上傳文件，使用FormData進行Ajax請求

通過傳統的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代碼

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