DIV CSS 佈局教程網

用 FormData 進行 Ajax 檔案上傳請求
編輯:AJAX基礎知識     

傳統表單上傳的限制

過去上傳檔案只能靠 form 表單提交:

 <form id="uploadForm" action="https://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>

問題是送出後頁面必然刷新。有些情況下我們並不希望如此,這時就得改用 Ajax。

為什麼 serialize() 不夠用

 $.ajax({
     url: "https://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);
     }
 });

$('#postForm').serialize() 確實能把表單中所有普通欄位序列化後送到後端,但檔案流無法被序列化,因此這條路走不通。

好消息是主流瀏覽器的新版本都支援 FormData 物件,有了它,Ajax 上傳檔案變得輕鬆許多。

關於 FormData

XMLHttpRequest Level 2 新增了 FormData 介面。利用它,我們可以用 JavaScript 以鍵值對的方式模擬一整組表單控制項,再透過 XHR 的 send() 非同步送出。相比普通 Ajax,最大的優點就是能非同步上傳二進位檔案。

支援情況大致為 Chrome 7+、Firefox 4+、IE 10+、Opera 12+、Safari 5+。

最簡單的用法是直接用既有的 form 元素初始化:

 <form enctype="multipart/form-data" method="post" name="fileinfo">
 var oData = new FormData(document.forms.namedItem("fileinfo"));
 oData.append("CustomField", "This is some extra data");   // 可再補欄位

 var oReq = new XMLHttpRequest();
 oReq.open("POST", "stash.php", true);
 oReq.onload = function (oEvent) {
     if (oReq.status == 200) {
         oOutput.innerHTML = "Uploaded!";
     } else {
         oOutput.innerHTML = "Error " + oReq.status + " occurred uploading your file.<br />";
     }
 };
 oReq.send(oData);

搭配 jQuery 的寫法

HTML 部分把送出改成按鈕觸發,避免表單預設行為:

 <form id="uploadForm">
<p>指定檔名:<input type="text" name="filename" value="" /></p>
<p>上傳檔案:<input type="file" name="file" /></p>
<input type="button" value="上傳" onclick="doUpload()" />
</form>

這裡有兩個參數務必注意:processData: false 避免 jQuery 把 FormData 轉成字串,contentType: false 則讓瀏覽器自行產生 multipart 的 boundary。少了這兩個設定,後端收到的會是一團無法解析的內容。另外建議使用 jQuery 2.0 以上版本。

 function doUpload() {
     var formData = new FormData($("#uploadForm")[0]);
     $.ajax({
         url: 'https://localhost:8080/cfJAX_RS/rest/file/upload',
         type: 'POST',
         data: formData,
         processData: false,   // 不處理資料
         contentType: false,   // 不設定 Content-Type,交由瀏覽器決定
         cache: false,
         success: function (returndata) {
             alert(returndata);
         },
         error: function (returndata) {
             alert(returndata);
         }
     });
 }

掌握 FormData 與這兩個參數,Ajax 上傳檔案就不再需要 iframe 那類繞路技巧。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved