问题标签 [openapi-generator-maven-plugin]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
2 回答
4896 浏览

spring-boot - 如何解决 openapi-generator-maven-plugin 使用已弃用的类?

根据互联网上的一些示例,我尝试将 openapi-generator-maven-plugin 与 Spring Boot 2.4.3 一起使用,通过 openapi.yaml 中的规范生成代码,其中没有示例提供包含所需的完整依赖项。该插件生成一个名为的类,该类OpenAPIDocumentationConfig在内部使用导入的类springfox.documentation.spring.web.paths.RelativePathProvider

AFAIK 这个类已被弃用,有利于类DefaultPathProvider,但我找不到这个新类的存储库。

这是我的POM:

在此处输入图像描述

在此处输入图像描述


仅使用springdoc-openapi-ui依赖项会导致更多错误: 在此处输入图像描述

有了这个更新的 POM:

openapi.yaml 指定要生成的代码:

0 投票
1 回答
1639 浏览

java - 仅从 OpenAPI 定义生成 POJO

我已经将 Web 服务定义编写为 OpenAPI 文档。我使用的 openapi-generator-maven-plugin 总是使用 poms 和 gradle 构建脚本生成整个项目,但我只需要生成 pojo 和可能的 API 客户端。它应该同样适用于 JaxB 或 JaxWS 代码生成器。

那么有没有办法告诉插件只生成Java代码?也许还有另一个插件可以完成这项工作?

这是我的配置:

0 投票
2 回答
1863 浏览

java - openAPI 生成器错误:无法处理模型“日期时间”。请确保您的架构是正确的

我决定从 swagger 生成器迁移到 openapi 生成器。但是在生成期间我有一个错误。有趣的是,swagger 可以使用相同的 yaml 文件并生成没有错误的代码。

错误:

在另一个 yaml 中定义的模型“DateTime”,即与生成的 yaml 文件位于同一目录中。

UPD。

在我的 pom.xml 文件中:

UPD2

主要 yaml 中的参考:

在 CommonData 中,它看起来像这样:

我发现了如何解决这个问题。我没有使用最新的 5.1.0 版本的插件,而是使用 4.3.1 版本,我没有这个问题。5.x 版本不支持继承(我有 INFO 日志:

但我需要使用最后一个版本。那么有没有另一种方法来解决这个问题呢?

0 投票
0 回答
26 浏览

swagger - 来自 http 的 openapi-generator-maven-plugin 代码生成

我们可以在 openapi-generator-maven-plugin 中传递输入 yml 规范 HTTP URL 吗?

我想保持输入规范和生成的代码同步。

0 投票
0 回答
36 浏览

openapi - OpenAPI V3 Maven Plugin 使用 multipart/form-data 生成多个文件上传的不完整接口代码

我正在使用带有 Maven 插件 openapi-generator-maven-plugin (5.3.0) 的 Openapi V3 使用 multipart/form-data 上传多个文件。但是,生成的接口代码是不完整的 - 在默认方法之一中缺少 List 声明(一种方法将输入参数声明为List<MultipartFile> file,另一种方法将其声明为MultipartFile file):

这是规格:

0 投票
1 回答
35 浏览

openapi-generator - openapi-generator asciidoc 限制参数列,省略类型

有没有办法指定哪些列出现在“参数”部分?例如,我想使用 Schema/type 而不是 Pattern。

我的配置:

这是相关的源代码段:

以及相关的输出片段:

而不是“模式”列,我希望它显示类似 Schema 的内容以及整数和/或 int64 的值。

0 投票
1 回答
289 浏览

java - openapi-generator-maven-plugin 将 openapi 规范升级到 3.1.0

我在 5.3.1 版本中使用插件 openapi-generator-maven-plugin。

将 openapi 规范从 3.0.3 升级到 3.1.0 会导致生成阶段错误:

规格样本:

插件错误:

以前版本的openapi工作正常..

如果插件支持该版本的规范,我找不到信息,但错误消息非常模糊。

如何在规范 3.1.0 中使用 openapi-generator-maven-plugin?

0 投票
1 回答
187 浏览

java - OpenApi 生成器无法获取架构名称

我有 openapi 合同:

在这个结构中:

在 mainRs.json 中,我对另一个 json 有一些参考,如下所示:

当我尝试用 openapi-generator-maven-plugin 打包它时:

我收到警告并生成错误:

openapi 可以像我一样使用 refs 生成代码吗?或者我需要重构 json 模式并删除这个 refs?也许将它连接到一个文件或类似的东西中

0 投票
1 回答
38 浏览

openapi - openapi-generator-maven-plugin 生成带格式的 AsciiDoc 描述

我正在使用 openapi-generator-maven-plugin 版本 5.4.0 将我的 OpenAPI.json 文件转换为 AsciiDoc。在我的 OpenApi.json 规范中,我为路径参数描述设置了一些格式:

"description": "TestDescription \n Line2 TestDescription",

但是 AsciiDoc 生成器输出它没有格式化:

测试说明第 2 行测试说明

有没有办法保持我的格式?

我如何使用插件:

我的 openapi.json 文件:

0 投票
0 回答
43 浏览

openapi - Swagger Open Api 需要 OneOfCatDog 模式而不是 Cat 和 Dog 模式

我想在我的 API 中定义两种响应:一种是在我返回域对象时成功,另一种是在错误情况下。

遵循此处的文档:https ://swagger.io/docs/specification/data-models/oneof-anyof-allof-not/

我首先测试了文档中给出的示例并将其添加到我的.yaml文件中:

编译时出现以下错误: cannot find symbol [ERROR] symbol: class OneOfCatDog

似乎它在我的组件中期待一个模式,OneOfCatDog这正是我试图不拥有的。

有人知道有什么问题吗?

更新:代码生成