C# 接口生成工具Swagger用法

1，新建一个WebApi项目

 

 2，项目打开之后，引用--》右键--》管理NuGet程序包

 

 

3，按账好之后，右键项目--》属性--》生成  输出勾选：XML文档文件，如果没有自动填充好路径，需要自己填写一下，文件名可以自己取

 

 4，打开App_Start文件夹下的SwaggerConfig.cs文件，新增一个如下方法：

 

 5，搜索GetXmlCommentsPath，下面能搜到已经注释了，自己把注释放开，要是没搜到，就自己手动写一下c.IncludeXmlComments(GetXmlCommentsPath());注意要写在register方法里面

 

 6，打开valuescontroller，自己写一些注释

 

 7，运行项目，在根路径后面直接加swagger，就会自动跳转到文档，如：http://localhost:8970/swagger，能看到我们写的一些注释

 

 8，在实际应用中，完全使用webapi的restful风格的api设计是比较少见的，请求方式一般也只使用get请求和post请求，所以我们做一些修改，使用的是类似restful风格的api设计，修改一下webapi的路由配置

 

 9，在Controllers中添加一个TestController.cs

using System;

using System.Collections.Generic;

using System.Linq;

using System.Net.Http;

using System.Web;

using System.Web.Http;

 

namespace 接口生成工具Swagger.Controllers

{

    public class TestController:ApiController

    {

        /// <summary>

        /// get列表

        /// </summary>

        /// <returns></returns>

        public IEnumerable<string> Get()

        {

            return new string[] { "value1", "value2" };

        }

 

        /// <summary>

        /// get请求

        /// </summary>

        /// <param name="id"></param>

        /// <returns></returns>

        public string Get(int id)

        {

            return "value";

        }

 

        /// <summary>

        /// post请求

        /// </summary>

        /// <param name="token"></param>

        /// <param name="model"></param>

        /// <returns></returns>

        //public HttpResponseMessage Post(string token, [FromBody]UserModel model)

        //{

        //    CookieHelper.SetUserCookie(model);

        //    string strResult = "{\"UserName\": \"" + model.UserName + "\", \"Pwd\": \"" + model.Pwd + "\"}";

        //    return new HttpResponseMessage(System.Net.HttpStatusCode.OK)

        //    {

        //        Content = new StringContent(strResult, Encoding.UTF8, "text/json")

        //    };

        //}

    }

}

　　10,运行 输入http://localhost:64956/api/Test/Get