.Net core3.0 集成swagger5.0上传文件

.Net core 3.0已经更新了，相信有挺多博主大佬们都更新了如何在.Net core3.0使用swagger，这里就不详细说了。

我们知道，如果.net core 2.x使用swagger上传文件是需要写个操作过滤器的类。

public class SwaggerFileUploadFilter : 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(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);

                operation.Parameters.Add(new NonBodyParameter

                {

                    Name = parameter.Name,

                    In = "formData",

                    Description = parameter.Description,

                    Required = parameter.Required,

                    Type = "file"

                });

            }

        }

    }

需要在startup类中配置：

这样上传文件的api就有选择文件的按钮了：

然后升级到.net core 3.0 ，swagger目前4.x版本不支持，只能下5.x的预览版，然后一堆报错。首先配置中的Info 需要改成OpenApiInfo：

  services.AddSwaggerGen(c =>

            {

                c.SwaggerDoc("v1", new Info { Title = "Web API", Version = "v1" });

                var xmlPath = Path.Combine(AppContext.BaseDirectory, "swagger.xml");

                c.IncludeXmlComments(xmlPath);

                c.OperationFilter<SwaggerFileUploadFilter>();

            });

改成：

  services.AddSwaggerGen(c =>

            {

                c.SwaggerDoc("v1", new OpenApiInfo { Title = "Web API", Version = "v1", Description = "Web API" });

                var xmlPath = Path.Combine(AppContext.BaseDirectory, "swagger.xml");

                c.IncludeXmlComments(xmlPath);

            });

而且swagger 5.0版本不需要手动写过滤器类，也就是

SwaggerFileUploadFilter

上文提到的这个类。

直接正常写api就可以了，不过IFormFile参数一定不要加[FromBody]这个特性。就像这样：

        /// <summary>

        /// 上传文件

        /// </summary>

        /// <param name="formFile">文件</param>

        /// <returns></returns>

        [HttpPost]

        public IActionResult test(IFormFile formFile)

        {

            return Ok("靓仔");

        }

然后打开swagger就可以看到：

结束！