(轉)WebApi自動生成在線文檔Swashbuckle

　　原文地址：http://www.cnblogs.com/Arrays/p/5146194.html?utm_source=tuicool&utm_medium=referral

　　

1.前言

1.1 SwaggerUI

SwaggerUI 是一個簡單的Restful API 測試和文檔工具。簡單、漂亮、易用（官方demo）。經過讀取JSON 配置顯示API. 項目自己僅僅也只依賴一些 html,css.js靜態文件. 你能夠幾乎放在任何Web容器上使用。

1.2 Swashbuckle

Swashbuckle 是.NET類庫,能夠將WebAPI全部開放的控制器方法生成對應SwaggerUI的JSON配置。再經過SwaggerUI 顯示出來。類庫中已經包含SwaggerUI 。因此不須要額外安裝。

2.版本和資源

你能夠經過下列鏈接獲取相關說明。

Swashbuckle 項目地址：
https://github.com/domaindrivendev/Swashbuckle
swagger-ui 項目地址：
https://github.com/swagger-api/swagger-ui
swagger-ui 官網地址：
http://swagger.io/swagger-ui/

3.快速開始

• WebAPI 安裝 Swashbuckle

  Install-Package Swashbuckle

• 瀏覽器訪問

  http://<yourhostname>.com/swagger/ui/index

• 若是不出意外則顯示
  

  4.代碼註釋生成文檔說明。

  Swashbuckle 是經過生成的XML文件來讀取註釋的，生成 SwaggerUI，JSON 配置中的說明的。
  安裝時會在項目目錄 App_Start 文件夾下生成一個 SwaggerConfig.cs 配置文件，用於配置 SwaggerUI 相關展現行爲的。如圖：

將配置文件第99行,註釋去掉，並修改成

c.IncludeXmlComments(GetXmlCommentsPath(thisAssembly.GetName().Name));

並在當前類中添加以下代碼

/// <summary> /// </summary> /// <param name="name"></param> /// <returns></returns> protected static string GetXmlCommentsPath(string name) { return string.Format(@"{0}\bin\{1}.XML", AppDomain.CurrentDomain.BaseDirectory, name); }

緊接着你在此Web項目屬性選型，生成選卡中 選擇 「XML 文檔文件」

打開控制 "ValuesController" 添加註釋

using System; using System.Collections.Generic; using System.Linq; using System.Net; using System.Net.Http; using System.Web.Http; using ClassLibrary1; namespace WebApplication1.Controllers { [Authorize] public class ValuesController : ApiController { //some code..... /// <summary> /// 根據ID獲取一個值 /// </summary> /// <param name="id">值的ID</param> /// <remarks>當前方法根據ID獲取一個值</remarks> /// <returns>返回</returns> public string Get(int id) { return "value"; } // some code .... } } 

保存重寫生成. 如圖