Enterprise Java

Spring Cloud Gateway – Configuring a simple route

Spring Cloud Gateway can be considered a successor to the Spring Cloud Netflix Zuul project and helps in implementing a Gateway pattern in a microservices environment. It is built on top of
Spring Boot 2 and Spring Webflux and is non-blocking end to end – it exposes a Netty based server, uses a Netty based client to make the downstream microservice calls and uses reactor-core for the rest of the flow.

My objective here is to show how a small Spring Cloud Netflix Zuul based route can be translated in multiple ways using Spring Cloud Gateway.

Spring Cloud Netflix Zuul

Spring Cloud Zuul allows simple routing rules to be configured using property files expressed as a yaml here:

      path: /zuul/**
      url: http://httpbin.org:80
      strip-prefix: true

This route would expose an endpoint in Zuul which intercepts any requests made to uri’s with a prefix of “/zuul” and forwards it to the downstream system after stripping out the “zuul” prefix.

Spring Cloud Gateway

Spring Cloud Gateway allows an equivalent functionality to be coded in three ways – using a Java based DSL, using Kotlin based DSL and using simple property based configuration.

A starter project can be generated using the excellent http://start.spring.io site:

Java Based DSL

A Java based dsl that creates a route similar to the Zuul route is the following:

import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

public class GatewayRoutes {

    public RouteLocator routeLocator(RouteLocatorBuilder builder) {
        return builder.routes()
                .route(r ->
                                        f -> f.stripPrefix(1)


This is a readable DSL that configures a route which intercepts uri’s with a prefix of “java” and sends it to a downstream system after stripping out this prefix.

Kotlin Based DSL

A Kotlin based DSL to configure this route looks like this.

import org.springframework.cloud.gateway.route.RouteLocator
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder
import org.springframework.cloud.gateway.route.builder.filters
import org.springframework.cloud.gateway.route.builder.routes
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration

class KotlinRoutes {

    fun kotlinBasedRoutes(routeLocatorBuilder: RouteLocatorBuilder): RouteLocator =
            routeLocatorBuilder.routes {
                route { 
                    filters { stripPrefix(1) }

I had originally submitted the PR for Kotlin based DSL for Spring Cloud Gateway routes and so have a bias towards using Kotlin for configuring Spring Cloud Gateway :-). The route takes in urls with a prefix of “kotlin” and strips it out before making the downstream microservice call.

Property based Route

And finally the property based one:

        - predicates:
            - Path=/props/**
            - StripPrefix=1
          uri: "http://httpbin.org"

This route like the Java and Kotlin version takes in a url with a prefix of “props” and strips this prefix out before making the downstream call. The properties based version has the added advantage of being refreshable at runtime.


This is a very quick intro to Spring Cloud Gateway by comparing how a typical configuration from Spring Cloud Netflix Zuul maps to Spring Cloud Gateway.

Published on Java Code Geeks with permission by Biju Kunjummen, partner at our JCG program. See the original article here: Spring Cloud Gateway – Configuring a simple route

Opinions expressed by Java Code Geeks contributors are their own.

Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Newest Most Voted
Inline Feedbacks
View all comments
Raj Aryan
6 years ago

Thank you Biju Kunjummen Sir for sharing this wonderful info about this spring clout technology. It gives such good details and clears the concepts.

5 years ago

very nice & helpful

Back to top button