[JAVA jaxrs-spec gen] add option for generating swagger V3 annotations#22300
Merged
wing328 merged 13 commits intoOpenAPITools:masterfrom Nov 10, 2025
raouldh:master
Merged
[JAVA jaxrs-spec gen] add option for generating swagger V3 annotations#22300wing328 merged 13 commits intoOpenAPITools:masterfrom raouldh:master
wing328 merged 13 commits intoOpenAPITools:masterfrom
raouldh:master
Conversation
Member
|
thanks for the pr let me know if this's ready for review |
Contributor
Author
Member
wing328
reviewed
Nov 10, 2025
| @@ -0,0 +1,11 @@ | |||
| generatorName: jaxrs-spec | |||
| outputDir: samples/server/petstore/jaxrs-spec-swagger-annotations | |||
Member
There was a problem hiding this comment.
please add the folder to the CI: https://github.com/OpenAPITools/openapi-generator/blob/master/.github/workflows/samples-jaxrs.yaml
so that it will be tested moved forward.
Member
There was a problem hiding this comment.
i'll do it in a separate pr. thanks for the contribution.
6 tasks
rajvesh
pushed a commit
to rajvesh/openapi-generator
that referenced
this pull request
Dec 25, 2025
OpenAPITools#22300) * feat: add support for Swagger v3 annotations to jaxrs-spec * test added unittest for jaxrs-spec with swagger3Annotations * test added integrationtest for jaxrs-spec with swagger3Annotations * test added integrationtest for jaxrs-spec with swaggerV2Annotations * documentation update for new option useSwaggerV3Annotations in the jaxrs-spec.md * test added integrationtest for jaxrs-spec with swaggerV3Annotations icm use JakartaEE * update documentation by executing: ./bin/utils/export_docs_generators.sh * ran on wsl: ./bin/generate-samples.sh ./bin/configs/*.yaml
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #12379
Add option useSwaggerV3Annotations for generating Swagger V3 Annotations to jaxrs-spec generator.
Default is false for useSwaggerV3Annotations.
When useSwaggerV3Annotations is set to true, the Swagger V2 annotation option(useSwaggerAnnotations) is automatically set to false.
PR checklist
Commit all changed files.
This is important, as CI jobs will verify all generator outputs of your HEAD commit as it would merge with master.
These must match the expectations made by your contribution.
You may regenerate an individual generator by passing the relevant config(s) as an argument to the script, for example
./bin/generate-samples.sh bin/configs/java*.IMPORTANT: Do NOT purge/delete any folders/files (e.g. tests) when regenerating the samples as manually written tests may be removed.
master(upcoming7.x.0minor release - breaking changes with fallbacks),8.0.x(breaking changes without fallbacks)"fixes #123"present in the PR description)