DIV CSS 佈局教程網

JavaScript 大文件分段上傳的兩種實現思路
編輯:關於JavaScript     

大文件上傳最怕的就是一條請求傳到底:中途斷網就得從頭再來,進度條也不好做。分段(分片)上傳的解法是把文件切成若干塊依次上報,服務端再拼接起來。本文整理兩種純前端實現方式。

一、基於 slice 的手動分段上傳

HTML 結構

<form method="POST" name="form" action="/mupload/upload/" enctype="multipart/form-data">
<input type='hidden' name='csrfmiddlewaretoken' value='' />
<input id='file' type='file' name='file' onchange="" />
<input id='button' name='submit' type='button' value="上傳" onclick="chunk_upload(this)" />
</form>

JavaScript 實現

var fileSplitSize = 1024 * 1024; // 每片 1MB
var start = 0, end = 0;
var i = 0;

function chunk_upload(button) {
    var xmlhttp = new XMLHttpRequest();
    xmlhttp.open("POST", "/chunk_upload/upload/", false);
    xmlhttp.setRequestHeader("X-CSRFToken", button.form['csrfmiddlewaretoken'].value);

    var f = button.form;
    var file = f['file']['files'][0];
    var size = file.size;

    end = start + fileSplitSize;
    if (end > size) {
        i = -1;
        end = size;
    } else {
        i += 1;
    }

    // 按大小切割文件片段
    var blob = file.slice(start, end);

    xmlhttp.setRequestHeader('charset', 'utf-8');
    xmlhttp.setRequestHeader("start", start);
    xmlhttp.setRequestHeader("end", end);
    xmlhttp.send(blob);

    if (xmlhttp.status == 200) {
        if (end == size) {
            alert(xmlhttp.responseText);
        } else {
            alert("上傳完成第 " + i + " 段");
            start = end;
            chunk_upload(button); // 遞歸上傳下一段
        }
    } else {
        alert("上傳錯誤");
        chunk_upload(button);
    }
}

核心要點

整個流程可以概括為五步:

  1. 確定切割起點 start 與片段大小,用 file.slice(start, end) 取出 Blob;
  2. 通過 XMLHttpRequest 發送請求,把 start、end 這類標記信息放進請求頭:xmlhttp.setRequestHeader("end", end);
  3. 用 send(blob) 發送協議體;
  4. 監聽返回狀態碼判斷本片是否成功,再決定下一步;
  5. 更新切割位置並遞歸調用自身:start = end; chunk_upload(button);

最需要小心的是 start、end 與 file.size 三者的大小關係:end 必須以 size 為上限截斷,否則最後一片會越界。

二、封裝成通用異步上傳函數(帶進度回調)

如果不想手動管理分片,可以直接用 FormData 上傳整個文件,同時借助 upload.onprogress 匯報進度。下面把它封裝成一個可複用的函數:

;(function (window, document) {
    var myUpload = function (option) {
        var file,
            fd = new FormData(),
            xhr = new XMLHttpRequest(),
            loaded, tot, per, uploadUrl, input;

        input = document.createElement("input");
        input.setAttribute('id', "myUpload-input");
        input.setAttribute('type', "file");
        input.setAttribute('name', "files");
        input.click();

        uploadUrl = option.uploadUrl;
        callback = option.callback;
        uploading = option.uploading;
        beforeSend = option.beforeSend;

        input.onchange = function () {
            file = input.files[0];

            // 可在發送前做文件校驗
            if (beforeSend instanceof Function) {
                if (beforeSend(file) === false) { return false; }
            }

            fd.append("files", file);

            xhr.onreadystatechange = function () {
                if (xhr.readyState == 4 && xhr.status == 200) {
                    if (callback instanceof Function) {
                        callback(xhr.responseText);
                    }
                }
            };

            // 偵查當前附件上傳情況,約 0.05~0.1 秒回調一次
            xhr.upload.onprogress = function (evt) {
                loaded = evt.loaded;
                tot = evt.total;
                per = Math.floor(100 * loaded / tot);
                if (uploading instanceof Function) { uploading(per); }
            };

            xhr.open("post", uploadUrl);
            xhr.send(fd);
        };
    };

    window.myUpload = myUpload;
})(window, document);

// 用法
myUpload({
    uploadUrl: "/async/myUpload.php", // 接收文件的地址
    // 選擇文件後、發送前的自定義邏輯,可用於校驗與初始化進度條
    beforeSend: function (file) {},
    // 上傳完成回調
    callback: function (res) {},
    // 上傳過程中的進度(已上傳百分比)
    uploading: function (per) {}
});

兩種方案的取捨

分段上傳的優勢在於可續傳、可並發、便於做真正的進度與斷點恢復,代價是服務端需要提供合併接口,並妥善處理分片順序與暫存清理。

FormData 整體上傳則簡單得多,配合 onprogress 就能畫出可信的進度條,適合中小文件。需要注意的是 xhr.upload.onprogress 只在 upload 對象上觸發,很多人誤把它掛在 xhr 上,結果進度條一直不動。

實際項目中常見的做法是:先按大小設定閾值,小文件直接整體上傳,超過閾值才切換到分片模式,兼顧簡單與可靠。

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