.Net WebApi接口调试之Swagger集成详解

引:以前没有写博的习惯,后来 在网上看到有些问题被一些刚入行的同学问来问去没有完整的教程供他们参考,决定以后也把自己的一些经验分享到网上,希望能帮助其他同学的同时,更多的与大家交流!有不对的地方还请多多指点,互相学习,共同进步。

本文详细的介绍了.net从一个新的项目中创建api后集成swagger调试接口的流程!

1、首先我们创建一个MVC项目(VS2012):

.Net WebApi接口调试之Swagger集成详解_第1张图片

2、然后在项目中的Controllers文件夹中添加API接口文件(WebApi):

.Net WebApi接口调试之Swagger集成详解_第2张图片

创建之后,接口中随便写一个获取信息的方法:

.Net WebApi接口调试之Swagger集成详解_第3张图片

.Net WebApi接口调试之Swagger集成详解_第4张图片

3、集成swagger,通过nuget管理平台添加(右键网站项目-->管理NuGet程序包):

.Net WebApi接口调试之Swagger集成详解_第5张图片

安装之后生成的swagger配置文件:

.Net WebApi接口调试之Swagger集成详解_第6张图片

4、安装之后还没法正常访问swagger,需要配置网站属性:

.Net WebApi接口调试之Swagger集成详解_第7张图片

.Net WebApi接口调试之Swagger集成详解_第8张图片

protected static string GetXmlCommentsPath()
        {
            var re = System.String.Format(@"{0}\bin\APIExample.XML", System.AppDomain.CurrentDomain.BaseDirectory);
            return re;
        }

XML名称必须与网站生成的XMl名称一致。

5、大功告成:

.Net WebApi接口调试之Swagger集成详解_第9张图片

没有默认读取到自己接口文件的,请去SwaggerNet.cs文件中配置路由地址:

.Net WebApi接口调试之Swagger集成详解_第10张图片

补充,如果想在swagger界面显示自己的方法名,在方法名前加Route指令试试,由于我目前的web.http.dll库版本有点低,还不支持,升级后再试,不过小伙伴可以先试试。如图:

.Net WebApi接口调试之Swagger集成详解_第11张图片

完!

有什么问题欢迎交流:Q、397874468


你可能感兴趣的:(.Net/C#)