
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Pangkalahatang-ideya Alamin kung paano gawing matatag ang iyong mga tawag sa microservice gamit ang Circuit Breaker pattern gamit ang   at   — kumpletong demo, hakbang-hakbang na mga utos, paliwanag bawat klase, mga sample na output, mga totoong kaso ng paggamit, at mga tip sa produksyon. Resilience4j Spring Boot Bakit Mahalaga Ito Sa mga distributed system, ang isang bumabagsak na downstream service ay maaaring maging sanhi ng pagkalat ng problema at magdulot ng pangkalahatang pagkabigo ng system. Ang   pattern: Circuit Breaker 
 
 
 
 
 Nakakadetect ng bumabagong dependency, Humihinto sa pagpapadala ng mga kahilingan dito (upang maiwasan ang pag-aaksaya ng mga mapagkukunan), Nagbabalik ng isang maayos na fallback na tugon, Paminsan-minsang sinusubok ang dependency at ibinabalik ang normal na operasyon kapag malusog. Binabawasan nito ang downtime, pinoprotektahan ang mga thread pool, pinapanatiling makatwiran ang karanasan ng user, at pinipigilan ang mga retry storm. Buod ng Demo (Ang Mayroon Ka) Isang demo ng dalawang Maven service: 
 
 
 
  (port  ) — simpleng REST provider na sinasadyang paminsan-minsan ay bumabagsak. hello-service 8081 End point GET /api/hello
 
 
 
 
  (port  ) — tumatawag sa hello-service gamit ang RestTemplate at protektado ng   na may fallback. client-service 8080 Resilience4j @CircuitBreaker End point GET /api/get-message
 Patakbuhin ang pareho ( ) hello-service at client-service Pagkatapos ay subukan GET http://localhost:8080/api/get-message
 Diagram ng Arkitektura Ito ay isang maliit, nakatutok na daloy na angkop para sa pagguhit ng isang diagram Mga File & Code: Paliwanag Bawat Klase hello-service HelloServiceApplication.java 
 
 
 
 Pamantayang   bootstrap class. @SpringBootApplication HelloController.java

@RestController
public class HelloController {

    private static int counter = 0;

    @GetMapping("/api/hello")
    public String sayHello() {
        counter++;
        // gayahin ang paminsan-minsang pagkabigo: mabigo sa bawat ika-3 na tawag
        if (counter % 3 == 0) {
            throw new RuntimeException("Simulated failure from Hello-Service!");
        }
        return "Hello from Hello-Service! (count=" + counter + ")";
    }
}
  Sinasadyang naghahagis ng RuntimeException ang controller na ito sa mga pana-panahong tawag upang gayahin ang mga panandaliang pagkabigo na makikita mo sa mga totoong system (DB outage, bad data, timeouts). Paliwanag: client-service ClientServiceApplication.java 
 
 Pamantayang Spring Boot main class. Walang kinakailangang espesyal na config. AppConfig.java
@Configuration
public class AppConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}
  Nagbibigay ng isang RestTemplate bean. Siguraduhin na ang RestTemplate ay isang Spring bean upang gumana nang maayos ang AOP/resilience proxy. Paliwanag: HelloClientService.java
@Service
public class HelloClientService {

    private final RestTemplate restTemplate;

    @Value("${hello.service.url}")
    private String helloServiceUrl;

    public HelloClientService(RestTemplate restTemplate) {
        this.restTemplate = restTemplate;
    }

    @CircuitBreaker(name = "helloService", fallbackMethod = "fallbackHello")
    public String getHelloMessage() {
        System.out.println("Calling hello service: " + helloServiceUrl);
        return restTemplate.getForObject(helloServiceUrl, String.class);
    }

    public String fallbackHello(Throwable t) {
        System.out.println("Fallback triggered: " + t);
        return "Hello Service is currently unavailable. Please try again later.";
    }
}
 Paliwanag (mga kritikal na bahagi) 
 
 
 
 
 
 Ang @CircuitBreaker(name = "helloService", fallbackMethod = "fallbackHello") ay bumabalot sa tawag sa getHelloMessage() sa isang circuit breaker. Ang pangalan ay nag-uugnay sa mga property ng configuration. 
 
 
 
 Ang fallbackHello(Throwable t) ay tinatawag kapag nabigo ang tawag ayon sa mga patakaran ng breaker. Ang fallback ay dapat:     o    Nasa parehong klase

    o    May parehong return type

    o   Tumatanggap ng orihinal na mga parameter ng paraan (wala dito) at isang huling parameter na Throwable (o Exception/Throwable na tugma sa mga itinapon na exception)
 
 
 Mahalaga: Ang paraan ay dapat na pampubliko, at ang klase ay dapat na isang Spring bean (@Service), upang gumana ang AOP na batay sa proxy. ClientController.java
@RestController
public class ClientController {

    private final HelloClientService helloClientService;

    public ClientController(HelloClientService helloClientService) {
        this.helloClientService = helloClientService;
    }

    @GetMapping("/api/get-message")
    public String getMessage() {
        return helloClientService.getHelloMessage();
    }
}
  Simpleng controller na nagde-delegate sa  . Tinitiyak nito na ang tawag ay dumaan sa proxy kung saan inilalapat ang circuit breaker. Paliwanag: HelloClientService Ginagamit na Konfigurasyon (client-service application.properties) Mahahalagang konfigurasyon na ginamit sa demo server.port=8080
spring.application.name=client-service

hello.service.url=http://localhost:8081/api/hello

resilience4j.circuitbreaker.instances.helloService.registerHealthIndicator=true
resilience4j.circuitbreaker.instances.helloService.slidingWindowSize=5
resilience4j.circuitbreaker.instances.helloService.minimumNumberOfCalls=2
resilience4j.circuitbreaker.instances.helloService.failureRateThreshold=50
resilience4j.circuitbreaker.instances.helloService.waitDurationInOpenState=10s

logging.level.io.github.resilience4j.circuitbreaker=DEBUG
 Kahulugan ng mahahalagang property 
 
 
 
 
 
  bilang ng mga tawag na binabantayan ng breaker para sa porsyento ng pagkabigo. slidingWindowSize:  pinakamababang bilang ng mga tawag bago suriin ang rate ng pagkabigo. minimumNumberOfCalls:  porsyento ng mga pagkabigo (hal., 50) upang buksan ang circuit. failureRateThreshold:  gaano katagal mananatiling bukas ang circuit bago lumipat sa kalahating bukas. waitDurationInOpenState:  naglalantad ng estado ng breaker sa pamamagitan ng actuator. registerHealthIndicator: Mga Hakbang-Hakbang na Pagsasagawa & Inaasahang Mga Output Simulan ang mga Serbisyo 
 
 Simulan ang  hello-service Bisitahin: http://localhost:8081/api/hello
  → "Hello from Hello-Service!" (o naghahagis ng simulated failure) Nagbabalik 
 
 Simulan ang  client-service Bisitahin: http://localhost:8080/api/get-message
 Mga Senaryo ng Pagsubok & Mga Output Senaryo A — Malusog ang Hello-Service Gumawa ng isang kahilingan GET http://localhost:8080/api/get-message
 Mga log ng kliyente Calling hello service: http://localhost:8081/api/hello
2025-11-13T11:58:23.366+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-8] i.g.r.c.i.CircuitBreakerStateMachine : CircuitBreaker 'helloService' succeeded:
2025-11-13T11:58:23.366+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-8] i.g.r.c.i.CircuitBreakerStateMachine : Event SUCCESS published: 2025-11-13T11:58:23.366634+05:30[Asia/Calcutta]: CircuitBreaker 'helloService' recorded a successful call. Elapsed time: 15 ms
 Tugon Hello from Hello-Service! (count=4)
 Senaryo B — Paminsan-minsang Pagkabigo ng Hello-Service Kung paulit-ulit kang tatawag at ang hello-service ay naghahagis ng   sa ilang mga kahilingan: RuntimeException ● Matagumpay na mga tawag: ibinabalik ng kliyente ang hello message. ●  Kapag ang isang downstream call ay nagbabalik ng HTTP 500/exception:             o    Itinatala ng Resilience4j ang pagkabigo.

            o    Kung ang rate ng pagkabigo ay lumampas sa threshold (hal., 50% sa sliding window), ang Circuit ay nagiging **BUKAS**.

            o    Habang BUKAS, ang mga tawag ay na-short-circuit; ang **fallbackHello**() ay agad na isinasagawa — walang network call. \n                       **Tugon ng kliyente habang aktibo ang fallback**
 Tugon ng Kliyente habang aktibo Tugon Hello Service is currently unavailable. Please try again later.
 Sample sequence ng log ng kliyente Calling hello service: http://localhost:8081/api/hello
2025-11-13T12:00:55.842+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-1] i.g.r.c.i.CircuitBreakerStateMachine : CircuitBreaker 'helloService' recorded an exception as failure:
 Senaryo C — Pagbawi Pagkatapos ng    waitDurationInOpenState (10s): 
 
 
 
 Ang Circuit ay nagiging  : pinapayagan ang ilang test calls. HALF_OPEN Kung magtagumpay ang mga test calls, ang breaker ay nagiging   at nagpapatuloy ang normal na trapiko. CLOSE Kung mabigo ang mga test, ang breaker ay bumabalik sa  . OPEN Mga Kaso ng Paggamit sa Totoong Mundo 
 
 
 
 
  Isang checkout service na tumatawag sa isang external bank API: kung ang API ng bangko ay bumagal/bumagsak, ang circuit breaker ay nagbabalik ng isang mensahe na madaling maintindihan ng user at pinipigilan ang mga retry storm. Integrasyon ng Pagbabayad - Mga API na may limitadong tawag bawat segundo — kapag naabot ang mga limitasyon, bumubukas ang circuit upang maiwasan ang karagdagang pag-abot sa mga quota; ang fallback ay nagbabalik ng cached data. Mga Third-party API na may limitadong rate —  Ang Serbisyo A ay tumatawag sa B, na tumatawag sa C. Kung ang C ay hindi matatag, pinoprotektahan ng mga bukas na breaker ang B at A, na pumipigil sa pagbagal ng buong system. Mga kadena ng Microservice sa loob ng isang enterprise —  Kapag nabigo ang isang hindi kritikal na service ng feature, magbalik ng mas simpleng resulta upang mapanatiling magagamit ang pangunahing paggana (hal., ibalik ang listahan ng produkto nang walang mga rekomendasyon). Mga toggle ng feature at maayos na pagbaba —  Mga Kalamangan & Halaga sa Negosyo 
 
 
 
 
 
 
  — pinipigilan ang isang masamang dependency na kumalat. Paghihiwalay ng Pagkabigo  — mabilis na nabibigo sa halip na maghintay sa mga timeout. Mas mabilis na pagtugon sa pagkabigo  — nag-aalok ng mga fallback na tugon sa halip na kumpletong pagkabigo. Maayos na pagbaba  — iniiwasan ang pag-aaksaya ng CPU, thread, at network. Proteksyon ng Mapagkukunan  — awtomatikong bumabalik sa normal kapag malusog ang dependency. Awtomatikong Pagbawi  — ang mga estado ng breaker at mga sukatan ay maaaring ilantad sa pamamagitan ng Actuator at bantayan. Pagiging Obserbable Mga sample na log na makikita mo (makatotohanan) Calling hello service: http://localhost:8081/api/hello
2025-11-13T12:00:55.842+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-1] i.g.r.c.i.CircuitBreakerStateMachine : CircuitBreaker 'helloService' recorded an exception as failure
2025-11-13T12:00:55.847+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-1] i.g.r.c.i.CircuitBreakerStateMachine : Event ERROR published: 2025-11-13T12:00:55.847908200+05:30[Asia/Calcutta]: CircuitBreaker 'helloService' recorded an error: 'org.springframework.web.client.HttpServerErrorException$InternalServerError: 500 : "{"timestamp":"2025-11-13T06:30:55.842+00:00","status":500,"error":"Internal Server Error","path":"/api/hello"}"'. Elapsed time: 8 ms
Fallback triggered: org.springframework.web.client.HttpServerErrorException$InternalServerError: 500 : "{"timestamp":"2025-11-13T06:30:55.842+00:00","status":500,"error":"Internal Server Error","path":"/api/hello"}"


Read My Stories

Ang audio na ito ay ginawa sa orihinal na wika ng kuwento!

Paano Bumuo ng Matatag na API Gamit ang Resilience4j Circuit Breaker sa Spring Boot

About Author

MGA KOMENTO

HANG TAGS

ANG ARTIKULONG ITO AY IPINAKITA SA

Related Stories

Hosting a DNS domain on the blockchain

State of the Noonion: The Year of Profitability and Product Renaissance

Encrypted Instant Messaging Recommendations January 2017

How I deployed my spark document classification(Logistic Regression) model/s as a standalone app…

Hosting a DNS domain on the blockchain

State of the Noonion: The Year of Profitability and Product Renaissance

Encrypted Instant Messaging Recommendations January 2017

How I deployed my spark document classification(Logistic Regression) model/s as a standalone app…

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps