<dependencies>
	<dependency>
		<groupId>com.netflix.feign</groupId>
		<artifactId>feign-jaxrs</artifactId>
		<version>8.11.0</version>
	</dependency>
	<dependency>
		<groupId>com.netflix.feign</groupId>
		<artifactId>feign-jackson</artifactId>
		<version>8.11.0</version>
	</dependency>
</dependencies>

@Path("/book")
public class BookStoreService {
	private BookRepository bookRepository;
 
	@POST
	@Consumes(MediaType.APPLICATION_JSON)
	@Produces(MediaType.APPLICATION_JSON)
	public Response saveBook(final Book book) {
		Book bookPersisted = bookRepository.saveBook(book);
		return Response.ok(bookPersisted).build();
	}
 
	@DELETE
	@Path("/{id}")
	public Response deleteBook(final @PathParam("id") String id) {
		bookRepository.deleteBook(id);
		return Response.ok().build();
	}
 
	@GET
	@Produces(MediaType.APPLICATION_JSON)
	public Response getAll() {
		List<Book> books = bookRepository.getAll();
		GenericEntity<List<Book>> bookWrapper = new GenericEntity<List<Book>>(
				books) {
		};
		return Response.ok(bookWrapper).build();
	}
 
	@GET
	@Path("/{id}")
	@Produces(MediaType.APPLICATION_JSON)
	public Response getById(final @PathParam("id") String id) {
		Book book = bookRepository.getById(id);
		return Response.ok(book).build();
	}
}

package com.hascode.tutorial;
 
import java.math.BigDecimal;
import java.util.Calendar;
 
public class Book {
	private String id;
	private String title;
	private BigDecimal price;
	private Calendar published;
 
	// getter, setter, toString ommitted ..
}

package com.hascode.tutorial;
 
import java.util.List;
 
import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
 
@Path("/book")
public interface BookService {
	@POST
	@Consumes(MediaType.APPLICATION_JSON)
	@Produces(MediaType.APPLICATION_JSON)
	public Book saveBook(final Book book);
 
	@DELETE
	@Path("/{id}")
	public void deleteBook(final @PathParam("id") String id);
 
	@GET
	@Produces(MediaType.APPLICATION_JSON)
	public List<Book> getAll();
 
	@GET
	@Path("/{id}")
	@Produces(MediaType.APPLICATION_JSON)
	public Book getById(final @PathParam("id") String id);
}

package com.hascode.tutorial;
 
import java.math.BigDecimal;
import java.util.Calendar;
import java.util.List;
 
import feign.Feign;
import feign.jackson.JacksonDecoder;
import feign.jackson.JacksonEncoder;
import feign.jaxrs.JAXRSContract;
 
public class BookServiceClient {
 
	public static void main(String[] args) {
		BookService bookService = Feign.builder().contract(new JAXRSContract()).encoder(new JacksonEncoder())
				.decoder(new JacksonDecoder()).target(BookService.class, "http://localhost:8080/tutorial/rs");
 
		System.out.println("fetching existing books..");
		List<Book> books = bookService.getAll();
		System.out.println(String.format("%s books received", books.size()));
		books.forEach(System.out::println);
 
		Book book = new Book(null, "One Book", BigDecimal.TEN, Calendar.getInstance());
		System.out.println("saving new book: " + book);
		bookService.saveBook(book);
 
		System.out.println("fetching existing books..");
		books = bookService.getAll();
		System.out.println(String.format("%s books received", books.size()));
		books.forEach(System.out::println);
 
		String id = books.get(0).getId();
		System.out.println("fetching book by id: " + id);
		Book byId = bookService.getById(id);
		System.out.println(String.format("book for id %s found: %s", id, byId));
 
		System.out.println("removing book with id: " + id);
		bookService.deleteBook(id);
 
		System.out.println("fetching existing books..");
		books = bookService.getAll();
		System.out.println(String.format("%s books received", books.size()));
		books.forEach(System.out::println);
	}
 
}

$ mvn exec:java -Dexec.mainClass=com.hascode.tutorial.BookServiceClient
[..]
fetching existing books..
0 books received
saving new book: Book [id=null, title=One Book, price=10, published=2015-10-20T12:26:21.741Z]
fetching existing books..
1 books received
Book [id=3633abdc-39c8-4fcc-a61b-80827983de6b, title=One Book, price=10, published=2015-10-20T12:26:21.741Z]
fetching book by id: 3633abdc-39c8-4fcc-a61b-80827983de6b
book for id 3633abdc-39c8-4fcc-a61b-80827983de6b found: Book [id=3633abdc-39c8-4fcc-a61b-80827983de6b, title=One Book, price=10, published=2015-10-20T12:26:21.741Z]
removing book with id: 3633abdc-39c8-4fcc-a61b-80827983de6b
fetching existing books..
0 books received
[..]

git clone https://bitbucket.org/hascode/feign-tutorial.git