c#在MVC Api(.net framework)当中使用Swagger,以及Demo下载
主要的步骤就是创建项目,通过nuget 添加Swashbuckle包,然后在SwaggerConfig当中进行相关的配置。
具体的步骤,可以参考下面的链接:
- https://www.cnblogs.com/94pm/p/8046580.html
- https://blog.csdn.net/xiaouncle/article/details/83995809
- https://www.cnblogs.com/dawenyang/p/10911051.html
根据需要,这里面添加了一些扩展。
其中2和3的部分是为了界面汉化和显示控制器说明。
1的部分是为了支持隐藏一些不需要暴露出来的控制器或者方法。具体怎么使用HiddenApi,请参考我写的两个控制器Demo
如下图所示,TestAPI20控制器(Controller)有2个 动作(Action),其中Test21可以正常出现在Swagger界面上,
而Test10因为上面标记的HiddenApi,而被隐藏。
-------------------------------------
备注两个特别的文章 :
一、让Swagger支持token
《【swagger】C# 中 swagger 的使用及避坑》
https://www.cnblogs.com/gl1573/p/12652708.html
二、解决跨方案(solution)、跨类库的注释问题
《swagger使用二:swagger配置多个项目注释》
https://www.cnblogs.com/eastday/p/6382613.html
流浪是注定的宿命;
漂泊是无尽的轮回。
漂泊是无尽的轮回。