Агляд Дазволілі гэта, я так адчуваю, таму, што ўсё начальства ўжо святкавала Новы год. і Комплексная дэма, крок за крокам каманды, класа за класам падрабязнасці, выпрабаванні прыкладу, рэальныя выпадкі выкарыстання і саветы для вытворчасці. Resilience4j Spring Boot Why This Matters Чаму гэта важна У распределеных сістэмах, няправільнасць даступнага абслугоўвання можа каскада і выклікаць агульныя выключэння сістэмы. Падрабязней па тэме: Circuit Breaker 
 
 
 
 
 Вызначыць няправільную залежнасць, Запрашаем усіх, хто цікавіцца беларускай гісторыяй, наведаць нашу Бібліятэку! Здадуць вас на працу на цагляны завод ці кукурузу лушчыць адправяць Периодически тестирует зависимость и восстанавливает нормальную работу, калі здольны. Гэта рэпрэсіўны механізм, які працуе на дыктатуру. Demo Summary (What You Have) Вынікі пошуку - what you have (англ.) Двухпалітнае абслугоўванне Maven demo: 
 
 
 
  (port  ) — simple REST provider that intentionally fails intermittently. hello-service 8081 Кожны пункт GET /api/hello
 
 
 
 
  (port  ) — calls hello-service using RestTemplate and is protected by   with a fallback. client-service 8080 Resilience4j @CircuitBreaker Кожны пункт GET /api/get-message
 2 Вынікі ў ( ) hello-service and client-service Затым праверка GET http://localhost:8080/api/get-message
 Архітэктурная схема Гэта невялікі, фокусаваны поток, прыдатны для малювання дыяграмы Files & Code: Class-By-Class Explanation Файлы і код: класа-па-класе падрабязнасць hello-service Папярэдні Тэкст: 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 + ")";
    }
}
 Гэты кантролер намеснікам выкідае RuntimeException на рэгулярныя выклікі, каб імітаваць пераходныя няправільнасці, якія вы бачыце ў рэальных сістэмах (DB-выпадкі, слабыя дадзеныя, часовыя выключэння). Explanation: client-service Вынікі пошуку - Java 
 
 Папярэдні Тэкст Стандартная класіфікацыя не патрабуецца. AppConfig.java
@Configuration
public class AppConfig {
    @Bean
    public RestTemplate restTemplate() {
        return new RestTemplate();
    }
}
 Для рэгістрацыі дамена кампаніям неабходна прадставіць рэгістрацыйны нумар кампаніі (business identity code або registration number), а прыватным асобам неабходна прадставіць свой ідэнтыфікацыйны код Finnish personal ID number. 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();
    }
}
 Праўда, праўда, праўда праўда, праўда праўда, праўда праўда Гэта забяспечвае, што выклик праходзіць праз проксі, дзе нанесены пераключальнік. Explanation: HelloClientService Configuration Used (client-service application.properties) Выкарыстоўваная канфігурацыя (клиент-service application.properties) Ключавая канфігурацыя, якая выкарыстоўваецца ў дэмо 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 
 
 
 
 
 
 СлайдWindowSize: колькасць выклікаў выключальніка для працэсу несправядлівасці. У гэтым выпадку пешаходы, якія сканчаюць пераход, уяўляюць істотную небяспеку (мал. Працягласць: % несправядлівасцяў (напрыклад, 50) для адкрыцця кола. У гэтым выпадку пешаходы, якія сканчаюць пераход, уяўляюць істотную небяспеку (мал. Узнагароджанне: вызначаецца з дапамогай актыўнай сістэмы. Step-by-Step Run і чаканыя вынікі Стартаванне паслуг 
 
 Папярэдні Тэкст Hello-Service Visit: http://localhost:8081/api/hello
 → «Hello from Hello-Service!» (або выкідаецца сіміляваная няўдача) Returns 
 
 Пачатак кліентаў Visit: http://localhost:8080/api/get-message
 Test Scenarios & Outputs Сцэнары і вынікі Scenario A — Hello-Service Healthy Зрабіць заяўку GET http://localhost:8080/api/get-message
 Кліент Лог 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 Калі вы часта размаўляеце і прымаеце прывітанне На некаторыя просьбы: RuntimeException Узнікае пытанне: ці можа вера на самой справе змяніць свет? ● Калі падступны выклик вяртае HTTP 500/выключэнне:             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 Потым   Чытаць падрабязна 10 дзён: Чытаць падрабязна 
 
 
 
 Кніга пераходзіць на HALF_OPEN: дазволена некалькі тэставых выклікаў. Калі тэставыя выклікі паспяхова, выключальнік ЗАКРЫВАЕТСЯ і нормальны трафік паўтараецца. Калі тэст не спрацуе, пераключальнік вяртаецца ў OPEN. Real-World Use Cases Факты пра рэальны свет 
 
 
 
 
 Інтэграцыя плацяжоў — каскадны сэрвіс, які выклікае знешні банкаўскі API: калі банкаўскі API становіцца слабым / няправільным, пераключальнік вяртае зручнае паведамленне і забяспечвае штормы перазагрузкі. Іншая справа, як раскрыць душу героя... Калі мы кажам пра кіно, каб захаваць гэтую натуральнасць паўсядзённасці і выявіць драму, неабходны моцны сцэнарый. Мікрасервісныя ланцуги ўнутры прадпрыемства - Сервіс A выклікае B, які выклікае C. Калі C нестабільны, адкрытыя пераключальнікі абараняюць B і A, перашкоджаючы спалазненню ў цэлым сістэме. У нашай багатай беларускай літаратуры няма другога такога твора, які па энцыклапедычнасці выяўлення ў ім нацыянальнага, так набліжаўся б да "Новай зямлі". Advantages & Business Value Правілы і бізнес-цін 
 
 
 
 
 
 
 Ізоляцыя вады — забяспечвае каскадаванне аднайменнай залежнасці. Шчырае адказ на несправядлівасць — несправядлівасць замяняецца на чаканні часоў. Гаспадарная дэградацыя — прапануе адказ на падпадзенне, а не поўныя перапынкі. Захоўванне рэсурсаў — выключае марнаванне CPU, праявы і сеткі. Аўтаматычнае аднаўленне — аўтаматычна вяртаецца ў норму, калі залежнасць здольная. Узнікае пытанне: калі іх ведае увесь свет, ці можна назваць іх няўдачнікамі? 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

Гэта аўдыя зроблена на мове арыгіналу гісторыі!

Як пабудаваць адстойныя API з Resilience4j Circuit Breaker ў Spring Boot

About Author

КАМЕНТАРЫІ

ВЕСІЦЬ БІРКІ

ГЭТЫ АРТЫКУЛ БЫЎ ПРАДСТАЎЛЕНЫ Ў

Related Stories

HackerNoon Releases “The Editing Protocol” - Technical Documentation for Digital Publishing at Scale

How Edge & Node’s Rodrigo Coelho Is Reimagining the Web with The Graph

How Fraction AI is Democratizing AI Ownership for the Masses

10 Reasons Why Publishing on HackerNoon Will Skyrocket Your Reach and Impact

HackerNoon Releases “The Editing Protocol” - Technical Documentation for Digital Publishing at Scale

How Edge & Node’s Rodrigo Coelho Is Reimagining the Web with The Graph

How Fraction AI is Democratizing AI Ownership for the Masses

10 Reasons Why Publishing on HackerNoon Will Skyrocket Your Reach and Impact

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps