9.7 KiB
9.7 KiB
title, source_type, status, confidence, url, archive_url, related_branches, related_projects, tags, created, last_reviewed
| title | source_type | status | confidence | url | archive_url | related_branches | related_projects | tags | created | last_reviewed | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| OpenFeign / Spring Cloud OpenFeign — declarative HTTP client (대안 비교) | official-doc | raw | high | https://spring.io/projects/spring-cloud-openfeign |
|
|
|
2026-05-22 | 2026-05-27 |
OpenFeign / Spring Cloud OpenFeign — declarative HTTP client
Layer:
raw/official-docs/— Spring Cloud OpenFeign project page + Spring Cloud OpenFeign reference + OpenFeign GitHub README 의 declarative client 정의/특성 발췌. ca-tmpl outbound Group G-C 의 대안 4 (OpenFeign 배제 근거).
Parent / 활용 branch (필수)
| Branch | 이 자료가 정당화하는 결정 |
|---|---|
| raw/branch-notes/feature-outbound-http-client-baseline | outbound HTTP baseline 선정 시 OpenFeign (declarative) vs RestClient (explicit) 비교에서 OpenFeign 배제 근거 |
| raw/branch-notes/feature-integration-adapter-templates | adapter template 표준화에서 declarative interface 패턴이 baseline 적합하지 않은 사유 (mapping/timeout/error 변환 책임 모호) |
컨텍스트
ca-tmpl outbound 대안 OpenFeign 의 위치 정리. declarative client 가 baseline 에 적합하지 않은 이유.
출처 / Source
- Spring Cloud OpenFeign 프로젝트 페이지: https://spring.io/projects/spring-cloud-openfeign
- Spring Cloud OpenFeign reference: https://docs.spring.io/spring-cloud-openfeign/docs/current/reference/html/
- OpenFeign GitHub: https://github.com/OpenFeign/feign
- 아카이브 URL: (미수집)
- 저자 / 조직: Spring Cloud (Pivotal/VMware/Broadcom) + OpenFeign community
- 발행일: rolling docs (Spring Cloud OpenFeign reference current)
- 마지막 확인일: 2026-05-27
핵심 인용 / Key quotes (verbatim)
[§Spring Cloud OpenFeign project page] "Declarative REST Client: Feign creates a dynamic implementation of an interface decorated with JAX-RS or Spring MVC annotations"
[§Spring Cloud OpenFeign reference — Declarative REST Client: Feign] "Feign is a declarative web service client. It makes writing web service clients easier. To use Feign create an interface and annotate it."
[§Spring Cloud OpenFeign reference — Declarative REST Client: Feign] "It has pluggable annotation support including Feign annotations and JAX-RS annotations. Feign also supports pluggable encoders and decoders."
[§Spring Cloud OpenFeign reference — Declarative REST Client: Feign] "Spring Cloud adds support for Spring MVC annotations and for using the same
HttpMessageConvertersused by default in Spring Web."
[§OpenFeign GitHub README] "Feign is a Java to HTTP client binder inspired by Retrofit, JAXRS-2.0, and WebSocket."
[§OpenFeign GitHub README] "Feign simplifies the process of writing Java HTTP clients"
[§OpenFeign GitHub README] "Feign has several aspects that can be customized."
Claims Extracted / 추출된 주장
| Claim ID | Claim (이 자료가 직접 말하는 것) | Evidence quote | Strength | Applies to | Does not prove |
|---|---|---|---|---|---|
| OPENFEIGN-C1 | Spring Cloud OpenFeign 은 interface 에 annotation 을 붙여 dynamic 구현을 생성하는 declarative REST client | [§project page] "Declarative REST Client: Feign creates a dynamic implementation of an interface decorated with JAX-RS or Spring MVC annotations" | official-vendor-doc |
Spring Cloud OpenFeign 도입 후 interface 기반 client | 동적 endpoint (런타임 URL 결정) 가 자연스럽다는 뜻 아님 — interface contract 가 컴파일 타임에 고정 |
| OPENFEIGN-C2 | Feign 의 사용 패턴: interface 생성 후 annotation. Annotation 어휘는 JAX-RS / Feign / Spring MVC 가 pluggable | [§reference — Declarative REST Client: Feign] "Feign is a declarative web service client. ... To use Feign create an interface and annotate it." + "It has pluggable annotation support including Feign annotations and JAX-RS annotations." | official-vendor-doc |
Feign + Spring Cloud OpenFeign 모듈 동시 사용 | RestClient 의 RequestInterceptor / ResponseErrorHandler 와 동일한 hook chain 을 보장한다는 뜻은 아님 |
| OPENFEIGN-C3 | Spring Cloud OpenFeign 은 Spring MVC annotation 및 Spring Web default HttpMessageConverters 통합을 추가 제공 |
[§reference] "Spring Cloud adds support for Spring MVC annotations and for using the same HttpMessageConverters used by default in Spring Web." |
official-vendor-doc |
Spring Cloud OpenFeign starter 사용 시 | Spring MVC annotation 시맨틱이 server-side 와 100% 동일하다는 뜻은 아님 — 일부 mapping 동작은 client-side 한정 |
| OPENFEIGN-C4 | Feign 은 Retrofit / JAX-RS 2.0 / WebSocket 에 영감을 받은 Java-to-HTTP client binder 이며, 여러 측면 (decoder/encoder/interceptor/contract) 이 customizable | [§GitHub README] "Feign is a Java to HTTP client binder inspired by Retrofit, JAXRS-2.0, and WebSocket." + "Feign has several aspects that can be customized." | official-vendor-doc |
OpenFeign core library | customization 의 정확한 hook 이름이 RestClient/WebClient 와 일대일 대응한다는 뜻 아님 |
| OPENFEIGN-C5 | Spring Cloud OpenFeign 이 "maintenance-only / feature complete" 상태라는 명시는 본 WebFetch 시점 (2026-05-27) 의 spring.io 프로젝트 페이지 및 current reference HTML 에서 확인 불가 — 본 메모/이전 인용은 별도 출처 확인 필요 | (negative finding — WebFetch 2회 모두 "No such notice appears") | needs-confirmation |
Spring Cloud OpenFeign 향후 로드맵 판단 시 | 이 부정 확인은 maintenance-only 가 거짓 이라는 뜻이 아니라, 본 페이지에서는 미확인 이라는 뜻 |
Usage Boundaries / 적용 경계
- 이 자료가 직접 증명하는 것:
OPENFEIGN-C1~C4: declarative 패턴, interface + annotation, JAX-RS / Spring MVC annotation pluggable,HttpMessageConverters통합, customizable hooks 의 존재
- 이 자료가 증명하지 않는 것:
- Spring Cloud OpenFeign 의 "maintenance-only / feature complete" 상태 — 본 페이지 인용으로 보장 안 됨 (
OPENFEIGN-C5). 별도 출처 확인 필요 (Spring blog announcement, GitHub repo status, 또는 spring-projects/spring-cloud-openfeign README) - Resilience4j
FeignDecorator의 존재 — 본 페이지에 없음 (Resilience4j 공식 문서에서 확인 필요) - Spring 6.1+
@HttpExchange+HttpServiceProxyFactory.builderFor(restClient)가 declarative + explicit 책임을 동시에 제공한다는 비교 — 본 페이지 미언급 (별도 Spring Framework reference 페이지 확인 필요) - reflection 비용 / startup time / GraalVM native image 호환성 — 본 페이지 미언급
- Spring Cloud OpenFeign 의 "maintenance-only / feature complete" 상태 — 본 페이지 인용으로 보장 안 됨 (
- 내 프로젝트에 적용하려면 추가 확인이 필요한 것:
- ca-tmpl 에서 OpenFeign 배제 결정의 1차 근거가 "maintenance-only" 라면 → 별도 출처로 보강 필수 (현재는 needs-confirmation)
- "OpenFeign interface 가 SDK 형태와 모호한 경계" 라는 ca-tmpl 결정 사항은 해석. Feign customization hook 의 명세에서 직접 도출되지 않음
- 동적 endpoint (런타임 URL 결정) 의 "어색함" 은 인용에서 직접 증명되지 않음 — RequestLine 또는
URIparameter 사용 가능 여부 별도 검증
메모 / Notes (내 프로젝트 해석)
본 섹션은 자료 직접 인용 아님. ca-tmpl 결정 컨텍스트 해석.
- 장점:
- interface annotation 기반 — controller 코드 ↔ client 코드 대칭. 사용처 발견성 좋음.
- encoder/decoder/interceptor 가 명시적 hook 으로 분리 (
OPENFEIGN-C4의 customizable 항목). - Resilience4j 통합 첫 시민 (별도 출처 검증 필요). CircuitBreaker/Retry decorator 를 interface 단위로 attach.
- 단점 (ca-tmpl 입장):
- Spring Cloud OpenFeign 이 maintenance-only 라는 일반적인 관측 — 본 WebFetch 로는 미확인 (
OPENFEIGN-C5). 별도 출처 보강 필요. - 동적 endpoint (런타임에 URL 결정) 처리 어색 (해석, 미검증).
- reflection 비용 — startup time 에 영향 (해석, 미검증). Native image / GraalVM 호환성 추가 작업 필요.
- 인터페이스 contract 가 사실상 SDK 형태가 됨 — provider SDK bypassing 금지 (ca-tmpl 결정) 와 모호한 경계 (해석).
- Spring Cloud OpenFeign 이 maintenance-only 라는 일반적인 관측 — 본 WebFetch 로는 미확인 (
- ca-tmpl 결정 정당성 (재구성):
- declarative client 는 편하지만 baseline 은 explicit RestClient 가 매핑/타임아웃/에러 변환 책임을 명확히 함.
- Spring 6.1+ 의
@HttpExchange+HttpServiceProxyFactory.builderFor(restClient)조합이면 RestClient 기반으로 declarative + explicit 책임을 동시에 얻을 수 있음 → OpenFeign 도입 정당성이 더 약해짐 (이 비교는 별도 Spring Framework reference 페이지에서 검증 필요).
- 시사점: ca-tmpl 가 OpenFeign 을 채택하지 않은 것은 maintenance status 가정 +
@HttpExchange대체 가능성 가정 때문. 두 가정 모두 본 raw 만으로는 증명되지 않으며 별도 보강 필요.
Related / 관련
- 같은 주제 다른 official-doc:
- raw/official-docs/outbound-spring-restclient-baseline — RestClient baseline 결정 근거
- raw/official-docs/outbound-webclient-vs-restclient-spring — sync vs reactive baseline 비교
- raw/official-docs/outbound-resilience4j-vs-spring-retry — retry/circuit breaker library 비교
- 같은 주제 company-tech-blog:
- raw/company-tech-blogs/outbound-stripe-rate-limit-retry-engineering — Stripe retry/idempotency 사례
- 인용하는 branch:
- 인용하는 wiki: (미작성)