#23560 Correct imports for RxJava2 and RxJava3. Add support for Vert.x 5.

[sjw2547]

The mustache template for rxApiImpl, when working with Rx Java 2 and 3, imports rx.Single. This class is relocated with Rx Java 2 and 3, import has been corrected for those versions, along with using SingleHelper instead of Single.create()

For Vert.x 5 the generated ApiClient does not compile because the deprecated methods in Vert.x 4 that take a handler as a final parameter have been removed, returning a furutre instead. Added a new command line option called useVertx5 to call the replacement methods instead.

---

Summary by cubic

Fixes incorrect RxJava imports in generated Vert.x Rx clients and adds Vert.x 5 support via a new useVertx5 option, so Java clients compile against Vert.x 5 while keeping Vert.x 4 compatibility. Adds a Vert.x 5 sample and updates templates/CI to use the right Vert.x/Rx artifacts and Java 11 where required.

• New Features

  • Added useVertx5 (--additional-properties useVertx5=true) to generate Vert.x 5 syntax in ApiClient (Future-based sendBody and file I/O); updated docs (docs/generators/java.md, docs/generators/java-microprofile.md), added bin/configs/java-vertx5.yaml, new sample at samples/client/petstore/java/vertx5, and included it in .github/workflows/samples-java-client-jdk11.yaml.
  • Gradle template: when useVertx5=true, set Vert.x 5.0.11 and Java 11; choose io.vertx:vertx-rx-java2 or io.vertx:vertx-rx-java3 based on useRxJava2/useRxJava3.

• Bug Fixes

  • Corrected RxJava imports in rxApiImpl.mustache: use io.reactivex.Single/io.reactivex.rxjava3.core.Single and io.vertx.reactivex.SingleHelper/io.vertx.rxjava3.SingleHelper; replaced Single.create with SingleHelper.toSingle for RxJava2/3.
  • Maven pom.mustache: fixed Rx artifact selection to pick io.vertx:vertx-rx-java3, io.vertx:vertx-rx-java2, or io.vertx:vertx-rx-java as appropriate; set Vert.x 5.0.11 and compiler source/target to 11 when useVertx5=true.

^{Written for commit 8fb8376. Summary will update on new commits.}

[cubic-dev-ai]

No issues found across 4 files

[wing328]

please follow step 3 to update samples and docs.

[sjw2547]

please follow step 3 to update samples and docs.

Done

[cubic-dev-ai]

2 issues found across 3 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="samples/client/petstore/java/vertx5/build.gradle">

<violation number="1" location="samples/client/petstore/java/vertx5/build.gradle:35">
P1: Vert.x was upgraded to 5.x, but the Gradle Java compatibility is still pinned to Java 8, creating a real toolchain/runtime compatibility mismatch.</violation>
</file>

<file name="modules/openapi-generator/src/main/resources/Java/libraries/vertx/build.gradle.mustache">

<violation number="1" location="modules/openapi-generator/src/main/resources/Java/libraries/vertx/build.gradle.mustache:35">
P1: `vertx_version` template can concatenate two versions (`5.0.11` + `4.0.0`) when both flags are true, producing an invalid dependency version.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

1 issue found across 3 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="modules/openapi-generator/src/main/resources/Java/libraries/vertx/build.gradle.mustache">

<violation number="1" location="modules/openapi-generator/src/main/resources/Java/libraries/vertx/build.gradle.mustache:35">
P1: `vertx_version` template logic has a missing branch: when both `useVertx5` and `supportVertxFuture` are true, it renders an empty version and breaks generated Gradle dependencies.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}

[cubic-dev-ai]

2 issues found across 2 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="samples/client/petstore/java/vertx5/pom.xml">

<violation number="1" location="samples/client/petstore/java/vertx5/pom.xml:272">
P2: Upgrading to Vert.x 5 while keeping Java 8 compiler target creates an inconsistent and potentially incompatible Java baseline.</violation>
</file>

<file name="modules/openapi-generator/src/main/resources/Java/libraries/vertx/pom.mustache">

<violation number="1" location="modules/openapi-generator/src/main/resources/Java/libraries/vertx/pom.mustache:234">
P1: POM Rx artifact selection omits the supported `useRxJava2` case, causing wrong dependency (`vertx-rx-java`) for RxJava2 generation.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}