傳統的檔案上傳必須整頁刷新,使用者盯著瀏覽器進度條無事可做。非同步上傳把這個過程收進頁面裡,讓使用者能繼續填其他欄位,上傳完成後再收到通知。以下示範以 jquery.upload.js 串接後端的完整流程。
先載入 jQuery 與 upload 插件:
<script src="jquery-1.7.2.js"></script> <script src="jquery.upload.js"></script>
觸發器就是一個普通連結:
<a href="javascript:void(0)" onclick="doUpload()">上傳</a>
頁面底部放一個隱藏的 iframe:
<iframe style="position:absolute; top:-9999px"
src="<%=basePath%>/resources/upload/upload.htm"></iframe>
這個 iframe 是關鍵。在 FormData 與 XMLHttpRequest Level 2 普及之前,Ajax 本身無法傳送檔案,唯一的方法是把表單的 target 指向一個隱藏 iframe,藉由 iframe 的 onload 事件得知上傳何時結束。這正是這類老式上傳插件的核心手法。
/* 檔案上傳 */
function doUpload() {
$.upload({
// 上傳位址
url: window.basePath + '/reply/imageUpload',
// 檔案欄位名稱
fileName: 'uploadfile',
// 其他附帶的表單資料
params: {},
// 上傳完成後回傳的資料格式:json 或 text
dataType: 'json',
// 上傳前回呼,return true 表示繼續
onSend: function () {
return true;
},
onSubmit: function () {},
// 上傳後回呼
onComplate: function (data) {
if (data.msg) {
// 處理成功
} else {
alert("上傳圖片出錯!");
}
}
});
}
onSend 回傳 false 可以取消上傳,這是做前置檢查的好位置——例如檢查副檔名、檔案大小,或使用者是否已選擇檔案。
/**
* 圖片上傳至本地伺服器
*/
@RequestMapping(value = "imageUpload")
@ResponseBody
public Object imageUpload(HttpServletRequest request,
HttpServletResponse response) {
Map<String, Object> map = new HashMap<String, Object>();
UploadUtil uploadUtil = new UploadUtil();
try {
String url = uploadUtil.excelUpload(request, response);
// 將結果寫入 map 後回傳 JSON
} catch (IOException e) {
e.printStackTrace();
}
return map;
}
這裡有幾個明顯需要補強的地方。map 建立後從未填入任何值就回傳,前端收到的會是空物件;catch 區塊只印出堆疊而沒有回傳錯誤資訊,使用者只會看到「上傳出錯」而無從得知原因;方法名 excelUpload 出現在圖片上傳情境裡,推測是複製貼上的痕跡。實務上應回傳結構化的成功/失敗結果,例如 {success: true, url: "...", message: "..."}。
那段 iframe 存在的唯一理由,是歷史上的技術限制。今日所有瀏覽器都支援 FormData,上傳檔案只需要幾行:
<input type="file" id="fileInput">
<button id="btnUpload">上傳</button>
<script>
$("#btnUpload").on("click", function () {
var file = document.getElementById("fileInput").files[0];
if (!file) { return alert("請選擇檔案"); }
var fd = new FormData();
fd.append("uploadfile", file);
fd.append("otherField", "其他資料"); // 可同時夾帶一般欄位
$.ajax({
url: "/reply/imageUpload",
type: "POST",
data: fd,
processData: false, // 關鍵:不轉為字串
contentType: false, // 關鍵:讓瀏覽器自動補上 boundary
success: function (res) {
console.log(res);
},
error: function (xhr) {
alert("上傳失敗:" + xhr.status);
}
});
});
</script>
兩個關鍵設定務必記住:processData: false 避免 jQuery 把 FormData 序列化為查詢字串;contentType: false 讓瀏覽器自行填入 multipart/form-data; boundary=...——邊界字串必須由瀏覽器產生,手動指定反而會導致後端無法解析。
若需要進度條,改用原生 XMLHttpRequest 的 upload.onprogress:
var xhr = new XMLHttpRequest();
xhr.upload.addEventListener("progress", function (e) {
if (e.lengthComputable) {
var pct = Math.round((e.loaded / e.total) * 100);
$("#bar").css("width", pct + "%").text(pct + "%");
}
});
xhr.open("POST", "/reply/imageUpload");
xhr.send(fd);
jQuery 的 $.ajax() 直到 3.x 仍不直接支援上傳進度事件,這是少數必須回到原生的場景之一。
檔案上傳是常見的入侵入口,後端至少應做到:
../../etc/passwd 這類路徑穿越,也避免中文名稱造成的編碼問題)。