Skip to content

feat: Support OpenAPI 3.1.x - #1231

Merged
ZhongpinWang merged 34 commits into
mainfrom
support-openapi-3.1
Aug 4, 2026
Merged

feat: Support OpenAPI 3.1.x#1231
ZhongpinWang merged 34 commits into
mainfrom
support-openapi-3.1

Conversation

@ZhongpinWang

@ZhongpinWang ZhongpinWang commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Context

This is a generated (later manually reviewed and fixed) PoC for evaluating the effort of supporting OpenAPI 3.1.x in the generator.

The following two files coming from the initial round of generation might be outdated but you can use as a reference.

  • Check the OAS31_GAPS.md for the gaps evaluated.
  • Check the OAS31_CHANGES.md for the actual changes generated.

I generated all data models in AI SDK Java with the new SNAPSHOT cloud sdk generator, and there were no breaking changes.

See SAP/ai-sdk-java#958 for the generated result.

@CharlesDuboisSAP CharlesDuboisSAP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some test coverage is lacking, you could add some more unit tests

@ZhongpinWang
ZhongpinWang marked this pull request as ready for review July 23, 2026 13:42

@CharlesDuboisSAP CharlesDuboisSAP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM, one small thing:
Why did you duplicate all integrations tests in DataModelGeneratorApacheIntegrationTest? I would remove them since they are already tested in DataModelGeneratorIntegrationTest, and they cover the same lines of code, apache only changes the inside of the Api class which are not the point of your tests anyway.

@ZhongpinWang ZhongpinWang changed the title feat: (PoC) Support OpenAPI 3.1.x feat: Support OpenAPI 3.1.x Jul 30, 2026
@ZhongpinWang

Copy link
Copy Markdown
Contributor Author

@CharlesDuboisSAP @Jonas-Isr Can you add a simple release note for this? I don't know how you do this normally in Java team.

@ZhongpinWang

Copy link
Copy Markdown
Contributor Author

I added a log warning for 3.1 to point out that this is an experimental feature. We can remove this after a while.

Comment thread datamodel/openapi/openapi-generator/pom.xml.bak Outdated
Comment thread datamodel/openapi/openapi-generator/pom.xml

@CharlesDuboisSAP CharlesDuboisSAP left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, let's wait for @Jonas-Isr's review

@Jonas-Isr Jonas-Isr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me :)

I only had some pretty minor points.

@ZhongpinWang
ZhongpinWang requested a review from Jonas-Isr August 3, 2026 15:25

@Jonas-Isr Jonas-Isr left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good :)

@ZhongpinWang
ZhongpinWang merged commit f2168d2 into main Aug 4, 2026
13 checks passed
@ZhongpinWang
ZhongpinWang deleted the support-openapi-3.1 branch August 4, 2026 09:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants