137

Could anyone explain to me what a JAX-RS Provider is and what ‘@Provider’ annotation does? I have been reading documentation but I cant get it.
If there are resource classes that service the incoming requests, what do Providers do? How are they different from singleton resource classes when I create a persistent resource class (the one that is not per-request)? Or are those classes also providers?

1
  • To go along with this: Why doesn't the JAX-RS document explain this in the first paragraph of the "Providers" chapter—the logically page I turned to when looking for understanding. JAX-RS Documentation PDF Apr 25, 2019 at 7:01

3 Answers 3

161

Providers are a simply a way of extending and customizing the JAX-RS runtime. You can think of them as plugins that (potentially) alter the behavior of the runtime, in order to accomplish a set of (program defined) goals.

Providers are not the same as resources classes, they exist, conceptually, at a level in-between resources classes and the JAX-RS implementation. If it helps, you can think of them in the same light as device drivers (existing between user and kernel space). This is a broad generalization.

There are three classes of providers defined by the current JAX-RS specification. The commonality between them is that all providers must be identified by the @Provider annotation and follow certain rules for constructor declaration. Apart from that, different provider types may have additional annotations, and will implement different interfaces.


Entity Providers

These providers control the mapping of data representations (like XML, JSON, CSV) to their Java object equivalents.

Context Providers

These providers control the context that resources can access via @Context annotations.

Exception Providers

These providers control the mapping of Java exceptions to a JAX-RS Response instance.


Your runtime will come with a number of predefined providers that will be responsible for implementing a base level of functionality (e.g for mapping to and from XML, translating the most common exceptions etc etc). You can also create your own providers as needed.

The JAX-RS specification is a good reference for reading up on these different provider types and what they do (see Chapter 4).

4
  • Thanks. I think I got the idea of the thing =) Nov 26, 2012 at 15:07
  • Well explained @Perception. This really helped in my understanding.
    – L-Samuels
    May 6, 2014 at 20:29
  • Well explained. One question though - how are @provider implementations different from an implementation of javax.ws.rs.core.Feature interface injected through the init param (jersey.config.server.provider.classnames) in web.xml? How is the order controlled? Jul 12, 2017 at 5:22
  • Note the latest version of the JAX-RS specification (Version 2.1 Final Release July 13, 2017) download.oracle.com/otn-pub/jcp/jaxrs-2_1-final-spec/…
    – burntsugar
    Jan 4, 2019 at 0:57
15

The @Provider annotation is used for anything that is of interest to the JAX-RS runtime, such as MessageBodyReader and MessageBodyWriter. For HTTP requests, the MessageBodyReader is used to map an HTTP request entity body to method parameters. On the response side, a return value is mapped to an HTTP response entity body by using a MessageBodyWriter. If the application needs to supply additional metadata, such as HTTP headers or a different status code, a method can return a Response that wraps the entity and that can be built using Response.ResponseBuilder.

@Provider annotation gives you the ability to examine incoming and outgoing messages at the raw XML level, and in this way Provider is the counterpart to Dispatch on the client.

12

To do certain activities such as Filtering-Request/Response, Exception Handling, the JAX-RS has its own default implementation logic. However, it allows users to provider their own implementation as well.

To provide our own implementation, we need to implement the appropriate classes by specifying them with @Provider annotation.

JAX-RS will do a round of scanning to find the existance of any such user-defined implementation by seaching for @Provider annotation.

For example:

...
@Provider
public class AppExceptionMapper implements ExceptionMapper<Throwable> {
...

...
@Provider
@PreMatching
public class RESTRequestResponseFilter implements ContainerRequestFilter, ContainerResponseFilter {
...

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.