.net怎么使用Swagger

目录导航

一、安装

新建一个没有身份验证的mvc项目 - SwaggerMvc5Demo，然后添加一个名为Remote（自定义）且包含基础读写（不想手写）的ApiController

使用以下方法来添加 Swashbuckle：

1.项目属性->勾选生成xml文档文件

2.添加导航链接

在_Layout.cshtml文件中添加代码

<li>@Html.ActionLink("Swagger Help", "", "Swagger", new { area = "" }, null)</li>

3.修改SwaggerConfig.cs文件

安装完成后，在文件夹App_Start自动生成一个配置文件 swagger.config。这里可以做多版本控制，定义扩展功能，自定义显示ui的样式脚本，可以配置过滤、权限等。

例如：

（1）为接口添加xml注释

string path = string.Format("{0}/bin/SwaggerMvc5Demo.XML", System.AppDomain.CurrentDomain.BaseDirectory);

c.IncludeXmlComments(path);

使用前

使用后

（2）使用特性 [Obsolete]

在config中开启 c.IgnoreObsoleteProperties();

1.直接调用

只要输入参数id，即可调用，非常方便

2.AutoRest

AutoRest (https://github.com/Azure/AutoRest), 简单来说，就是一个EXE工具，可以根据Swagger的结构生成服务的客户端，这个客户端可以让你像调用本地方法一样调用服务，方法内部包装了Http请求。

扩展：ABP集成swagger

http://www.cnblogs.com/wer-ltm/p/5776024.html

一个controller中只能有一个HttpGet请求，多了就会报错。建议减少重载方法，将其他Get方法分开

如果在swagger.config中加上c.ResolveConflictingActions(apiDescriptions => apiDescriptions.FirstOrDefault());则会只显示第一个get方法