zoukankan      html  css  js  c++  java
  • webapi 利用webapiHelp和swagger生成接口文档

    webapi 利用webapiHelp和swagger生成接口文档。均依赖xml(需允许项目生成注释xml)

    webapiHelp:微软技术自带,仅含有模块、方法、请求-相应参数的注释。

    swagger:除了上述,还可以执行请求、获取响应等

    详细可看代码:https://gitee.com/nlh774/AspNetWebApiStudy   我是分步骤提交git的,所以应该很清楚。

    后期该项目会不断扩充,作为个人持续研究webapi的笔记

    另外,还可以利用vs2017 添加rest api客户端  生成调用方法,我自己写的demo   https://gitee.com/nlh774/AspNetWebApiStudy

    主要参考 https://www.red-gate.com/simple-talk/dotnet/net-development/visual-studio-2017-swagger-building-documenting-web-apis/

    以下2篇了解即可,没多大用暂时

    https://code-maze.com/different-ways-consume-restful-api-csharp/

    https://docs.microsoft.com/en-us/dotnet/csharp/tutorials/console-webapiclient

    webapi目前我个人只是了解阶段,还不能大规模应用。其实我看上的是他的Rest风格+swaggerUI+vs2017“添加rest api客户端“生成调用方法,非常节省开发对接时间。

    本人目前对MVC的api熟悉(就是本质是asp.net MVC,只是返回json)

  • 相关阅读:
    TCP协议
    各相机品牌型号分类
    思科华为命令对比
    网工笔记(一)
    数学笔记
    word快捷键汇总
    请个假
    word笔记
    ScrollView不能到顶部的解决方法
    Gridview 显示成正方形
  • 原文地址:https://www.cnblogs.com/nlh774/p/10149067.html
Copyright © 2011-2022 走看看