Loading...
Spring Framework Reference Documentation 7.0.2의 API Versioning의 한국어 번역본입니다.
아래의 경우에 피드백에서 신고해주신다면 반영하겠습니다.
감사합니다 :)
See equivalent in the Reactive stack
Spring MVC는 API 버전 관리를 지원합니다. 이 섹션은 지원 내용과 그 기반이 되는 전략을 개괄합니다.
또한 다음 관련 내용을 참고하십시오:
API 버전 관리에 대한 클라이언트 지원은 RestClient, WebClient, 그리고
HTTP Service 클라이언트에서 사용할 수 있으며,
테스트를 위해서는 MockMvc와 WebTestClient에서도 사용할 수 있습니다.
See equivalent in the Reactive stack
이것은 버전 관리와 관련된, 구성된 모든 선호도를 보유하는 API 버전 관리를 위한 중앙 전략입니다. 다음과 같은 일을 수행합니다:
Comparable<?>로 파싱ApiVersionStrategy는 요청을 @RequestMapping 컨트롤러 메서드에 매핑하는 데 도움을 주며,
MVC 설정에 의해 초기화됩니다. 일반적으로 애플리케이션은 이것과 직접 상호 작용하지 않습니다.
See equivalent in the Reactive stack
이 전략은 요청에서 API 버전을 해석합니다. MVC 설정은 헤더, 쿼리 매개변수,
미디어 타입 매개변수 또는 URL 경로에서 해석하기 위한 내장 옵션을 제공합니다.
또한 커스텀 ApiVersionResolver를 사용할 수도 있습니다.
| 주의 |
|---|
경로 리졸버는 항상 지정된 경로 세그먼트에서 버전을 해석하거나,<br>그렇지 않으면 InvalidApiVersionException을 발생시키므로, 다른 리졸버에<br>양보할 수 없습니다. |
See equivalent in the Reactive stack
이 전략은 원시 버전 값을 Comparable<?>로 파싱하는 데 도움을 주며, 이를 통해
버전을 비교, 정렬 및 선택할 수 있습니다. 기본적으로 내장 SemanticApiVersionParser는
버전을 major, minor, 그리고 patch 정수 값으로 파싱합니다. minor와 patch 값은
존재하지 않을 경우 0으로 설정됩니다.
See equivalent in the Reactive stack
요청 버전이 지원되지 않는 경우, InvalidApiVersionException이 발생하여
400 응답이 반환됩니다. 기본적으로 지원되는 버전 목록은 어노테이션 기반 컨트롤러 매핑에
선언된 버전에서 초기화되지만, MVC 설정의 플래그를 통해 이를 끄고,
설정에 명시적으로 구성된 버전만 사용할 수 있습니다.
기본적으로, API 버전 관리가 활성화되면 버전이 필수이며,
존재하지 않을 경우 MissingApiVersionException이 발생하여 400 응답이 반환됩니다.
이를 선택 사항으로 만들 수 있으며, 이 경우 가장 최근 버전이 사용됩니다.
또한 사용할 기본 버전을 지정할 수도 있습니다.
See equivalent in the Reactive stack
이 전략은 사용 중단된 버전에 대한 힌트와 정보를 응답 헤더를 통해
클라이언트에게 전송하도록 구성할 수 있습니다. 내장 StandardApiVersionDeprecationHandler는
"Deprecation" "Sunset" 헤더와 RFC 9745 및
RFC 8594에 정의된 "Link" 헤더를 설정할 수 있습니다.
다른 헤더를 위한 커스텀 핸들러를 구성할 수도 있습니다.
See equivalent in the Reactive stack
ApiVersionStrategy는 요청을 어노테이션 기반 컨트롤러 메서드에 매핑하는 것을 지원합니다.
자세한 내용은 API Version을 참조하십시오.
CORS
Error Responses