zoukankan      html  css  js  c++  java
  • 初识 Swagger

    什么是Swagger:

         Swagger是一个规范完整的框架,用于生成、描述、调用和可视化RESTful风格的Web服务。总体目标是使客户端文件系统作为服务器以同样的速度来更新。接口的方法,参数和模型紧密集成到服务端的代码,允许API来始终保持同步。Swagger让部署管理和使用功能强大的API从未如此简单。

         在实际开发过程,我们的RESTfulAPI就有可能要面对多个开发人员或者多个开发团队:IOS开发、Android开发、Web开发。为了减少与其他团队平时开发期间的频繁沟通成本,传统做法我们会创建一份RESTful文档来记录所有接口细节,然而这样的做法有以下几个问题:

    》》》由于接口众多,并且细节复杂(需要考虑不同的HTTP请求类型、HTTP头部信息、HTTP请求内容等)

    》》》随着时间的推移,不断地修改接口实现地时候都必须同步修改接口文档,而文档与代码又处于两个不同地媒介,除非有严格的管理机制,不然很容易导致不一致现象

        而swagger完美的解决了上面的几个问题,并与Spring boot程序配合组织出强大的RESTful API文档。它既可以减少我们创建文档的工作量,同时说明内容又整合入实现代码中,让维护文档和修改代码整合为一体,可以让我们修改代码逻辑的同时方便的修改文档说明。另外Swagger2也提供了强大的页面测试功能,来调试每个RESTful API

        

  • 相关阅读:
    餐饮点菜控件
    数据模块池
    关于sqlite数据库
    PHP使用DateTime类做时间日期到字符串转换
    php字符串比较函数
    Xdebug开源PHP程序调试器
    ubuntu chmod 无法更改 文件夹权限 系统提示“不允许的操作 2、linux 如何修改只读文件 3、ubuntu安装
    ubuntu的命令day1
    linux用终端上传文件和文件家到远程的服务器
    Symfony学习--原创。。。。
  • 原文地址:https://www.cnblogs.com/xiaofanblog/p/11430228.html
Copyright © 2011-2022 走看看