តើធ្វើដូចម្តេចដើម្បីបង្កើត APIs resilient ជាមួយ Resilience4j Circuit Breaker នៅក្នុង Spring Boot

យោបល់ តើធ្វើដូចម្តេចដើម្បីធ្វើឱ្យទូរស័ព្ទ microservice របស់អ្នកមានភាពងាយស្រួលដោយប្រើគំរូ Circuit Breaker ជាមួយនឹង និង — ការធ្វើតេស្តពេញលេញ, ការធ្វើតេស្តបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយបន្ទាប់ពីដំណោះស្រាយ។ Resilience4j Spring Boot Why This Matters ដូច្នេះអ្វីទៅជាការសំខាន់ នៅលើប្រព័ន្ធផ្លាស់ប្តូរ, សេវាកម្ម downstream ដែលមិនមានប្រសិទ្ធិភាពអាចកាត់បន្ថយនិងធ្វើឱ្យប្រព័ន្ធទាំងអស់បានកាត់បន្ថយ។ គំរូ : Circuit Breaker ការទទួលស្គាល់ពីការបាត់បន្ថយការផ្លាស់ប្តូរ, សូមចង់ផ្ញើអ៊ីនធឺណិតអ៊ីនធឺណិតអ៊ីនធឺណិតអ៊ីនធឺណិតអ៊ីនធឺណិតអ៊ីនធឺណិតអ៊ីនធឺណិត។ វាត្រូវបានធ្វើឱ្យប្រសើរឡើងនូវការឆ្លើយតប fallback, ការធ្វើតេស្តប្រសិទ្ធិភាពនិងធ្វើតេស្តការធ្វើតេស្តប្រសើរឡើងប្រសើរឡើងប្រសើរឡើងប្រសើរឡើងប្រសើរឡើងប្រសើរឡើងប្រសើរឡើង នេះបានកាត់បន្ថយអំឡុងពេលវេលាការពារបំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់បំពង់ Demo Summary (What You Have) Demo Summary (អ្វីដែលអ្នកមាន) ការផ្តល់សេវាកម្ម 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 ប្រព័ន្ធ ប្រតិបត្តិការ iOS ( ) hello-service and client-service ការធ្វើតេស្ត GET http://localhost:8080/api/get-message សៀវភៅអាសយដ្ឋាន នេះគឺជាដំណោះស្រាយតូចដែលមានតម្រូវការសម្រាប់ការរចនាដំណោះស្រាយ Files & Code: Class-By-Class Explanation Files & Code: Class-by-Class ការបង្ហាញ hello-service សៀវភៅសៀវភៅសៀវភៅ 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, ទិន្នន័យលក្ខខណ្ឌ, timeouts) ។ Explanation: client-service អ្នកជំនាញវិជ្ជាជីវៈ - Java ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot ប្រព័ន្ធ ប្រតិបត្តិការ Spring Boot AppConfig.java @Configuration public class AppConfig { @Bean public RestTemplate restTemplate() { return new RestTemplate(); } } ការផ្តល់នូវប័ណ្ណ RestTemplate មួយតែមួយ។ ការធានាថា RestTemplate គឺជាប័ណ្ណ Spring ដូច្នេះការផ្លាស់ប្តូរ AOP / resilience អាចធ្វើការយ៉ាងត្រឹមត្រូវ។ 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(); } } អ្នកគ្រប់គ្រងដែលបានផ្លាស់ប្តូរទៅ នេះធ្វើឱ្យប្រសិនបើការហៅហៅបានតាមរយៈ proxy ដែលមានការផ្លាស់ប្តូរកុំព្យូទ័រ។ Explanation: HelloClientService Configuration Used (client-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 SlidingWindowSize: អតិបរមា នៃ ការ ទាញ យក ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក នៃ ការ ទាញ យក ។ minimumNumberOfCalls: ទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទទូរស័ព្ទ លក្ខណៈពិសេសនៃការបញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់បញ្ឈប់ វគ្គបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តុះបណ្តាល កុំព្យូទ័រ HealthIndicator: ការបង្វិលកុំព្យូទ័រតាមរយៈប្រព័ន្ធប្រតិបត្តិការ។ Step-by-Step Run និងផលិតផលដែលគួរឱ្យចាប់អារម្មណ៍ ការចាប់ផ្តើមសេវាកម្ម សូមចាប់ផ្តើមសេវាកម្ម Visit: http://localhost:8081/api/hello → "Hello from Hello-Service!" (ឬដោះស្រាយបញ្ហានៃការជឿទុកចិត្ត) Returns ការចាប់ផ្តើមសេវាកម្មអតិថិជន Visit: http://localhost:8080/api/get-message Test Scenarios & Outputs ការធ្វើតេស្តរូបភាព & 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 / exception: 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 ល): លក្ខណៈពិសេស ប្រព័ន្ធ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រតិបត្តិការ ប្រសិនបើការធ្វើតេស្តបានជោគជ័យ, ការបាត់បន្ថយបាត់បន្ថយនិងការធ្វើតេស្តធម្មតានៃការធ្វើតេស្តបានចាប់ផ្តើម។ ប្រសិនបើការធ្វើតេស្តមិនជោគជ័យ, ការបង្វិលមកវិញទៅ Open ។ Real-World Use Cases ការប្រើប្រាស់ពិភពលោកពិតប្រាកដ ការរួមបញ្ចូលការទូទាត់ - សេវាកម្មការបញ្ចូលការទូទាត់ដែលទូរស័ព្ទ API របស់ក្រុមហ៊ុនទូទាត់ខាងក្រៅ: ប្រសិនបើ API របស់ក្រុមហ៊ុនទូទាត់កាត់បន្ថយ / កាត់បន្ថយ, កាត់បន្ថយបន្ថយផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ្នែកផ API ដែលមានតម្រូវការកាត់បន្ថយដោយអ្នកផ្គត់ផ្គង់បី - API ដែលមានការហៅទូរស័ព្ទដែលមានតម្រូវការកាត់បន្ថយក្នុងរយៈពេល ២ វិនាទី - នៅពេលដែលការកាត់បន្ថយបានបញ្ចប់កម្រិតនេះ, កម្រិតនេះបើកចំហដើម្បីគ្មានការកាត់បន្ថយការកាត់បន្ថយបន្ថយបន្ថយបន្ថយបន្ថយការកាត់បន្ថយ។ កញ្ចប់សេវាកម្ម microservice នៅក្នុងសហគ្រាស - សេវាកម្ម A បានទូរស័ព្ទ B, ដែលបានទូរស័ព្ទ C. ប្រសិនបើ C គឺមិនមានស្ថេរភាព, ការបិទបើកការពារ B និង A, ការពារការរំខានប្រព័ន្ធទាំងអស់។ ការផ្លាស់ប្តូរលក្ខណៈពិសេសនិងការកាត់បន្ថយដ៏គួរឱ្យចាប់អារម្មណ៍ - នៅពេលដែលសេវាកម្មលក្ខណៈពិសេសដែលមិនគួរឱ្យចាប់អារម្មណ៍មិនត្រឹមត្រូវធ្វើឱ្យប្រសិនបើមានការផ្លាស់ប្តូរលក្ខណៈពិសេសសំខាន់ជាងមុន (ដូចជាការផ្លាស់ប្តូរសៀវភៅផលិតផលដោយគ្មានការផ្លាស់ប្តូរ). Advantages & Business Value អត្ថប្រយោជន៍និងតម្លៃអាជីវកម្ម ការកាត់បន្ថយគោលបំណង - ការពារការកាត់បន្ថយគោលបំណងនៃការកាត់បន្ថយគោលបំណង។ ការឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតបឆ្លើយតប ការកាត់បន្ថយដ៏អស្ចារ្យ - ផ្តល់ជូននូវការឆ្លើយតបឆ្លើយតបជាងការកាត់បន្ថយពេញលេញ។ ការពារសម្ភារៈ - ការពារការបាត់បង់ CPU, threads និងបណ្តាញ។ ការកើនឡើងដោយស្វ័យប្រវត្តិ - ដោយស្វ័យប្រវត្តិធ្វើឱ្យប្រសើរឡើងទៅជាធម្មតានៅពេលដែលការប្រើប្រាស់គឺមានប្រសិទ្ធិភាព។ ការពិនិត្យឡើងវិញ - សមត្ថភាពនៃការបាត់បន្ថយនិងម៉ែត្រអាចត្រូវបានបង្ហាញតាមរយៈ Actuator និងត្រួតពិនិត្យឡើងវិញ។ 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"}"