Skip to content

Commit 84e4d62

Browse files
committed
chore(deps): bump OpenAPI Generator to 7.22.0 across platform and samples
1 parent 3d8887f commit 84e4d62

5 files changed

Lines changed: 40 additions & 4 deletions

File tree

README.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,6 +24,7 @@
2424
* [Real usage (what you actually do)](#real-usage-what-you-actually-do)
2525
* [Quick start (2 minutes)](#quick-start-2-minutes)
2626
* [Compatibility](#compatibility)
27+
* [Relationship to OpenAPI Generator](#relationship-to-openapi-generator)
2728
* [Contract lifecycle model](#contract-lifecycle-model)
2829
* [Core idea](#core-idea)
2930
* [System Architecture Overview](#system-architecture-overview)
@@ -300,6 +301,39 @@ See the full compatibility matrix and support policy: [Compatibility & Support P
300301

301302
---
302303

304+
## Relationship to OpenAPI Generator
305+
306+
This is **not a fork** of OpenAPI Generator. It uses the upstream tool
307+
as a Maven dependency and adds a Java/Spring Boot specialization layer
308+
on top.
309+
310+
What stays upstream:
311+
312+
- OpenAPI Generator (used as-is, fresh extraction on every build)
313+
- OpenAPI 3.x spec (only `x-` vendor extensions added)
314+
- The full upstream template chain
315+
316+
What this project adds:
317+
318+
- A custom generator extending `JavaClientCodegen`
319+
- A surgical patch to upstream `model.mustache` that injects a single
320+
generic-aware branch — the rest is untouched
321+
- Vendor extensions (`x-api-wrapper`, `x-data-container`) carrying
322+
generic semantics through the spec
323+
- Server-side `OpenApiCustomizer` for contract introspection
324+
325+
Why not just drop a custom `model.mustache` into `templateDirectory`?
326+
That approach freezes a snapshot of the upstream template and quietly
327+
falls behind as upstream evolves. This project keeps upstream as the
328+
source of structure, injects only the generic-aware branch, and fails
329+
the build fast if upstream changes invalidate the patch.
330+
331+
Cross-language parity is an explicit non-goal. Java generics deserve a
332+
generics-aware solution; other languages may benefit from different
333+
specializations on top of the same upstream.
334+
335+
---
336+
303337
## Contract lifecycle model
304338

305339
```text

openapi-generics-java-codegen-parent/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@
4343

4444
<properties>
4545
<openapi-generics-java-codegen.version>1.0.0</openapi-generics-java-codegen.version>
46-
<openapi-generator.version>7.21.0</openapi-generator.version>
46+
<openapi-generator.version>7.22.0</openapi-generator.version>
4747

4848
<maven.resources.plugin.version>3.5.0</maven.resources.plugin.version>
4949
<maven-antrun-plugin.version>3.2.0</maven-antrun-plugin.version>

openapi-generics-platform-bom/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@
4545

4646
<properties>
4747
<openapi.generics.contract.version>1.0.0</openapi.generics.contract.version>
48-
<openapi.generator.version>7.21.0</openapi.generator.version>
48+
<openapi.generator.version>7.22.0</openapi.generator.version>
4949
<springdoc.version>2.8.17</springdoc.version>
5050
</properties>
5151

samples/spring-boot-3/customer-service-client/pom.xml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
<scm>
3131
<url>https://github.com/blueprint-platform/openapi-generics</url>
3232
<connection>scm:git:https://github.com/blueprint-platform/openapi-generics.git</connection>
33-
<developerConnection>scm:git:ssh://git@github.com:bsayli/spring-boot-openapi-generics-clients.git</developerConnection>
33+
<developerConnection>scm:git:ssh://git@github.com:blueprint-platform/openapi-generics.git</developerConnection>
3434
<tag>v1.0.0</tag>
3535
</scm>
3636

@@ -47,6 +47,7 @@
4747
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
4848

4949
<spring-boot.version>3.5.14</spring-boot.version>
50+
<openapi-generator.version>7.22.0</openapi-generator.version>
5051
<customer-contract.version>1.0.1-SNAPSHOT</customer-contract.version>
5152
<jakarta.validation.version>3.1.1</jakarta.validation.version>
5253
<jakarta.annotation-api.version>3.0.0</jakarta.annotation-api.version>

samples/spring-boot-4/customer-service-client/pom.xml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@
3030
<scm>
3131
<url>https://github.com/blueprint-platform/openapi-generics</url>
3232
<connection>scm:git:https://github.com/blueprint-platform/openapi-generics.git</connection>
33-
<developerConnection>scm:git:ssh://git@github.com:bsayli/spring-boot-openapi-generics-clients.git</developerConnection>
33+
<developerConnection>scm:git:ssh://git@github.com:blueprint-platform/openapi-generics.git</developerConnection>
3434
<tag>v1.0.0</tag>
3535
</scm>
3636

@@ -47,6 +47,7 @@
4747
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
4848

4949
<spring-boot.version>4.0.6</spring-boot.version>
50+
<openapi-generator.version>7.22.0</openapi-generator.version>
5051
<customer-contract.version>1.0.1-SNAPSHOT</customer-contract.version>
5152
<jakarta.validation.version>3.1.1</jakarta.validation.version>
5253
<jakarta.annotation-api.version>3.0.0</jakarta.annotation-api.version>

0 commit comments

Comments
 (0)