0%

Spring学习资料

Spring Boot

技术选型

数据库

前端

页面渲染

  • FreeMarker
  • Velocity

Swagger

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

Swagger能成为最受欢迎的REST APIs文档生成工具之一,有以下几个原因:

  • Swagger可以生成一个具有互动性的API控制台,开发者可以用来快速学习和尝试API。
  • Swagger可以生成客户端SDK代码用于各种不同的平台上的实现。
  • Swagger文件可以在许多不同的平台上从代码注释中自动生成。
  • Swagger有一个强大的社区,里面有许多强悍的贡献者。
  • Swagger文档提供了一个方法,使我们可以用指定的 JSON 或者 YAML 摘要来描述你的 API,包括了比如 names、order 等 API 信息。

我们可以通过一个文本编辑器来编辑 Swagger 文件,或者你也可以从你的代码注释中自动生成。
各种工具都可以使用 Swagger 文件来生成互动的 API 文档。