Pregled Saznajte kako učiniti mikroslužbene pozive otpornima pomoću obrasca prekidača kruga i — potpuni demo, korak po korak komande, razred po razred objašnjenja, uzorci izlaza, slučajevi korištenja u stvarnom svijetu i savjeti za proizvodnju. Resilience4j Spring Boot Why This Matters Zašto je to važno U distribuiranim sustavima, neuspjeh usluge u daljnjem toku može kaskadirati i uzrokovati opće prekide sustava. Način patenata: Circuit Breaker 
 
 
 
 
 otkrivanje neuspješne ovisnosti, zaustavlja slanje zahtjeva (kako bi se izbjeglo trošenje resursa), Vraća graciozan povratni odgovor, Periodično testira ovisnost i vraća normalno funkcioniranje kada je zdravo. To smanjuje vrijeme prestanka rada, štiti bazene nitova, održava korisničko iskustvo razumnim i sprječava oluje ponovnog uklanjanja. Demo Summary (What You Have) Demo sažetak (što imate) Dvostruka služba Maven demo: 
 
 
 
  (port  ) — simple REST provider that intentionally fails intermittently. hello-service 8081 Kraj točke GET /api/hello
 
 
 
 
  (port  ) — calls hello-service using RestTemplate and is protected by   with a fallback. client-service 8080 Resilience4j @CircuitBreaker Kraj točke GET /api/get-message
 Sljedeći članakSljedeći članakSljedeći članakSljedeći ( ) hello-service and client-service Nakon toga test GET http://localhost:8080/api/get-message
 Arhitektonski dijagram Ovo je mali, fokusirani protok pogodan za crtanje dijagrama Files & Code: Class-By-Class Explanation Files & Code: razred po razredu objašnjenje hello-service Sljedeći članakHelloServiceApplication.java 
 
 
 
 Standard   bootstrap class. @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 + ")";
    }
}
 Ovaj kontrolor namjerno baca RuntimeException na periodične pozive kako bi simulirao prijelazne neuspjehe koje biste vidjeli u stvarnim sustavima (DB prekid, loši podaci, vremenske prekide). Explanation: client-service Sljedeći članakPrijava.java 
 
 Standardni Spring Boot glavni razred. ne zahtijeva posebnu konfiguraciju. AppConfig.java
@Configuration
public class AppConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}
 Osigurajte da je RestTemplate Spring bean tako da AOP/resilience proxy može pravilno raditi. Explanation: 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.";
    }
}
 Explanation (crucial bits) 
 
 
 
 
 
 @CircuitBreaker(name = "helloService", fallbackMethod = "fallbackHello") wraps the getHelloMessage() call in a circuit breaker. The name links to configuration properties. 
 
 
 
 fallbackHello(Throwable t) is called when the call fails according to the breaker rules. The fallback must:     o    Be in the same class

    o    Have the same return type

    o   Accept the original method parameters (none here) and a final Throwable parameter (or Exception/Throwable compatible with thrown exceptions)
 
 
 Important: The method must be public, and the class must be a Spring bean (@Service), so proxy-based AOP works. 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();
    }
}
 Jednostavni kontrolori delegiraju na To osigurava da poziv prolazi kroz proxy gdje se primjenjuje prekidač kruga. Explanation: HelloClientService Configuration Used (client-service application.properties) Konfiguracija korištena (aplikacija za usluge klijenta.properties) Konfiguracija ključa koja se koristi u demo-u 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
 Meaning of important properties 
 
 
 
 
 
 SlidingWindowSize: broj poziva prekidača za procjenu neuspjeha. minimumNumberOfCalls: minimalni pozivi prije procjene stope neuspjeha. failureRateThreshold: postotak neuspjeha (npr., 50) za otvaranje kruga. Vrijeme trajanja: koliko dugo krug ostaje otvoren prije nego što se premjesti na poluotvoreno. RegistryHealthIndicator: izlaže stanje prekidača putem aktuatora. Step-by-Step Run i očekivani rezultati Početak usluga 
 
 Počnite s uslugom Visit: http://localhost:8081/api/hello
 “Hello from Hello-Service!” (ili bacanje simuliranog neuspjeha) Returns 
 
 Početak korisničkog servisa Visit: http://localhost:8080/api/get-message
 Test Scenarios & Outputs Testiranje scenarija i rezultata Scenario A — Hello-Service Healthy Napravite zahtjev GET http://localhost:8080/api/get-message
 Klijenti logovi 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
 Response Hello from Hello-Service! (count=4)
 Scenario B — Hello-Service Intermittent Failures Ako nazovete više puta i pozdravne usluge bacaju Na nekim zahtjevima: RuntimeException ● Uspješni pozivi: klijent vraća pozdravnu poruku. Kada dolazni poziv vrati HTTP 500/iznimku:             o    Resilience4j records the failure.

            o    If failure rate exceeds threshold (e.g., 50% over sliding window), the Circuit becomes **OPEN**.

            o    While OPEN, calls are short-circuited; **fallbackHello**() is immediately executed — no network call. \n                       **Client response while fallback active**
 Client Response while active Response Hello Service is currently unavailable. Please try again later.
 Sample client log sequence 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:
 Scenario C — Recovery Nakon   Vrijeme otvaranja (na primjer 10s) Vrijeme otvaranja 
 
 
 
 Krug ide na HALF_OPEN: dopušteno je nekoliko test poziva. Ako testni pozivi uspiju, prekidač se zatvara i normalni promet se nastavlja. Ako testovi ne uspiju, prekidač se vraća na OPEN. Real-World Use Cases Slučajevi stvarnog svijeta 
 
 
 
 
 Integracija plaćanja - usluga plaćanja koja poziva API vanjske banke: ako API banke postane spor / neuspješan, prekidač kruga vraća korisničku poruku i sprječava oluje ponovnog pokretanja. API-ji s ograničenom stopom treće strane - API-ji s ograničenim pozivima po sekundi - kada se dosegnu ograničenja, krug se otvara kako bi se izbjegle daljnje kvote; Fallback vraća pohranjene podatke. Microservice lanci unutar poduzeća - Service A poziva B, koji poziva C. Ako je C nestabilan, otvoreni prekidači štite B i A, sprječavajući usporavanje cijelog sustava. Prebacivanje značajki i graciozna degradacija - Kada ne-kritična usluga značajki ne uspije, vratite jednostavniji rezultat kako biste održali dostupnost osnovne funkcionalnosti (npr. vratite popis proizvoda bez preporuka). Advantages & Business Value Prednosti i poslovna vrijednost 
 
 
 
 
 
 
 Izolacija grešaka - sprječava jednu lošu ovisnost od kaskadiranja. Brži odgovor na neuspjeh - neuspjeh brzo umjesto čekanja na vremenske prekide. Graciozna degradacija – nudi povratne odgovore umjesto potpunih prekida. Zaštita resursa – izbjegava trošenje CPU-a, žica i mreže. Auto oporavak – automatski se vraća u normalu kada je ovisnost zdrava. Posmatranost – stanja i mjerila prekidača mogu se izložiti putem aktuatora i pratiti. Sample logs you’ll see (realistic) 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

Ovaj zvuk je proizveden na izvornom jeziku priče!

Kako izgraditi otporne API-je s prekidačem kruga Resilience4j u Spring Bootu

About Author

KOMENTARI

VIJESI OZNAKE

OVAJ ČLANAK JE PREDSTAVLJEN U

Related Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps