```html
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
``` Përshkrim i Përgjithshëm Mësoni se si t'i bëni thirrjet tuaja të mikroshërbimit të qëndrueshëm duke përdorur modelin Circuit Breaker me   dhe   — demo e plotë, komanda hap pas hapi, shpjegime klasë pas klase, rezultate shembull, raste përdorimi në botën reale dhe këshilla prodhimi. Resilience4j Spring Boot Pse Kjo Ka Rëndësi Në sistemet e shpërndara, një shërbim i poshtëm që dështon mund të kaskadohet dhe të shkaktojë ndërprerje të përgjithshme të sistemit. Modeli  : Circuit Breaker 
 
 
 
 
 Zbulon një varësi që dështon, Nuk dërgon më kërkesa drejt saj (për të shmangur humbjen e burimeve), Kthen një përgjigje të butë të kompensimit (fallback), Teston periodikisht varësinë dhe rivendos funksionimin normal kur ajo është në gjendje të mirë. Kjo zvogëlon kohën e ndërprerjes, mbron pellgjet e fijeve (thread pools), ruan përvojën e përdoruesit të arsyeshme dhe parandalon stuhitë e ripërpjekjeve (retry storms). Përmbledhje e Demonstrimit (Çfarë Keni) Një demo e dy shërbimeve në Maven: 
 
 
 
  (porti  ) — ofrues i thjeshtë REST që qëllimisht dështon ndonjëherë. hello-service 8081 Pika e fundit (End point) GET /api/hello
 
 
 
 
  (porti  ) — thërret hello-service duke përdorur RestTemplate dhe është i mbrojtur nga   me një kompensim (fallback). client-service 8080 Resilience4j @CircuitBreaker Pika e fundit (End point) GET /api/get-message
 Këndojini të dyja ( ) hello-service dhe client-service Pastaj testoni GET http://localhost:8080/api/get-message
 Diagrami i Arkitekturës Ky është një fluks i vogël, i fokusuar, i përshtatshëm për të vizatuar një diagramë Dosjet & Kodi: Shpjegimi Klasë Pas Klase hello-service HelloServiceApplication.java 
 
 
 
 Klasë standard   për fillimin e aplikacionit. @SpringBootApplication HelloController.java

@RestController
public class HelloController {

    private static int counter = 0;

    @GetMapping("/api/hello")
    public String sayHello() {
        counter++;
        // simuloni dështim të ndërprerë: dështoni në çdo kërkesë të 3-të
        if (counter % 3 == 0) {
            throw new RuntimeException("Dështim i simuluar nga Hello-Service!");
        }
        return "Përshëndetje nga Hello-Service! (numri=" + counter + ")";
    }
}
  Ky kontrollues (controller) qëllimisht hedh një RuntimeException në thirrje periodike për të simuluar dështime kalimtare që do të shihnit në sisteme reale (ndërprerje e DB, të dhëna të këqija, kohëzgjatje). Shpjegim: client-service ClientServiceApplication.java 
 
 Klasë kryesore standard Spring Boot. Nuk kërkohet konfigurim special. AppConfig.java
@Configuration
public class AppConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}
  Ofron një bean të vetëm RestTemplate. Sigurohuni që RestTemplate të jetë një bean i Spring-ut në mënyrë që proxy-të AOP/resilience të funksionojnë siç duhet. Shpjegim: 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("Duke thirrur shërbimin hello: " + helloServiceUrl);
        return restTemplate.getForObject(helloServiceUrl, String.class);
    }

    public String fallbackHello(Throwable t) {
        System.out.println("Kompensimi (Fallback) u aktivizua: " + t);
        return "Shërbimi Hello aktualisht është i paarritshëm. Ju lutemi provoni përsëri më vonë.";
    }
}
 Shpjegim (pikat kyçe) 
 
 
 
 
 
 @CircuitBreaker(name = "helloService", fallbackMethod = "fallbackHello") e mbështjell thirrjen getHelloMessage() në një circuit breaker. Emri lidhet me vetitë e konfigurimit. 
 
 
 
 fallbackHello(Throwable t) thirret kur thirrja dështon sipas rregullave të breaker-it. Kompensimi (Fallback) duhet:     o    Të jetë në të njëjtën klasë

    o    Të ketë të njëjtin tip kthimi

    o    Të pranojë parametrat origjinalë të metodës (këtu asnjë) dhe një parametër përfundimtar Throwable (ose Exception/Throwable të pajtueshëm me përjashtimet e hedhura)
 
 
 E rëndësishme: Metoda duhet të jetë publike, dhe klasa duhet të jetë një bean i Spring-ut (@Service), në mënyrë që AOP-ja e bazuar në proxy të funksionojë. 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();
    }
}
  Kontrollues (controller) i thjeshtë që delegohet te  . Kjo siguron që thirrja të kalojë nëpër proxy ku aplikohet circuit breaker. Shpjegim: HelloClientService Konfigurimi i Përdorur (client-service application.properties) Konfigurimi kyç i përdorur në 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
 Kuptimi i vetive të rëndësishme 
 
 
 
 
 
  numri i thirrjeve që breaker-i monitoron për përqindjen e dështimit. slidingWindowSize:  numri minimal i thirrjeve përpara se të vlerësohet shkalla e dështimit. minimumNumberOfCalls:  përqindja e dështimeve (p.sh., 50) për të hapur qarkun (circuit). failureRateThreshold:  sa kohë qëndron i hapur qarku (circuit) para se të kalojë në gjysmë-hapur (half-open). waitDurationInOpenState:  ekspozon gjendjen e breaker-it përmes actuator-it. registerHealthIndicator: Veprimi Hap Pas Hapi & Rezultatet e Pritshme Nisni Shërbimet 
 
 Nisni  hello-service Vizitoni: http://localhost:8081/api/hello
  → "Përshëndetje nga Hello-Service!" (ose hedh dështim të simuluar) Kthen 
 
 Nisni  client-service Vizitoni: http://localhost:8080/api/get-message
 Skenarë Testimi & Rezultate Skenari A — Hello-Service në Gjendje të Mirë Bëni një kërkesë GET http://localhost:8080/api/get-message
 Regjistrimet (logs) e klientit Duke thirrur shërbimin hello: 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' arriti sukses:
2025-11-11:58:23.366+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-8] i.g.r.c.i.CircuitBreakerStateMachine : Ngjarja SUCCESS e publikuar: 2025-11-11:58:23.366634+05:30[Asia/Calcutta]: CircuitBreaker 'helloService' regjistroi një thirrje të suksesshme. Koha e kaluar: 15 ms
 Përgjigja Përshëndetje nga Hello-Service! (numri=4)
 Skenari B — Dështime të Ndërprera të Hello-Service Nëse thërrisni vazhdimisht dhe hello-service hedh   në disa kërkesa: RuntimeException ● Thirrje të suksesshme: klienti kthen mesazhin e përshëndetjes. ● Kur një thirrje e poshtëme kthen HTTP 500/përjashtim:             o    Resilience4j regjistron dështimin.

            o    Nëse shkalla e dështimit tejkalon pragun (p.sh., 50% mbi dritaren rrëshqitëse), Circuit bëhet **OPEN**.

            o    Ndërsa është OPEN, thirrjet shkurtohen; **fallbackHello**() ekzekutohet menjëherë — pa thirrje rrjeti. \n                       **Përgjigja e klientit gjatë aktivizimit të kompensimit (fallback)**
 Përgjigja e Klientit gjatë aktivizimit Përgjigja Shërbimi Hello aktualisht është i paarritshëm. Ju lutemi provoni përsëri më vonë.
 Shembull i sekuencës së regjistrimeve (logs) të klientit Duke thirrur shërbimin hello: 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' regjistroi një përjashtim si dështim:
 Skenari C — Rimëkëmbja Pas    waitDurationInOpenState (10 sekonda): 
 
 
 
 Circuit kalon në  : lejohen disa thirrje testuese. HALF_OPEN Nëse thirrjet testuese janë të suksesshme, breaker-i   dhe trafiku normal rifilloi. MBYLLET Nëse testet dështojnë, breaker-i kthehet në  . OPEN Raste Përdorimi në Botën Reale 
 
 
 
 
  Një shërbim pagese që thërret një API bankare të jashtme: nëse API-ja e bankës bëhet e ngadaltë/dështon, circuit breaker kthen një mesazh miqësor për përdoruesin dhe parandalon stuhitë e ripërpjekjeve. Integrimi i Pagesave -   API me numër të kufizuar thirrjesh në sekondë — kur arrihen limitet, circuit-i hapet për të shmangur tejkalimin e kuotave më tej; kompensimi (fallback) kthen të dhëna të ruajtura në cache. API të palëve të treta të kufizuara nga shkalla (rate-limited) -   Shërbimi A thërret B, i cili thërret C. Nëse C është e paqëndrueshme, circuit breakers-et e hapura mbrojnë B dhe A, duke parandaluar ngadalësimin në të gjithë sistemin. Vargje mikroshërbimesh brenda një ndërmarrjeje -   Kur një shërbim funksional jo kritik dështon, ktheni një rezultat më të thjeshtë për të mbajtur funksionalitetin kryesor të disponueshëm (p.sh., ktheni listën e produkteve pa rekomandime). Çelësa funksionesh dhe degradim i butë -  Avantazhet & Vlera për Biznesin 
 
 
 
 
 
 
  — parandalon që një varësi e keqe të kaskadohet. Izolimi i defekteve  — dështon shpejt në vend që të presë për kohëzgjatje. Përgjigje më e shpejtë ndaj dështimeve  — ofron përgjigje kompensimi (fallback) në vend të ndërprerjeve të plota. Degradim i butë  — shmang humbjen e CPU-së, fijeve (threads) dhe rrjetit. Mbrojtja e burimeve  — kthehet automatikisht në normalitet kur varësia është në gjendje të mirë. Rimëkëmbje automatike  — gjendjet dhe metrikë e breaker-it mund të ekspozohen përmes Actuator dhe të monitorohen. Vëzhgueshmëri Shembull regjistrimesh (logs) që do të shihni (realiste) Duke thirrur shërbimin hello: 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' regjistroi një përjashtim si dështim
2025-11-13T12:00:55.847+05:30 DEBUG 32692 --- [client-service] [nio-8080-exec-1] i.g.r.c.i.CircuitBreakerStateMachine : Ngjarja ERROR e publikuar: 2025-11-13T12:00:55.847908200+05:30[Asia/Calcutta]: CircuitBreaker 'helloService' regjistroi një gabim: '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"}"'. Koha e kaluar: 8 ms
Kompensimi (Fallback) u aktivizua: 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

Odyo sa a pwodui nan lang orijinal istwa a!

Kòman pou Bati API Ki Rezistan Ak Circuit Breaker Resilience4j nan Spring Boot

About Author

KÒMANtè

KANDYE TAGS

ATIK SA A TE PREZANTE NAN

Related Stories

It's Gonna Be May... a New Mobile App Update, Pixelated Avatars, Revamped Story Pages and More

STOP: In the name of the brand police!

Meet the Writer: HackerNoon's Contributor Konstantin Malkov - Product Manager

Gathering Threat Intelligence to Strengthen Security

It's Gonna Be May... a New Mobile App Update, Pixelated Avatars, Revamped Story Pages and More

STOP: In the name of the brand police!

Meet the Writer: HackerNoon's Contributor Konstantin Malkov - Product Manager

Gathering Threat Intelligence to Strengthen Security

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps