Spring cloud open feign 적용하기

[JunsuLime]

https://github.com/OpenFeign/feign spring integration

Declarative REST Client: Feign creates a dynamic implementation of an interface decorated with JAX-RS or Spring MVC annotations

[JunsuLime]

Spring Cloud integrates Eureka, Spring Cloud CircuitBreaker, as well as Spring Cloud LoadBalancer to provide a load-balanced http client when using Feign.

• Eureka
• CircuitBreaker
• LoadBalancer

Spring openfeign 은 spring load balancer 의 blocking mode client 를 사용한다.

Spring Cloud OpenFeign supports all the features available for the blocking mode of Spring Cloud LoadBalancer. You can read more about them in the project documentation.

http 요청 클라이언트는 아래의 친구들로 커스터마이즈 가능하다.

The OkHttpClient and ApacheHttpClient and ApacheHC5 feign clients can be used by setting feign.okhttp.enabled or feign.httpclient.enabled or feign.httpclient.hc5.enabled to true, respectively, and having them on the classpath.

[JunsuLime]

Feign 은

• decoder
• encoder
• contract 를 설정할 수 있다.

그리고 아래의 프로퍼티도 추가설정 가능

• Logger.Level
• Retryer
• ErrorDecoder
• Request.Options
• Collection
• SetterFactory
• QueryMapEncoder
• Capability (MicrometerCapability is provided by default)

[JunsuLime]

Spring cloud open-feign 을 팔아보자!

1. 선언적 프로그래밍
2. 추후 webclient 지원
3. timeout(conn, read), retry 등 기본 설정 가능

[JunsuLime]

아하 Spring open feign 의 contract 개념에 대해 한번 더 짚고 넘어가자. https://techblog.woowahan.com/2630/ https://techblog.woowahan.com/2657/ https://docs.spring.io/spring-cloud-openfeign/docs/current/reference/html

역시 한국인은 한글로 한번 훑고 영어를 보는게 ㅇㅁㅇ 영어 어렵다.

Decoder - ResponseEntityDecoder Encoder - SpringEncoder Contract - SpringMvcContract

Feign ErrorDecoder 까지 마저 보고 오늘 마무리하자. sleuth 는 어떻게 적용되는지 마저 보자.

[JunsuLime]

Default 는 FeignClientsConfiguration 를 통해서 적용됨

ErrorDecoder

아무것도 적용하지않았을 경우 ErrorDecoder.Default 가 사용됨 Default 적용 시 "Retry-After" 가 header 에 있을 경우 RetryableException 이 발생합니다.

Retryer

Default 로 Retryer.NEVER_RETRY 를 사용한다. 기본 retry 는 Retryer.Default 로 충분할 것으로 보임

Retryer 는 RetryableException 발생 시 동작함 Feign에서의 Exception 은 FeignException 을 상속받고있다.

[JunsuLime]

의문점

• FeignConfiguration 에 ObjectMapper 가 bean 으로 등록되어있는 이유
  • HttpMessageConverter 만들 때 ObjectMapper 를 사용하고 있음
  • 모든 곳에 영향을 주는 ObjectMapper 가 등록됨, 기본 ObjectMapper 는 덮어쓰기 됨
  • HttpMessageConverter 를 Bean 으로 등록하는게 영향도는 적지만 (기존 HttpMessageConverter 를 오염시키지않음), 이는 별도 QA가 필요 -- 이번작업범위에는 제외하자.
• CustomErrorDecoder 의 역할
• GlobalExceptionHandler 는 왜 Feign exception 을 bypass 하고 있을까
• FeignClientException 를 제거하자.
• 의존성을 어디까지 가져올 것인가???
  • Feign 까지이면 그냥 쓰면됨
  • Http 의존성 제거가 목적이면 별도 interface 필요

=====================================================

• CustomErrorDecoder 제거하기
• GlobalExceptionHandler 의 ByPass 확인
  • 필요없다면, Handling 하지않고 자연스레 500 내려가게 패치
• Retryer 설정하기 (Retryer.Default 면 충분)
• FeignClientException 제거하기
  • FeignException 및 이를 상속받은 Exception 활용가능
• FeignClient primary 설정 제거하기

[JunsuLime]

Feign 간단 소개, 에러 처리와 재시도

Feign 소개

• 선언적형식의 REST Client
• Spring cloud project 밑에 있는 친구
• 간단한 사용 방법
  • @EnableFeignClients
  • @FeignClient(“stores”)

Feign 의 여러가지 설정들

• Decoder
• Encoder
• Contract
• etc …

FeignClientsConfiguration 에 spring.cloud.openFeign 의 Default 설정들이 있으며, 아무것도 건들지 않을 경우 해당 설정을 사용한다. FeignClientsConfiguration, Feign.Builder 를 통해 Default 값 파악 가능

에러 처리 및 재시도

• ErrorDecoder
• Retryer
• FeignException

SynchronousMethodHandler 를 사용해서 동작한다. Feign은 FeignException 을 최상위에 구현했으며 이를 상속 받아 여러 Exception 을 만든다.

마무리

• (여기서는 에러 핸들링만 언급했지만) 현재 사용하고 있는 Feign 관련 코드를 문서 및 코드를 확인하며 적절하게 동작하도록 하자.
• Feign 을 보니 문서, 코드, 디버깅을 통해서 어느정도 그림이 그려졌다. 라이브러리, 프레임워크 등을 파악할 때 요런식으로 접근해보는게 도움이 되어서 공유하고 싶었다!

[JunsuLime]

기회가 된다면 다음에

• Client customize
• Hystrix 도입

을 챙겨보자. (이번에는 여기까지로 마무리)