.Net Core之Swagger

最新推荐文章于 2024-06-29 09:44:07 发布

2Ker

最新推荐文章于 2024-06-29 09:44:07 发布

阅读量1.3k

点赞数

分类专栏： .Net Core Swagger WebApi

本文链接：https://blog.csdn.net/sinat_14899485/article/details/88596695

版权

本文介绍了如何在.Net Core WebApi中集成Swagger，特别提到了使用Swashbuckle和NSwag的情况。针对Swashbuckle加载速度慢的问题，推荐使用NSwag，因为其页面响应更流畅，并且详细说明了相关自定义功能。

摘要由CSDN通过智能技术生成

.Net Core之Swagger

WebApi + Swagger是绝配，这里主要使用Swashbuckle和NSwag

.Net Core WebApi集成Swagger主要使用Swashbuckle，但是Swashbuckle得页面真的比较卡慢，这时候使用NSwag的页面明显流畅得多：

public static class SwaggerExtension
{
    public static void AddMySwagger(this IServiceCollection services)
    {
        services.AddSwaggerGen(c =>
        {
            //需要项目启动xml生成功能，swagger可以自动提取注释
            c.SwaggerDoc("v1", new Info { Title = "XX API", Version = "v1" });
            var filePath = Path.Combine(AppContext.BaseDirectory, "xx.xml");
            c.IncludeXmlComments(filePath, true);
            //默认的api排序不是按照字母来的，可自定义IDocumentFilter重排序
            c.DocumentFilter<TagReOrderDocumentFilter>();
            //默认情况下没法识别文件上传，可自定义IOperationFilter提供上传文件的功能
            c.OperationFilter&l