• api文档管理工具


    优秀的框架都有一个特点:文档和示例非常多,为了方便前后端对接,经常需要自己为代码写注释,为了解放繁琐且易出错的手写API文档,本文总结一下使用过的文档生成工具。
    1、 Swagger
    生成的接口文档可以直接在线测试,省去了使用 Postman 设置接口参数的过程,而且请求参数,返回参数一目了然。只是需要提前写大量的注解,加上复杂模块的弱势导致我没有继续用。

    2、 Eolinker
    围绕文档进行工作的模式,一开始只是尝试区别于先开发再写文档,没想到意外的好用,效率提升了不少,还能直接导入Swagger的Json文件,降低了转用的成本。
    我现在一直在用的就是这个,后面还发现这是个集成性的工具,其他功能也挺好用的,这里就不展开了。

    3、 Apizza
    开发时调试接口后,文档就可以同步生成。很方便,就是BUG有点多…

    4、 JApiDocs
    一个开源的 SpringBoot API 文档生成工具,无需额外注解,厌烦了 Swagger 满屏的注解和额外的工作量可以试一试,我是因为配置麻烦放弃掉了。

    希望大家都能找到自己觉得好用的文档生成工具。

  • 相关阅读:
    CSS div 塌陷问题
    jquery 选择器包含特殊字符
    ASP.NET Core Action 读取流
    SQL 列拼接使用
    bootstrap div 固定
    Jquery 操作HTML5自定义属性data-*
    Vue 页面加载闪现代码问题
    iframe 加载完成事件
    closest
    【开发者的精进】 数据驱动下的程序设计
  • 原文地址:https://www.cnblogs.com/dc20181010/p/13882294.html
Copyright © 2020-2023  润新知