zoukankan      html  css  js  c++  java
  • (转)创建WebAPI文档的3个简单步骤

    默认情况下,Microsoft.AspNet.WebApi.HelpPage创建的API帮助页不包含任何文档。 我们会看到所有的ApiController动作都列在No documentation available.

    要启用文档,我们只需要遵循三个简单步骤。

    步骤1-在控制器级别上

    为了测试目的,创建了一个新的ApiController,名为DocumentationsController

    
    public class DocumentationsController : ApiController
    {
     // GET api/documentation
     public IEnumerable<string> Get()
     {
     return new string[] {"value1","value2" };
     }
    ....
    

    在控制器操作前点击///以获取文档。

    
    // GET api/documentation
    /// <summary>
    /// This is how we create a documentation
    /// </summary>
    /// <returns></returns>
    public IEnumerable<string> Get()
    ....
    

    有关可以记录的内容的详细信息,可以按"<"来出现IntelliSense,或转到MSDN页面

    步骤2-生成属性

    调出项目属性页,并且设置文档的xml输出,在本例中,文档文件将是App_DataDocumentation.XML

    步骤3- HelpPage配置

    若要将HelpPageConfig设置为使用我们的文档xml文件,请转到~AreasHelpPageHelpPageConfig.cs

    默认情况下,config.SetDocumentationProvider语句被注释掉,使用该语句,并将DocumentationProvider的位置指向我们的xml文件:

    
    public static void Register(HttpConfiguration config)
    {
     // Uncomment the following to use the documentation from XML documentation file.
     config.SetDocumentationProvider(
     new XmlDocumentationProvider(
     HttpContext.Current.Server.MapPath("~/App_Data/Documentation.xml")));
    

    现在我们可以做一个构建和刷新api documenation页面:略

    其它参考资料:https://www.cnblogs.com/AntonWang/p/5208655.html

    解决swagger跨程序集问题:https://www.cnblogs.com/ricolee/p/swagger-summary.html

  • 相关阅读:
    007-搭建框架-开发AOP框架
    007-安装百度云,搜狗输入法,播放器
    006-重装yum
    005-快捷键,host,查看版本
    004-ibus输入法,快捷键,浏览器
    003-centos搭建idea开发java
    002-命令行模式安装图形界面
    006-网站统计中的数据收集原理及实现
    007-sql整体概述
    017-Hadoop Hive sql语法详解7-去重排序、数据倾斜
  • 原文地址:https://www.cnblogs.com/hhhh2010/p/12605579.html
Copyright © 2011-2022 走看看