CustomerResource.java

@Path("customer")
@Api(value = "/customer", description = "Customer Operations")
public interface CustomerResource {

  @GET
  @Path("/{id:[1-9][0-9]*}")
  @Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
  @ApiOperation(value = "Find customer by id")
  Response getCustomer(@PathParam("id") final Long id);

  @GET
  @Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
  @ApiOperation(value = "Find all customers")
  Response getCustomers();
}