在应用系统开发当中,文件的上传和下载是非常普遍的需求。在基于.NET的C/S架构的项目开发当中,有多种方案可以实现文件的上传和下载(httpwebrequest、webclient等),而且多采用异步(xxxxAsync或async/await等)的方式实现。而在基于.NET的B/S架构的项目开发当中,虽然webform提供了上传控件(HttpPostFile),但用户体验并不好(页面刷新,如果上传大文件则卡死,即不支持分块上传),虽然有基于Flash的上传文件的解决方案,但Flash已经过时(安全性差)。因此我们一般采用基于h5+js的上传文件插件的解决方案。本文介绍的是使用WebUploader控件结合ASP.NET MVC实现文件的上传、下载以及上传成功后将Excel数据保存到SQL Server数据库中的功能。
关于WebUploader的介绍,读者可以去查看官方网页 http://fex.baidu.com/webuploader/,跟ECharts一样,这也是百度开发的基于h5+js的开源上传文件插件。官网上面也有详细的使用介绍,基本上是介绍了js前端的配置和关键代码,但后端代码并没有提供,需要读者自行实现。
在ASP.NET MVC4中使用WebUploader只需要导入开发包中的js和css文件就可以了。比如:
<link href="@Url.Content("~/Scripts/webuploader/webuploader.css")" rel="stylesheet" type="text/css" /> <link href="@Url.Content("~/Scripts/webuploader/bootstrap.css")" rel="stylesheet" type="text/css" /> <link href="@Url.Content("~/Scripts/webuploader/style.css")" rel="stylesheet" type="text/css" /> <script src="@Url.Content("~/Scripts/webuploader/jquery-1.10.2.min.js")" type="text/javascript"></script> <script src="@Url.Content("~/Scripts/webuploader/bootstrap.js")" type="text/javascript"></script> <script src="@Url.Content("~/Scripts/webuploader/webuploader.js")" type="text/javascript"></script>
然后是Html部分:
<div id="uploader"> <div id="thelist" class="uploader-list"></div> <div class="btns"> <div id="picker">选择文件</div> <input id="ctlBtn" type="button" value="开始上传" class="btn btn-default" /> @Html.ActionLink("下载Excel", "DownLoad", null, new { @class = "btn btn-default" }) </div> </div>
这里面的id和class都是webuploader默认为我们提供的,后面的btn-default则是bootstrap为我们提供的。
关键的就是js部分代码:
<script type="text/javascript"> var applicationPath = window.applicationPath === "" ? "" : window.applicationPath || "../../"; var GUID = WebUploader.Base.guid(); $(function () { var $ = jQuery; var $list = $('#thelist'); var uploader = WebUploader.create({ auto: false, // 是否自动上传 swf: applicationPath + '../Scripts/webuploader/Uploader.swf', //server: applicationPath + 'DAManage/Upload', server: '@Url.Action("Upload", "Test")', pick: '#picker', accept: { title: 'Excels', extensions: 'xls,xlsx', mimeTypes: 'application/vnd.ms-excel,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }, chunked: true, //分片上传 chunkSize: 2048000, //每一片的大小 formData: { guid: GUID }, resize: false //不压缩image }); //添加进上传文件队列 uploader.on('fileQueued', function (file) { $list.append('<div id="' + file.id + '" class="item">' + '<h4 class="info">' + file.name + '</h4>' + '<p class="state">等待上传...</p>' + '</div>'); }); //开始上传 $("#ctlBtn").click(function () { uploader.upload(); }); //上传进度 uploader.on('uploadProgress', function (file, percentage) { var $li = $('#' + file.id), $percent = $li.find('.progress .progress-bar'); // 避免重复创建 if (!$percent.length) { $percent = $('<div class="progress progress-striped active">' + '<div class="progress-bar" role="progressbar" style=" 0%">' + '</div>' + '</div>').appendTo($li).find('.progress-bar'); } $li.find('p.state').text('上传中'); $percent.css('width', percentage * 100 + '%'); }); //上传成功 uploader.on('uploadSuccess', function (file, response) { $('#' + file.id).find('p.state').text('已上传'); $.post('@Url.Action("Merge", "Test")', { guid: GUID, fileName: file.name }, function (data) { $("#uploader .state").html("上传成功..."); uploader.removeFile(file); }); }); // 上传失败 uploader.on('uploadError', function (file) { $('#' + file.id).find('p.state').text('上传出错'); }); //上传完成后 uploader.on('uploadComplete', function (file) { $('#' + file.id).find('.progress').fadeOut(); }); //上传完毕 uploader.on("uploadFinished", function () { uploader.reset(); }); }); </script>
上面我给出了基本的注释,想要获取参数的详细定义和说明,请参考:http://fex.baidu.com/webuploader/doc/index.html。
后端控制器部分代码,主要是上面js中所指向的两个Action,分别为Upload和Merge。
Upload部分代码:
/// <summary> /// 上传Excel /// </summary> /// <returns>1表示失败,0表示成功</returns> [HttpPost] public ActionResult Upload() { var fileName = Request["name"]; var fileRelName = fileName.Substring(0, fileName.LastIndexOf('.')); int index = Convert.ToInt32(Request["chunk"]); var dir = Server.MapPath("~/Upload"); dir = Path.Combine(dir, fileRelName); if (!System.IO.Directory.Exists(dir)) System.IO.Directory.CreateDirectory(dir); try { string filePath = Path.Combine(dir, index.ToString()); var data = Request.Files["file"]; data.SaveAs(filePath); } catch (Exception) { return Json(new { error = 1 }); } return Json(new { erron = 0 }); }
Merge部分代码:
/// <summary> /// 合并Excel成功后,将其数据导入数据库 /// </summary> /// <returns>1表示失败,0表示成功</returns> public ActionResult Merge() { var uploadDir = Server.MapPath("~/Upload"); var fileName = Request["fileName"]; var fileRelName = fileName.Substring(0, fileName.LastIndexOf('.')); var dir = Path.Combine(uploadDir, fileRelName);//临时文件夹 var files = System.IO.Directory.GetFiles(dir); var finalPath = Path.Combine(uploadDir, fileName); var fs = new FileStream(finalPath, FileMode.Create); foreach (var part in files.OrderBy(x => x.Length).ThenBy(x => x))//排一下序,保证从0-N块写入 { var bytes = System.IO.File.ReadAllBytes(part); fs.Write(bytes, 0, bytes.Length); System.IO.File.Delete(part);//删除分块 } fs.Flush(); fs.Close(); System.IO.Directory.Delete(dir);//删除文件夹 try { //读取上传的Excel并保存到数据库 DbHelper.Excel2DB(finalPath, "Sheet1"); } catch (Exception) { return Json(new { error = 1 }); } return Json(new { error = 0 }); }
WebUploader是基于分块上传(这个设计主要针对大文件的上传)的,所以后端的处理也是分块合并的。Merge中的Excel2DB方法是将上传到服务器的Excel文件中的数据保存到数据库的方法,其中涉及Excel文件内容的读取(NPOI,支持xls和xlsx类型)和EF(5.0)实现数据的保存(保存到SQLServer)。具体的代码可以参考本篇博客最后的示例代码下载。
而关于文件的下载,其实ASP.NET MVC已经提供了FileResult类型,只需要返回File对象就可以了,具体的Action代码如下:
/// <summary> /// 下载excel /// </summary> /// <returns></returns> public FileResult DownLoad() { var path = Server.MapPath("~/Upload/"); var file = System.IO.Directory.GetFiles(path).OrderByDescending(t => new FileInfo(t).CreationTime).FirstOrDefault(); return File(file, "application/vnd.ms-excel", new FileInfo(file).Name); }
File对应的第二个参数是Content-Type,由于这里要下载Excel,所以用了application/vnd.ms-excel。关于如何确定各种文件类型的Content-Type可以查看这个网址里的内容:http://tool.oschina.net/commons。
对应的前端代码上面已经贴过了,代码如下:
@Html.ActionLink("下载Excel", "DownLoad", null, new { @class = "btn btn-default" })