热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

更多_想说爱你不容易|使用最小WEBAPI实现文件上传(Swagger支持)

篇首语:本文由编程笔记#小编为大家整理,主要介绍了想说爱你不容易|使用最小WEBAPI实现文件上传(Swagger支持)相关的知识,希望对你有一定的参考价值。

篇首语:本文由编程笔记#小编为大家整理,主要介绍了想说爱你不容易 | 使用最小 WEB API 实现文件上传(Swagger 支持)相关的知识,希望对你有一定的参考价值。



前言

上回,我们使用最小 WEB API 实现文件上传功能(《想说爱你不容易 | 使用最小 WEB API 实现文件上传》),虽然客户端访问是正常的,但是当打开 Swagger 页面时,发现是这样的:



没法使用 Swagger 页面测试。


允许 Content Type

正常的 Swagger 页面应该是这样的:



看来,我们需要指定 Content Type:


app.MapPost("/upload",
    async (HttpRequest request) =>
    
        var form = await request.ReadFormAsync();
        return Results.Ok(form.Files.First().FileName);
    ).Accepts("multipart/form-data");

结果,Swagger 页面变成了这样,增加了一堆 Form 相关属性,唯独没有 file :



看来,只有自定义 Swagger 页面了。


自定义 OperationFilter

在 OpenAPI 3.0 中,文件上传的请求可以用下列结构描述(https://swagger.io/docs/specification/describing-request-body/file-upload/):



而在 Swashbuckle 中,可以使用 IOperationFilter 接口实现操作筛选器,控制如何定义 Swagger UI 的行为。


在这里,我们将利用 RequestBody 对象来实现上述的文件上传的请求结构。


public class FileUploadOperationFilter : IOperationFilter
    public void Apply(OpenApiOperation operation, OperationFilterContext context)
    
        const string FileUploadContentType = "multipart/form-data";
        if (operation.RequestBody == null ||
            !operation.RequestBody.Content.Any(x =>
            x.Key.Equals(FileUploadContentType, StringComparison.InvariantCultureIgnoreCase)))
        
            return;
         
        
        if (context.ApiDescription.ParameterDescriptions[0].Type == typeof(HttpRequest))
        
            operation.RequestBody = new OpenApiRequestBody
            
                Description = "My IO",
                Content = new Dictionary
                
                    
                        FileUploadContentType, new OpenApiMediaType
                        
                            Schema = new OpenApiSchema
                            
                                Type = "object",
                                Required = new HashSet "file" ,
                                Properties = new Dictionary
                                
                                    
                                        "file", new OpenApiSchema()
                                        
                                            Type = "string",
                                            Format = "binary"
                                        
                                    
                                
                            
                        
                    
                
            ;
        
    

然后,在启动代码中配置,应用此操作筛选器:


builder.Services.AddSwaggerGen(setup =>
    setup.OperationFilter();
);

这将呈现如下 Swagger 页面:



结论

今天,我们使用 IOperationFilter 解决了最小 WEB API 实现文件上传的 Swagger 支持。


想了解更多内容,请关注我的个人公众号”My IO“


推荐阅读
author-avatar
浅浅的醉意_942_932
这个家伙很懒,什么也没留下!
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有