JAX-RS 2.0 change default implementation

Konstantin Milyutin picture Konstantin Milyutin · Jun 28, 2013 · Viewed 17.5k times · Source

I'm trying to use RESTEasy as JAX-RS 2.0 client implementation. The problem is that I got runtime exception:

06-28 13:29:06.410: E/AndroidRuntime(5745): Caused by: java.lang.RuntimeException: java.lang.ClassNotFoundException: org.glassfish.jersey.client.JerseyClientBuilder
06-28 13:29:06.410: E/AndroidRuntime(5745):     at javax.ws.rs.client.ClientBuilder.newBuilder(ClientBuilder.java:103)

So the newBuilder() method is searching for JerseyClientBuilder if I understand it correct. How can I tell the system to use RESTEasy instead?

Answer

Carlo Pellegrini picture Carlo Pellegrini · Jul 4, 2013

Well, JAX-RS relies on the Service Provider convention. On the first lines of the newBuilder method you can read:

 Object delegate = FactoryFinder.find(JAXRS_DEFAULT_CLIENT_BUILDER_PROPERTY,
   JAXRS_DEFAULT_CLIENT_BUILDER); 

Where JAXRS_DEFAULT_CLIENT_BUILDER_PROPERTY is "javax.ws.rs.client.ClientBuilder"

In turn, FactoryFinder looks

  • first for the class name into META-INF/services/javax.ws.rs.client.ClientBuilder
  • then in the property javax.ws.rs.client.ClientBuilder into ${java.home}/lib/jaxrs.properties
  • finally into the System property javax.ws.rs.client.ClientBuilder.

So, to use RESTEasy, you should create a file

META-INF/services/javax.ws.rs.client.ClientBuilder

with the text:

org.jboss.resteasy.client.jaxrs.ResteasyClientBuilder

which is the class name of the RESTEasy ClientBuilder