java.lang
클래스 Throwable

java.lang.Object 
  java.lang.Throwable

모든 구현된 인터페이스:

Serializable

알려진 직계 서브 클래스:

Error, Exception

public class Throwable
extends Object 
implements Serializable 

Throwable 클래스는 Java 언어의 모든 에러와 예외의 슈퍼 클래스입니다. 이 클래스 (또는 그 서브 클래스 중의 1개)의 인스턴스인 객체만이 Java 가상 머신에 의해 발생되는 지, Java throw 구문에 의해 발생 됩니다. 똑같이, 이 클래스 또는 그 서브 클래스 중의 1개 만이 catch 절의 인수의 형태로 지정할 수 있습니다.

보통, Error 및 Exception 2개의 서브 클래스의 인스턴스는 예외적인 상황이 발생한 것을 나타내기 위해서 사용됩니다. 이러한 인스턴스는 보통, 관련된 정보 (스택 트레이스 데이터등)를 포함하기 위해서 예외적인 상황에 따라 새롭게 작성됩니다.

Throw 가능 객체에는 작성시의 그 thread의 실행 스택의 snapshot가 포함됩니다. 이 클래스에는 에러에 대한 상세한 정보를 나타내는 메세지 캐릭터 라인도 포함됩니다. 최종적으로 이것은 「원인」 (이 Throw 가능 객체의 Throw를 일으킨 다른 Throw 가능 객체)을 포함할 수 있습니다 . 원인 기능은 릴리스 1.4 신기능입니다. 이것은 원인 자체가 원인을 보관 유지해 예외의 연쇄를 작성할 수 있기 때문에 「체인 된 예외」기능이라고도 불립니다.

Throw 가능 객체가 원인을 보관 유지할 수 있는 1개의 이유로서 Throw 가능 객체를 Throw 하는 클래스가 하위 레이어 추상화 위에 구축되고 있는 것이 들고 있습니다. 이 때문에 상위 레이어에 대한 조작이 실패하는 것은 하위 레이어에서의 조작이 실패하기 때문에입니다. 하위 레이어에 의해 발생되는 Throw 가능 객체를 외부에 송신하는 것은 부적절한 설계 방법입니다. 이것은 보통, 상위 레이어에 의해 제공되는 추상화 기능과는 관계가 없기 때문입니다. 게다가 이러한 조작을 실시하면, 상위 레이어의 API를 구현의 상세하게 연결시켜 버리기 때문에 하위 레이어의 예외가 체크 예외라고 보여져 버립니다. 「랩 된 예외」 (원인을 포함한 예외)을 Throw 하면, 이러한 결점에 접하지 않고 상위 레이어가 장해의 상세를 호출해 측에 통신할 수 있게 됩니다. 이 때문에 상위 레이어의 구현 (특히 메서드에 의해 발생되는 예외세트)을 API를 변경하지 않고 유연하게 변경할 수 있습니다.

Throw 가능 객체가 원인을 보관 유지하는 2번째의 이유는 Throw 가능 객체를 Throw 하는 메서드가 원인을 직접 Throw 하는 것을 메서드에 허가하지 않는 범용 인터페이스에 준거할 필요가 있는 것입니다. 예를 들어 지속 컬렉션이 Collection 인터페이스에 준거해, 그 지속성이 java.io 상위에 구현되는 경우를 생각합시다. put 메서드의 내부는 IOException를 Throw 가능하다라고 합니다. 이 경우 적절한 체크되지 않는 예외의 IOException을 감싸는 것으로써, 구현은 Collection 인터페이스에 준거하면서, IOException 상세를 호출해 측에 통지할 수 있습니다. 지속 컬렉션의 사양에 이런 종류의 예외를 Throw 가능하다라고 하는 것이 나타나고 있을 필요가 있습니다.

원인은 2개의 방법으로 Throw 가능 객체에 관련지을 수가 있습니다. 1개는 원인을 인수로서 취하는 생성자를 사용하는 방법, 이제(이미 ) 1개는 initCause(Throwable) 메서드를 사용하는 방법입니다. 원인이 관련짓고를 가능하게 하는 새로운 Throw 가능 클래스는 원인을 받는 생성자를 제공해, 원인을 받는 몇개의 Throwable 생성자에 (보통 간접적으로) 위양 할 필요가 있습니다. 다음에 예를 나타냅니다.

     try {
         lowLevelOp();
     } catch (LowLevelException le) {
         throw new HighLevelException(le);  // Chaining-aware constructor
     }
 

initCause 메서드는 public 이기 때문에 원인을 임의의 Throw 가능 객체에 관련짓는 것이 가능합니다. 이것은 구현이 예외 체인 도구 의 Throwable에 의 추가에 선행하는 「유산 Throw 가능 객체」여도 들어맞읍니다. 다음에 예를 나타냅니다.

     try {
         lowLevelOp();
     } catch (LowLevelException le) {
         throw (HighLevelException)
                 new HighLevelException(). initCause(le);  // Legacy constructor
     }
 

릴리스 1.4 이전에는 비표준의 독자 예외 체인 도구 (ExceptionInInitializerError, ClassNotFoundException, UndeclaredThrowableException, InvocationTargetException, WriteAbortedException, PrivilegedActionException, PrinterIOException, RemoteException 및 NamingException )를 보관 유지하는 다수의 Throw 가능 객체가 존재하고 있었습니다. 릴리스 1.4 에서는 이러한 Throw 가능 객체는 모두, 호환성을 위해서 「종래의」연쇄 도구 의 구현을 유지하면서, 표준의 예외 연쇄 도구를 사용할 수 있도록 개량되고 있습니다.

게다가 릴리스 1.4 에서는 다수의 범용 Throwable 클래스 (Exception, RuntimeException, Error 등)가 원인을 취하는 생성자에 맞추어 개량되고 있습니다. initCause 메서드가 이미 존재하고 있기 때문에 이것은 엄밀하게는 필수는 아니지만 원인을 취하는 생성자에의 위양을 실시하는 것보다 간편하고 표현력이 있는 방법입니다.

종래, Throwable 클래스 및 그 서브 클래스는 2개의 생성자를 보관 유지합니다. 1개는 인수를 취하지 않고, 이제(이미 ) 1개는 상세 메세지의 생성에 사용 가능한 String인수를 취합니다. 또, 관련된 원인을 보관 유지 가능한 이러한 서브 클래스는 게다가 2개의 생성자를 보관 유지합니다. 1개는 Throwable (원인)를 취해, 이제(이미 ) 1개는 String (상세 메세지) 및 Throwable (원인)를 취합니다.

또, 릴리스 1.4 에서는 getStackTrace() 메서드도 도입되었습니다. 이 메서드를 사용하면, 지금까지 printStackTrace() 메서드를 사용해 텍스트 형식에서 밖에 이용할 수 없었던 스택 트레이스 정보에 프로그램화 된 액세스를 실행할 수 있습니다. 이 정보가 이 클래스의 「직렬화 표현」에 추가되었기 때문에 getStackTrace 및 printStackTrace가 직렬화 복원에 의해 취득된 Throw 가능 객체에 대해서 적정하게 기능합니다.

도입된 버전 :

JDK1. 0

관련 항목:

직렬화 된 형식

생성자 개요

Throwable ()
상세 메세지에 null을 사용해, 새로운 Throw 가능 객체를 구축합니다.

Throwable (String message)
지정된 상세 메세지를 사용해, 새로운 Throw 가능 객체를 구축합니다.

Throwable (String message, Throwable cause)
지정된 상세 메세지 및 원인을 사용해 새로운 Throw 가능 객체를 구축합니다.

Throwable (Throwable cause)
(cause==null ? null : cause.toString()) 지정된 원인 및 상세 메세지를 사용해 새로운 예외를 구축합니다.

메서드 개요

Throwable	fillInStackTrace () 실행 스택 트레이스를 묻습니다.
Throwable	getCause () 원인이 존재하지 않는가 불명한 경우에 이 Throwable 또는 null 원인을 리턴합니다.
String	getLocalizedMessage () 이 Throw 가능 객체의, 지역 대응된 기술을 작성합니다.
String	getMessage () 이 Throwable 객체의 상세 메세지 캐릭터 라인을 리턴합니다.
StackTraceElement []	getStackTrace () printStackTrace() 에 의해 출력된 스택 트레이스 정보에의, 프로그램화 된 액세스를 제공합니다.
Throwable	initCause (Throwable cause) 지정된 값에 대한 이 Throwable 「원인」을 초기화합니다.
void	printStackTrace () 이 Throw 가능 객체 및 그 백 트레이스를 표준 에러 스트림에 출력합니다.
void	printStackTrace (PrintStream s) 이 Throw 가능 객체와 그 백 트레이스가 지정된 인쇄 스트림에 출력합니다.
void	printStackTrace (PrintWriter s) 이 Throw 가능 객체와 그 백 트레이스가 지정된 프린트 Writer에 출력합니다.
void	setStackTrace (StackTraceElement [] stackTrace) getStackTrace() 에 의해 돌려주고져printStackTrace() 및 관련된 메서드에 의해 출력되는 스택 트레이스 요소를 설정합니다.
String	toString () 이 Throw 가능 객체의 짧은 기술을 리턴합니다.

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

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

생성자 상세

Throwable

public Throwable()

상세 메세지에 null을 사용해, 새로운 Throw 가능 객체를 구축합니다. 원인은 초기화되지 않고, 그 후 initCause(java.lang.Throwable)를 호출하는 것으로 초기화됩니다.

fillInStackTrace() 메서드를 호출해, 새로운 작성된 Throw 가능 객체내의 스택 트레이스 데이터를 초기화합니다.

Throwable

public Throwable(String  message)

지정된 상세 메세지를 사용해, 새로운 Throw 가능 객체를 구축합니다. 원인은 초기화되지 않고, 그 후 initCause(java.lang.Throwable)를 호출하는 것으로 초기화됩니다.

fillInStackTrace() 메서드를 호출해, 새로운 작성된 Throw 가능 객체내의 스택 트레이스 데이터를 초기화합니다.

파라미터:

message - 상세 메세지. 상세 메세지는 나중에 getMessage() 메서드로 취득하기 위해서 보존된다

Throwable

public Throwable(String  message,
                 Throwable  cause)

지정된 상세 메세지 및 원인을 사용해 새로운 Throw 가능 객체를 구축합니다.

cause와 관련된 상세 메세지가 이 Throw 가능 객체의 상세 메세지에 자동적으로 통합될 것은 없습니다.

fillInStackTrace() 메서드를 호출해, 새로운 작성된 Throw 가능 객체내의 스택 트레이스 데이터를 초기화합니다.

파라미터:

message - 상세 메세지 (나중에 getMessage() 메서드로 취득하기 위해서 보존된다)

cause - 원인 (나중에 getCause() 메서드로 취득하기 위해서 보존된다). null 값이 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버전 :

1.4

Throwable

public Throwable(Throwable  cause)

(cause==null ? null : cause.toString()) 지정된 원인 및 상세 메세지를 사용해 새로운 예외를 구축합니다. 보통, (cause==null ? null : cause.toString())에는 cause 클래스 및 상세 메세지가 포함됩니다. 이 생성자는 Throw 가능 객체가 다른 Throw 가능 객체 (PrivilegedActionException 등)의 래퍼인 경우에 유용합니다.

fillInStackTrace() 메서드를 호출해, 새로운 작성된 Throw 가능 객체내의 스택 트레이스 데이터를 초기화합니다.

파라미터:

cause - 원인 (나중에 getCause() 메서드로 취득하기 위해서 보존된다). null 값이 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타내는

도입된 버전 :

1.4

메서드의 상세

getMessage

public String  getMessage()

이 Throwable 객체의 상세 메세지 캐릭터 라인을 리턴합니다.

반환값:

이 Throwable 인스턴스의 상세 메세지 캐릭터 라인 (null도 가능)

getLocalizedMessage

public String  getLocalizedMessage()

이 Throw 가능 객체의, 지역 대응된 기술을 작성합니다. 서브 클래스는 이 메서드를 오버라이드(override) 해, 로케일에 고유의 메세지를 작성할 수 있습니다. 이 메서드를 오버라이드(override) 하지 않는 서브 클래스의 경우는 디폴트의 구현에 의해 getMessage()와 같은 결과가 리턴됩니다 .

반환값:

이 Throw 가능 객체의, 지역 대응된 기술

도입된 버전 :

JDK1. 1

getCause

public Throwable  getCause()

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

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

반환값:

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

도입된 버전 :

1.4

initCause

public Throwable  initCause(Throwable  cause)

지정된 값에 대한 이 Throwable 「원인」을 초기화합니다. 원인은 이 Throwable를 Throw 시킨 Throwable 입니다.

이 메서드는 1회 만 호출할 수 있습니다 . 보통, 이 메서드는 생성자 내부로부터 호출되는지, Throw 가능 객체의 작성 후 곧바로 호출합니다. Throwable(Throwable) 또는 Throwable(String, Throwable)를 사용해 이 Throw 가능 객체를 작성했을 경우, 이 메서드를 한번도 호출할 수 없습니다.

파라미터:

cause - 원인 (나중에 getCause() 메서드로 취득하기 위해서 보존된다). null 값이 허가되고 있어 원인이 존재하지 않는가 불명한 것을 나타낸다

반환값:

이 Throwable인스턴스에의 참조

예외:

IllegalArgumentException - cause가 이 Throwable 인 경우 (Throwable는 그것 자신의 원인으로는 될 수 없다)

IllegalStateException - 이 Throw 가능 객체가 Throwable(Throwable) 또는 Throwable(String, Throwable)를 사용해 작성되었는지, 이 메서드가 이 Throw 가능 객체에 대해서 호출을 실행이 끝난 상태인 경우

도입된 버전 :

1.4

toString

public String  toString()

이 Throw 가능 객체의 짧은 기술을 리턴합니다. 이 Throwable 객체가 비 null 상세 메세지 캐릭터 라인을 사용해 작성되었을 경우, 결과는 다음의 3개의 캐릭터 라인을 연결한 것이 됩니다.

• 이 객체 실제의 클래스명
• ": " (구두점과 스페이스)
• 이 객체에 대한 getMessage() 메서드의 결과

이 Throwable 객체가 null 상세 메세지 캐릭터 라인을 사용해 작성되었을 경우는 이 객체의 실제의 클래스명이 리턴됩니다 .

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 Throw 가능 객체의 캐릭터 라인 표현

printStackTrace

public void printStackTrace()

이 Throw 가능 객체 및 그 백 트레이스를 표준 에러 스트림에 출력합니다. 이 메서드는 이 Throwable 객체의 스택 트레이스를, System.err 필드의 값인 에러 출력 스트림로 출력합니다. 출력의 선두행에는 이 객체에 대한 toString() 메서드의 결과가 포함됩니다. 나머지의 행은 이전에 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 {
 }
 

printStackTrace

public void printStackTrace(PrintStream  s)

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

파라미터:

s - 출력에 사용하는 PrintStream

printStackTrace

public void printStackTrace(PrintWriter  s)

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

파라미터:

s - 출력에 사용하는 PrintWriter

도입된 버전 :

JDK1. 1

fillInStackTrace

public Throwable  fillInStackTrace()

실행 스택 트레이스를 묻습니다. 이 메서드는 현행 thread의 스택 프레임의 현재 상태에 관한 정보를, 이 Throwable 객체내에 기록합니다.

반환값:

이 Throwable인스턴스에의 참조

관련 항목:

printStackTrace()

getStackTrace

public StackTraceElement [] getStackTrace()

printStackTrace() 에 의해 출력된 스택 트레이스 정보에의, 프로그램화 된 액세스를 제공합니다. 스택 트레이스 요소 ( 각 요소는 1개의 스택 프레임을 나타낸다)의 배열을 리턴합니다. 배열의 제로 번째의 요소 (배열의 길이가 제로가 아닌 경우)는 스택의 선두 (일련의 메서드 호출의 최후)를 나타냅니다. 보통, 이것은 Throw 가능 객체가 작성 및 Throw 된 포인트입니다. 배열의 마지막 요소 (배열의 길이가 제로가 아닌 경우)는 스택의 말미 (일련의 메서드 호출의 최초)를 나타냅니다.

가상 머신안에는 특정의 상황하로 스택 트레이스로부터 1개 이상의 스택 프레임을 생략 하는 것이 있습니다. 극단적인 경우, 이 Throw 가능 객체에 관한 스택 트레이스 정보를 보관 유지하지 않는 가상 머신이, 이 메서드로부터 길이 제로의 배열을 돌려주는 것이 허가됩니다. 일반적으로 이 메서드에 의해 리턴된 배열은, printStackTrace에 의해 출력되는 프레임 마다 1개의 요소를 포함합니다.

반환값:

이 Throw 가능 객체에 관한 스택 트레이스를 나타내는 스택 트레이스 요소의 배열

도입된 버전 :

1.4

setStackTrace

public void setStackTrace(StackTraceElement [] stackTrace)

getStackTrace() 에 의해 돌려주고져printStackTrace() 및 관련된 메서드에 의해 출력되는 스택 트레이스 요소를 설정합니다.이 메서드는 RPC 체제 및 다른 고성능 시스템에서의 사용을 목적으로 설계되고 있어 클라이언트가 디폴트 스택 트레이스를 오버라이드(override) 할 수 있도록 합니다. 디폴트 스택 트레이스는 Throw 가능 객체의 구축시에 fillInStackTrace() 에 의해 생성되는지, Throw 가능 객체가 직렬화 스트림로부터 읽어들일 때에 직렬화 복원됩니다.

파라미터:

stackTrace - 이 Throwable와 관련짓는 스택 트레이스 요소. 지정된 배열은 이 호출에 의해 카피된다. 메서드 호출의 복귀 후에 지정된 배열내에서 행해진 변경은, Throwable 스택 트레이스에 영향을 미치지 않는다

예외:

NullPointerException - stackTrace가 null인 경우, 또는 stackTrace 몇개의 요소가 null인 경우

도입된 버전 :

1.4