文件各种上传,离不开的表单

汉王 WEB前端 2017年08月03日 收藏

作为程序员的我们,经常会要用到文件的上传和下载功能。到了需要用的时候,各种查资料。有木有..有木有...。为了方便下次使用,这里来做个总结和备忘。

利用表单实现文件上传

最原始、最简单、最粗暴的文件上传。
前端代码:

  1. //方式1
  2. <form action="/Home/SaveFile1" method="post" enctype="multipart/form-data">
  3. <input type="file" class="file1" name="file1" />
  4. <button type="submit" class="but1">上传</button>
  5. </form>

【注意】

  • 1、需要post提交
  • 2、enctype="multipart/form-data" (传输文件)
  • 3、需要提交的表单元素需要设置 name 属性

后台代码:

  1. public ActionResult SaveFile1()
  2. {
  3. if (Request.Files.Count > 0)
  4. {
  5. Request.Files[0].SaveAs(Server.MapPath("~/App_Data/") + Request.Files[0].FileName);
  6. return Content("保存成功");
  7. }
  8. return Content("没有读到文件");
  9. }

表单异步上传(jquery.form插件)

虽然上面的方式简单粗暴,但是不够友好。页面必然会刷新。难以实现停留在当前页面,并给出文件上传成功的提示。
随着时间的流逝,技术日新月异。ajax的出现,使得异步文件提交变得更加容易。
下面我们利用jquery.form插件来实现文件的异步上传。
首先我们需要导入jquery.jsjquery.form.js
前端代码:

  1. <form id="form2" action="/Home/SaveFile2" method="post" enctype="multipart/form-data">
  2. <input type="file" class="file1" name="file1" />
  3. <button type="submit" class="but1">上传1</button>
  4. <button type="button" class="but2">上传2</button>
  5. </form>
  1. //方式2(通过ajaxForm绑定ajax操作)
  2. $(function () {
  3. $('#form2').ajaxForm({
  4. success: function (responseText) {
  5. alert(responseText);
  6. }
  7. });
  8. });
  9. //方式3(通过ajaxSubmit直接执行ajax操作)
  10. $(function () {
  11. $(".but2").click(function () {
  12. $('#form2').ajaxSubmit({
  13. success: function (responseText) {
  14. alert(responseText);
  15. }
  16. });
  17. });
  18. });

后台代码:

  1. public string SaveFile2()
  2. {
  3. if (Request.Files.Count > 0)
  4. {
  5. Request.Files[0].SaveAs(Server.MapPath("~/App_Data/") + Path.GetFileName(Request.Files[0].FileName));
  6. return "保存成功";
  7. }
  8. return "没有读到文件";
  9. }

原理:
我们很多时候使用了插件,就不管其他三七二十一呢。
如果有点好奇心,想想这个插件是怎么实现的。随便看了看源码一千五百多行。我的妈呀,不就是个异步上传吗,怎么这么复杂。
难以看出个什么鬼来,直接断点调试下吧。

原来插件内部有iframe和FormData不同方式来上传,来适应更多版本浏览器。

模拟表单数据上传(FormData)

iframe这东西太恶心。我们看到上面可以利用FormData来上传文件,这个是Html 5 才有的。下面我们自己也来试试把。
前端代码:

  1. <input id="fileinfo" type="file" class="notFormFile" />
  2. <button type="button" class="btnNotForm">上传4</button>
  1. //方式4
  2. $(".btnNotForm").click(function () {
  3. var formData = new FormData();//初始化一个FormData对象
  4. formData.append("files", $(".notFormFile")[0].files[0]);//将文件塞入FormData
  5. $.ajax({
  6. url: "/Home/SaveFile2",
  7. type: "POST",
  8. data: formData,
  9. processData: false, // 告诉jQuery不要去处理发送的数据
  10. contentType: false, // 告诉jQuery不要去设置Content-Type请求头
  11. success: function (responseText) {
  12. alert(responseText);
  13. }
  14. });
  15. });

后的代码:(不变,还是上例代码)

  1. public string SaveFile2()
  2. {
  3. if (Request.Files.Count > 0)
  4. {
  5. Request.Files[0].SaveAs(Server.MapPath("~/App_Data/") + Path.GetFileName(Request.Files[0].FileName));
  6. return "保存成功";
  7. }
  8. return "没有读到文件";
  9. }

我们看到,FormData对象也只是在模拟一个原始的表单格式的数据。那有没有可能不利用表单或表单格式来上传文件呢?答案是肯定的。(下面马上揭晓)
前端代码:

  1. <input type="file" id="file5" multiple>
  2. <button type="button" class="btnFile5">上传5</button>
  1. //方式5
  2. $(".btnFile5").click(function () {
  3. $.ajax({
  4. url: "/Home/SaveFile4",
  5. type: "POST",
  6. data: $("#file5")[0].files[0],
  7. processData: false, // 告诉jQuery不要去处理发送的数据
  8. contentType: false, // 告诉jQuery不要去设置Content-Type请求头
  9. success: function (responseText) {
  10. alert(responseText);
  11. }
  12. });;
  13. });

后台代码:

  1. public string SaveFile4()
  2. {
  3. //这里发现只能得到一个网络流,没有其他信息了。(比如,文件大小、文件格式、文件名等)
  4. Request.SaveAs(Server.MapPath("~/App_Data/SaveFile4.data") + "", false);
  5. return "保存成功";
  6. }

细心的你发现没有了表单格式,我们除了可以上传文件流数据外,不能再告诉后台其他信息了(如文件格式)。
到这里,我似乎明白了以前上传文件为什么非得要用个form包起来,原来这只是和后台约定的一个传输格式而已。
其实我们单纯的用jq的ajax传输文本数据的时候,最后也是组装成了form格式的数据,如:

  1. $.ajax({
  2. data: { "userName": "张三" }

分片上传

在知道了上面的各种上传之后,我们是不是就满于现状了呢?no,很多时候我们需要传输大文件,一般服务器都会有一定的大小限制。
某天,你发现了一个激情小电影想要分享个大家。无奈,高清文件太大传不了,怎么办?我们可以化整为零,一部分一部分的传嘛,也就是所谓的分片上传。
前端代码:

  1. <input type="file" id="file6" multiple>
  2. <button type="button" class="btnFile6">分片上传6</button>
  3. <div class="result"></div>
  1. //方式6
  2. $(".btnFile6").click(function () {
  3. var upload = function (file, skip) {
  4. var formData = new FormData();//初始化一个FormData对象
  5. var blockSize = 1000000;//每块的大小
  6. var nextSize = Math.min((skip + 1) * blockSize, file.size);//读取到结束位置
  7. var fileData = file.slice(skip * blockSize, nextSize);//截取 部分文件 块
  8. formData.append("file", fileData);//将 部分文件 塞入FormData
  9. formData.append("fileName", file.name);//保存文件名字
  10. $.ajax({
  11. url: "/Home/SaveFile6",
  12. type: "POST",
  13. data: formData,
  14. processData: false, // 告诉jQuery不要去处理发送的数据
  15. contentType: false, // 告诉jQuery不要去设置Content-Type请求头
  16. success: function (responseText) {
  17. $(".result").html("已经上传了" + (skip + 1) + "块文件");
  18. if (file.size <= nextSize) {//如果上传完成,则跳出继续上传
  19. alert("上传完成");
  20. return;
  21. }
  22. upload(file, ++skip);//递归调用
  23. }
  24. });
  25. };
  26. var file = $("#file6")[0].files[0];
  27. upload(file, 0);
  28. });

后台代码:

  1. public string SaveFile6()
  2. {
  3. //保存文件到根目录 App_Data + 获取文件名称和格式
  4. var filePath = Server.MapPath("~/App_Data/") + Request.Form["fileName"];
  5. //创建一个追加(FileMode.Append)方式的文件流
  6. using (FileStream fs = new FileStream(filePath, FileMode.Append, FileAccess.Write))
  7. {
  8. using (BinaryWriter bw = new BinaryWriter(fs))
  9. {
  10. //读取文件流
  11. BinaryReader br = new BinaryReader(Request.Files[0].InputStream);
  12. //将文件留转成字节数组
  13. byte[] bytes = br.ReadBytes((int)Request.Files[0].InputStream.Length);
  14. //将字节数组追加到文件
  15. bw.Write(bytes);
  16. }
  17. }
  18. return "保存成功";
  19. }

相对而言,代码量多了一点,复杂了一点。不过相对于网上的其他分片上传的代码应该要简单得多(因为这里没有考虑多文件块同时上传、断点续传。那样就需要在后台把文件块排序,然后上传完成按序合并,然后删除原来的临时文件。有兴趣的同学可以自己试试,稍候在分析上传插件webuploader的时候也会实现)。
效果图:

【说明】:如果我们想要上传多个文件怎么办?其实H5中也提供了非常简单的方式。直接在input里面标记multiple<input type="file" id="file6" multiple>,然后我们后台接收的也是一个数组Request.Files

使用HTML5 拖拽、粘贴上传

只能说H5真是强大啊,权限越来越大,操作越来越牛逼。
前端代码(拖拽上传):

  1. <textarea class="divFile7" style="min-width:800px;height:150px" placeholder="请将文件拖拽或直接粘贴到这里"></textarea>
  1. //方式7
  2. $(".divFile7")[0].ondrop = function (event) {
  3. event.preventDefault();//不要执行与事件关联的默认动作
  4. var files = event.dataTransfer.files;//获取拖上来的文件
  5. //以下代码不变
  6. var formData = new FormData();//初始化一个FormData对象
  7. formData.append("files", files[0]);//将文件塞入FormData
  8. $.ajax({
  9. url: "/Home/SaveFile2",
  10. type: "POST",
  11. data: formData,
  12. processData: false, // 告诉jQuery不要去处理发送的数据
  13. contentType: false, // 告诉jQuery不要去设置Content-Type请求头
  14. success: function (responseText) {
  15. alert(responseText);
  16. }
  17. });
  18. };

后台代码:
略(和之前的SaveFile2一样)

前端代码(粘贴上传 限图片格式):

  1. //方式8
  2. $(".divFile7")[0].onpaste = function (event) {
  3. event.preventDefault();//不要执行与事件关联的默认动作
  4. var clipboard = event.clipboardData.items[0];//剪贴板数据
  5. if (clipboard.kind == 'file' || clipboard.type.indexOf('image') > -1) {//判断是图片格式
  6. var imageFile = clipboard.getAsFile();//获取文件
  7. //以下代码不变
  8. var formData = new FormData;
  9. formData.append('files', imageFile);
  10. formData.append('fileName', "temp.png");//这里给文件命个名(或者直接在后台保存的时候命名)
  11. $.ajax({
  12. url: "/Home/SaveFile8",
  13. type: "POST",
  14. data: formData,
  15. processData: false, // 告诉jQuery不要去处理发送的数据
  16. contentType: false, // 告诉jQuery不要去设置Content-Type请求头
  17. success: function (responseText) {
  18. alert(responseText);
  19. }
  20. });
  21. }
  22. };

后台代码:

  1. public string SaveFile8()
  2. {
  3. //保存文件到根目录 App_Data + 获取文件名称和格式
  4. var filePath = Server.MapPath("~/App_Data/") + Request.Form["fileName"];
  5. if (Request.Files.Count > 0)
  6. {
  7. Request.Files[0].SaveAs(filePath);
  8. return "保存成功";
  9. }
  10. return "没有读到文件";
  11. }

效果图:

上传插件(WebUploader)

已经列举分析了多种上传文件的方式,我想总有一种适合你。不过,上传这个功能比较通用,而我们自己写的可能好多情况没有考虑到。接下来简单介绍下百度的WebUploader插件。
比起我们自己写的简单上传,它的优势:稳定、兼容性好(有flash切换,所以支持IE)、功能多、并发上传、断点续传(主要还是靠后台配合)。
官网:http://fex.baidu.com/webuploader/
插件下载:https://github.com/fex-team/webuploader/releases/download/0.1.5/webuploader-0.1.5.zip
下面开始对WebUploader的使用
第一种,简单粗暴
前端代码:

  1. <div id="picker">选择文件</div>
  2. <button id="ctlBtn" class="btn btn-default">开始上传</button>
  1. <!--引用webuploader的js和css-->
  2. <link href="~/Scripts/webuploader-0.1.5/webuploader.css" rel="stylesheet" />
  3. <script src="~/Scripts/webuploader-0.1.5/webuploader.js"></script>
  4. <script type="text/javascript">
  5. var uploader = WebUploader.create({
  6. // (如果是新浏览器 可以不用 flash)
  7. //swf: '/Scripts/webuploader-0.1.5/Uploader.swf',
  8. // 文件接收服务端。
  9. server: '/Webuploader/SaveFile',
  10. // 选择文件的按钮。可选。
  11. // 内部根据当前运行是创建,可能是input元素,也可能是flash.
  12. pick: '#picker'
  13. });
  14. $("#ctlBtn").click(function () {
  15. uploader.upload();
  16. });
  17. uploader.on('uploadSuccess', function (file) {
  18. alert("上传成功");
  19. });
  20. </script>

后台代码:

  1. public string SaveFile()
  2. {
  3. if (Request.Files.Count > 0)
  4. {
  5. Request.Files[0].SaveAs(Server.MapPath("~/App_Data/") + Path.GetFileName(Request.Files[0].FileName));
  6. return "保存成功";
  7. }
  8. return "没有读到文件";
  9. }

第二种,分片上传。和我们之前自己写的效果差不多。
前端代码:

  1. var uploader = WebUploader.create({
  2. //兼容老版本IE
  3. swf: '/Scripts/webuploader-0.1.5/Uploader.swf',
  4. // 文件接收服务端。
  5. server: '/Webuploader/SveFile2',
  6. // 开起分片上传。
  7. chunked: true,
  8. //分片大小
  9. chunkSize: 1000000,
  10. //上传并发数
  11. threads: 1,
  12. // 选择文件的按钮。
  13. pick: '#picker'
  14. });
  15. // 点击触发上传
  16. $("#ctlBtn").click(function () {
  17. uploader.upload();
  18. });
  19. uploader.on('uploadSuccess', function (file) {
  20. alert("上传成功");
  21. });

后台代码:

  1. public string SveFile2()
  2. {
  3. //保存文件到根目录 App_Data + 获取文件名称和格式
  4. var filePath = Server.MapPath("~/App_Data/") + Path.GetFileName(Request.Files[0].FileName);
  5. //创建一个追加(FileMode.Append)方式的文件流
  6. using (FileStream fs = new FileStream(filePath, FileMode.Append, FileAccess.Write))
  7. {
  8. using (BinaryWriter bw = new BinaryWriter(fs))
  9. {
  10. //读取文件流
  11. BinaryReader br = new BinaryReader(Request.Files[0].InputStream);
  12. //将文件留转成字节数组
  13. byte[] bytes = br.ReadBytes((int)Request.Files[0].InputStream.Length);
  14. //将字节数组追加到文件
  15. bw.Write(bytes);
  16. }
  17. }
  18. return "保存成功";
  19. }

我们看到了有个参数threads: 1上传并发数,如果我们改成大于1会怎样?前端会同时发起多个文件片上传。后台就会报错,多个进程同时操作一个文件。
那如果我们想要多线程上传怎么办?改代码吧(主要是后台逻辑)。
前端代码:

  1. //并发上传(多线程上传)
  2. var uploader = WebUploader.create({
  3. //兼容老版本IE
  4. swf: '/Scripts/webuploader-0.1.5/Uploader.swf',
  5. // 文件接收服务端。
  6. server: '/Webuploader/SveFile3',
  7. // 开起分片上传。
  8. chunked: true,
  9. //分片大小
  10. chunkSize: 1000000,
  11. //上传并发数
  12. threads: 10,
  13. // 选择文件的按钮。
  14. pick: '#picker'
  15. });
  16. // 点击触发上传
  17. $("#ctlBtn").click(function () {
  18. uploader.upload();
  19. });
  20. uploader.on('uploadSuccess', function (file) {
  21. //上传完成后,给后台发送一个合并文件的命令
  22. $.ajax({
  23. url: "/Webuploader/FileMerge",
  24. data: { "fileName": file.name },
  25. type: "post",
  26. success: function () {
  27. alert("上传成功");
  28. }
  29. });
  30. });

后台代码:

  1. public string SveFile3()
  2. {
  3. var chunk = Request.Form["chunk"];//当前是第多少片
  4. var path = Server.MapPath("~/App_Data/") + Path.GetFileNameWithoutExtension(Request.Files
  5. if (!Directory.Exists(path))//判断是否存在此路径,如果不存在则创建
  6. {
  7. Directory.CreateDirectory(path);
  8. }
  9. //保存文件到根目录 App_Data + 获取文件名称和格式
  10. var filePath = path + "/" + chunk;
  11. //创建一个追加(FileMode.Append)方式的文件流
  12. using (FileStream fs = new FileStream(filePath, FileMode.Append, FileAccess.Write))
  13. {
  14. using (BinaryWriter bw = new BinaryWriter(fs))
  15. {
  16. //读取文件流
  17. BinaryReader br = new BinaryReader(Request.Files[0].InputStream);
  18. //将文件留转成字节数组
  19. byte[] bytes = br.ReadBytes((int)Request.Files[0].InputStream.Length);
  20. //将字节数组追加到文件
  21. bw.Write(bytes);
  22. }
  23. }
  24. return "保存成功";
  25. }
  1. /// <summary>
  2. /// 合并文件
  3. /// </summary>
  4. /// <param name="path"></param>
  5. /// <returns></returns>
  6. public bool FileMerge()
  7. {
  8. var fileName = Request.Form["fileName"];
  9. var path = Server.MapPath("~/App_Data/") + Path.GetFileNameWithoutExtension(fileName);
  10. //这里排序一定要正确,转成数字后排序(字符串会按1 10 11排序,默认10比2小)
  11. foreach (var filePath in Directory.GetFiles(path).OrderBy(t => int.Parse(Path.GetFileNameWithoutExtension(t))))
  12. {
  13. using (FileStream fs = new FileStream(Server.MapPath("~/App_Data/") + fileName, FileMode.Append, FileAccess.Write))
  14. {
  15. byte[] bytes = System.IO.File.ReadAllBytes(filePath);//读取文件到字节数组
  16. fs.Write(bytes, 0, bytes.Length);//写入文件
  17. }
  18. System.IO.File.Delete(filePath);
  19. }
  20. Directory.Delete(path);
  21. return true;
  22. }

到这里你以为就结束了吗?错,还有好多情况没有考虑到。如果多个用户上传的文件名字一样会怎样?如何实现断点续传?还没实现选择多个文件?不过,这里不打算继续贴代码了(再贴下去,代码量越来越多了),自己也来练习练习吧。
提供一个思路,上传前先往数据库插入一条数据。数据包含文件要存的路径、文件名(用GUID命名,防止同名文件冲突)、文件MD5(用来识别下次续传和秒传)、临时文件块存放路径、文件是否完整上传成功等信息。
然后如果我们断网后再传,首先获取文件MD5值,看数据库里面有没上传完成的文件,如果有就实现秒传。如果没有,看是不是有上传了部分的。如果有接着传,如果没有则重新传一个新的文件。

总结

之前我一直很疑惑,为什么上传文件一定要用form包起来,现在算是大概明白了。
最开始在javascript还不流行时,我们就可以直接使用submit按钮提交表单数据了。表单里面可以包含文字和文件。然后随着js和ajax的流行,可以利用ajax直接异步提交部分表单数据。这里开始我就纠结了,为什么ajax可以提交自己组装的数据。那为什么不能直接提交文件呢。这里我错了,ajax提交的并不是随意的数据,最后还是组装成了表单格式(因为后台技术对表单格式数据的支持比较普及)。但是现有的技术还不能通过js组装一个文件格式的表单数据。直到H5中的FormData出现,让前端js组装一个包含文件的表单格式数据成为了可能。所以说表单只是为了满足和后台“约定”的数据格式而已。

 

相关推荐

demo