javax.xml.soap
클래스 SOAPException

java.lang.Object 
  java.lang.Throwable 
      java.lang.Exception 
          javax.xml.soap.SOAPException

모든 구현된 인터페이스:

Serializable

public class SOAPException
extends Exception 

SOAP 예외가 발생한 것을 통지하는 예외입니다. SOAPException 객체에는, 예외의 이유를 나타내는 String, 편입 Throwable 객체, 혹은 그 양쪽 모두가 포함되는 경우가 있습니다. 이 클래스는, 이유 메세지의 취득 및 짜넣어 Throwable 객체의 취득을 위한 메소드를 제공합니다. 　

SOAPException 객체가 throw 되는 일반적인 이유는, 헤더의 설정이 곤란하다, 메세지를 송신할 수 없는, 및 프로바이더와의 접속을 취득할 수 없는등의 문제입니다. Throwable 객체의 짜넣어에 관한 이유에는, 입출력 에러 또는 헤더의 구문 분석시의 에러등의, 해석 관련의 문제등이 포함됩니다.

관련 항목:

직렬화 된 형식

생성자 의 개요

SOAPException ()
이유 이루어 또는 짜넣어 Throwable 객체에서의 SOAPException 객체를 구축합니다.

SOAPException (String reason)
throw 되는 예외의 이유로서 지정된 String 를 사용해,SOAPException 객체를 구축합니다.

SOAPException (String reason, Throwable cause)
throw 되는 예외의 이유로서 지정된 String 를 사용해, 또 짜넣어 예외로서 지정된 Throwable 객체를 사용해,SOAPException 객체를 구축합니다.

SOAPException (Throwable cause)
지정된 Throwable 객체로 초기화된 SOAPException 객체를 구축합니다.

메소드의 개요

Throwable	getCause () 이 SOAPException 에 짜넣어진 Throwable 객체를 돌려줍니다 (존재하는 경우).
String	getMessage () SOAPException 의 상세 메세지를 돌려줍니다.
Throwable	initCause (Throwable cause) 이 SOAPException 객체의 cause 필드를, 지정한 Throwable 객체로 초기화합니다.

클래스 java.lang. Throwable 로부터 상속된 메소드

fillInStackTrace , getLocalizedMessage , getStackTrace , printStackTrace , printStackTrace , printStackTrace , setStackTrace , toString

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자 의 상세

SOAPException

public SOAPException()

이유 이루어 또는 짜넣어 Throwable 객체에서의 SOAPException 객체를 구축합니다.

SOAPException

public SOAPException(String  reason)

throw 되는 예외의 이유로서 지정된 String 를 사용해,SOAPException 객체를 구축합니다.

파라미터:

reason - 예외의 발생 원인의 설명

SOAPException

public SOAPException(String  reason,
                     Throwable  cause)

throw 되는 예외의 이유로서 지정된 String 를 사용해, 또 짜넣어 예외로서 지정된 Throwable 객체를 사용해,SOAPException 객체를 구축합니다.

파라미터:

reason - 예외의 발생 원인의 설명

cause - 이 SOAPException 객체에 짜넣어진다 Throwable 객체

SOAPException

public SOAPException(Throwable  cause)

지정된 Throwable 객체로 초기화된 SOAPException 객체를 구축합니다.

메소드의 상세

getMessage

public String  getMessage()

SOAPException 의 상세 메세지를 돌려줍니다.

편입 Throwable 객체가 존재해,SOAPException 객체가 고유의 상세 메세지를 가지지 않는 경우, 이 메소드는 짜넣어 Throwable 객체의 상세 메세지를 돌려줍니다.

오버라이드(override):

클래스 Throwable 내의 getMessage

반환값:

이 SOAPException 의 에러 메세지 또는 경고 메세지, 또는 그것들이 없는 경우, 편입 Throwable 객체의 메세지 (존재하는 경우)

getCause

public Throwable  getCause()

이 SOAPException 에 짜넣어진 Throwable 객체를 돌려줍니다 (존재하는 경우). 그렇지 않은 경우는, 이 메소드는 null 를 돌려줍니다.

오버라이드(override):

클래스 Throwable 내의 getCause

반환값:

편입Throwable 객체 또는 null (존재하지 않는 경우)

initCause

public Throwable  initCause(Throwable  cause)

이 SOAPException 객체의 cause 필드를, 지정한 Throwable 객체로 초기화합니다.

이 메소드는 최대로 1 회 밖에 호출할 수가 없습니다. 일반적으로은, 생성자 내로부터, 또는 생성자 이 새로운 SOAPException 객체를 돌려준 직후에 불려 갑니다. 이 SOAPException 객체가 생성자 SOAPException(Throwable) 또는 SOAPException(String, Throwable) 를 사용해 작성되었을 경우, 즉 그 cause 필드에 벌써 값이 존재하는 경우, 이 메소드는 1 회나 호출할 수가 없습니다.

오버라이드(override):

클래스 Throwable 내의 initCause

파라미터:

cause - SOAPException 객체가 throw 된다 원인이 된 Throwable 객체. 이 파라미터의 값은, getCause() 에 의해 다음에 취득되는 경우를 위해서(때문에) 보존됩니다. null 치가 허가되고 있어 원인이 존재하지 않는 또는 불명한 경우

반환값:

이 SOAPException 인스턴스에의 참조

예외:

IllegalArgumentException - cause 가 이 Throwable 객체인 경우(Throwable 객체는, 그것 자신의 원인이 되는 것은 할 수 없다)

IllegalStateException - 이 SOAPException 객체의 원인이 이미 초기화되고 있는 경우