Chapter 2. Getting Started with Spring Boot


2.1. Overview of the circuit breaker booster

The Netflix/Hystrix circuit breaker enables distributed applications to cope with interruptions to network connectivity and temporary unavailability of backend services. The basic idea of the circuit breaker pattern is that the loss of a dependent service is detected automatically and an alternative behavior can be programmed, in case the backend service is temporarily unavailable.

The Fuse circuit breaker booster consists of two related services:

  • A name service, the backend service that returns a name to greet.
  • A greetings service, the frontend service that invokes the name service to get a name and then returns the string, Hello, NAME.

In this booster demonstration, the Hystrix circuit breaker is inserted between the greetings service and the name service. If the backend name service becomes unavailable, the greetings service can fall back to an alternative behavior and respond to the client immediately, instead of being blocked while it waits for the name service to restart.

2.2. Prerequisites

To build and run the booster demonstration, install the following prerequisites:

2.3. Generate the booster project

To generate the circuit breaker booster project, perform the following steps:

  1. Navigate to https://developers.redhat.com/launch.
  2. Click START.

    The launcher wizard prompts you to log in to your Red Hat account.

  3. Click the Log in or register button and then log in.
  4. On the Launcher page, click the Deploy an Example Application button.
  5. On the Create Example Application page, type the name, fuse-circuit-breaker, in the Create Example Application as field.
  6. Click Select an Example.
  7. In the Example dialog, select the Circuit Breaker option. A Select a Runtime dropdown menu appears.

    1. From the Select a Runtime dropdown, select Fuse.
    2. From the version dropdown menu, select 7.2.0 (Red Hat Fuse) (do not select the 2.21.2 (Community) version).
    3. Click Save.
  8. On the Create Example Application page, click Download.
  9. When you see the Your Application is Ready dialog, click Download.zip. Your browser downloads the generated booster project (packaged as a ZIP file).
  10. Use an archive utility to extract the generated project to a convenient location on your local file system.

2.4. Build and run the booster

To build and run the booster project, perform the following steps:

  1. Open a shell prompt and build the project from the command line, using Maven:

    cd fuse-circuit-breaker
    Copy to Clipboard Toggle word wrap
    mvn clean package
    Copy to Clipboard Toggle word wrap

    After Maven builds the project, it displays a Build Success message.

  2. Open a new shell prompt and start the name service, as follows:

    cd name-service
    Copy to Clipboard Toggle word wrap
    mvn spring-boot:run -DskipTests -Dserver.port=8081
    Copy to Clipboard Toggle word wrap

    As Spring Boot starts up, you should see output similar to the following:

    ...
    2019-06-14 15:38:37.380  INFO 31260 --- [           main] o.a.camel.spring.SpringCamelContext      : Total 1 routes, of which 1 are started
    2019-06-14 15:38:37.381  INFO 31260 --- [           main] o.a.camel.spring.SpringCamelContext      : Apache Camel 2.21.0.fuse-720050-redhat-00001 (CamelContext: camel-1) started in 0.553 seconds
    2019-06-14 15:38:37.384  INFO 31260 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
    2019-06-14 15:38:37.463  INFO 31260 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8081 (http)
    2019-06-14 15:38:37.469  INFO 31260 --- [           main] com.redhat.fuse.boosters.cb.Application  : Started Application in 6.436 seconds (JVM running for 10.097)
    Copy to Clipboard Toggle word wrap
  3. Open a new shell prompt and start the greetings service, as follows:

    cd greetings-service
    Copy to Clipboard Toggle word wrap
    mvn spring-boot:run -DskipTests
    Copy to Clipboard Toggle word wrap

    As Spring Boot starts up, you should see output similar to the following:

    ...
    2019-06-14 15:39:57.650  INFO 31435 --- [           main] o.a.c.c.s.CamelHttpTransportServlet      : Initialized CamelHttpTransportServlet[name=CamelServlet, contextPath=]
    2019-06-14 15:39:57.725  INFO 31435 --- [           main] b.c.e.u.UndertowEmbeddedServletContainer : Undertow started on port(s) 8080 (http)
    2019-06-14 15:39:57.732  INFO 31435 --- [           main] com.redhat.fuse.boosters.cb.Application  : Started Application in 6.91 seconds (JVM running for 11.243)
    Copy to Clipboard Toggle word wrap

    The greetings service exposes a REST endpoint at the http://localhost:8080/camel/greetings URL.

  4. Invoke the REST endpoint by either opening the URL in a web browser or by opening another shell prompt and typing the following curl command:

    curl http://localhost:8080/camel/greetings
    Copy to Clipboard Toggle word wrap

    Here is the response:

    {"greetings":"Hello, Jacopo"}
    Copy to Clipboard Toggle word wrap
  5. To demonstrate the circuit breaker functionality provided by Camel Hystrix, kill the backend name service by typing Ctrl-C in the shell prompt window where the name service is running.

    Now that the name service is unavailable, the circuit breaker kicks in to prevent the greetings service from hanging when it is invoked.

  6. Invoke the greetings REST endpoint by either opening http://localhost:8080/camel/greetings in a web browser or by typing the following curl command in another shell prompt window:

    curl http://localhost:8080/camel/greetings
    Copy to Clipboard Toggle word wrap

    Here is the response:

    {"greetings":"Hello, default fallback"}
    Copy to Clipboard Toggle word wrap

    In the window where the greetings service is running, the log shows the following sequence of messages:

    2019-06-14 15:42:27.016  INFO 31435 --- [-CamelHystrix-3] route2                                   :  Try to call name Service
    2019-06-14 15:42:27.019  INFO 31435 --- [-CamelHystrix-3] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
    2019-06-14 15:42:27.019  INFO 31435 --- [-CamelHystrix-3] o.a.c.httpclient.HttpMethodDirector      : Retrying request
    2019-06-14 15:42:27.020  INFO 31435 --- [-CamelHystrix-3] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
    2019-06-14 15:42:27.020  INFO 31435 --- [-CamelHystrix-3] o.a.c.httpclient.HttpMethodDirector      : Retrying request
    2019-06-14 15:42:27.020  INFO 31435 --- [-CamelHystrix-3] o.a.c.httpclient.HttpMethodDirector      : I/O exception (java.net.ConnectException) caught when processing request: Connection refused (Connection refused)
    2019-06-14 15:42:27.020  INFO 31435 --- [-CamelHystrix-3] o.a.c.httpclient.HttpMethodDirector      : Retrying request
    2019-06-14 15:42:27.029  INFO 31435 --- [-CamelHystrix-3] route2                                   :  We are falling back!!!!
    Copy to Clipboard Toggle word wrap
  7. For more information about this example, open the Circuit Breaker - Red Hat Fuse page at http://localhost:8080/ (while the greetings-service is running). This page includes a link to the Hystrix dashboard that monitors the state of the circuit breaker.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat