仅从OpenAPI定义生成POJO
OpenAPI（Open Application Programming Interface）是一种用于描述和定义Web服务的规范。它使用JSON或YAML格式来描述API的接口、参数、请求和响应等信息，使得开发者能够更好地理解和使用API。
生成POJO（Plain Old Java Object）是指根据OpenAPI定义自动生成对应的Java类，这些类用于表示API的请求和响应数据结构。生成POJO的过程可以通过使用OpenAPI生成工具来实现，该工具会根据OpenAPI定义文件自动生成Java类，并根据定义的数据结构生成对应的属性、方法和注解。
生成POJO的优势在于简化了开发过程，开发者无需手动编写大量的数据结构类，减少了出错的可能性，提高了开发效率。此外，生成的POJO类具有良好的可读性和可维护性，使得代码更加清晰易懂。
生成POJO的应用场景广泛，特别适用于需要与外部API进行交互的项目。例如，当我们需要调用某个第三方服务的API时，可以通过生成POJO来表示请求和响应的数据结构，从而更方便地进行数据传递和处理。
腾讯云提供了一系列与OpenAPI相关的产品和服务，其中包括：
- API网关：腾讯云API网关是一种高性能、高可用的API管理服务，可以帮助用户快速构建和部署API，并提供安全、稳定的访问控制和流量管理。详情请参考：腾讯云API网关
- 云函数：腾讯云云函数是一种事件驱动的无服务器计算服务，可以根据触发事件自动运行代码。通过云函数，可以将生成的POJO类与OpenAPI定义结合起来，实现自动化的数据处理和业务逻辑。详情请参考：腾讯云云函数
- 云开发：腾讯云云开发是一种全栈云原生开发平台，提供了前后端一体化的开发环境和丰富的云服务支持。通过云开发，可以方便地进行前端开发、后端开发和数据库操作，与生成的POJO类相互配合，实现全面的应用开发。详情请参考：腾讯云云开发
总之，通过OpenAPI定义生成POJO可以帮助开发者更高效地使用和开发API，腾讯云提供了相应的产品和服务来支持这一过程。
相关·内容
我们正在使用openapi生成器的openapi生成器-maven-插件来实现与swagger的集成，该集成使用的是非int64的数字数据类型。我们的代码库试图围绕使用长值进行标准化，但是openapi生成使用int的工件。是否可以将插件配置为生成使用Long而不是Integer的POJO？
我们可以修改swagger定义来指定int64格式，但更愿意通过在swagger之外的配置来实现。
浏览 6提问于2021-03-03得票数 3
回答已采纳
我使用OpenAPI生成器maven插件，如下所示，用于为模型生成Java代码。
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>4.3.1</version>
<executions>
<execution>
<goals>
浏览 13提问于2021-01-15得票数 11
回答已采纳
1回答
我使用openapi生成器从JsonSchema生成POJO。在我的pom.xml中，我指定了
<output>${project.build.directory}/generated-sources/openapi</output> <modelPackage>com.test.generated.model</modelPackage>
这将生成以下所有文件：
generated-sources/openapi/src/main/java/com.test.generated.model
我有基于不同模式的冲突类名，这会导致错误。
是否有一种
浏览 6提问于2022-01-13得票数 0
2回答
我有以下控制器：
public interface GetScoreController {
@GetMapping(value = "/score", produces = MediaType.APPLICATION_JSON_VALUE)
@Operation(parameters = {@Parameter(in = ParameterIn.QUERY, name = "request")})
Score getScore(ScoreRequest request);
}
我希望OpenApi在生成Swagger文档时将ScoreRequest
浏览 7提问于2021-04-15得票数 6
回答已采纳
5回答
为什么区分器属性会被序列化两次？
、、、、
我在组件模式中使用Java3.0继承，我有OpenAPI生成器(使用openapi)生成的类。
为什么判别器属性在结果JSON中被序列化两次？
这是一个Java优先项目，它应该使用openapi生成器来生成JHipster模型(POJO带有JHipster注释)和API控制器(与Spring@Api注释的接口)。
通过遵循OpenAPI 3.x文档/示例，似乎还必须在模式的properties列表中指定用作discriminator的属性。
通过这种方式，生成的Java类似乎与杰克逊关于批注多态类型处理()的指导方针不同，在这种情况下，类中不能存在用作鉴别器的属性。相反，生成的代码还将此属性包
浏览 3提问于2019-08-29得票数 5
我有一个springboot应用程序，我想转换成Micronaut，但是我如何通过代码配置openapi，如本文所示
代码片段：
@配置公共类OpenApiConfig {
@Bean
public OpenAPI customOpenAPI(OpenApiProperties properties) {
var openApi = new OpenAPI()
.info(getInfo(properties));
return openApi;
}
private Info getInfo(OpenApiProperties properties
浏览 9提问于2022-07-07得票数 1
1回答
我是OpenAPI 3.0.0的新手。
我已经成功地使用openapi-generator.创建了一个java客户端库。
但是OpenAPI生成器允许生成API库( documentation )、服务器存根、文档。因此，我想知道是否有任何命令或步骤可用于生成HTML文档和自定义文档模板。
浏览 1提问于2020-01-14得票数 8
我正在玩，我有一个示例openapi.yaml文件：
openapi: 3.1.0
info:
title: Sample API
description: My amazing description.
version: 0.0.9
servers:
- url: http://localhost:8080/v1
description: My amazing server description.
paths:
/users:
get:
summary: Returns a list of all users.
descri
浏览 13提问于2022-11-02得票数 0
我定义了Java3.0文档，并使用OpenAPI生成器-cli-3.3.4.jar来生成openapi代码。但我解决不了这个案子：List<Map<Integer, Set<String>>>。
在Map<Integer, String>杂志上：
- As I know I can use [schema object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#schema-object): _**additionalPro
浏览 0提问于2019-07-05得票数 7
我想要在我的helidon项目中自动生成openapi的仪器(Java1.8，helidon 1.3.1)
我读过文献/例子，并说：
在maven中添加依赖项
在META中添加openapi.yml
为路由器添加端点。
添加apifilter和apimodelreader
pom.xml：
<dependency>
<groupId>io.helidon.openapi</groupId>
<artifactId>helidon-openapi</artifactId>
<version
浏览 3提问于2019-10-08得票数 2
回答已采纳
我为实现了自定义代码生成
但我不知道如何将这个添加到gradle插件中。我需要在gradle执行openapi任务时将其添加到类路径中。
对于maven，我可以轻松地在插件依赖块中添加我的自定义实现com.my.生成器:定制生成器:1.0-快照，
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>${openapi-ge
浏览 1提问于2020-01-17得票数 4
OpenAPI生成器文档包含与任何OpenAPI生成器工具(CLI、Maven/Gradle插件等)相关的所有可用选项的列表。有几种选择让我感到困惑，我不明白两者的区别：--api-package，--invoker-package和--package-name.以下是他们从上摘录的描述
- api -包:生成api类的包--调用程序包:生成代码的根包--包-名称:生成类的包(支持)
有人能解释一下这三种选择的区别吗？
注意:不确定这是否相关，但我是在带有Gradle OpenAPI生成器插件的Java堆栈的上下文中问这个问题的。
浏览 10提问于2022-03-24得票数 1
我试图为我的项目中的两个作用域生成两个控制器类。我可以通过两个单独的openapi.yaml文件和两个maven执行来实现这一点。
我正在使用swagger-codegen-maven-plugin来完成它，我只能找到使用不同插件的swagger.yaml或openapi.yaml的代码。我找不到这个密码，虽然我肯定这是可能的。
问题是，如果我有两个作用域，如'DB‘和'Browse'，并且我希望为两个作用域(如DBApi.java和BrowseApi.java )创建两个接口，那么如何才能这样做，如果可以使用一个openapi.yaml文件来完成呢？
我确实看到了一个
浏览 6提问于2022-03-02得票数 0
在我们公司，没有关于如何记录API的标准。缺少的API文档减缓了开发过程。
因此，我们要介绍OpenAPI。
我们希望使用码发生器来确保OpenAPI规范是最新的，并确保服务符合它们发布的OpenAPI规范。
但是，有时代码生成器生成的代码不符合商定的编码标准，有时代码生成器过时，有时它们可能不可用。
当注意到使用代码生成器时，我们如何确保OpenAPI文档是最新的和兼容的？
浏览 0提问于2023-05-09得票数 0
1回答
我尝试通过SAR在JBoss 6.1中部署和启动真正简单的pojo。我的jboss-service.xml如下所示：
<deployment xmlns="urn:jboss:bean-deployer:2.0">
<bean name="TestBean" class="somepacage.TestBean">
<alias>bw:name=testBean</alias>
<install method="start"/>
浏览 0提问于2012-09-13得票数 2
回答已采纳
1回答
当使用swagger2.0时，java.util.Currency类作为单独的定义生成。但是当我们生成OpenAPI 3.0时，我们会遇到这样的问题: swagger-core将它作为属性生成。
从类生成OpenAPI 3.0规范
我们找到f.e了。这门课：
import java.util.Currency;
public class Wrapper {
private Currency currency;
}
从这段代码中，我们使用以下插件配置生成openapi规范：
<plugin>
<groupId>io.swag
浏览 4提问于2019-12-09得票数 5
回答已采纳
自从springdoc ui版本1.4.0以来，我再也无法管理java继承了。我知道在1.4.0中添加了AllOf，OneOf的概念，但是我不知道如何使它工作。
我有一个简单的pojo，它包含X的列表(x是抽象的)。有两种可能的实现。使用类X的属性确定适当的实现。
**代码：(类名已被重命名) **
两个版本的CheeseDTO YAML：
CheeseDTO:
type: object
properties:
cheeseType:
type: string
discriminator:
propertyNam
浏览 1提问于2021-02-19得票数 1
我正在评估Quarkus作为后端，通过一个角度前端访问。我想使用Quarkus通过提供的openapi数据，并通过openapi生成器工具生成一个typescript-angular客户端存根。
我使用Quarkus Openapi Guide：作为第一步，但在运行未经修改的示例并通过检索Openapi YAML-Data后，我注意到生成的数据是错误的，openapi生成器无法生成客户端，因为堆栈溢出错误。
问题: SetFruit-Definition (最后一行)的Openapi-data中的自我引用：
openapi: 3.0.1
info:
title: Generated API
浏览 25提问于2020-02-17得票数 0
在使用Kotlin的Microprofile / Quarkus项目中，有一个变量类型为Instant的数据类。
@Schema(name = "Vehicle", description = "POJO that represents a vehicle at a specific time.")
data class VehicleDTO(
var time: Instant = Instant.EPOCH
)
问题是生成的openapi模式并不表示Instant的值是如何实际传输的。
模式如下所示，而它只是简单地表示为类似于此的字符串：2015-0
浏览 7提问于2020-03-13得票数 4
回答已采纳
我有一个OpenAPI规范，我使用OpenAPI生成器成功地将其转换为服务器/客户端Python代码。但是，服务器的结构并不完全符合我的需要。要指定如何处理请求(比如方法.foo())，我需要在生成的代码"default_controller.py“中修改一个文件。我更愿意生成一个Python，该对象指定.foo()方法，并将其交给生成的代码，该代码将其转换为一个有效的服务器。
class HandlerClass:
def foo(self):
print("Performing foo")
def bar(self
浏览 19提问于2022-03-21得票数 0
我使用go-swagger openAPI来生成REST客户端。 现在，我想将响应大小限制在最大值，例如1MB。在Go中，这意味着在使用响应的正文时使用LimitReader。 有没有办法也用go-swagger openAPI来限制响应大小？
浏览 50提问于2021-02-11得票数 3
我正在尝试通过gradle插件测试openapi代码生成器。所以，我有一个包含文档的.yml文件(在中运行它，看起来很酷)
openapi: 3.0.2
info:
title: Testing docs
version: 1.0.0
tags:
- name: Registration
paths:
/registration:
post:
tags:
- Registration
summary: Register user
...
这是我的build.gradle的一部分
plugins {
id "org.
浏览 18提问于2021-02-19得票数 0
回答已采纳
我有一个PDF3.0规范，我想从它生成一个OpenAPI，这样它就可以提供给最终用户。
目前，像或这样的工具只支持Swager2.0，而不支持OpenAPI 3.0。有没有可能在不将其转换为Swagger2.0的情况下从PDF3.0规范生成OpenAPI？
浏览 10提问于2019-01-19得票数 16
我无法从生成“.openapi-生成器”文件夹中跳过openapi生成器maven插件版本5.3.0。
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>5.3.0</version>
<executions>
浏览 12提问于2022-02-19得票数 2
回答已采纳
我有一个使用ecore EMF创建的域模型。
我想生成POJO。我希望能够自定义POJO，所以我正在考虑使用Acceleo。
然而，我只能看到通过UML在Acceleo中创建POJO。当使用EMF时，它会生成EObjects、Estrings等。
有没有可能只生产POJO？
浏览 1提问于2013-03-31得票数 0
我有一个DTO，用于查询中的投影，它基于JOOQ创建的POJO，但添加了一个自定义字段(从JOOQ检索)。
目前，我需要：
为投影定义DTO，从生成的POJO继承
在DTO中添加自定义字段
创建构造函数
它是一个很小的类，但是每次修改基础POJO时都需要修改。
我不知道这个过程能不能被自动化？我可以利用生成过程来释放我的DTO吗？
浏览 3提问于2020-06-24得票数 1
回答已采纳
2回答
弹簧引导请求验证不起作用
、、、
应用背景
Spring引导版本1.5.12
通过swagger-codegen-maven插件生成的Java
问题
使用OpenAPI3.0创建的swagger模板被使用swagger-codegen-maven-plugin转换为pojos。
下面是生成pojo
public class TestPojo {
@JsonProperty("isNameValid")
private Boolean isNameValid = null;
@Schema(
required = true,
description = "C
浏览 3提问于2020-03-14得票数 1
由于krakend.json不是发生傲慢的understands.Following错误的类型，所以：
错误:文档必须是有效的OpenAPI 3.0.0定义
是否有其他方法为krakenD生成文档
浏览 5提问于2020-10-15得票数 2
在OpenAPI v2.0和Swagger上，产品的注释是：
/**
* @SWG\Get(
* path="/posts",
* operationId="getPosts",
* tags={"Authentication"},
* produces="application/json"
* summary="Returns the posts",
* description="Returns the posts",
浏览 0提问于2019-03-25得票数 2
回答已采纳
我已经创建了一个Azure管理实例。我想将OpenAPI集成到Azure管理中，使用Azure DevOps CI & CD管道。
对于每个版本，我都希望从代码中自动生成OpenAPI规范。如何在这个OpenApi规范的基础上建立，使用所有必需的版本集、API、产品、标签、用户、订阅、证书和策略？
浏览 12提问于2022-04-15得票数 0
我使用OpenApi v3.3.4 (以前称为Swagger CodeGen) maven插件通过api.yml文件生成rest控制器，其中描述了我想公开的所有操作。
在我的用例中，我想公开一个方法POST: handleNotification(@RequestBody SignatureNotification notification)，它的请求体类型是通过/targer文件夹中的另一个maven插件生成的。
实际上，我正在Components文件的Components中定义.yml：
...
requestBody:
required: true
con
浏览 1提问于2019-11-27得票数 4
回答已采纳
2回答
我使用的是Windows Postman v7.13.0应用程序，它在尝试从OpenAPI规范生成集合时抛出一条隐秘的消息。
有没有办法获得关于这个问题的更多细节？PostMan中有没有验证器或调试选项？
Couldn’t generate collection
Invalid schema supplied
注意:在Swagger UI和OpenAPI生成器中使用相同的openapi: 3.0.2规范。我还检查了PostMan控制台，似乎没有日志进一步描述该问题。
浏览 5提问于2019-12-12得票数 0
我有一个示例SpringBoot API，它具有以下特性：
公开一个可通过GET请求调用的端点并返回自定义类( example)ContainerClass中的ContainerClass包含一个属性)的1控制器是一个抽象类，有两个子类: ChildA和ChildB。
我尝试用springdoc-openapi-maven-plugin.从这个API生成一个OpenApi契约。
在我的pom.xml中，我有以下元素：
2.2.6org.springdoc:springdoc-openapi-ui:1.4.1org.springdoc:springdoc-openapi-maven-plugin
浏览 14提问于2020-06-29得票数 4
回答已采纳
我希望使用openapi-generator-cli.生成一个类型记录获取客户端。这些规格由信号灯使用OpenAPI 3.1格式生成。但是，当我运行命令时
openapi-generator-cli generate -i resources/openapi/Attribute.yaml -o ../test/ -g typescript-fetch
我知道错误了
[ERROR] i.s.parser.SwaggerCompatConverter - failed to read resource listing
com.fasterxml.jackson.core.JsonParseExce
浏览 33提问于2022-04-13得票数 2
回答已采纳
2回答
多值OpenApi枚举
、、、、
我是OpenApi新手，我想用api.yaml (OpenApi版本3.0.1)定义api。我的问题是生成的枚举只包含名称，而不是值。
这是我的代码中的枚举：
TEST1(1, "Test 1", "T1"),
TEST2(2, "Test 2", "T2"),
TEST3(3, "Test 3", "T2");
这是用OpenApi生成它之后的枚举：
TEST1("TEST1"),
TEST2("TEST2"),
TE
浏览 27提问于2022-04-14得票数 2
我正在寻找一种简单、可维护的方法来为Azure API管理建立一个CI/CD管道。
比方说，对于每个版本，我可以从代码自动生成OpenAPI规范。如何在这个OpenApi规范的基础上建立，使用所有必需的版本集、API、产品、标签、用户、订阅、证书和策略？
我已经找到了Azure DevOps工具包，但是它有but，没有提供所有的特性，也不容易和灵活地集成到CI/CD管道中。
浏览 1提问于2019-11-27得票数 1
回答已采纳
我有一个OpenAPI规范，并且我已经使用openapi-generator来生成Golang gin服务器。
从OpenAPI规范生成Swagger文档服务器的常规方法是什么？
我已经尝试过：它生成关于端点的文档。但这需要在代码批注中描述API。我正在寻找一个来自OpenAPI规范的Swagger UI生成器，我已经有了。
谢谢。
浏览 2提问于2021-02-24得票数 1
我试图在java中找到一种简单的方法，以静态格式转换openapi 3文档(json或yaml)，比如markdown、html或adoc。在四处搜索时，我发现了一个像这样的视图项目，但是它们还没有准备好进行Openapi v3！
有人对我的库或maven插件有什么建议或提示吗？
浏览 20提问于2022-04-02得票数 2
回答已采纳
我想要实现的
我正在尝试使用来自OpenAPI脚本的build.gradle生成器为Android生成REST客户端。这样，每次规范更改时，我都不必运行生成器命令行。理想情况下，这将在我构建/组装我的应用程序时生成，并且源代码将在java ( generated )文件夹中结束，在那里生成的源代码可以从代码中访问(例如，BuildConfig.java文件就是这样的)。
到目前为止我尝试过的
在这个之后，下面是我最后得到的build.gradle文件：
apply plugin: 'com.android.application'
apply plugin: 'org.
浏览 9提问于2020-08-17得票数 6
我想知道在Swagger/OpenAPI定义中包含常见错误类型的良好实践。
让我们考虑以下控制器方法：
[HttpGet]
[ProducesResponseType(StatusCodes.Status400BadRequest)] // to be or not to be?
public ActionResult SomeMethod(Foo foo)
{
if (foo.Property != "expectedValue")
{
return BadRequest();
}
return Ok();
}
所以，我在控制
浏览 14提问于2021-12-20得票数 1
我有一个用于OpenAPI 3的JSON文件，它包含以下内容：
"trait_hasProjectResponse_200": {
"description": "",
"content": {
"application/xml": {
"example": {
"
浏览 0提问于2019-02-27得票数 0
回答已采纳
我有一个现有的Spring，我想为它生成OpenAPI 3.0 YAML文件，而不是Swagger2.0JSON/YAML？
因为到目前为止，SpringFox不支持YAML生成。它使用Swagger2.0(遵循OpenAPI3.0规范)生成JSON。
此外，还有，但它似乎不支持Spring。
我尝试了孔晨spring plugin，它能够生成YAML文件，但使用Swagger2.0定义，而不是打开API3.0，如下所示：
swagger: "2.0"
info:
description: "Test rest project"
version:
浏览 0提问于2019-02-28得票数 26
回答已采纳
我有一个OpenAPI规范文档(我不控制)，其中包含以下代码段：
servers:
- url: http://www.[someservice].com/api
我正在使用这个OpenAPI文档来生成一个类型记录-角客户端，我在我的角度SPA中使用。当我在生产上运行这个程序(我的api后端可以在提供的url上访问)时，这是很好的。
我想用进行本地测试。如何使用openapi生成器覆盖basepath，以便生成本地工作的客户端代码？
浏览 0提问于2020-06-19得票数 9
回答已采纳
目前，我正试图在一些openapi-generator-maven-plugin上使用api.yaml。
我在公司内部这样做，我遇到了一个我不确定如何解决的问题:它产生的依赖之一是org.apache.oltu.oauth2.client版本1.0.2，但我只能在我的公司使用1.0.0版本。
在使用openapi生成器时，是否有方法为特定的依赖项指定版本，从而创建带有指定版本的依赖项，以便我们以后不会手动更改版本？
谢谢！
浏览 7提问于2020-08-02得票数 1
目前使用的是3.0.3的OpenAPI规范，因为这是最新版本的6.0.0支持的。
我们为应用浏览器客户端生成typescript，为服务器生成java。
当前的OpenAPI规范，它生成一个类型为string的status字段：
UpdateAuthzResponse:
description: >
'APPROVED' or 'REQUESTED'
type: object
required: [status]
properties:
status: {type:
浏览 5提问于2022-09-13得票数 0
回答已采纳
我想自定义openapi-generator，以便在每个文件的顶部自动生成带有特定许可证头的代码。 我想我需要编辑openapi-generator/src/main/resources/go/partial_header.mustache，在该文件的顶部粘贴一堆许可证文本是不是一个好主意？
浏览 14提问于2021-09-02得票数 0
回答已采纳
1回答
有没有人知道好的Eclipse POJO生成器？生成getter\setters和来自字段的构造函数都非常好，但是将其绑定到一个新的class\POJO对话框中会很有用。
浏览 0提问于2008-10-13得票数 3
回答已采纳
1回答
我正在尝试使用Scala构建Vert.X应用程序，并通过OpenAPI 3规范通过OpenAPI3RouterFactory生成路由。我需要生成我的规范中描述为Scala类的模型。有什么简单而直截了当的方法来实现这一点吗？
我正在使用SBT来构建我的应用程序，我已经尝试了一些用于Swagger的sbt代码源插件，但它们似乎都不起作用。
浏览 1提问于2019-04-23得票数 0
回答已采纳
1回答
我对Java很陌生。我正在开发一个使用openapi2.0的遗留应用程序。我添加了一个带有两个api端点的新控制器。这两个api端点并没有出现在swagger中。我看到了openapi.json中现有端点的条目。我正在尽我最大的努力不手动编辑openapi.json。我们是否必须在openapi.json版本2.0中手动配置api端点，才能在夸大其词的ui中显示？我们使用gradle来构建我们的项目。我重新建造了这个项目，但没有运气。
本教程的大部分内容似乎是针对openapi 3.0的，而不是2.0。openapi 3.0似乎自动生成swagger中的所有端点，但不确定2.0是否会这样做。
浏览 6提问于2022-02-09得票数 2
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
实时音视频
即时通信 IM活动推荐
腾讯云开发者
