47장. 리소스 클래스 및 메서드에 정보 전달
초록
Cryostat-RS는 개발자가 리소스에 전달되는 정보가 들어오는 위치를 제어할 수 있는 여러 주석을 지정합니다. 주석은 URI의 매트릭스 매개변수와 같은 일반적인 HTTP 개념을 준수합니다. 표준 API를 사용하면 주석을 메서드 매개변수, 빈 속성 및 리소스 클래스 필드에서 사용할 수 있습니다. Apache CXF는 여러 매개 변수를 빈에 삽입할 수 있는 확장을 제공합니다.
47.1. 데이터 삽입의 기본 사항
47.1.1. 개요
HTTP 요청 메시지의 데이터를 사용하여 초기화되는 parameters, 필드,ans 속성의 값은 런타임에서 해당 값에 삽입됩니다. 삽입된 특정 데이터는 47.2절. “Cryostat-RS API 사용” 에 설명된 주석 세트에 의해 지정됩니다.
Cryostat-RS 사양은 데이터가 삽입될 때 몇 가지 제한 사항을 배치합니다. 또한 요청 데이터를 삽입할 수 있는 오브젝트 유형에 대한 몇 가지 제한 사항을 배치합니다.
47.1.2. 데이터가 삽입되는 경우
요청 데이터는 요청으로 인해 인스턴스화될 때 오브젝트에 삽입됩니다. 즉, 리소스에 직접 해당하는 오브젝트만 인젝션 주석을 사용할 수 있습니다. 46장. 리소스 생성 에서 설명한 대로 이러한 오브젝트는 @Path 주석으로 데코레이팅된 루트 리소스 또는 하위 리소스 Cryostat 메서드에서 반환된 오브젝트입니다.
47.1.3. 지원되는 데이터 유형
데이터를 삽입할 수 있는 특정 데이터 유형 세트는 삽입된 데이터의 소스를 지정하는 데 사용되는 주석에 따라 달라집니다. 그러나 모든 삽입 주석은 최소한 다음 데이터 유형 세트를 지원합니다.
-
int,char또는long과 같은 프리미티브 -
단일
String인수를 허용하는 생성자가 있는 개체 -
단일
String인수를 허용하는 정적valueOf()메서드가 있는 개체 - List<T>, Set<T>, 또는 SortedSet<T> T > T는 목록의 다른 조건을 충족
삽입 주석에 지원되는 데이터 유형에 대한 요구 사항이 다른 경우 주석에 대한 토론에서 차이점이 강조 표시됩니다.
