javax.xml.transform
인터페이스 ErrorListener

public interface ErrorListener

커스터마이즈 된 에러 처리를 제공하려면 , 이 인터페이스를 구현해, setErrorListener 메소드를 사용해,Transformer 로 구현의 인스턴스를 등록합니다. Transformer 는 다음에 이 인터페이스를 개입시켜 모두 에러와 경고를 리포트합니다.

어플리케이션이 ErrorListener 를 등록 「하지 않는다」경우, 에러는 System.err 에 리포트됩니다.

변환 에러의 경우, Transformer 는 예외를 슬로우 하지 않고 이 인터페이스를 사용할 필요가 있습니다. 다른 타입의 에러와 경고에 관한 예외를 슬로우 할지 어떨지의 판정은 어플리케이션으로 실시할 필요가 있습니다. 다만, Transformer 는 fatalError 를 호출한 뒤에 변환을 계속할 필요는 없습니다.

Transformer 는 이 기구를 사용해 XML 해석 에러 및 변환 에러를 리포트할 수 있습니다.

메소드의 개요

void	error (TransformerException exception) 회복 가능한 에러의 통지를 받습니다.
void	fatalError (TransformerException exception) 회복 불능인 에러의 통지를 받습니다.
void	warning (TransformerException exception) 경고의 통지를 받습니다.

메소드의 상세

warning

public void warning(TransformerException  exception)
             throws TransformerException 

경고의 통지를 받습니다.

Transformer 는 이 메소드를 사용해 회복 가능한 에러가 아닌 경고를 리포트할 수 있습니다. 디폴트의 동작에서는 아무것도 실행되지 않습니다.

이 메소드를 호출한 뒤, Transformer 는 변환을 계속할 필요가 있습니다. 어플리케이션이 문서를 끝까지 처리하는 것은 여전히 가능합니다.

파라미터:

exception - Transformer 예외에 캡슐화된 경고 정보

예외:

TransformerException - 어플리케이션이 변환의 계속 해제를 선택했을 경우

관련 항목:

TransformerException

error

public void error(TransformerException  exception)
           throws TransformerException 

회복 가능한 에러의 통지를 받습니다.

Transformer 는 이 메소드를 호출한 뒤, 통상의 변환의 시행과 제공을 계속할 필요가 있습니다. 다른 에러가 검출되지 않으면, 어플리케이션이 문서를 끝까지 처리하는 것은 여전히 가능합니다.

파라미터:

exception - Transformer 예외에 캡슐화된 에러 정보

예외:

TransformerException - 어플리케이션이 변환의 계속 해제를 선택했을 경우

관련 항목:

TransformerException

fatalError

public void fatalError(TransformerException  exception)
                throws TransformerException 

회복 불능인 에러의 통지를 받습니다.

Transformer 는 이 메소드를 호출한 뒤, 통상의 변환의 시행과 제공을 계속할 필요가 있습니다. 다른 에러가 검출되지 않으면, 어플리케이션이 문서를 끝까지 처리하는 것은 여전히 가능합니다만, 출력이 사용 가능하다라고 말하는 프로텍션은 없습니다.

파라미터:

exception - Transformer 예외에 캡슐화된 에러 정보

예외:

TransformerException - 어플리케이션이 변환의 계속 해제를 선택했을 경우

관련 항목:

TransformerException