其他分享
首页 > 其他分享> > .net怎么使用Swagger

.net怎么使用Swagger

作者:互联网

 

目录导航

一、安装

新建一个没有身份验证的mvc项目 - SwaggerMvc5Demo,然后添加一个名为Remote(自定义)且包含基础读写(不想手写)的ApiController   开源地址:https://github.com/domaindrivendev/Swashbuckle 使用以下方法来添加 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请求。  详细教程请看 https://www.cnblogs.com/Leo_wl/p/5982882.html   扩展:ABP集成swagger http://www.cnblogs.com/wer-ltm/p/5776024.html    

四、错误记录

swagger出现问题:not supported by swagger 2.0

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

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

原文:https://blog.csdn.net/jin80506/article/details/77737470

标签:Swagger,调用,Swashbuckle,https,使用,net,swagger,com
来源: https://www.cnblogs.com/txlit/p/11533676.html