48장. 소비자에게 정보 반환
초록
RESTful 요청은 최소한 HTTP 응답 코드를 소비자에게 반환해야 합니다. 대부분의 경우 일반 JAXB 오브젝트 또는 GenericEntity 오브젝트를 반환하여 요청을 충족할 수 있습니다. 리소스 메서드가 응답 엔터티와 함께 추가 메타데이터를 반환해야 하는 경우 JAX-RS 리소스 메서드에서 필요한 HTTP 헤더 또는 기타 메타데이터가 포함된 Response 개체를 반환할 수 있습니다.
48.1. 반환 유형
소비자에게 반환되는 정보는 리소스 메서드가 반환하는 정확한 유형의 개체를 결정합니다. 이는 명확하게 보일 수 있지만 Java 반환 오브젝트 간의 매핑과 RESTful 소비자로 반환되는 것은 일대일이 아닙니다. 최소한 RESTful 소비자는 응답 엔티티 본문 외에도 유효한 HTTP 반환 코드를 반환해야 합니다. Java 객체에 포함된 데이터를 응답 엔티티에 포함된 데이터의 매핑은 소비자가 기꺼이 받아들일 준비가 되어 있는 MIME 타입에 의해 영향을 받습니다.
Java 오브젝트를 RESTful 응답 메시지와 관련된 문제를 해결하기 위해 리소스 메서드는 다음과 같이 네 가지 유형의 Java 구문을 반환할 수 있습니다.
- 48.2절. “일반 Java 구문 반환” JAX-RS 런타임으로 결정되는 HTTP 반환 코드로 기본 정보를 반환합니다.
- 48.2절. “일반 Java 구문 반환” JAX-RS 런타임에 의해 결정된 HTTP 반환 코드로 복잡한 정보를 반환합니다.
-
48.3절. “애플리케이션 응답 미세 조정” 프로그래밍 방식으로 확인된 HTTP 반환 상태로 복잡한 정보를 반환합니다.
Response오브젝트를 사용하면 HTTP 헤더도 지정할 수 있습니다. -
48.4절. “일반 유형 정보가 있는 엔터티 반환” JAX-RS 런타임에 의해 결정된 HTTP 반환 코드로 복잡한 정보를 반환합니다.
GenericEnitity오브젝트는 데이터를 serialize하는 런타임 구성 요소에 대한 자세한 정보를 제공합니다.
