Skip to content

fix: URL Path Parameter Encoding Issue#1516

Open
matheusandre1 wants to merge 2 commits intoquarkiverse:mainfrom
matheusandre1:issue1460
Open

fix: URL Path Parameter Encoding Issue#1516
matheusandre1 wants to merge 2 commits intoquarkiverse:mainfrom
matheusandre1:issue1460

Conversation

@matheusandre1
Copy link
Copy Markdown
Contributor

Many thanks for submitting your Pull Request ❤️!

Please make sure that your PR meets the following requirements:

  • You have read the contributors guide
  • Your code is properly formatted according to our code style
  • Pull Request title contains the target branch if not targeting main: [0.9.x] Subject
  • Pull Request contains link to the issue Closes: URL Path Parameter Encoding Issue #1460
  • Pull Request contains link to any dependent or related Pull Request
  • Pull Request contains description of the issue
  • Pull Request does not include fixes for issues other than the main ticket
How to backport a pull request to a different branch?

In order to automatically create a backporting pull request please add one or more labels having the following format backport-<branch-name>, where <branch-name> is the name of the branch where the pull request must be backported to (e.g., backport-quarkus2 to backport the original PR to the quarkus2 branch).

NOTE: backporting is an action aiming to move a change (usually a commit) from a branch (usually the main one) to another one, which is generally referring to a still maintained release branch. Keeping it simple: it is about to move a specific change or a set of them from one branch to another.

Once the original pull request is successfully merged, the automated action will create one backporting pull request per each label (with the previous format) that has been added.

If something goes wrong, the author will be notified and at this point a manual backporting is needed.

NOTE: this automated backporting is triggered whenever a pull request on main branch is labeled or closed, but both conditions must be satisfied to get the new PR created.

@matheusandre1 matheusandre1 marked this pull request as ready for review April 1, 2026 22:06
@matheusandre1 matheusandre1 requested a review from a team as a code owner April 1, 2026 22:06
@mcruzdev mcruzdev requested a review from Copilot April 7, 2026 03:42
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a MicroProfile REST client provider and annotation to ensure generated client path parameters are percent-encoded correctly (without double-encoding already-encoded %XX sequences), addressing the URL path parameter encoding issue (Closes #1460).

Changes:

  • Introduces @EncodedPathParam and a ParamConverterProvider to encode path parameter values while preserving existing percent-escapes.
  • Updates MicroProfile templates to register the provider and mark generated @PathParam parameters for encoding.
  • Adds runtime and deployment tests to validate encoding behavior and generator output.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
client/runtime/src/main/java/io/quarkiverse/openapi/generator/providers/PathParamEncodingParamConverterProvider.java Adds the JAX-RS ParamConverterProvider implementing “encode but don’t double-encode” behavior.
client/runtime/src/main/java/io/quarkiverse/openapi/generator/annotations/EncodedPathParam.java Adds marker annotation used to opt-in path param encoding for generated clients.
client/runtime/src/test/java/io/quarkiverse/openapi/generator/providers/PathParamEncodingParamConverterProviderTest.java Adds unit tests for encoding + instance reuse behavior.
client/deployment/src/main/resources/templates/libraries/microprofile/api.qute Registers the new provider on generated client APIs.
client/deployment/src/main/resources/templates/libraries/microprofile/pathParams.qute Marks generated path params with @EncodedPathParam.
client/deployment/src/test/java/io/quarkiverse/openapi/generator/deployment/wrapper/OpenApiClientGeneratorWrapperTest.java Adds generator-level test to confirm provider registration and annotation emission.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 9, 2026

🚀 PR Preview 41e7f27 has been successfully built and deployed to https://quarkiverse-openapi-generator-preview-pr-1516.surge.sh

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

URL Path Parameter Encoding Issue

3 participants