javax.xml.xpath
클래스 XPathException

java.lang.Object 
  java.lang.Throwable 
      java.lang.Exception 
          javax.xml.xpath.XPathException

모든 구현된 인터페이스:

Serializable

알려진 직계 서브 클래스:

XPathExpressionException, XPathFactoryConfigurationException

public class XPathException
extends Exception 

XPathException는 범용 XPath 예외를 나타냅니다.

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

생성자 개요

XPathException (String message)
지정된 상세 메세지로 새로운 XPathException을 구축합니다.

XPathException (Throwable cause)
지정된 cause로 새로운 XPathException을 구축합니다.

메서드 개요

Throwable	getCause () 원인이 존재하지 않는가 불명한 경우에 이 Throwable 또는 null 원인을 리턴합니다.
void	printStackTrace () 이 Throw 가능 객체 및 그 백 트레이스를 표준 에러 스트림에 출력합니다.
void	printStackTrace (PrintStream s) 이 Throw 가능 객체와 그 백 트레이스가 지정된 인쇄 스트림에 출력합니다.
void	printStackTrace (PrintWriter s) 이 Throw 가능 객체와 그 백 트레이스가 지정된 프린트 Writer에 출력합니다.

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

fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString

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

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

생성자 상세

XPathException

public XPathException(String  message)

지정된 상세 메세지로 새로운 XPathException을 구축합니다.

cause는 초기화되지 않습니다.

message가 null인 경우는 NullPointerException가 발생 됩니다.

파라미터:

message - 상세 메세지

XPathException

public XPathException(Throwable  cause)

지정된 cause로 새로운 XPathException을 구축합니다.

cause가 null인 경우는 NullPointerException가 발생 됩니다.

파라미터:

cause - 원인

예외:

NullPointerException - cause가 null인 경우

메서드의 상세

getCause

public Throwable  getCause()

클래스 Throwable 기술:

원인이 존재하지 않는가 불명한 경우에 이 Throwable 또는 null 원인을 리턴합니다. 원인은 이 Throwable를 Throw 시킨 Throwable 입니다.

이 구현은, Throwable를 요구하는 몇개의 생성자 경유로 제공된 원인, 또는 Throwable.initCause(Throwable) 메서드를 사용해 작성 후로 설정된 원인을 리턴합니다. 보통, 이 메서드를 오버라이드(override) 할 필요는 없습니다만, 서브 클래스는 이 메서드를 오버라이드(override) 해, 다른 어떠한 방법으로 설정된 원인을 돌려줄 수가 있습니다. 이것은 체인 된 예외의 Throwable에 의 추가전에 실행되는 「유산 연쇄 Throw 가능 객체」의 경우에 적절한 동작입니다. PrintStackTrace 메서드의 어느쪽이든을 오버라이드(override) 할 필요는 없습니다. 이러한 메서드는 모두 getCause 메서드를 호출해, Throw 가능 객체의 원인을 판별합니다.

오버라이드(override):

클래스 Throwable 내의 getCause

반환값:

Throw 가능한 객체의 원인. 원인이 존재하지 않는가 불명의 경우는 null

printStackTrace

public void printStackTrace(PrintStream  s)

클래스 Throwable 기술:

이 Throw 가능 객체와 그 백 트레이스가 지정된 인쇄 스트림에 출력합니다.

오버라이드(override):

클래스 Throwable 내의 printStackTrace

파라미터:

s - 출력에 사용하는 PrintStream

printStackTrace

public void printStackTrace()

클래스 Throwable 기술:

이 Throw 가능 객체 및 그 백 트레이스를 표준 에러 스트림에 출력합니다. 이 메서드는 이 Throwable 객체의 스택 트레이스를, System.err 필드의 값인 에러 출력 스트림로 출력합니다. 출력의 선두행에는 이 객체에 대한 Throwable.toString() 메서드의 결과가 포함됩니다. 나머지의 행은 이전에 Throwable.fillInStackTrace() 메서드에 의해 기록된 데이터를 나타냅니다. 이 정보의 서식은 구현에 의해 다소 다릅니다만, 전형적인 서식의 예를 다음에 나타냅니다.

 java.lang.NullPointerException at MyClass.mash(MyClass.java:9) at MyClass.crunch(MyClass.java:6) at MyClass.main(MyClass.java:3)

이 예는 다음의 프로그램을 실행하는 것에 의해 작성된 것입니다.

 class MyClass {
     public static void main (String [] args) {
         crunch(null);
     }
     static void crunch(int[] a) {
         mash(a);
     }
     static void mash(int[] b) {
         System.out.println(b[0]);
     }
 }
 

초기화된 비 null 원인을 보관 유지하는 Throw 가능 객체의 백 트레이스에는 보통, 원인의 백 트레이스가 포함됩니다. 이 정보의 서식은 구현에 따라서 다릅니다만, 전형적인 서식의 예를 다음에 나타냅니다.

 HighLevelException: MidLevelException: LowLevelException
         at Junk.a(Junk.java:13)
         at Junk.main(Junk.java:4)
 Caused by: MidLevelException: LowLevelException
         at Junk.c(Junk.java:23)
         at Junk.b(Junk.java:17)
         at Junk.a(Junk.java:11)
         ... 1 more
 Caused by: LowLevelException
         at Junk.e(Junk.java:30)
         at Junk.d(Junk.java:27)
         at Junk.c(Junk.java:21)
         ... 3 more
 

문자 "..."를 포함한 행이 존재하는 것에 주목해 주세요. 이러한 행은 이 예외의 스택 트레이스의 나머지가 이 예외에 의해 일으켜진 예외의 스택 트레이스아래로부터의 프레임수로 일치하는 것을 나타냅니다. 보통 의 ( 「원인이 되는 예외」를 캐치 하는 것과 같은 메서드로부터 랩 된 예외가 Throw 된다) 경우, 이 단축형을 사용하는 것으로 출력의 길이를 큰폭으로 단축할 수 있습니다. 위의 예는 다음의 프로그램을 실행하는 것으로 생성됩니다.

 public class Junk {
     public static void main(String args[]) {
         try {
             a();
         } catch(HighLevelException e) {
             e.printStackTrace();
         }
     }
     static void a() throws HighLevelException {
         try {
             b();
         } catch(MidLevelException e) {
             throw new HighLevelException(e);
         }
     }
     static void b() throws MidLevelException {
         c();
     }   
     static void c() throws MidLevelException {
         try {
             d();
         } catch(LowLevelException e) {
             throw new MidLevelException(e);
         }
     }
     static void d() throws LowLevelException {
        e();
     }
     static void e() throws LowLevelException {
         throw new LowLevelException();
     }
 }

 class HighLevelException extends Exception {
     HighLevelException(Throwable cause) { super(cause); }
 }

 class MidLevelException extends Exception {
     MidLevelException(Throwable cause)  { super(cause); }
 }
 
 class LowLevelException extends Exception {
 }
 

오버라이드(override):

클래스 Throwable 내의 printStackTrace

printStackTrace

public void printStackTrace(PrintWriter  s)

클래스 Throwable 기술:

이 Throw 가능 객체와 그 백 트레이스가 지정된 프린트 Writer에 출력합니다.

오버라이드(override):

클래스 Throwable 내의 printStackTrace

파라미터:

s - 출력에 사용하는 PrintWriter