This module overrides annotation processing to instead use standard ones supplied by the JAX-RS specification. This is currently targeted at the 1.1 spec.
While it may appear possible to reuse the same interface across client and server, bear in mind that JAX-RS resource annotations were not designed to be processed by clients. Moreover, JAX-RS 2.0 has a different package hierarchy for client invocation. Finally, JAX-RS is a large spec and attempts to implement it completely would be a project larger than feign itself. In other words, this implementation is best efforts and concedes far from 100% compatibility with server interface behavior.
Feign only supports processing java interfaces (not abstract or concrete classes).
ISE is raised when any annotation's value is empty or null. Ex. Path("") raises an ISE.
Here are a list of behaviors currently supported.
Appends the value to Target.url(). Can have tokens corresponding to @PathParam annotations.
Sets the request method.
Appends the value to Target.url(). Can have tokens corresponding to @PathParam annotations.
Adds the first value as the Accept header.
Adds the first value as the Content-Type header.
Links the value of the corresponding parameter to a template variable declared in the path.
Links the value of the corresponding parameter to a query parameter. When invoked, null will skip the query param.
Links the value of the corresponding parameter to a header.
Links the value of the corresponding parameter to a key passed to Encoder.Text<Map<String, Object>>.encode().