DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 + WebSocket 實現多文件並發上傳實例
編輯:HTML5教程     

在傳統 HTTP 應用裡,想同時上傳多個文件並實時看到每個文件的進度,是一件頗為頭疼的事。早年我們只能依賴基於 SWF 的上傳組件。到了 HTML5 時代,文件讀取與上傳控制變得靈活得多:File API 提供了一系列讀取能力,連「只取文件的某一小塊」這種操作都很方便,再配合 WebSocket 做通道,整套方案就變得既輕快又可擴展。本文用 HTML5 結合 WebSocket,做一個多文件同時上傳的最小可用示例。

功能目標

用戶把文件直接拖進網頁即可開始上傳,上傳過程中實時展示每個文件的進度信息。

封裝 FileInfo 類

為了方便讀取和管理文件信息,在原生 File 基礎上封裝了一個簡單的包裝類。

function FileInfo(file, pagesize) {
  this.Size = file.size;
  this.File = file;
  this.FileType = file.type;
  this.FileName = file.name;
  this.PageSize = pagesize;
  this.PageIndex = 0;
  this.Pages = 0;
  this.UploadError = null;
  this.UploadProcess = null;
  this.DataBuffer = null;
  this.UploadBytes = 0;
  this.ID = Math.floor(Math.random() * 0x10000).toString(16);
  this.LoadCallBack = null;

  if (Math.floor(this.Size % this.PageSize) > 0) {
    this.Pages = Math.floor((this.Size / this.PageSize)) + 1;
  } else {
    this.Pages = Math.floor(this.Size / this.PageSize);
  }
}

FileInfo.prototype.Reset = function () {
  this.PageIndex = 0;
  this.UploadBytes = 0;
};

FileInfo.prototype.toBase64String = function () {
  var binary = ''
  var bytes = new Uint8Array(this.DataBuffer)
  var len = bytes.byteLength;
  for (var i = 0; i < len; i++) {
    binary += String.fromCharCode(bytes[i])
  }
  return window.btoa(binary);
};

FileInfo.prototype.OnLoadData = function (evt) {
  var obj = evt.target["tag"];
  if (evt.target.readyState == FileReader.DONE) {
    obj.DataBuffer = evt.target.result;
    if (obj.LoadCallBack != null) obj.LoadCallBack(obj);
  } else {
    if (obj.UploadError != null) obj.UploadError(fi, evt.target.error);
  }
};

FileInfo.prototype.Load = function (completed) {
  this.LoadCallBack = completed;
  if (this.filereader == null || this.filereader == undefined) {
    this.filereader = new FileReader();
  }
  var reader = this.filereader;
  reader["tag"] = this;
  reader.onloadend = this.OnLoadData;

  var count = this.Size - this.PageIndex * this.PageSize;
  if (count > this.PageSize) count = this.PageSize;
  this.UploadBytes += count;

  var blob = this.File.slice(this.PageIndex * this.PageSize,
                             this.PageIndex * this.PageSize + count);
  reader.readAsArrayBuffer(blob);
};

FileInfo.prototype.OnUploadData = function (file) {
  var channel = file._channel;
  var url = file._url;
  channel.Send({
    url: url,
    parameters: {
      FileID: file.ID,
      PageIndex: file.PageIndex,
      Pages: file.Pages,
      Base64Data: file.toBase64String()
    }
  }, function (result) {
    if (result.status == null || result.status == undefined) {
      file.PageIndex++;
      if (file.UploadProcess != null) file.UploadProcess(file);
      if (file.PageIndex < file.Pages) {
        file.Load(file.OnUploadData);
      }
    } else {
      if (file.UploadError != null) file.UploadError(file, data.status);
    }
  });
};

FileInfo.prototype.Upload = function (channel, url) {
  var fi = this;
  channel.Send({
    url: url,
    parameters: {
      FileName: fi.FileName,
      Size: fi.Size,
      FileID: fi.ID
    }
  }, function (result) {
    if (result.status == null || result.status == undefined) {
      fi._channel = channel;
      fi._url = result.data;
      fi.Load(fi.OnUploadData);
    } else {
      if (file.UploadError != null) file.UploadError(fi, result.status);
    }
  });
}

這個類的職責很清晰:通過 file 初始化並指定分塊大小,算出總頁數、頁大小等元信息;最重要的部分是封裝了 Upload 方法,負責把文件塊轉成 base64 後通過 WebSocket 送達服務器,並在每塊成功後遞歸地繼續下一塊。

文件拖放

在 HTML5 中接收系統拖放進來的文件並不需要複雜的處理,只要給容器元素綁定相關事件即可。

function onDragEnter(e) {
  e.stopPropagation();
  e.preventDefault();
}
function onDragOver(e) {
  e.stopPropagation();
  e.preventDefault();
  $(dropbox).addClass('rounded');
}
function onDragLeave(e) {
  e.stopPropagation();
  e.preventDefault();
  $(dropbox).removeClass('rounded');
}
function onDrop(e) {
  e.stopPropagation();
  e.preventDefault();
  $(dropbox).removeClass('rounded');
  var readFileSize = 0;
  var files = e.dataTransfer.files;
  if (files.length > 0) {
    onFileOpen(files);
  }
}

只需在 onDrop 過程中取出拖放的文件列表,拿到 File 對象後為每個文件構建 FileInfo 實例並調用上傳方法:

function onFileOpen(files) {
  if (files.length > 0) {
    for (var i = 0; i < files.length; i++) {
      var info = new FileInfo(files[i], 32768);
      uploads.push(info);
      info.UploadProcess = onUploadProcess;
      addUploadItem(info);
    }
  }
}

通過 UploadProcess 回調即時刷新進度條:

function onUploadProcess(file) {
  $('#p_' + file.ID).progressbar({
    value: (file.PageIndex / file.Pages) * 100,
    text: file.FileName + '[' + file.UploadBytes + '/' + file.Size + ']'
  });
}

C# 服務端

借助 Beetle 對 WebSocket 的支持,服務端實現非常精簡:

/// <summary>
/// Copyright © henryfan 2012
/// CreateTime: 2012/12/14 21:13:34
/// </summary>
public class Handler
{
    public void UploadPackage(string FileID, int PageIndex, int Pages, string Base64Data)
    {
        Console.WriteLine("FileID:{2},PageIndex:{0} Pages:{1} DataLength:{3}",
            PageIndex, Pages, FileID, Base64Data.Length);
    }

    public string UploadFile(string FileID, string FileName, long Size)
    {
        Console.WriteLine("FileID:{2},FileName:{0} Size:{1}", FileName, Size, FileID);
        return "Handler.UploadPackage";
    }
}

兩個方法各司其職:一個處理上傳文件的初始化請求並返回後續接收分片的目標地址,另一個負責接收具體的文件塊。

總結與取捨

以上這些代碼就足以支撐多文件並發上傳了。此處採用 JSON 傳遞上傳信息,因此文件流需要先做 base64 編碼。要留意的是,WebSocket 傳送的數據本身通常已有 MASK 處理,再疊加一層 base64,開銷相對偏重。實際上 WebSocket 提供了流的數據包格式(arraybuffer),採用它可以省下這部分損耗,只是在編程便利性上不如 JSON 來得直觀——這是一個典型的「性能 vs 開發效率」取捨,需要依具體場景決定。

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