Course – LS – All

Get started with Spring and Spring Boot, through the Learn Spring course:


1. Overview

So far, in our cloud application, we’ve used the Gateway Pattern to support two main features.

First, we insulated our clients from each service, eliminating the need for cross-origin support. Next, we implemented locating instances of services using Eureka.

In this article, we are going to look at how to use the Gateway pattern to retrieve data from multiple services with a single request. To do this, we’re going to introduce Feign into our gateway to help write the API calls to our services.

To read up on how to use the OpenFeign client check out this article.

Spring Cloud now also provides the Spring Cloud Gateway project which implements this pattern.

2. Setup

Let’s open up the pom.xml of our gateway server and add the dependency for OpenFeign:


For reference – we can find the latest versions on Maven Central (spring-cloud-starter-feign).

Now that we have the support for building a OpenFeign client, let’s enable it in the

public class GatewayApplication { ... }

Now let’s set up OpenFeign clients for the book and rating services.

3. OpenFeign Clients

3.1. Book Client

Let’s create a new interface called

public interface BooksClient {
    @RequestMapping(value = "/books/{bookId}", method = RequestMethod.GET)
    Book getBookById(@PathVariable("bookId") Long bookId);

With this interface, we’re instructing Spring to create a OpenFeign client that will access the “/books/{bookId}” endpoint. When called, the getBookById method will make an HTTP call to the endpoint, and make use of the bookId parameter.

To make this work we need to add a DTO:

@JsonIgnoreProperties(ignoreUnknown = true)
public class Book {
    private Long id;
    private String author;
    private String title;
    private List<Rating> ratings;
    // getters and setters

Let’s move on to the RatingsClient.

3.2. Ratings Client

Let’s create an interface called RatingsClient:

public interface RatingsClient {
    @RequestMapping(value = "/ratings", method = RequestMethod.GET)
    List<Rating> getRatingsByBookId(
      @RequestParam("bookId") Long bookId, 
      @RequestHeader("Cookie") String session);

Like with the BookClient, the method exposed here will make a rest call to our rating service and return the list of ratings for a book.

However, this endpoint is secured. To be able to access this endpoint properly we need to pass the user’s session to the request.

We do this using the @RequestHeader annotation. This will instruct OpenFeign to write the value of that variable to the request’s header. In our case, we are writing to the Cookie header because Spring Session will be looking for our session in a cookie.

In our case, we are writing to the Cookie header because Spring Session will be looking for our session in a cookie.

Finally, let’s add a DTO:

@JsonIgnoreProperties(ignoreUnknown = true)
public class Rating {
    private Long id;
    private Long bookId;
    private int stars;

Now, both clients are complete. Let’s put them to use!

4. Combined Request

One common use case for the Gateway pattern is to have endpoints that encapsulate commonly called services. This can increase performance by reducing the number of client requests.

To do this let’s create a controller and call it

public class CombinedController { ... }

Next, let’s wire in our newly created OpenFeign clients:

private BooksClient booksClient;
private RatingsClient ratingsClient;

public CombinedController(
  BooksClient booksClient, 
  RatingsClient ratingsClient) {
    this.booksClient = booksClient;
    this.ratingsClient = ratingsClient;

And finally let’s create a GET request that combines these two endpoints and returns a single book with its ratings loaded:

public Book getCombinedResponse(
  @RequestParam Long bookId,
  @CookieValue("SESSION") String session) {
    Book book = booksClient.getBookById(bookId);
    List<Rating> ratings = ratingsClient.getRatingsByBookId(bookId, "SESSION="+session);
    return book;

Notice that we are setting the session value using the @CookieValue annotation that extracts it from the request.

There it is! We have a combined endpoint in our gateway that reduces network calls between the client and the system!

5. Testing

Let’s make sure our new endpoint is working.

Navigate to and let’s add a test for our combined endpoint:

public void accessCombinedEndpoint() {
    Response response = RestAssured.given()
      .form("user", "password", formConfig)
      .get(ROOT_URI + "/combined?bookId=1");
    assertEquals(HttpStatus.OK.value(), response.getStatusCode());
    Book result =;
    assertEquals(new Long(1), result.getId());
    assertTrue(result.getRatings().size() > 0);

Start up Redis, and then run each service in our application: config, discovery, zipkin, gateway, book, and the rating service.

Once everything is up, run the new test to confirm it is working.

6. Conclusion

We’ve seen how to integrate OpenFeign into our gateway to build a specialized endpoint. We can leverage this information to build any API we need to support. Most importantly we see that we are not trapped by a one-size-fits-all API that only exposes individual resources.

Using the Gateway pattern we can set up our gateway service to each client’s needs uniquely. This creates decoupling giving our services the freedom to evolve as they need, remaining lean and focused on one area of the application.

As always, code snippets can be found over on GitHub.

Course – LS – All

Get started with Spring and Spring Boot, through the Learn Spring course:

res – Microservices (eBook) (cat=Cloud/Spring Cloud)
Comments are open for 30 days after publishing a post. For any issues past this date, use the Contact form on the site.