JAX-RS

JAX-RS é uma específicação Java para criação de serviços REST, e oferece um rico conjunto de anotações. O java-restify fornece suporte para utilizar as mesmas anotações no client-side.

Instalação

Para utilizar as anotações do JAX-RS, adicione a dependência java-restify-jaxrs-contract, que fornece a implementação JaxRsContractReader.

Maven

<dependency>
  <groupId>com.github.ljtfreitas</groupId>
  <artifactId>java-restify-jaxrs-contract</artifactId>
  <version>{version}</version>
</dependency>

Gradle

dependencies {
  compile("com.github.ljtfreitas:java-restify-jaxrs-contract:{version}")
}

Utilização

import javax.ws.rs.ApplicationPath;
import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.HeaderParam;
import javax.ws.rs.CookieParam;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.QueryParam;

@ApplicationPath("http://myapi.com") //@Path também é suportado no topo da interface
interface MyApi {

    @Path("/resource") //@Path para métodos (@ApplicationPath é suportado apenas no topo da interface)
    @GET
    String getResource();

    @Path("/resource/{id}")
    @GET
    String getResourceById(@PathParam("id") String id);

    @Path("/resource")
    @GET
    String getResourceWithHeader(@HeaderParam("X-Custom-Header") String id);

    @Path("/resource")
    @GET
    String getResourceWithCookie(@CookieParam("whatever") String content);

    @Path("/resource")
    @GET
    String getResourceByName(@QueryParam("name") String name);

    @Path("/resource/{id}")
    @DELETE
    void deleteResourceById(@PathParam("id") String id);

    @Path("/resource/{id}")
    @PUT
    @Consumes("application/json") //adiciona o cabeçalho Content-Type:application/json
    void updateResourceById(@PathParam("id") String id, Resource body); //o argumento sem anotação será considerado como request body

    @Path("/resource")
    @POST
    @Consumes("application/json") //adiciona o cabeçalho Content-Type:application/json
    void createResource(Resource body); //o argumento sem anotação será considerado como request body

    @Path("/resource/{id}")
    @GET
    @Produces("application/json") //adiciona o cabeçalho Accept:application/json
    String getResourceByIdAsJson(@PathParam("id") String id);
}

MyApi myApi = new RestifyProxyBuilder()
  .contract(new JaxRsContractReader())
  .target(MyApi.class)
    .build();

As anotações MatrixParam e BeanParam não são suportadas.