所謂 Ajax 上傳,說穿了仍舊是 form 表單提交,只是在頁面上放一個隱藏 iframe,讓提交結果跳進 iframe 裡,造成「頁面沒有刷新」的錯覺。
以前處理上傳基本都用 commons-fileupload 元件,步驟是:servlet 處理完上傳後,用 PrintWriter 輸出顯示內容。輸出方式有兩種,一是直接吐字串:
response.getWriter().write("上傳成功!");
二是直接吐一段 script 去操作父頁面:
response.getWriter().write( "<script type=\"text/javascript\">parent.item_update.uploadUponSize();</script>" );
這兩種做法都把「對頁面的操作」封裝進了 servlet 裡。問題是,如果這個專案你碰不到伺服器端程式碼——對方只回傳一個標誌位,剩下的要你自己在前端處理——那又該怎麼辦?
關鍵在於:form 提交到 iframe 時,iframe 會觸發一個 load 事件。於是流程變成:
1. 表單提交時,先給 iframe 註冊 load 事件。
2. 在事件裡用 JS 讀取 iframe 內的內容,判斷那個標誌位並做對應操作。
3. 處理完立刻解除綁定,避免下次提交時事件被重複註冊、導致回呼被觸發多次。
package com.justsy.servlet;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class UploadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
this.doPost(request, response);
}
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
PrintWriter writer = response.getWriter();
response.setContentType("text/html");
writer.print("<root>ok</root>");
}
}
function submitForm(){
$("#hidden_iframe").load(function(){
var content = document.getElementById("hidden_iframe")
.contentWindow.document.body.innerHTML;
content = createXml(content);
var root = $(content).find("root").eq(0);
alert(root.text());
$("#hidden_iframe").unbind("load"); // 處理完就解除綁定
});
document.getElementById("form2").submit();
}
// 把 iframe 裡的字串解析成 XML 文件
function createXml(str){
if (document.all) {
var xmlDom = new ActiveXObject("Microsoft.XMLDOM");
xmlDom.loadXML(str);
return xmlDom;
} else {
return new DOMParser().parseFromString(str, "text/xml");
}
}
<form action="uploadServlet.do" id="form2" enctype="multipart/form-data"
method="post" target="hidden_iframe">
<input type="hidden" name="method" value="uploadExcel" />
<input type="button" value="Submit" onclick="submitForm()" />
</form>
<iframe name="hidden_iframe" id="hidden_iframe" width="300" height="200"></iframe>
如此一來,就能依伺服器回傳的內容決定前端要做什麼了。
第一,記得 unbind。這是這個模式最常被忽略的一點:如果每次提交都重新 load 一次而從不解除,回呼會層層疊加,一次上傳觸發十次處理。用 $("#hidden_iframe").one("load", handler) 也能達到同樣效果,而且更直觀。
第二,iframe 若不設定 display:none,會佔掉版面。實務上通常給它 style="display:none";但要注意某些舊版瀏覽器對隱藏 iframe 的提交行為有差異,必要時改用 position 移出視線範圍而非 display。
當然,如果環境允許,用 FormData 搭配 XHR 才是真正的 Ajax 上傳——能拿到進度事件、不必依賴 iframe 這類取巧手法。