OpenFeign: MSA 서비스 간 통신

📌MSA에서의 HTTP 클라이언트 사용

MSA 환경에서는 각 서비스가 독립적으로 동작하며, 서로의 API를 호출해야 한다. 이때 다양한 HTTP 클라이언트를 사용할 수 있으며, 성능과 유지보수를 고려해 적절한 방식을 선택해야 한다.

 

✅ HTTP 클라이언트는 MSA에서만 사용할까?

➡️ 아니다! 일반적인 모놀리식 아키텍처에서도 다른 외부 API 호출을 위해 HTTP 클라이언트를 사용한다.
➡️ 하지만 MSA에서는 서비스 간 통신이 필수적이므로, OpenFeign 같은 라이브러리가 특히 많이 사용된다.

 

✅ 일반적인 API 호출과의 차이점은?

➡️ 보통 API 호출은 단순한 HTTP 요청이지만, MSA에서는 더 세밀한 HTTP 클라이언트 설정이 필요하다.

• 서비스 디스커버리(Eureka) 를 이용한 동적 URL 매핑
• 로드 밸런싱 (Ribbon, Spring Cloud LoadBalancer)
• 보안 및 인증 처리 (JWT, OAuth 등)
  
  

🔥 HTTP 클라이언트 비교

방식	동기/비동기	주요 특징	장점	단점
RestTemplate (Deprecated)	동기	Spring 기본 HTTP 클라이언트 (Spring 5 이후 비추천)	사용법이 간단	Blocking 방식, 유지보수 어려움
WebClient	비동기	Spring WebFlux 기반, Reactive 지원	성능 우수, 확장성 좋음	코드 복잡
OkHttp / Apache HttpClient	동기/비동기 가능	저수준 HTTP 라이브러리	세밀한 제어 가능	직접 구현 필요
OpenFeign	동기 (기본)	선언형 API 클라이언트, Spring Cloud 공식 지원	코드가 간결, 유지보수 쉬움	기본적으로 동기 처리 (비동기는 설정 필요)

📌 예제 코드

✅ 1. RestTemplate (Deprecated)

주문 서비스 → 상품 서비스 API 호출 예제

import org.springframework.stereotype.Service; import org.springframework.web.client.RestTemplate; @Service public class ProductServiceClient {     private final RestTemplate restTemplate = new RestTemplate();     public ProductDetailDTO getProductDetail(int productId) {         String url = "http://product-service/api/query/products/" + productId;         return restTemplate.getForObject(url, ProductDetailDTO.class);     } }

✔️ 장점: 간단하게 HTTP 요청 가능
❌ 단점: 동기 방식(Blocking)이라 성능이 떨어지고, Spring 5부터 비추천됨

 

✅ 2. WebClient 사용 (비동기 방식, 추천!)

Spring WebFlux의 WebClient를 사용하면 비동기 처리 가능!

import org.springframework.stereotype.Service; import org.springframework.web.reactive.function.client.WebClient; import reactor.core.publisher.Mono; @Service public class ProductServiceClient {     private final WebClient webClient;     public ProductServiceClient(WebClient.Builder webClientBuilder) {         this.webClient = webClientBuilder.baseUrl("http://product-service").build();     }     public ProductDetailDTO getProductDetail(int productId) {         return webClient.get()                 .uri("/api/query/products/{id}", productId)                 .retrieve()                 .bodyToMono(ProductDetailDTO.class)                 .block(); // 동기 처리 (비동기로 하려면 .subscribe())     } }

✔️ 장점: 비동기(Non-blocking) 방식, 성능 우수, WebFlux와 함께 사용하면 높은 확장성 제공

❌ 단점: 코드가 다소 복잡

 

✅ 3. OkHttp 또는 Apache HttpClient 직접 사용

Low-Level HTTP Client를 직접 구현하는 방식
보통 OkHttp나 Apache HttpClient 같은 서드파티 라이브러리를 직접 써야 함.
이 방식은 거의 안 씀!

import okhttp3.OkHttpClient; import okhttp3.Request; import okhttp3.Response; import com.fasterxml.jackson.databind.ObjectMapper; @Service public class ProductServiceClient {     private final OkHttpClient client = new OkHttpClient();     private final ObjectMapper objectMapper = new ObjectMapper();     public ProductDetailDTO getProductDetail(int productId) throws Exception {         Request request = new Request.Builder()                 .url("http://product-service/api/query/products/" + productId)                 .get()                 .build();         try (Response response = client.newCall(request).execute()) {             return objectMapper.readValue(response.body().string(), ProductDetailDTO.class);         }     } }

✔️ 장점: 세밀한 HTTP 요청 제어 가능
❌ 단점: 직접 구현해야 할 것이 많음 (직접 요청 생성, 응답 처리)

 

✅ 4. OpenFeign (추천!)

@FeignClient(name = "서비스명")만 하면 Eureka로 서비스 간 호출 가능!

@FeignClient(name = "product-service", url = "http://product-service") public interface ProductClient {     @GetMapping("/api/query/products/{id}")     ProductDetailDTO getProductDetail(@PathVariable("id") int id); }

✔️ 장점: 선언형 인터페이스만으로 API 호출 가능, 유지보수 편리, Spring Cloud에서 공식 지원

❌ 단점: 기본적으로 동기 방식 (비동기 처리는 추가 설정 필요)

🚀결론: 어떤 방식을 선택할까?

➡️ 단순한 API 호출: RestTemplate (하지만 비추천)
➡️ 비동기 + 성능 중요: WebClient
➡️ 세밀한 HTTP 제어 필요: OkHttp / Apache HttpClient
➡️ MSA 환경에서 가장 효율적: OpenFeign ( Spring Cloud 공식 지원!)

 

OpenFeign을 쓰면 서비스 디스커버리(Eureka)와 연계하여 동적 API 호출이 가능하므로,

MSA 환경에서 가장 효율적이다! 😄