目录
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、然后运行即可