IDEA插件:OpenAPI ​(Swagger)​ Editor的使用(swagger3、OpenAPI3、swagger-codegen生成java代码)

目录

步骤一:安装

步骤二:创建 定义文件

步骤三:编写 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、然后运行即可

Micronaut框架提供了生成OpenAPI Swagger文档的功能。要在Micronaut项目中生成OpenAPI Swagger文档,你可以按照以下步骤进行操作: 1. 首先,确保你的Micronaut项目中已经添加了Swagger支持的依赖。在你的构建工具(如Gradle或Maven)的配置文件中,添加以下依赖: Gradle: ```groovy implementation &#39;io.swagger.core.v3:swagger-core:2.1.1&#39; implementation &#39;io.swagger.core.v3:swagger-jaxrs2:2.1.1&#39; implementation &#39;io.swagger.core.v3:swagger-annotations:2.1.1&#39; ``` Maven: ```xml <dependency> <groupId>io.swagger.core.v3</groupId> <artifactId>swagger-core</artifactId> <version>2.1.1</version> </dependency> <dependency> <groupId>io.swagger.core.v3</groupId> <artifactId>swagger-jaxrs2</artifactId> <version>2.1.1</version> </dependency> <dependency> <groupId>io.swagger.core.v3</groupId> <artifactId>swagger-annotations</artifactId> <version>2.1.1</version> </dependency> ``` 2. 在你的Micronaut应用程序的配置文件中,添加以下配置: ```yaml micronaut: application: openapi: paths: # 设置OpenAPI文档生成的路径 spec: /swagger ``` 3. 在你的Micronaut应用程序的控制器类或方法上,使用Swagger注解来描述API的信息,例如: ```java import io.micronaut.http.MediaType; import io.micronaut.http.annotation.Controller; import io.micronaut.http.annotation.Get; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.tags.Tag; @Controller("/api") @Tag(name = "Example") public class ExampleController { @Get(value = "/hello", produces = MediaType.TEXT_PLAIN) @Operation(summary = "Say hello") public String hello() { return "Hello World!"; } } ``` 4. 启动你的Micronaut应用程序,并访问`http://localhost:port/swagger`,其中`port`是你应用程序的端口号。你将能够看到生成OpenAPI Swagger文档,并可以在Swagger UI中浏览和测试API。 以上就是在Micronaut项目中生成OpenAPI Swagger文档的基本步骤。通过使用Swagger注解,你可以进一步定制和描述你的API。请注意,这只是Micronaut生成OpenAPI Swagger文档的一种方法,你也可以使用其他工具或插件来实现相似的功能。
评论 6
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值