DIV CSS 佈局教程網

用 jquery.upload.js 實作非同步檔案上傳:前端與後端完整串接
編輯:JQuery特效代碼     

傳統的檔案上傳必須整頁刷新,使用者盯著瀏覽器進度條無事可做。非同步上傳把這個過程收進頁面裡,讓使用者能繼續填其他欄位,上傳完成後再收到通知。以下示範以 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 事件得知上傳何時結束。這正是這類老式上傳插件的核心手法。

二、JavaScript

/* 檔案上傳 */
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 可以取消上傳,這是做前置檢查的好位置——例如檢查副檔名、檔案大小,或使用者是否已選擇檔案。

三、後端(Spring MVC)

/**
 * 圖片上傳至本地伺服器
 */
@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: "..."}。

現代做法:直接用 FormData

那段 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 仍不直接支援上傳進度事件,這是少數必須回到原生的場景之一。

安全性提醒

檔案上傳是常見的入侵入口,後端至少應做到:

  • 副檔名與 MIME 雙重驗證,且採用白名單。只看副檔名或只看 Content-Type 都可被偽造。
  • 重新命名儲存檔案,不要沿用使用者提供的檔名(避免 ../../etc/passwd 這類路徑穿越,也避免中文名稱造成的編碼問題)。
  • 儲存位置不可執行,或至少讓上傳目錄無執行權限,否則上傳一個 .aspx/.jsp 就等於給出了遠端執行能力。
  • 限制大小與數量,防止有心人士用大檔案塞滿磁碟。
  • 前端檢查只是體驗優化,任何繞過前端直送 API 的攻擊都不受你的 JS 規範,所有驗證都必須在伺服器端重做一遍。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved