net core 3.1 swagger

2021-01-28 20:13

阅读：714

标签：exec pre class ret tco art 自动 sed herf

1、引入最新版的swaager

Install-Package Swashbuckle.AspNetCore -Version 5.0.0-rc4

2、在startup类中的ConfigureServices 方法中的服务集合中添加如下代码

// Register the Swagger generator, defining 1 or more Swagger documents
    services.AddSwaggerGen(c =>
    {
        c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
    });

3、在startup类中的Configure 方法中启用中间件为生成的 JSON 文档和 Swagger UI 提供服务

 // Enable middleware to serve generated Swagger as a JSON endpoint.
    app.UseSwagger();

    // Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.),
    // specifying the Swagger JSON endpoint.
    app.UseSwaggerUI(c =>
    {
        c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1");
    });

4、运行项目并在浏览器访问swaager/index.html,结果如下：

技术图片

5、swagger显示xml注释

5.1给接口加一个注释

        /// 
        /// 获取天气预报（get）
        /// 
        /// 
        [HttpGet]
        public IEnumerable Get()

5.2右键点击项目---->属性------>生成------>勾选xml文档文件

技术图片

5.3在startup类中的ConfigureServices 方法中的服务集合中添加如下代码

 //注册swagger 
            services.AddSwaggerGen(c =>
            {
                c.SwaggerDoc("v1", new OpenApiInfo { Title = "My API", Version = "v1" });
                var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
                var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
                c.IncludeXmlComments(xmlPath,true); //添加控制器层注释（true表示显示控制器注释）
           
            });

5.4运行项目并访问swaggerUI

技术图片

6、生成swaggerUI 规范，直接访问如下链接，会自动生成一个swagger.json的json文件。

swagger/v1/swagger.json

net core 3.1 swagger

标签：exec pre class ret tco art 自动 sed herf

原文地址：https://www.cnblogs.com/LiuFengH/p/13208665.html

上一篇：js拖拽功能的实现

下一篇：深入探究ASP.NET Core异常处理中间件

文章来自：搜素材网的编程语言模块，转载请注明文章出处。
文章标题：net core 3.1 swagger
文章链接：http://soscw.com/index.php/essay/48373.html

亲，登录后才可以留言！

net core 3.1 swagger

评论

热门文章

推荐文章

最新文章

置顶文章