swagger使用二:swagger配置多个项目注释
2017-02-09 16:12
706 查看
在项目中采用swagger测试接口,提供接口给其他人员都非常的方便.
在swagger默认配置中,默认只显示接口访问层中的注释,可是很多的参数说明都已经在实体层中了啊?(如下图)不可能再把实体层中的模型再搬过来吧,这样子重复性也太大了.
经过一番摸索,发现swagger可以同时支持多个路径的.
1.修改swagger的配置,添加多个文件路径.
2.修改实体层生成时,注释文档保存的位置,注意需要修改到接口访问层中的路径.
保存,重新生成,再访问swagger。
可以显示出实体层的注释了,完毕。
在swagger默认配置中,默认只显示接口访问层中的注释,可是很多的参数说明都已经在实体层中了啊?(如下图)不可能再把实体层中的模型再搬过来吧,这样子重复性也太大了.
经过一番摸索,发现swagger可以同时支持多个路径的.
1.修改swagger的配置,添加多个文件路径.
c.IncludeXmlComments(GetXmlControllersCommentsPath()); c.IncludeXmlComments(GetXmlModelCommentsPath());
private static string GetXmlControllersCommentsPath() { return System.IO.Path.Combine(System.Web.HttpRuntime.AppDomainAppPath, "./App_Data/WebApi.XML"); } private static string GetXmlModelCommentsPath() { return System.IO.Path.Combine(System.Web.HttpRuntime.AppDomainAppPath, "./App_Data/Model.XML"); }
2.修改实体层生成时,注释文档保存的位置,注意需要修改到接口访问层中的路径.
保存,重新生成,再访问swagger。
可以显示出实体层的注释了,完毕。
相关文章推荐
- Nginx配置多个项目使用同一端口号的办法
- Nginx配置多个项目使用同一端口号的办法
- 请教,一个解决方案中包含多个相互引用的项目,该如何配置?
- 使用Log4j为项目配置日志输出应用详解以及示例演示的实现分析
- WEB项目中,让FineReport6.5使用Tomcat下所配置的JNDI数据源
- [项目过程中所遇到的各种问题记录]ORM篇——使用NHibernate配置对象实体的一些小问题
- Web应用程序项目OxiteSite已配置为使用IIS.在本地计算机上找不到服务器
- 使用 Visual Studio .NET 开发 Web 项目的远程服务器配置
- 大型项目使用Automake/Autoconf完成编译配置(2)——步步为营
- weblogic 9.2 配置使用及web项目部署
- spring项目中log4j使用配置
- [项目过程中所遇到的各种问题记录]ORM篇——使用NHibernate配置对象实体的一些小问题 22
- 使用VIM开发软件项目 - (4) 保存项目相关配置
- jsf 如何在项目中使用之-导航栏的配置-上
- 使用flex Builder3配置与开发AS3项目详解
- Quartz 最简单使用,没有用到配置文件,不适用于项目
- [导入]Visual Studio 中多个项目通过链接方式共享使用同一个文件
- 项目中使用Spring时配置web.xml的listener侦听接口不能初始化的问题
- 不同的项目使用同一个配置文件
- 在apache中配置多个站点使用同一个ip