經過Ajax方式上傳文件,使用FormData進行Ajax請求

經過傳統的form表單提交的方式上傳文件:

 

[html]  view plain  copy
 
 在CODE上查看代碼片派生到個人代碼片
  1. <form id= "uploadForm" action= "http://localhost:8080/cfJAX_RS/rest/file/upload" method= "post" enctype ="multipart/form-data">    
  2.      <h1 >測試經過Rest接口上傳文件 </h1>    
  3.      <>指定文件名: <input type ="text" name="filename" /></p>    
  4.      <>上傳文件: <input type ="file" name="file" /></p>    
  5.      <>關鍵字1: <input type ="text" name="keyword" /></p>    
  6.      <>關鍵字2: <input type ="text" name="keyword" /></p>    
  7.      <>關鍵字3: <input type ="text" name="keyword" /></p>    
  8.      <input type ="submit" value="上傳"/>    
  9. </form>    


不過傳統的form表單提交會致使頁面刷新,可是在有些狀況下,咱們不但願頁面被刷新,這種時候咱們都是使用Ajax的方式進行請求的。javascript

 

 

Ajax的方式進行請求:

 

[javascript]  view plain  copy
 
 在CODE上查看代碼片派生到個人代碼片
  1. $.ajax({    
  2.      url : "http://localhost:8080/STS/rest/user",    
  3.      type : "POST",    
  4.      data : $( '#postForm').serialize(),    
  5.      success : function(data) {    
  6.           $( '#serverResponse').html(data);    
  7.      },    
  8.      error : function(data) {    
  9.           $( '#serverResponse').html(data.status + " : " + data.statusText + " : " + data.responseText);    
  10.      }    
  11. });   


一般咱們提交(使用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的最大優勢就是咱們能夠異步上傳一個二進制文件. 
 
全部主流瀏覽器的較新版本都已經支持這個對象了,好比Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+。
 
參見: https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest/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); // "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

 

 

 

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">裏添加multiplemultiple="multiple"屬性。

 

 

3.服務器端讀文件

 

Servlet 3.0 開始,能夠經過 request.getPart() 或 request.getPars() 兩個接口獲取上傳的文件。

相關文章
相關標籤/搜索