[JAXRS-spec] Add option useSwaggerAnnotations (for MicroProfile-OpenAPI)

[michbeck100]

PR checklist

• Read the contribution guidelines.
• Ran the shell script under ./bin/ to update Petstore sample so that CIs can verify the change. (For instance, only need to run ./bin/{LANG}-petstore.sh and ./bin/security/{LANG}-petstore.sh if updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates). Windows batch files can be found in .\bin\windows\.
• Filed the PR against the correct branch: master, 3.3.x, 4.0.x. Default: master.
• Copied the technical committee to review the pull request if your PR is targeting a particular programming language.

Description of the PR

The Microprofile OpenAPI specification allows to have just a static openapi.yaml file in the application module’s root META-INF folder (see here). So this PR adds an additional property "useSwaggerAnnotations" that doesn't generate the Swagger annotations if set to false (default value is true for backward compatibility).

This way you can easily generate code that conforms to contract first and is compliant with the microprofile openapi specification

[jmini]

Thank you for this PR. I like your approach.

Shippable — Run 2208 status is FAILED.

The Shippable CI Job ensure that the content of the samples/ folder correspond to the state of the generator. Can you please update it?

• Run mvn to update the cli
• Run the scripts to udpate the outdated samples:
  • bin/jaxrs-cxf-cdi-petstore-server.sh to update samples/server/petstore/jaxrs-cxf-cdi
  • bin/jaxrs-spec-petstore-server-interface.sh to update samples/server/petstore/jaxrs-spec-interface
  • bin/jaxrs-spec-petstore-server.sh to update samples/server/petstore/jaxrs-spec
• add the changes as new commit in this PR (we will squash all small commit of the PR as one single commit when we merge it)

See also: https://github.com/OpenAPITools/openapi-generator/wiki/Pull-Request-Checklist#shippable-ensure-up-to-date

[michbeck100]

I just ran bin/jaxrs-spec-petstore-server.sh, my fault. How can one know which scripts to run?

[jmini]

I once generated this table: https://github.com/OpenAPITools/openapi-generator/wiki/Samples-folder#scripts (might be outdated)

I have computed the list for your by looking at the Shippable error report.

If you have time (takes some minutes), you can also run bin/utils/ensure-up-to-date locally.

[michbeck100]

I had to fix some missing imports in efe7014. BTW: it seems that before 82eba8d this wan't working at all. And i don't really know what this is good for.

[jmini]

Thank you a lot for this contribution

[wing328]

@michbeck100 thanks for the enhancement, which is included in the v3.2.2 stable release: https://twitter.com/oas_generator/status/1032252335131512832