-
Notifications
You must be signed in to change notification settings - Fork 2.7k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Explain semantics of quarkus.rest.path; add tests #15474
Conversation
quarkus.rest.path
quarkus.rest.path
* JAX-RS resource URIs provided by Path annotations when there are no | ||
* {@code @ApplicationPath} annotation defined on {@code Application} classes. | ||
* <p> | ||
* This value is always resolved relative to {@code quarkus.http.root-path}. | ||
*/ | ||
@ConfigItem(defaultValue = "/") |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is it confusing that we're saying it's a relative path and then the default is an absolute?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a substitute for @ApplicationPath
.. it is JAX-RS. It will ALWAYS be interpreted relative to http.root-path. Always
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm trying to make that unambiguous .. by reference more JAX-RS things in JAX-RS-y language.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@stuartwdouglas .. we could remove the default or leave it empty or.. ?
Since #15030, we now have a convention in our config that leading slashes in configured paths matter.
Update doc for
quarkus.rest.path
to make clearer association with@ApplicationPath
Add a few tests to make expected behavior more obvious (and ensure it keeps working that way)