swagger使用二:swagger配置多个项目注释
Posted zhangyang529
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了swagger使用二:swagger配置多个项目注释相关的知识,希望对你有一定的参考价值。
转载:https://www.cnblogs.com/eastday/p/6382613.html
在项目中采用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。
可以显示出实体层的注释了,完毕。
以上是关于swagger使用二:swagger配置多个项目注释的主要内容,如果未能解决你的问题,请参考以下文章