DIV CSS 佈局教程網

用 Ajax + JSP 做 WEB 上傳進度條(第 1/2 頁)
編輯:AJAX基礎知識     

本文結構

  1. 引言
  2. 實現代碼
    • 2.1 伺服器端:FileUploadStatus、FileUploadListener、BackGroundService、BeanControler
    • 2.2 客戶端:AjaxWrapper.js、fileUpload.html、result.jsp、fileUpload.css
    • 2.3 設定檔
  3. 結語

一、問題在哪裡

瀏覽器的檔案上傳,特別是透過 <input type="file"> 這種傳統方式,一直有嚴重的體驗問題:使用者按下送出之後,檔案在傳輸途中畫面看起來就像當機一樣,完全沒有回饋。小檔案還能忍受,一旦要傳的是幾 MB、幾十 MB 甚至上百 MB 的檔案,那段空白時間就非常煎熬。

本文要做的,是一個具備監控能力的 WEB 上傳程式——它不只把檔案送到伺服器,還能「即時地」監視整個上傳過程。

二、解法思路

  • 表單提交上傳檔案的同時,以 Ajax 週期性地向 Servlet 輪詢上傳狀態。
  • 依據取回的狀態更新進度條與相關文字,即時反映傳輸進度。
  • 若使用者中途取消,則執行清理:刪除已上傳的檔案,並在表單頁面顯示對應訊息。
  • 若上傳完成,則顯示已上傳檔案的內容或連結。

先看一下程式執行的畫面:

三、伺服器端實作

2.1.1 檔案上傳狀態類(FileUploadStatus)

這個類別負責記錄上傳狀態,同時作為伺服器端與用戶端溝通的媒介:伺服器把狀態物件序列化後回傳,用戶端再以 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();
}

2.1.2 檔案上傳狀態偵聽類(FileUploadListener)

此範例使用 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 與前端進度條的實作。

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