The existing EE8→EE9 migration page at https://openliberty.io/docs/latest/reference/diff/jakarta-ee-diff.html covers several behaviour differences when migrating from jaxrs-2.1 (Apache CXF) to restfulWS-3.0 (RESTEasy). Two additional confirmed differences should be added in the same format as the existing entries.
1. UriInfo.getPath() — leading slash
jaxrs-2.1 behavior
UriInfo.getPath() returns the path of the current request relative to the base URI without a leading slash. For example, for a request to /myapp/resources/test, getPath() returns resources/test. This applies in both root resources and sub-resource locators.
restfulWS-3.0 behavior
UriInfo.getPath() returns the path with a leading slash. For the same request, getPath() returns /resources/test. This applies in both root resources and sub-resource locators.
2. Percent-encoded dot (%2E) in URI path
jaxrs-2.1 behavior
URIs containing %2E in any path segment are accepted and matched normally against @Path templates. For example, GET /app/items/%2E → 200 and GET /app/items/v1%2E0 → 200.
restfulWS-3.0 behavior
URIs containing %2E in any path segment are rejected with HTTP 400 before reaching JAX-RS. This applies to both standalone (/items/%2E) and embedded (/items/v1%2E0) cases.
Both differences also apply to restfulWS-3.1 and restfulWS-4.0. These should be presented as known behaviour changes when moving between EE versions, without implying a fix is planned.
The existing EE8→EE9 migration page at https://openliberty.io/docs/latest/reference/diff/jakarta-ee-diff.html covers several behaviour differences when migrating from
jaxrs-2.1(Apache CXF) torestfulWS-3.0(RESTEasy). Two additional confirmed differences should be added in the same format as the existing entries.1.
UriInfo.getPath()— leading slashjaxrs-2.1behaviorUriInfo.getPath()returns the path of the current request relative to the base URI without a leading slash. For example, for a request to/myapp/resources/test,getPath()returnsresources/test. This applies in both root resources and sub-resource locators.restfulWS-3.0behaviorUriInfo.getPath()returns the path with a leading slash. For the same request,getPath()returns/resources/test. This applies in both root resources and sub-resource locators.2. Percent-encoded dot (
%2E) in URI pathjaxrs-2.1behaviorURIs containing
%2Ein any path segment are accepted and matched normally against@Pathtemplates. For example,GET /app/items/%2E→ 200 andGET /app/items/v1%2E0→ 200.restfulWS-3.0behaviorURIs containing
%2Ein any path segment are rejected with HTTP 400 before reaching JAX-RS. This applies to both standalone (/items/%2E) and embedded (/items/v1%2E0) cases.Both differences also apply to
restfulWS-3.1andrestfulWS-4.0. These should be presented as known behaviour changes when moving between EE versions, without implying a fix is planned.