過去上傳檔案只能靠 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。
$.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 上傳檔案變得輕鬆許多。
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);
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 那類繞路技巧。