MVC5:使用Ajax和HTML5实现文件上传功能

引言

在实际编程中,经常遇到实现文件上传并显示上传进度的功能,基于此目的,本文就为大家介绍不使用flash 或任何上传文件的插件来实现带有进度显示的文件上传功能。

基本功能:实现带有进度条的文件上传功能

高级功能:通过拖拽文件的操作实现多个文件上传功能

背景

HTML5提供了一种标准的访问本地文件的方法——File API规格说明,通过调用File API 能够访问文件信息,也可以利用客户端来验证上传文件的类型和大小是否规范。

该规格说明包含以下几个接口来使用文件:

File接口:具有文件的“读权限”,可以获取文件名,类型,大小等。

FileList接口:指单独选定的文件列表,可以通过<input type="file">或拖拽呈现在用户界面供用户选择。

XMLHTTPRequest2是HTML5的无名英雄,XHR2与XMLHttpRequest大体相同,但同时也添加了很多新功能,如下:

1. 增加了上传/下载二进制数据

2. 增加了上传过程中Progess (进度条)事件,该事件包含多部分的信息:

  • Total:整型值,用于指定传输数据的总字节数。
  • Loaded:整型值,用于指定上传的字节。
  • lengthComputable:Bool值用于检测上传文件大小是否可计算。

3. 跨资源共享请求

这些新特性都使得Ajax和HTML5很好的协作,让文件上传变得非常简单,不再需要使用Flash Player、外部插件或html的<form>标签就可以完成,根据服务器端就可以显示上传进度条。

本文会编写一个小型应用程序,能够实现以下功能:

  • 上传单个文件,提供上传进度信息显示。
  • 将图片发送到服务器时,创建图像缩略图。
  • 通过文件列表或拖拽操作实现多个文件上传。

首先我们需要检验浏览器是否支持XHR2,File API,FormData及拖拽操作。

编写代码

如何上传单个文件并显示上传进度?

首先需要做的是创建简单的View :

  • 定义一个表单,由输入文件元素和提交按钮组成。
  • 使用Bootstrap 进度条显示进度。

 <div id=

在Onchange 事件中添加输入文件元素,并在JS方法SingleFileSelected使用,因此在用户选择和修改文件时都会调用此方法。在该方法中,我们将选择输入文件元素和访问FileList的文件对象,选择第一个文件files[0],因此我们可以得到文件名,文件类型等信息。

function singleFileSelected(evt) {
   2:      //var selectedFile = evt.target.files can use this  or select input file element 
   3:      //and access it's files object
    var selectedFile = ($())[0].files[0];
     (selectedFile) {
        var FileSize = 0;
        var imageType = /image.*/;
         (selectedFile.size > 1048576) {
            FileSize = Math.round(selectedFile.size * 100 / 1048576) / 100 + ;
        }
          (selectedFile.size > 1024) {
            FileSize = Math.round(selectedFile.size * 100 / 1024) / 100 + ;
        }
         {
            FileSize = selectedFile.size + ;
        }
  17:          // here we will add the code of thumbnail preview of upload images
  18:  
        $().text( + selectedFile.name);
        $().text( + selectedFile.type);
        $().text( + FileSize);
    }
}

可以通过File reader对象从内存读取上传文件内容。reader 对象提供很多事件,onload,onError以及四种读取数据的函数readAsBinaryString(), readAsText(),readAsArrayBuffer(), readAsDataURL(),result属性表示文件内容。该属性只有当读操作执行完成后才有效,数据格式根据调用的初始化读操作制定的。

在这里就不详细解释File reader,我们会在SingleFileSelected 方法中使用,用于预览图像,查看代码:

 (selectedFile.type.match(imageType)) {
           var reader =  FileReader();
           reader.onload = function (e) {
   4:  
               $().empty();
               var dataURL = reader.result;
               var img =  Image()
               img.src = dataURL;
               img.className = ;
               $().append(img);
           };
           reader.readAsDataURL(selectedFile);
       }


到现在为止,就可看到下图:

现在需要将已上传的文件发送到服务器,因此添加Onclick事件,并在JS uploadFile()方法中调用,代码如下:

function UploadFile() {
   2:      //we can create form by passing the form to Constructor of formData object
   3:      //or creating it manually using append function 
   4:      //but please note file name should be same like the action Parameter
   5:      //var dataString = new FormData();
   6:      //dataString.append("UploadedFile", selectedFile);
   7:  
    var form = $()[0];
    var dataString =  FormData(form);
    $.ajax({
        url: ,
        type: ,
        xhr: function () {
            var myXhr = $.ajaxSettings.xhr();
             (myXhr.upload) {
  16:                  //myXhr.upload.onprogress = progressHandlingFunction
                myXhr.upload.addEventListener(, progressHandlingFunction,
                );
            }
             myXhr;
        },
  22:          //Ajax events
        success: successHandler,
        error: errorHandler,
        complete:completeHandler,
  26:          // Form data
        data: dataString,
  28:          //Options to tell jQuery not to process data or worry about content-type.
        cache: ,
        contentType: ,
        processData:
    });
}

在该方法中,发送表单,使用Form 数据对象来序列化文件值,我们可以手动创建formdata数据的实例化,通过调用append()方法将域值挂起,或是通过检索HTML 表单的FormData对象。

progressHandlingFunction方法会提供检验上传文件Size 是否可计算,使用e.loaded和e.total计算出已上传百分之多少的数据。

function progressHandlingFunction(e) {
     (e.lengthComputable) {
        var percentComplete = Math.round(e.loaded * 100 / e.total);
        $().css(,
        percentComplete + ).attr(, percentComplete);
        $().text(percentComplete + );
    }
     {
        $().text();
    }
}

现在已经实现了基本的发送数据及提供进度条的功能,接下来需要实现服务器端的代码处理,使用upload action方法和uplpader controller 。

在upload 方法中,可以从HttpPostedfileBase对象中获取文件信息,该对象包含上传的文件的基本信息如Filename属性,Contenttype属性,inputStream属性等内容,这些信息都可以用来验证服务器端接收的文件是否有错,也可以用来保存文件。

[HttpPost]
   2:  
         JsonResult Upload(HttpPostedFileBase uploadedFile)
        {
             (uploadedFile !=  && uploadedFile.ContentLength > 0)
            {
                [] FileByteArray =  [uploadedFile.ContentLength];
                uploadedFile.InputStream.Read(FileByteArray, 0, uploadedFile.ContentLength);
                Attachment newAttchment =  Attachment();
                newAttchment.FileName = uploadedFile.FileName;
                newAttchment.FileType = uploadedFile.ContentType;
                newAttchment.FileContent = FileByteArray;
                OperationResult operationResult = attachmentManager.SaveAttachment(newAttchment);
                 (operationResult.Success)
                {
                     HTMLString = CaptureHelper.RenderViewToString
                    (, newAttchment, .ControllerContext);
                     Json(
                    {
                        statusCode = 200,
                        status = operationResult.Message,
                        NewRow = HTMLString
                    }, JsonRequestBehavior.AllowGet);
  24:  
                }
  26:                  else
                {
                     Json(
                    {
                        statusCode = 400,
                        status = operationResult.Message,
                        file = uploadedFile.FileName
                    }, JsonRequestBehavior.AllowGet);
  34:  
                }
            }
             Json(
            {
                statusCode = 400,
                status = ,
                file = .Empty
            }, JsonRequestBehavior.AllowGet);
        }

能否通过拖拽操作实现多个文件上传的功能?

在这一部分,实现相同的uploader,并为uploader添加一些新功能:

  • 允许选择多个文件
  • 拖拽操作

现在给Uplodaer View添加新功能:

  • 为输入文件元素添加多个属性,实现同时选择多个文件。
  • 添加实现拖拽功能的文件,如以下代码所示:
<div id=>Drop images Here</div>

在JS方法MultiplefileSelected中添加onChange事件,与之前SingleFileSelected的写法类似,不同的是需要将所有的文件列出,并允许拖拽文件。代码如下:

function MultiplefileSelected(evt) {
    evt.stopPropagation();
    evt.preventDefault();
    $().removeClass();
    selectedFiles = evt.target.files || evt.dataTransfer.files;
     (selectedFiles) {
        $().empty();
         (var i = 0; i < selectedFiles.length; i++) {
            DataURLFileReader.read(selectedFiles[i], function (err, fileInfo) {
                 (err != ) {
                    var RowInfo =  + i +
                    class="info"><div class="InfoContainer">' +
                                    + err +  +
  14:                                    '<div data-name="FileName" 
                                  class="info">' + fileInfo.name +  +
  16:                                    '<div data-type="FileType" 
                                  class="info">' + fileInfo.type +  +
  18:                                    '<div data-size="FileSize" 
                                  class="info">' + fileInfo.size() +
                                  ;
                    $().append(RowInfo);
                }
                 {
                    var image =  + fileInfo.fileContent +
                     +
                    fileInfo.name + ;
                    var RowInfo =  + i +
                    class="info"><div class="InfoContainer">' +
                                   +
                                  image +  +
  31:                                    '<div data-name="FileName" 
                                  class="info">' + fileInfo.name +  +
  33:                                    '<div data-type="FileType" 
                                  class="info">' + fileInfo.type +  +
  35:                                    '<div data-size="FileSize" 
                                  class="info">' + fileInfo.size() +
                                  ;
                    $().append(RowInfo);
                }
            });
        }
    }
}

在该方法中,将选择和拖拽文件操作的变量设置为全局变量selectedFiles,然后扫描 selectedfiles中的每个文件,将从 DataURLreader对象中调用Read 方法读取文件。

DataURLreader对象可调用read方法,并将File对象和回调方法作为read方法参数,在上述方法中我们创建了FileReader,并修改了FileReader的Onload和onerror回调函数。调用 readAsDataURL 方法来读文件。

新建FileInfo对象包括了所有的文件信息及内容。

var DataURLFileReader = {
    read: function (file, callback) {
        var reader =  FileReader();
        var fileInfo = {
            name: file.name,
            type: file.type,
            fileContent: ,
            size: function () {
                var FileSize = 0;
                 (file.size > 1048576) {
                    FileSize = Math.round(file.size * 100 / 1048576) / 100 + ;
                }
                  (file.size > 1024) {
                    FileSize = Math.round(file.size * 100 / 1024) / 100 + ;
                }
                 {
                    FileSize = file.size + ;
                }
                 FileSize;
            }
        };
         (!file.type.match()) {
            callback(, fileInfo);
            ;
        }
        reader.onload = function () {
            fileInfo.fileContent = reader.result;
            callback(, fileInfo);
        };
        reader.onerror = function () {
            callback(reader.error, fileInfo);
        };
        reader.readAsDataURL(file);
    }
};

使用拖拽操作选择

由于大部分浏览器现在已经执行拖拽操作,为了实现拖拽操作,在drop_zone 元素中添加dragover和drop事件。

var dropZone = document.getElementById();
    dropZone.addEventListener(, handleDragOver, );
    dropZone.addEventListener(, MultiplefileSelected, );
    dropZone.addEventListener(, dragenterHandler, );
    dropZone.addEventListener(, dragleaveHandler, );

当文件拖到目标位置时触发dragover事件,在以下代码中,我们修改了默认浏览器及datatransfer的dropEffect 属性,代码如下:

function handleDragOver(evt) {
    evt.preventDefault();
    evt.dataTransfer.effectAllowed = ;
    evt.dataTransfer.dropEffect = ;
}

接着在MultiplefileSelected中添加drop事件来处理文件drop操作。

大部分功能已经完善,现在需要添加“上传按钮”,通过Onclick事件来调用UploadMultipleFiles方法。

该方法与上文提到的Uploadfile方法类似,不同的是手动验证formdata对象值。

function UploadMultipleFiles() {
   2:  
   3:      // here we will create FormData manually to prevent sending mon image files
    var dataString =  FormData();
   5:      //var files = document.getElementById("UploadedFiles").files;
     (var i = 0; i < selectedFiles.length; i++) {
         (!selectedFiles[i].type.match()) {
            ;
        }
       }
  11:  // AJAX Request code here
}

接下来添加服务器端处理代码,与上文添加的代码类似,需要做的就是接受一系列的文件列表,如下:

 JsonResult UplodMultiple(HttpPostedFileBase[] uploadedFiles)

确保 HttpPostedFileBase 数组名称与append 方法中的名称相同,只有这样,MVC才能映射到文件数组中。

 JsonResult UplodMultiple(HttpPostedFileBase[] uploadedFiles)
dataString.append(, selectedFiles[i]);

上传大文件

为了允许上传大文件,如果使用的是 IIS7及以上版本,需要修改Web.config 文件,添加以下代码:

<system.webServer>
       <security>
                <requestFiltering>
                           <requestLimits maxAllowedContentLength= />
                </requestFiltering>
       </security>
</system.webServer>
   8:  
<httpRuntime targetFramework=  maxRequestLength=/>

到这里所有的功能就可以实现了,而且最大可上传2GB的文件。

猜你喜欢

转载自my.oschina.net/u/2345713/blog/534227