30장. 일반 Fault Handling

초록

JAX-WS 사양은 두 가지 유형의 오류를 정의합니다. 하나는 일반 JAX-WS 런타임 예외입니다. 다른 하나는 메시지 처리 중에 발생하는 예외의 프로토콜 특정 클래스입니다.

30.1. 런타임 Faults

대부분의 JAX-WS API는 일반 javax.xml.ws.WebServiceException 예외를 throw합니다.

표 30.1. “WebServiceException을 지원하는 API” 일반 WebServiceException 예외를 throw할 수 있는 JAX-WS API 중 일부를 나열합니다.

표 30.1. WebServiceException을 지원하는 API
API	이유
`Binding.setHandlerChain()`	처리기 체인 구성에 오류가 있습니다.
`BindingProvider.getEndpointReference()`	지정된 클래스는 `W3CEndpointReference` 에서 할당되지 않습니다.
`Dispatch.invoke()`	Dispatch 인스턴스의 구성에 오류가 있거나 서비스와 통신하는 동안 오류가 발생했습니다.
`Dispatch.invokeAsync()`	Dispatch 인스턴스의 구성에 오류가 있습니다.
`Dispatch.invokeOneWay()`	Dispatch 인스턴스의 구성에 오류가 있거나 서비스와 통신하는 동안 오류가 발생했습니다.
`LogicalMessage.getPayload()`	제공된 `JAXBContext` 를 사용하여 페이로드를 분리 해제할 때 오류가 발생했습니다. WebServiceException의 `원인` 필드에는 원래 JAXBException이 포함되어 있습니다.
`LogicalMessage.setPayload()`	메시지 페이로드를 설정할 때 오류가 발생했습니다. `JAXBContext` 를 사용할 때 예외가 throw되는 경우 WebServiceException의 `원인` 필드에는 원래 JAXBException이 포함되어 있습니다.
`WebServiceContext.getEndpointReference()`	지정된 클래스는 `W3CEndpointReference` 에서 할당되지 않습니다.