认识 Swagger

Question

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

作用：

1. 接口的文档在线自动生成。
2. 功能测试。

Swagger 是一组开源项目，其中主要要项目如下：

1. Swagger-tools：提供各种与 Swagger 进行集成和交互的工具。例如模式检验、Swagger 1.2 文档转换成 Swagger 2.0 文档等功能。
2. Swagger-core：用于 Java/Scala 的的 Swagger 实现。与 JAX-RS(Jersey、Resteasy、CXF...)、Servlets 和 Play 框架进行集成。
3. Swagger-js：用于 JavaScript 的 Swagger 实现。
4. Swagger-node-express：Swagger 模块，用于 node.js 的 Express web 应用框架。
5. Swagger-ui：一个无依赖的 HTML、JS 和 CSS 集合，可以为 Swagger 兼容 API 动态生成优雅文档。
6. Swagger-codegen：一个模板驱动引擎，通过分析用户 Swagger 资源声明以各种语言生成客户端代码。