RestClient.Builder

RestClient.Builder는 RestClient를 생성하기 위한 빌더 패턴 클래스죠.

그래서 RestClient를 사용하기 위해서는 RestClient.Builder 를 사용해야 합니다. RestClient를 생성하는 유일한 방법이죠.

또한 RestClient.Builder 는 아래와 같은 장점이 있습니다.

1. 메서드 체이닝으로 설정을 명확하게 표현

   • 다양한 설정 옵션 제공 (URL, 헤더, 타임아웃, 인터셉터 등)
     1. baseUrl - 기본 URL 설정
     2. defaultHeader - 기본 헤더 설정
     3. defaultHeaders - 여러 헤더 한번에
     4. requestFactory - HTTP 클라이언트 설정
     5. requestInterceptor - 요청/응답 가로채기
     6. defaultStatusHandler - 에러 처리
     7. messageConverters - 메시지 변환기 설정

2. 불변 객체 생성으로 스레드 안전성 보장

   • Builder는 불변 객체를 생성합니다. 설정 후 변경 불가능합니다.

3. Spring Boot에서 자동으로 빈 등록 됨

   • Spring Boot 3.2+에서는 RestClient.Builder가 자동으로 빈으로 등록됩니다.

   • 참고로 application.yml에서 설정이 가능합니다.

     spring:
       http:
         client:
           connect-timeout: 5s
           read-timeout: 10s
     

4. 재사용 가능하여 여러 RestClient 생성 가능

1. Builder를 주입받아 생성

@Component
public class MyClient {
    
    private final RestClient restClient;
    
    public MyClient(RestClient.Builder builder) {
        this.restClient = builder
            .build();
    }
}

특징:

• 매번 새로운 인스턴스: Builder는 프로토타입 스코프로, 호출할 때마다 새로운 RestClient 생성
• 컴포넌트마다 독립적: 각 클래스가 자신만의 RestClient 설정을 가짐
• 분산된 설정: 각 컴포넌트에서 필요에 맞게 설정 가능

2. @Bean으로 RestClient 등록