74得票3回答
将OpenAPI 3.0转换为Swagger 2.0

有没有一种转换器可以将OpenAPI 3.0转换成Swagger 2.0? Mashery是一个API网关,需要在输入端使用Swagger 2.0格式以打开终端节点。

49得票3回答
OpenAPI工具生成器与Swagger Codegen的比较

我在依赖和工具中迷失了方向: 我之前使用以下工具为我的Swagger Web服务生成代码: swagger-codegen-cli https://mvnrepository.com/artifact/io.swagger.codegen.v3/swagger-codegen-cli/3...

48得票3回答
有没有办法在生成过程中配置openapi-generator使用jakarta包?

我最近升级了我的项目,使用了spring-boot 3.0.0。因此,在项目中我不再使用javax.*模块。但是Open API生成器仍然试图导入javax模块。特别是,它使用了javax.annotation.Generated来进行@Generated注解,而这个注解在项目中已经不存在了。...

33得票5回答
使用java.time.Instant代替OffsetDateTime来表示日期时间

我正在使用 openApi maven插件 为REST api生成Java请求/响应。请求中有一个DateTime属性,当我运行生成器时,生成的属性的DateTime属性以java.time.OffsetDateTime表示。问题在于,我需要将该属性表示为java.time.Instant。这...

31得票4回答
如何在使用openapi-generator-maven-plugin生成Spring代码时,使用OpenAPI的"oneOf"属性?

我正在开发一个应用程序,使用Angular前端和RESTful Spring Boot后端。 我发现这个非常方便的maven插件openapi-generator-maven-plugin来自org.openapitools。它具有代码生成能力,可以帮助我们在前端和后端API之间强制使用“契约...

27得票2回答
Swagger Codegen(带有Maven插件)用于OpenAPI3.0

我希望使用Swagger Codegen处理OpenAPI 3.0的YAML文件。我看到Swagger Codegen 3.0.0-rc0已经发布。但是当我尝试使用时遇到了问题。以下是详细信息: 我的pom.xml文件中有swagger-codegen插件:<plugin> ...

23得票5回答
OpenAPI SpringBoot Generator Jackson无法从String值反序列化,因为没有String参数构造函数/工厂方法。

我正在使用 OpenApi SpringBoot 生成器来生成控制器接口和模型。这将创建带有可为空字段的 JsonNullable<String> 模型类。然而,当在可为空字段中发送具有值的 POST 请求时,我会收到 Jackson 的类型定义错误。com.fasterxml.j...

21得票4回答
如何使用openAPI Generator和Maven跳过支持文件和元数据文件的生成?

我正在使用Maven和openapi-yaml生成器将一个swagger文件转换成一个OpenAPI v3文件。 我想要做的是直接把新文件放到某个目录中。 然而,一些额外的文件也被生成了,但我不需要,例如:README.md,.openapi-generator/VERSION,.open...

20得票3回答
使用OpenAPI生成器和Lombok注解生成POJOs

我正在使用 OpenAPI 生成器 Maven 插件,像下面这样为模型生成 Java 客户端代码。 Translated: 我正在使用类似下面的 OpenAPI 生成器 Maven 插件来生成Java客户端代码以用于模型。<plugin> <groupId>o...

19得票1回答
如何在OpenAPI 3.0中定义字节数组

我正在将我的API从Swagger 2.0迁移到OpenAPI 3.0。在数据传输对象(DTO)中,我有一个字段被指定为字节数组。 DTO的Swagger定义:Job: type: object properties: body: type: str...