瀏覽器的檔案上傳,特別是透過 <input type="file"> 這種傳統方式,一直有嚴重的體驗問題:使用者按下送出之後,檔案在傳輸途中畫面看起來就像當機一樣,完全沒有回饋。小檔案還能忍受,一旦要傳的是幾 MB、幾十 MB 甚至上百 MB 的檔案,那段空白時間就非常煎熬。
本文要做的,是一個具備監控能力的 WEB 上傳程式——它不只把檔案送到伺服器,還能「即時地」監視整個上傳過程。
先看一下程式執行的畫面:

這個類別負責記錄上傳狀態,同時作為伺服器端與用戶端溝通的媒介:伺服器把狀態物件序列化後回傳,用戶端再以 JavaScript 取用。它記錄了上傳位址、上傳總量、已讀取量、目前檔案序號、成功檔案數、狀態文字、起訖時間與耗時、檔案 URL 清單、是否取消,以及 base 目錄。
最關鍵的是 toJSon() 方法,它把上述欄位拼成一個 JSON 字串,讓前端可以直接 eval 或解析使用:
public String toJSon() {
StringBuffer strJSon = new StringBuffer();
strJSon.append("{UploadTotalSize:").append(getUploadTotalSize()).append(",")
.append("ReadTotalSize:").append(getReadTotalSize()).append(",")
.append("CurrentUploadFileNum:").append(getCurrentUploadFileNum()).append(",")
.append("SuccessUploadFileCount:").append(getSuccessUploadFileCount()).append(",")
.append("Status:'").append(getStatus()).append("',")
.append("ProcessStartTime:").append(getProcessStartTime()).append(",")
.append("ProcessEndTime:").append(getProcessEndTime()).append(",")
.append("ProcessRunningTime:").append(getProcessRunningTime()).append(",")
.append("Cancel:").append(getCancel()).append("}");
return strJSon.toString();
}
此範例使用 Common-FileUpload 1.2 版(20070103)。該版本提供了能監視上傳狀況的 ProgressListener 介面,開發者可透過 FileUploadBase 物件的 setProcessListener 方法植入自訂的 Listener。
FileUploadListener 實作 ProgressListener,在整個上傳過程中持續監控進度,並依上傳狀況即時更新狀態 Bean:
public class FileUploadListener implements ProgressListener {
private HttpServletRequest request = null;
public FileUploadListener(HttpServletRequest request) {
this.request = request;
}
/** 更新狀態 */
public void update(long pBytesRead, long pContentLength, int pItems) {
FileUploadStatus statusBean = BackGroundService.getStatusBean(request);
statusBean.setUploadTotalSize(pContentLength);
if (pContentLength == -1) {
// 讀取完成
statusBean.setStatus("完成對" + pItems + "個文件的讀取:讀取了 " + pBytesRead + " bytes.");
statusBean.setReadTotalSize(pBytesRead);
statusBean.setSuccessUploadFileCount(pItems);
statusBean.setProcessEndTime(System.currentTimeMillis());
statusBean.setProcessRunningTime(statusBean.getProcessEndTime());
} else {
// 讀取中
statusBean.setStatus("當前正在處理第" + pItems + "個文件:已經讀取了 "
+ pBytesRead + "/" + pContentLength + " bytes.");
statusBean.setReadTotalSize(pBytesRead);
statusBean.setCurrentUploadFileNum(pItems);
statusBean.setProcessRunningTime(System.currentTimeMillis());
}
BackGroundService.saveStatusBean(request, statusBean);
}
}
判斷邏輯很直白:pContentLength 為 -1 代表整批讀取結束,此時寫入完成時間與成功檔案數;否則就更新已讀位元組數與目前處理到第幾個檔案。兩個分支最後都會把狀態寫回 BackGroundService,供輪詢時取用。
下頁將接續說明 BackGroundService、BeanControler,以及 AjaxWrapper.js 與前端進度條的實作。