검색

50.3. JAX-RS 2.0 예외 유형

download PDF

50.3.1. 개요

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

50.3.2. 예외 계층 구조

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

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

exceptions 01

50.3.3. WebApplicationException 클래스

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

50.3.4. ClientErrorException 클래스

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

50.3.5. ServerErrorException 클래스

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

50.3.6. RedirectionException 클래스

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

50.3.7. 클라이언트 예외 하위 클래스

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

BadRequestException
400 Bad Request HTTP 오류 상태를 캡슐화합니다.
ForbiddenException
403 Forbidden HTTP 오류 상태를 캡슐화합니다.
NotAcceptableException
406 Acceptable HTTP 오류 상태를 캡슐화합니다.
NotAllowedException
405 Method Not Allowed HTTP 오류 상태를 캡슐화합니다.
NotAuthorizedException

401 Unauthorized HTTP 오류 상태를 캡슐화합니다. 이 예외는 다음 경우 중 하나에서 발생할 수 있습니다.This exception could be raised in either of the following cases:

  • 클라이언트가 필요한 자격 증명을 전송하지 않았거나 (HTTP Authorization 헤더에 있음)
  • 클라이언트에서 자격 증명을 제공했지만 자격 증명이 유효하지 않았습니다.
NotFoundException
404 Not Found HTTP 오류 상태를 캡슐화합니다.
NotSupportedException
415 지원되지 않는 미디어 유형 HTTP 오류 상태를 캡슐화합니다.

50.3.8. 서버 예외 하위 클래스

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

InternalServerErrorException
500 Internal Server Error HTTP 오류 상태를 캡슐화합니다.
ServiceUnavailableException
503 Service Unavailable HTTP 오류 상태를 캡슐화합니다.
Red Hat logoGithubRedditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

© 2024 Red Hat, Inc.