經過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對象：

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);

 

 

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