一、Swagger配置

1、注解不显示

SwaggerConfig文件下

SRE实战 互联网时代守护先锋,助力企业售后服务体系运筹帷幄!一键直达领取阿里云限量特价优惠。

  //c.IncludeXmlComments(GetXmlCommentsPath());  内下面添加:

c.IncludeXmlComments(Path.Combine(System.AppDomain.CurrentDomain.BaseDirectory, @"bin\YDShengya_WebApi.xml"));

 一、Swagger配置 随笔 第1张 

然后报错一、Swagger配置 随笔 第2张

未能找到输出的XML文件 -我去bin目录也没有找到

具体解决方案:

 原本调试环境下配置的

一、Swagger配置 随笔 第3张

在发布配置下Release 也配置输出生成XML才ok

一、Swagger配置 随笔 第4张

保存即可发布-包含XML的文件 

注意:运行时提示  

请将注册表值 [HKLM\Software\Microsoft\Fusion!EnableLog] (DWORD)设置为 1

一、Swagger配置 随笔 第5张  即可。

 

2、使用Swagger 让某些接口不显示在文档

 在Action 上加[ApiExplorerSettings(IgnoreApi = true)]

[HttpGet] 
[ApiExplorerSettings(IgnoreApi = true)] 
public ActionResult Index(string appKey , string username ) 
{ 
//todo 
}

  

3、Swagger默认路由

Core是在StartUp.cs文件配置

一、Swagger配置 随笔 第6张

基于framework 配置swagger

 

 

 

3、MVC和WebApi路由区别汇总

WebApi的默认路由机制通过http请求的类型匹配Action,MVC的默认路由机制通过url匹配Action
WebApi的路由配置文件是WebApiConfig.cs,MVC的路由配置文件是RouteConfig.cs
WebApi的Controller继承自Web.Http.ApiController,MVC的Controller继承自Web.Mvc.Controller

  

 

扫码关注我们
微信号:SRE实战
拒绝背锅 运筹帷幄