zoukankan      html  css  js  c++  java
  • swagger使用二:swagger配置多个项目注释

    在项目中采用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。

    可以显示出实体层的注释了,完毕。

  • 相关阅读:
    HDOJ 1069_大二写
    HDOJ 2037:今年暑假不AC_大二写
    第二次HDOJ:1058
    HDOJ 1019
    第二次 HDOJ 1003
    第二次做HDOJ 1051
    memset()的用法
    数据结构中的频度含义
    程序框图的书写
    python课堂整理22----装饰器进阶
  • 原文地址:https://www.cnblogs.com/eastday/p/6382613.html
Copyright © 2011-2022 走看看