Агляд Дазволілі гэта, я так адчуваю, таму, што ўсё начальства ўжо святкавала Новы год. і Комплексная дэма, крок за крокам каманды, класа за класам падрабязнасці, выпрабаванні прыкладу, рэальныя выпадкі выкарыстання і саветы для вытворчасці. 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

34 Stories To Learn About Eos

Building a Decentralized OS for the Next Generation of dApps – Dana Love on Andromeda

Inside BTCC: What 14 Years of Crypto Taught BTCC, and What Comes Next

Meet AQUi9, SOS Tech Groups, and Dicken AI: HackerNoon Startups of the Week

34 Stories To Learn About Eos

Building a Decentralized OS for the Next Generation of dApps – Dana Love on Andromeda

Inside BTCC: What 14 Years of Crypto Taught BTCC, and What Comes Next

Meet AQUi9, SOS Tech Groups, and Dicken AI: HackerNoon Startups of the Week

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps