feat(resilience): add Resilience4j circuit breaker and retry for S3

integration

- Add resilience4j-spring-boot3 and spring-boot-starter-aop dependencies
- Configure CircuitBreaker and Retry instances for S3 in application.yml
- Annotate S3Service#uploadFile with @CIRCUITBREAKER and @Retry
- Add uploadFallback method with matching signature (MultipartFile,
String, String, Exception)

Author: erichiroshi

build.gradle

@@ -64,6 +64,8 @@ ext {
    	shedlockVersion = "6.9.1"
    	otelVersion = "1.7.0-M3"
    	openTelemetryVersion = "2.25.0"
+   	aopVersion = "4.0.0-M2"
+   	resilience4jVersion = "2.3.0"
 }
 
 dependencies {
@@ -135,6 +137,10 @@ dependencies {
 
     // Source: https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-zipkin
 	implementation 'org.springframework.boot:spring-boot-starter-zipkin'
+	
+	// Source: https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-aop
+    implementation "org.springframework.boot:spring-boot-starter-aop:${aopVersion}"
+	implementation "io.github.resilience4j:resilience4j-spring-boot3:${resilience4jVersion}"
 }
 
 // ─────────────────────────────────────────────

src/main/java/com/example/library/aws/S3Service.java

@@ -12,6 +12,9 @@
 import org.springframework.stereotype.Service;
 import org.springframework.web.multipart.MultipartFile;
 
+import io.github.resilience4j.circuitbreaker.annotation.CircuitBreaker;
+import io.github.resilience4j.retry.annotation.Retry;
+
 import software.amazon.awssdk.awscore.exception.AwsServiceException;
 import software.amazon.awssdk.core.exception.SdkClientException;
 import software.amazon.awssdk.core.sync.RequestBody;
@@ -51,6 +54,8 @@ public class S3Service {
 	@Value("${s3.bucket}")
 	private String bucketName;
 
+	@CircuitBreaker(name = "s3", fallbackMethod = "uploadFallback")
+	@Retry(name = "s3")
 	public URI uploadFile(MultipartFile file, String folder, String fileName) {
 
 		validateFileSize(file);
@@ -94,7 +99,12 @@ public URI uploadFile(MultipartFile file, String folder, String fileName) {
 		} catch (Exception _) {
 			throw new URIException();
 		}
+	}
 
+	@SuppressWarnings("unused")
+	private URI uploadFallback(MultipartFile file, String folder, String fileName, Exception ex) {
+	    log.error("S3 circuit breaker open or retry exhausted | reason={}", ex.getMessage());
+	    throw new AmazonClientException();
 	}
 
 	private void validateContentType(MultipartFile file) {

src/main/resources/application.yml

@@ -32,3 +32,17 @@ aws:
 s3:
   bucket: ${BUCKET_NAME:library-api-s3}
   region: ${BUCKET_REGION:sa-east-1}
+
+resilience4j:
+  circuitbreaker:
+    instances:
+      s3:
+        sliding-window-size: 5
+        failure-rate-threshold: 50
+        wait-duration-in-open-state: 10s
+
+  retry:
+    instances:
+      s3:
+        max-attempts: 3
+        wait-duration: 500ms