JavaTM Platform
Standard Ed. 6

javax.xml.transform
클래스 TransformerException

java.lang.Object 
  상위를 확장 java.lang.Throwable 
      상위를 확장 java.lang.Exception 
          상위를 확장 javax.xml.transform.TransformerException
모든 구현된 인터페이스:
Serializable
직계의 기존의 서브 클래스:
TransformerConfigurationException


public class TransformerException
extends Exception

이 클래스는, 변환 처리중에 발생한 예외 상태를 나타냅니다.

관련 항목:
직렬화 된 형식

생성자 의 개요
TransformerException (String  message)
          새로운 TransformerException 를 작성합니다.
TransformerException (String  message, SourceLocator  locator)
          메세지와 locator로부터 새로운 TransformerException 를 작성합니다.
TransformerException (String  message, SourceLocator  locator, Throwable  e)
          기존의 예외를 TransformerException 에 랩 합니다.
TransformerException (String  message, Throwable  e)
          기존의 예외를 TransformerException 에 랩 합니다.
TransformerException (Throwable  e)
          기존의 예외를 랩 하는 새로운 TransformerException 를 작성합니다.
 
메소드의 개요
 Throwable getCause ()
          원인이 존재하지 않는가 불명한 경우에, 이 Throwable 또는 null 의 원인을 돌려줍니다.
 Throwable getException ()
          이 메소드는, 이 예외가 랩 하는 예외를 가져옵니다.
 String getLocationAsString ()
          위치 정보를 캐릭터 라인으로서 가져옵니다.
 SourceLocator getLocator ()
          getLocator 메소드는, 에러가 발생한 장소를 나타내는 SourceLocator 객체의 인스턴스를 가져옵니다.
 String getMessageAndLocation ()
          위치 정보가 추가된 에러 메세지를 가져옵니다.
 Throwable initCause (Throwable  cause)
          지정된 값에 대한 이 Throwable 의 「원인」을 초기화합니다.
 void printStackTrace ()
          에러가 발생한 원의 장소로부터의 메소드의 트레이스를 출력합니다.
 void printStackTrace (PrintStream  s)
          에러가 발생한 원의 장소로부터의 메소드의 트레이스를 출력합니다.
 void printStackTrace (PrintWriter  s)
          에러가 발생한 원의 장소로부터의 메소드의 트레이스를 출력합니다.
 void setLocator (SourceLocator  location)
          setLocator 메소드는, 에러가 발생한 장소를 나타내는 SourceLocator 객체의 인스턴스를 설정합니다.
 
클래스 java.lang. Throwable 로부터 상속된 메소드
fillInStackTrace , getLocalizedMessage , getMessage , getStackTrace , setStackTrace , toString
 
클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait
 

생성자 의 상세

TransformerException

public TransformerException(String  message)
새로운 TransformerException 를 작성합니다.

파라미터:
message - 에러 또는 경고 메세지

TransformerException

public TransformerException(Throwable  e)
기존의 예외를 랩 하는 새로운 TransformerException 를 작성합니다.

파라미터:
e - 랩 되는 예외

TransformerException

public TransformerException(String  message,
                            Throwable  e)
기존의 예외를 TransformerException 에 랩 합니다.  

이것은, 처리를 개시하기 전에 프로세서 예외를 throw 하기 위해서 사용됩니다.

파라미터:
message - 에러 메세지, 경고 메세지, 또는 null. null 의 경우는 짜넣어 예외의 메세지를 이용하는
e - 임의의 예외

TransformerException

public TransformerException(String  message,
                            SourceLocator  locator)
메세지와 locator로부터 새로운 TransformerException 를 작성합니다.  

이 생성자 은, 어플리케이션이 DocumentHandler 콜백내로부터 독자적인 예외를 작성할 경우에 특별히 도움이 됩니다.

파라미터:
message - 에러 또는 경고 메세지
locator - 에러 또는 경고의 locator 객체

TransformerException

public TransformerException(String  message,
                            SourceLocator  locator,
                            Throwable  e)
기존의 예외를 TransformerException 에 랩 합니다.

파라미터:
message - 에러 메세지, 경고 메세지, 또는 null. null 의 경우는 짜넣어 예외의 메세지를 이용하는
locator - 에러 또는 경고의 locator 객체
e - 임의의 예외
메소드의 상세

getLocator

public SourceLocator  getLocator()
getLocator 메소드는, 에러가 발생한 장소를 나타내는 SourceLocator 객체의 인스턴스를 가져옵니다.

반환값:
SourceLocator 객체. 아무것도 지정되지 않았던 경우는 null

setLocator

public void setLocator(SourceLocator  location)
setLocator 메소드는, 에러가 발생한 장소를 나타내는 SourceLocator 객체의 인스턴스를 설정합니다.

파라미터:
location - SourceLocator 객체. 장소를 클리어 하는 경우는 null

getException

public Throwable  getException()
이 메소드는, 이 예외가 랩 하는 예외를 가져옵니다.

반환값:
Throwable 객체, 또는 null
관련 항목:
getCause()

getCause

public Throwable  getCause()
원인이 존재하지 않는가 불명한 경우에, 이 Throwable 또는 null 의 원인을 돌려줍니다. 원인은 이 Throwable 를 throw 시킨 Throwable 입니다.

오버라이드(override):
클래스 Throwable 내의 getCause
반환값:
throw 가능한 객체의 원인. 원인이 존재하지 않는가 불명의 경우는 null

initCause

public Throwable  initCause(Throwable  cause)
지정된 값에 대한 이 Throwable 의 「원인」을 초기화합니다. 원인은 이 Throwable 를 throw 시킨 Throwable 입니다.  

이 메소드는 최대로 1 회 밖에 호출할 수가 없습니다. 일반적으로은, 생성자 내로부터, 또는 Throwable 의 작성 직후에 불려 갑니다. 이 Throwable 가 TransformerException(Throwable) 또는 TransformerException(String, Throwable) 를 사용해 작성되었을 경우, 이 메소드는 1 회나 호출할 수가 없습니다.

오버라이드(override):
클래스 Throwable 내의 initCause
파라미터:
cause - 원인 (나중에 Throwable#getCause() 메소드를 사용해 꺼낼 수 있도록(듯이) 보존된다). null 치가 허가되어 원인이 존재하지 않는가 불명한 것을 가리킨다
반환값:
Throwable 인스턴스에의 참조
예외:
IllegalArgumentException - cause 가 이 Throwable 인 경우 (Throwable 는 그것 자신의 원인이 될 수 없다)
IllegalStateException - 이 Throwable 가 TransformerException(Throwable) 또는 TransformerException(String, Throwable) 를 사용해 작성되었을 경우, 또는 이 메소드가 이 Throwable 에 대해서 벌써 불려 가고 있는 경우

getMessageAndLocation

public String  getMessageAndLocation()
위치 정보가 추가된 에러 메세지를 가져옵니다.

반환값:
위치 정보가 추가된 에러 메세지를 나타낸다 String

getLocationAsString

public String  getLocationAsString()
위치 정보를 캐릭터 라인으로서 가져옵니다.

반환값:
위치 정보를 포함한 캐릭터 라인. 위치 정보가 없는 경우는 null

printStackTrace

public void printStackTrace()
에러가 발생한 원의 장소로부터의 메소드의 트레이스를 출력합니다. 이것은, 모든 상자가 되어 있는 예외 객체, 및 이 객체를 추적합니다.

오버라이드(override):
클래스 Throwable 내의 printStackTrace

printStackTrace

public void printStackTrace(PrintStream  s)
에러가 발생한 원의 장소로부터의 메소드의 트레이스를 출력합니다. 이것은, 모든 상자가 되어 있는 예외 객체, 및 이 객체를 추적합니다.

오버라이드(override):
클래스 Throwable 내의 printStackTrace
파라미터:
s - 덤프의 발송지의 스트림

printStackTrace

public void printStackTrace(PrintWriter  s)
에러가 발생한 원의 장소로부터의 메소드의 트레이스를 출력합니다. 이것은, 모든 상자가 되어 있는 예외 객체, 및 이 객체를 추적합니다.

오버라이드(override):
클래스 Throwable 내의 printStackTrace
파라미터:
s - 덤프의 발송지의 라이터

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.