[jaxrs-spec][quarkus] Feat: Add an option to use "org.jboss.resteasy.reactive.RestResponse"

[cmoine-swi]

PR for #21424

• Add generator option useJBossResponse to use typed org.jboss.resteasy.reactive.RestResponse instead of javax.ws.rs.core.Response (see here)
• Add tests
• Update documentation

[wing328]

thanks for the PR

cc @bbdouglas (2017/07) @sreeshas (2017/08) @jfiala (2017/08) @lukoyanov (2017/09) @cbornet (2017/09) @jeff9finger (2018/01) @karismann (2019/03) @Zomzog (2019/04) @lwlee2608 (2019/10) @martin-mfg (2023/08)

[wing328]

did you test this PR locally to confirm it works for your use cases?

[cmoine-swi]

Hi @wing328, I just tested, and I confirm that version "7.16.0-SNAPSHOT" works on my project 👍

[wing328]

i tested with

java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate -g jaxrs-spec --library quarkus -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml -o /tmp/jaxrs2/ --additional-properties returnJBossResponse=true,interfaceOnly=true

but the output won't compile

does it work for you locally in your machine?

[wing328]

please also follow step 3 in the PR checklist to update samples and doc

[wing328]

instead of adding a new option, what about updating the existing one returnResponse to have one additional option to support your use cases?

[petretiandrea]

+1

[cmoine-swi]

instead of adding a new option, what about updating the existing one returnResponse to have one additional option to support your use cases?

That was tempting @wing328 , but I was concerned about the migration for existing users. The type would change.
It sounds like a three-state boolean. I thought it would be a bit strange. What do you suggest as values? true/false/jboss?

i tested with

java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate -g jaxrs-spec --library quarkus -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml -o /tmp/jaxrs2/ --additional-properties returnJBossResponse=true,interfaceOnly=true

but the output won't compile

does it work for you locally in your machine?

Good catch! An issue with the pom.xml. I had an existing pom.xml which is why it worked on my side. I will fix it.

[cmoine-swi]

pom.xml generation was fixed @wing328, however, I had to change rules a bit: RestResponseis only available from Quarkus 2.x, so it needs the useJakartaEe to be enabled. I updated the document accordingly (and samples 🙏). I also raise an exception when the conditions are not met.

[wing328]

tested again and the output compiles without issues

Downloading from central: https://repo.maven.apache.org/maven2/io/quarkus/quarkus-smallrye-openapi-deployment/3.0.1.Final/quarkus-smallrye-openapi-deployment-3.0.1.Final.jar
Downloaded from central: https://repo.maven.apache.org/maven2/io/quarkus/quarkus-smallrye-openapi-deployment/3.0.1.Final/quarkus-smallrye-openapi-deployment-3.0.1.Final.jar (47 kB at 208 kB/s)
Downloading from central: https://repo.maven.apache.org/maven2/io/quarkus/quarkus-universe-bom-quarkus-platform-properties/3.0.1.Final/quarkus-universe-bom-quarkus-platform-properties-3.0.1.Final.properties
Downloaded from central: https://repo.maven.apache.org/maven2/io/quarkus/quarkus-universe-bom-quarkus-platform-properties/3.0.1.Final/quarkus-universe-bom-quarkus-platform-properties-3.0.1.Final.properties (113 B at 356 B/s)
[INFO] [io.quarkus.deployment.QuarkusAugmentor] Quarkus augmentation completed in 3657ms
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:21 min
[INFO] Finished at: 2025-09-14T17:09:55+08:00
[INFO] ------------------------------------------------------------------------