目录

步骤一：安装

步骤二：创建 定义文件

步骤三：编写 YAML或者JSON、快速定位、本地调试

步骤四：预览 swagger-ui

步骤五：生成代码

---

OpenAPI

是一个规范的名称。

3.0版本的对RESTful API方面做得很好。

Swagger

是一个 API文档维护组织，后来成为了 Open API 标准的主要定义者。自2017年宣Swagger2停止维护，新发布的 Swagger3（Open Api3）。

OpenAPI ​(Swagger)​ Editor

OpenAPI ​(Swagger)​ Editor是 IntelliJ IDEA 的一款插件 https://plugins.jetbrains.com/plugin/14837-openapi-swagger-editor/versions

可以通过它来编写YAML使用完美定义Open Api规范的接口，生成Java代码。

演示工具：

IntelliJ IDEA 2021.1.2 (Ultimate Edition)

OpenAPI ​(Swagger)​ Editor 1.18

步骤一：安装

安装 OpenAPI ​(Swagger)​ Editor，同时OpenAPI Specifications会被绑定安装。

步骤二：创建 定义文件

例：选择 OpenApi3.0的yaml文件

步骤三：编写 YAML或者JSON、快速定位、本地调试

步骤四：预览 swagger-ui

步骤五：生成代码

1、设置api的定义文件

2、设置代码生成目录

3、设置生成器，此处加载自定义jar openapi-generator-cli-5.0.0.jar

4、然后运行即可