50.3. JAX-RS 2.0 예외 유형

JAX-RS 2.0에는 애플리케이션 코드에서 throw(및 catch)할 수 있는 여러 특정 HTTP 예외 유형이 도입되었습니다(기존 WebApplicationException 예외 유형 포함). 이러한 예외 유형을 사용하여 HTTP 클라이언트 오류(HTTP 4xx 상태 코드) 또는 HTTP 서버 오류(HTTP 5xx 상태 코드)에 대해 표준 HTTP 상태 코드를 래핑할 수 있습니다.

그림 50.1. “JAX-RS 2.0 애플리케이션 예외 계층 구조” JAX-RS 2.0에서 지원되는 애플리케이션 수준 예외의 계층 구조를 보여줍니다.

그림 50.1. JAX-RS 2.0 애플리케이션 예외 계층 구조

javax.ws.rs.WebApplicationException 예외 클래스(Tht-RS 1.x 이후 사용 가능)는 JAX-RS 2.0 예외 계층의 기반에 있으며 50.2절. “WebApplicationException 예외를 보고서에 사용” 에 자세히 설명되어 있습니다.

javax.ws.rs.ClientErrorException 예외 클래스는 HTTP 클라이언트 오류(HTTP 4xx 상태 코드)를 캡슐화하는 데 사용됩니다. 애플리케이션 코드에서 이 예외 또는 해당 하위 클래스 중 하나를 throw할 수 있습니다.

javax.ws.rs.ServerErrorException 예외 클래스는 HTTP 서버 오류(HTTP 5xx 상태 코드)를 캡슐화하는 데 사용됩니다. 애플리케이션 코드에서 이 예외 또는 해당 하위 클래스 중 하나를 throw할 수 있습니다.

javax.ws.rs.RedirectionException 예외 클래스는 HTTP 요청 리디렉션(HTTP 3xx 상태 코드)을 캡슐화하는 데 사용됩니다. 이 클래스의 생성자는 리디렉션 위치를 지정하는 URI 인수를 사용합니다. 리디렉션 URI는 getLocation() 메서드를 통해 액세스할 수 있습니다. 일반적으로 HTTP 리디렉션은 클라이언트 측에서 투명합니다.

JAX-RS 2.0 애플리케이션에서 다음 HTTP 클라이언트 예외(HTTP 4xx 상태 코드)를 발생시킬 수 있습니다.

JAX-RS 2.0 애플리케이션에서 다음 HTTP 서버 예외(HTTP 5xx 상태 코드)를 발생시킬 수 있습니다.