ASP.NET Web API 使用Swagger生成在線幫助測試文檔,支持多個GET

 

如下爲教程:

 

在現有webapi項目中,nuget安裝如下兩個插件

swagger.net.ui

swashbuckle

 安裝完畢後能夠卸載Swagger.NET,此處不須要!

安裝完畢後屏蔽如下代碼

直接運行調試

在瀏覽器的目錄後面加上/swagger便可跳轉到swagger調試頁

此時若是沒有註釋.

項目屬性裏添加xml註釋的生成

修改App_Start下的SwaggerConfig.cs文件

 添加以下代碼

            GlobalConfiguration.Configuration
                .EnableSwagger(c =>
                    {
                        c.IncludeXmlComments(GetXmlCommentsPath());
......
}

 

  protected static string GetXmlCommentsPath()
        {
            return System.String.Format(@"{0}\bin\你的xml文件名.XML", System.AppDomain.CurrentDomain.BaseDirectory);
        }

此時從新生成瀏覽能夠獲取正確的註釋並調試了.

 異常解決

報錯

webapi 配置swagger出現問題：

Swagger Not supported by Swagger 2.0: Multiple operations with path 解決方法

一個controller中只能有一個HttpGet請求，多了就會報錯。建議減小重載方法，將其餘Get方法分開

若是在swagger.config中加上c.ResolveConflictingActions(apiDescriptions => apiDescriptions.First());則會只顯示第一個get方法

 

異常2

加了上面的方法後,get可能會只顯示一條記錄

WebAPI 默認只支持一個get方法,支持多個Get須要修改

RouteConfig文件

   routes.MapRoute(
                name: "Default",
                url: "{controller}/{action}/{id}",
                defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
            );

 

所以,須要對swagger.net也添加相應的支持.

 public static void RegisterRoutes(RouteCollection routes)
        {
            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
            RouteTable.Routes.MapHttpRoute(
               name: "SwaggerApi",
               routeTemplate: "api/docs/{controller}/{action}",
               defaults: new { swagger = true }
           );
            routes.MapRoute(
                name: "Default",
                url: "{controller}/{action}/{id}",
                defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }
            );
        }

以上

config.Routes.MapHttpRoute(
                name: "DefaultApi",
                //   routeTemplate: "api/{controller}/{id}",
                routeTemplate: "api/{controller}/{action}/{id}",
                  //defaults: new { id = RouteParameter.Optional }
                  defaults: new { controller = "Home", action = "Index", id = RouteParameter.Optional }
            );

 

 

完成

 

異常3

fetching resource list: http://localhost:8011/swagger/docs/v1; Please wait.

一直顯示這個界面

 

只返回Json Result的content negotiation代替Web Api中默認的content negotiation形成的.

WebApiConfig

config.Services.Replace(typeof(IContentNegotiator), new JsonContentNegotiator(jsonFormatter));

臨時屏蔽便可