
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 Umbhaliso Funda indlela yokwenza imiswele yakho ye-microservice ibe yomelele usebenzisa ipatheni ye-Circuit Breaker kunye ne-  kunye ne-  — idemo epheleleyo, imiyalelo yenyathelo ngenyathelo, iinkcazo zeklasi ngeklasi, imizekelo yeziphumo, iimeko zokusebenzisa kwihlabathi lokwenyani, kunye neengcebiso zokuvelisa. Resilience4j Spring Boot Kutheni oku Kubalulekile Kwiinkqubo ezisasaziweyo, inkonzo esezantsi enokuhluleka ingadala ukuba inkqubo iphele kwaphela. Ipatheni ye- : Circuit Breaker 
 
 
 
 
 Iqaphela umxhasi ohleliyo, Iyeka ukuthumela izicelo kuyo (ukuthintela ukuchitha izixhobo), Ibuyisa impendulo eyamkelekileyo yokubuyela umva, Ijikela umxhasi ngamaxesha athile kwaye ibuyisele ukusebenza okuqhelekileyo xa iphilile. Oku kunciphisa ixesha lokungasebenzi, kukhusela iindawo zokugcina imisonto, kugcina amava omsebenzisi ethembekile, kwaye kuthintela iziqhumezi zokuzama kwakhona. Isishwankathelo seDemo (Oko Unako) IMaven demo yenkonzo ezimbini: 
 
 
 
  (izibuko  ) — umboneleli olula we-REST owenza iimpazamo ngamaxesha athile. hello-service 8081 Isiphelo GET /api/hello
 
 
 
 
  (izibuko  ) — ibiza i-hello-service usebenzisa i-RestTemplate kwaye ikhuselwe yi-  enokubuyela umva. client-service 8080 Resilience4j @CircuitBreaker Isiphelo GET /api/get-message
 Qalisa zombini ( ) hello-service kunye client-service Emva koko vjiya GET http://localhost:8080/api/get-message
 Umzobo weNdlela Yokusebenza Le yindlela encinci, egxileyo efanelekileyo ukuzoba idayagramu Iifayile & Ikhowudi: Ingcaciso yeklasi ngeklasi hello-service HelloServiceApplication.java 
 
 
 
 Iklasi yokuqalisa ye-  eqhelekileyo. @SpringBootApplication HelloController.java

@RestController
public class HelloController {

    private static int counter = 0;

    @GetMapping("/api/hello")
    public String sayHello() {
        counter++;
        // simulate intermittent failure: fail on every 3rd request
        if (counter % 3 == 0) {
            throw new RuntimeException("Simulated failure from Hello-Service!");
        }
        return "Hello from Hello-Service! (count=" + counter + ")";
    }
}
  Le controller ngabom iphonsa i-RuntimeException kwizicelo ezithile ukuxelisa iimpazamo ezithwaxayo ozozibona kwiinkqubo zokwenyani (ukungasebenzi kwe-DB, idatha embi, amaxesha okugqiba). Ingcaciso: client-service ClientServiceApplication.java 
 
 Iklasi ephambili eqhelekileyo ye-Spring Boot. Akukho konqeqesho olukhethekileyo olufunekayo. AppConfig.java
@Configuration
public class AppConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}
  Inikezela ibhasi enye ye-RestTemplate. Qinisekisa ukuba i-RestTemplate yibhasi ye-Spring ukuze i-AOP/i-resilience proxies ingasebenza ngokufanelekileyo. Ingcaciso: 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.";
    }
}
 Ingcaciso (iingongoma ezibalulekileyo) 
 
 
 
 
 
 @CircuitBreaker(name = "helloService", fallbackMethod = "fallbackHello") igubungela umnxeba we-getHelloMessage() kwisekethe. Igama libopha kwiipropathi zokunqeqesha. 
 
 
 
 i-fallbackHello(Throwable t) ibizwa xa umnxeba uhluleka ngokweemithetho yesekethe. I-fallback kufuneka:     o    Ingabiklasi enye

    o    Ibengohlobo lokubuyela olufanayo

    o    Yamkele iiparamitha zendlela yokuqala (akukho nto apha) kunye ne-Throwable yokugqibela iparamitha (okanye i-Exception/Throwable ehambelanayo neziphumo eziphonjiweyo)
 
 
 Kubalulekile: Indlela kufuneka ibe yimfihlo, kwaye iklasi kufuneka ibe yibhasi ye-Spring (@Service), ukuze i-AOP esekelwe kwi-proxy ingasebenza. 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();
    }
}
  I-controller elula ethumela kwi- . Oku kuqinisekisa ukuba umnxeba uhamba kwi-proxy apho isekethe isetyenziswayo. Ingcaciso: HelloClientService Ukonqeqesho Olusetyenzisiweyo (client-service application.properties) Ukonqeqesho olubalulekileyo olusetyenziswe kwi-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
 Intsingiselo yeepropathi ezibalulekileyo 
 
 
 
 
 
  inombolo yezicelo isekethe ehlola ngazo kwipesenti yempazamo. slidingWindowSize:  ubuncinci bezicelo phambi kokuba kuv Jiwe inqanaba lempazamo. minimumNumberOfCalls:  ipesenti yeempazamo (umzekelo, 50) ukuvula isekethe. failureRateThreshold:  ixesha elingakanani isekethe ihlala ivuliwe ngaphambi kokuba ingene kwisiqingatha-sikho. waitDurationInOpenState:  ibonisa imeko yesekethe nge-actuator. registerHealthIndicator: Inyathelo ngenyathelo lokuSebenza & Izimvo Ezilindelekileyo Qalisa iinkonzo 
 
 Qalisa  hello-service Vjiya: http://localhost:8081/api/hello
  → "Hello from Hello-Service!" (okanye iphonsa impazamo eyenziweyo) Ibiza 
 
 Qalisa  client-service Vjiya: http://localhost:8080/api/get-message
 Iimeko zokuvjiya & Izimvo Imeko A — Hello-Service Iphilile Yenza isicelo GET http://localhost:8080/api/get-message
 Iilogi ze-Client 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
 Impendulo Hello from Hello-Service! (count=4)
 Imeko B — Iimpazamo ezingapheliyo ze-Hello-Service Ukuba ubiza rhoqo kwaye i-hello-service iphonsa i-  kwezinye izicelo: RUNTIMEEXCEPTION ● Izicelo eziphumeleleyo: i-client ibuyisa umyalezo we-hello. ● Xa umnxeba ongaphantsi ubuyisa i-HTTP 500/exception:             o    I-Resilience4j irekhoda impazamo.

            o    Ukuba inqanaba lempazamo lingaphezulu kwesikhundla (umzekelo, 50% ngaphezulu kwesilayidi esijikelezayo), iSckitu iba yi- .

            o    Ngelixa kuvuliwe, izicelo zimfutshane; i- () ibizwa ngoko nangoko — akukho mnxeba wenethiwekhi. \n                       **Impendulo ye-Client ngelixa i-fallback isebenza**
 OPEN fallbackHello Impendulo ye-Client ngelixa isebenza Impendulo Hello Service is currently unavailable. Please try again later.
 Umzekelo wenkqubo yelogi ye-client 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:
 Imeko C — Ukubuyiselwa Emva kwe-   waitDurationInOpenState (10s): 
 
 
 
 Isekethe ingena kwisimo se- : izicelo ezimbalwa zokuvjiya ziyavunyelwa. HALF_OPEN Ukuba izicelo zokuvjiya ziphumelela, isekethe   kwaye umsebenzi oqhelekileyo uyaqhubeka. IYAVULA Ukuba izicelo zivjiya ziyahluleka, isekethe ibuyela kwisimo se- . OPEN Iimeko Zokusebenzisa Kwihlabathi Lokwenyani 
 
 
 
 
  Inkonzo yokuhlawula etsalela i-API yebhanki yangaphandle: ukuba i-API yebhanki icotha/iyasilela, isekethe i-breaker ibuyisa umyalezo owamkelekileyo kwaye ithintela iziqhumezi zokuzama kwakhona. Ukudibanisa Intlawulo -  I-APIs ezineezicelo ezincinci ngomzuzwana — xa amabakala efikelelwa, isekethe iyavula ukunqanda ukubetha kwakhona imilinganiselo; ukubuyela umva kubuyisa idatha egcinweyo. I-APIs enqanaba elingaphandle -  Inkonzo A ibiza uB, o calls uC. Ukuba uC akazinzile, ii-breakers ezivulekileyo zikhusela uB noA, thintela ukucotha okusasazekayo kwinkqubo. Iinkonzo ezichazwe ngaphakathi kwinkampani -  Xa inkonzo ye-feature engabalulekanga iyasilela, buyisela isiphumo esilula ukuze ugcine ukusebenza okubalulekileyo kufumaneka (umzekelo, buyisela uluhlu lweemveliso ngaphandle kwezibonelelo). Ii-switches ze-Feature kunye nokuhla okunamandla - Izibonelelo & Ixabiso Le-Shishini 
 
 
 
 
 
 
  — kuthintela umxhasi omnye ombi ukuba angadluliseli. Ukunqunyanyiswa kweziphazamiso  — kuyasilela ngokukhawuleza endaweni yokulinda ixesha lokugqiba. Ukuphendula ngokukhawuleza kwiimpazamo  — kubonelela ngezimpendulo zokubuyela umva endaweni yokungasebenzi ngokupheleleyo. Ukuhla okunamandla  — kuthintela ukuchitha i-CPU, imisonto, kunye nenethiwekhi. Ukukhuselwa kwezixhobo  — kubuyela ngokuzenzekelayo kwesiqhelo xa umxhasi ephile. Ukubuyiselwa ngokuzenzekelayo  — iimeko ze-breaker kunye nemetrics zinokuvezwa nge-Actuator kwaye ziqwalaselwe. Ukubona Imizekelo yeelogi ozozibona (zokwenyani) 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

Le audio iveliswe ngolwimi lokuqala lwebali!

Idlalani ukwakha ii-API eziQinisekileyo kunye neCircuit Breaker yeResilience4j kwiSpring Boot

About Author

IZIMVO

ZIJONGE IIMPAWU

ELI NQAKU LINIKEZELWE KU

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps