系列目录

循序渐进学.Net Core Web Api开发系列目录

本系列涉及到的源码下载地址：https://github.com/seabluescn/Blog_WebApi

一、概述

本篇介绍通过.NET core WebApi实现文件上传。

二、Controller端代码

直接上代码：

    [Route("api/files")]

    [Produces("application/json")]

    public class FileController : Controller

    {

        private readonly IHostingEnvironment _hostingEnvironment;

        public FileController(IHostingEnvironment hostingEnvironment)

        {

            _hostingEnvironment = hostingEnvironment;

        }

        [HttpPost("iform")]

        public ResultObject UploadIForm(List<IFormFile> files)

        {

            List<String> filenames = new List<string>();  foreach (var file in files)

            {

                var fileName = file.FileName;

                Console.WriteLine(fileName);

                fileName = $"/UploadFile/{fileName}";

                filenames.Add(fileName);

                fileName = _hostingEnvironment.WebRootPath + fileName;

                using (FileStream fs = System.IO.File.Create(fileName))

                {

                    file.CopyTo(fs);

                    fs.Flush();

                }

            }

            return new ResultObject

            {

                state = "Success",

                resultObject = filenames

            };

        }

为了同时返回上传的文件名和操作状态，我们定义了一个ResultObject的类来返回信息。

    public class ResultObject

    {

        public String state { get; set; }

        public Object resultObject { get; set; }

    }

返回上传的文件名称列表的目的是因为后台可能会给文件重新命名，以避免冲突，新的文件名称需要让前台知道。

后台的files是通过传入的参数获得的，还有其他两种方法可以获取到文件，效果一样：

       [HttpPost]

        public ResultObject UploadAjax()

        {

            var files = Request.Form.Files;

            ...

         }

或：

       public ResultObject UploadForm(IFormCollection form)

        {

            var files = form.Files;

            ...

       }

除了获取到files的方式不同，其他操作完全一致。

三、前端代码

<!DOCTYPE html>

<html>

<head>

    <meta charset="utf-8" />

    <title></title>

    <script src="lib/jquery/dist/jquery.min.js"></script>

    <script src="lib/jquery-form/dist/jquery.form.min.js"></script>

    <script type="text/javascript">

        function AjaxFormDataUploadfile() {

            var fileUpload = $("#files").get();

            var files = fileUpload.files;

            var data = new FormData();       
            for (var i = ; i < files.length; i++) {

                data.append("files", files[i]);

            }

            $.ajax({

                type: "POST",

                url: "/api/files/iform",

                contentType: false,

                processData: false,

                data: data,

                success: function (message) {

                    alert("success");

                },

                error: function () {

                    alert("上传文件出现错误！");

                }

            });

        }  </script>

</head>

<body>

    <form id="myform" method="post" action="/api/files/iform" enctype="multipart/form-data">

         <input type="file" id="files" name="files" multiple /> <br /><br />

         <input id="formupload" type="button" value="Form Data Upload" onclick="AjaxFormDataUploadfile();" /><br /><br />

    </form>

</body>

</html>

两个注意点：

1、form要提供enctype="multipart/form-data" 属性

2、如果要上传多个文件，文件表单需要提供multiple属性

这里我们通过FormData对象的append操作来构建提交的数据，根据我上一篇博客提到的，这里提交数据还有其他两个办法：

        function formuploadfile() {

            $("#myform").ajaxSubmit();

        }

或者：

        function Ajaxuploadfile() {

            var formdata = new FormData(document.getElementById("myform"));

            $.ajax({

                type: "POST",

                url: "/api/files/iform",

                contentType: false,

                processData: false,

                data: formdata,

                success: function (result) {

                    alert("success");

                    $.each(result.resultObject, function (i, filename) {

                        alert(filename);

                    });

                },

                error: function () {

                    alert("上传文件出现错误！");

                }

            });

        }

具体选择哪种方式，要看前端的需求，个人认为 var formdata = new FormData(document.getElementById("myform")); 比较方便。

四、上传大文件

上传大文件和上传小文件代码是一样的，关键是上传大文件时间太长，需要前端提供进度报告，不然用户体验太差。

解决的方案是利用ajax的HXR对象。

<!DOCTYPE html>

<html>

<head>

    <meta charset="utf-8" />

    <title></title>

    <script src="lib/jquery/dist/jquery.min.js"></script>

    <script src="lib/jquery-form/dist/jquery.form.min.js"></script>

    <script type="text/javascript">

        function AjaxuploadfileWithprogress() {

            var formdata = new FormData(document.getElementById("myform"));          

            $.ajax({

                type: "POST",

                url: "/api/files/iform",

                contentType: false,

                processData: false,

                data: formdata,

                success: function (result) {

                    alert("success");

                    $.each(result.resultObject, function (i, filename) {

                        alert(filename);

                    });

                },

                error: function () {

                    alert("上传文件出现错误！");

                },

                xhr: function () {

                    var xhr = $.ajaxSettings.xhr();

                    if (onprogress && xhr.upload) {

                        xhr.upload.addEventListener("progress", onprogress, false);

                        return xhr;

                    }

                }

            });

        }

        function onprogress(evt)

        {

            var loaded = evt.loaded;                  //已经上传大小

            var tot = evt.total;                      //附件总大小

            var per = Math.floor( * loaded / tot); //百分比

            $("#son").html(per + "%");

            $("#son").css("width", per + "%");

        }

    </script>

    <style type="text/css">

        #parent {

            width: 550px;

            height: 10px;

            border: 2px solid #09F;

        }

        #son {

            width: ;

            height: %;

            background-color: #09F;

            text-align: center;

            line-height: 10px;

            font-size: 20px;

            font-weight: bold;

        }

    </style>

</head>

<body>

    <form id="myform" method="post" action="/api/files/iform" enctype="multipart/form-data">

        <div>

            <div>

                <br />

                <p>表单多个上传文件:</p><br />

                <input type="file" id="files" name="files" multiple /> <br /><br />

                <input id="formuploadprogress" type="button" value="Ajax Upload Progress" onclick="AjaxuploadfileWithprogress();" /><br /><br />

                <div id="parent">

                    <div id="son"></div>

                </div>

            </div>

        </div>

    </form>

</body>

</html>

此时，可以看到上传进度条了，可以选择一个大文件测试一下。或者把浏览器的传输速度调低也可以进行调试。

五、为Swagger提供文件上传调试功能支持

目前swagger是不支持List<IFormFile>类型的，为了方便调试，我们为swagger提供该类型的支撑。

新增类：

public class SwaggerFileUploadListFilter : IOperationFilter

    {

        public void Apply(Operation operation, OperationFilterContext context)

        {

            if (!context.ApiDescription.HttpMethod.Equals("POST", StringComparison.OrdinalIgnoreCase) &&

                !context.ApiDescription.HttpMethod.Equals("PUT", StringComparison.OrdinalIgnoreCase))

            {

                return;

            }

            var fileParameters = context.ApiDescription.ActionDescriptor.Parameters.Where(n => n.ParameterType == typeof(List<IFormFile>)).ToList();

            if (fileParameters.Count < )

            {

                return;

            }

            operation.Consumes.Add("multipart/form-data");

            foreach (var fileParameter in fileParameters)

            {

                var parameter = operation.Parameters.Single(n => n.Name == fileParameter.Name);

                operation.Parameters.Remove(parameter);               

                NonBodyParameter p = new NonBodyParameter

                {

                    Name = parameter.Name,

                    In = "formData",

                    Description = parameter.Description,

                    Required = parameter.Required,

                    Type = "file"

                };   

                operation.Parameters.Add(p);

            }

        }

    }

在Startup类的ConfigureServices方法里注册该过滤器：

       public void ConfigureServices(IServiceCollection services)

        {

            services.AddMvc();

            services.AddCors();                      

            services.AddSwaggerGen(option =>

            {

                option.SwaggerDoc("v1", new Info

                {

                    Version = "v1",

                    Title = "SaleService接口文档",

                    Description = "RESTful API for SaleService.",

                    TermsOfService = "None",

                    Contact = new Contact { Name = "seabluescn", Email = "seabluescn@163.com", Url = "" }

                });

               

                option.OperationFilter<SwaggerFileUploadListFilter>();

                //Set the comments path for the swagger json and ui.

                var basePath = PlatformServices.Default.Application.ApplicationBasePath;

                var xmlPath = Path.Combine(basePath, "SaleService.xml");

                option.IncludeXmlComments(xmlPath);

            });

        }

此时可以通过swagger选择文件了

但有个缺点是只能上传一个文件，如何实现可以选择多个文件还不会搞。

循序渐进学.Net Core Web Api开发系列【5】：文件上传的更多相关文章

  1. 循序渐进学.Net Core Web Api开发系列【0】：序言与目录

    一.序言 我大约在2003年时候开始接触到.NET,最初在.NET framework 1.1版本下写过代码,曾经做过WinForm和ASP.NET开发.大约在2010年的时候转型JAVA环境,这么多 ...

  2. 循序渐进学.Net Core Web Api开发系列【16】：应用安全续-加密与解密

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 应用安全除 ...

  3. 循序渐进学.Net Core Web Api开发系列【15】：应用安全

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇介绍W ...

  4. 循序渐进学.Net Core Web Api开发系列【14】：异常处理

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇介绍异 ...

  5. 循序渐进学.Net Core Web Api开发系列【13】：中间件（Middleware）

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇介绍如 ...

  6. 循序渐进学.Net Core Web Api开发系列【12】：缓存

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇介绍如 ...

  7. 循序渐进学.Net Core Web Api开发系列【11】：依赖注入

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇介绍如 ...

  8. 循序渐进学.Net Core Web Api开发系列【10】：使用日志

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.本篇概述 本篇介 ...

  9. 循序渐进学.Net Core Web Api开发系列【9】：常用的数据库操作

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇描述一 ...

  10. 循序渐进学.Net Core Web Api开发系列【8】：访问数据库(基本功能)

    系列目录 循序渐进学.Net Core Web Api开发系列目录 本系列涉及到的源码下载地址:https://github.com/seabluescn/Blog_WebApi 一.概述 本篇讨论如 ...

随机推荐

  1. bzoj千题计划250：bzoj3670: [Noi2014]动物园

    http://www.lydsy.com/JudgeOnline/problem.php?id=3670 法一:KMP+st表 抽离nxt数组,构成一棵树 若nxt[i]=j,则i作为j的子节点 那么 ...

  2. hdu 6166 Senior Pan

    http://acm.hdu.edu.cn/showproblem.php?pid=6166 题意: 给出一张无向图,给定k个特殊点 求这k个特殊点两两之间的最短路 二进制分组 枚举一位二进制位 这一 ...

  3. 数学：拓展Lucas定理

    拓展Lucas定理解决大组合数取模并且模数为任意数的情况 大概的思路是把模数用唯一分解定理拆开之后然后去做 然后要解决的一个子问题是求模质数的k次方 将分母部分转化成逆元再去做就好了 这里贴一份别人的 ...

  4. Nodejs stream模块-翻译

    花了两天时间尝试按照自己的话翻译了一下stream模块,以下内容皆翻译于:https://nodejs.org/api/stream.html. 目录 1  Stream(流)     1.1     ...

  5. MySql数据库表设计规范

    建表规约 索引规约 SQL 语句 其他实战建议 选用utf8编码 建议使用InnoDB存储引擎 建议每张表都设置一个主键 建议字段定义为NOT NULL 唯一值字段要指定唯一性约束 ALTER TAB ...

  6. [原]Android Fragment 入门介绍

    Fragment Fragment 产生,优点,用途,使用方法简介 1 Fragmeng简介 自从Android 3.0中引入fragments 的概念,根据词海的翻译可以译为:碎片.片段.其上的是为 ...

  7. ASP.NET批量下载文件

    一.实现步骤 在用户操作界面,由用户选择需要下载的文件,系统根据所选文件,在服务器上创建用于存储所选文件的临时文件夹,将所选文件拷贝至临时文件夹.然后调用 RAR程序,对临时文件夹进行压缩,然后输出到 ...

  8. HDU 6395 Sequence 杜教板子题

    题目意思非常明确,就是叫你求第n项,据我们学校一个大佬说他推出了矩阵,但是我是菜鸡,那么肯定是用简单的方法水过啦!我们先p^(1/2)的复杂度处理出i=[i,p]范围内的所有种类的(int)(p/i) ...

  9. hdu GuGuFishtion 6390 数论 欧拉函数

    题目:http://acm.hdu.edu.cn/showproblem.php?pid=6390 直接开始证明: 我们设…………………………………….....…...............………… ...

  10. Linux下可以使用ps命令来查看Oracle相关的进程

    Linux下可以使用ps命令来查看Oracle相关的进程 Oracle Listener 这个命令会列出Oracle Net Listener的进程 [oracle@ www.linuxidc.com ...