javax.xml.transform
인터페이스 ErrorListener

public interface ErrorListener

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

어플리케이션이 독자적인 커스텀 ErrorListener를 등록하지 않는 경우, 디폴트의 ErrorListener가 사용되어 모든 경고와 에러가 System.err에 리포트되어, Exception는 Throw 되지 않습니다. 어플리케이션에서는 경고와 에러의 정상적인 동작을 확보하기 위해, ErrorListener를 등록해 사용하는 것을 강하게 추천합니다.

변환 에러의 경우, Transformer는 Exception을 Throw 하지 않고 이 인터페이스를 사용할 필요가 있습니다. 다양한 종류의 에러와 경고에 대해서 Exception을 Throw 할지 어떨지의 판정은 어플리케이션으로 실시할 필요가 있습니다. 다만, Transformer는 fatalError(TransformerException exception)를 호출한 뒤에 변환을 계속할 필요는 없습니다.

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

메서드 개요

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

메서드의 상세

warning

void warning(TransformerException  exception)
             throws TransformerException 

경고의 통지를 받습니다.

Transformer 는 이 메서드를 사용해 에러 혹은 치명적인 에러가 아닌 조건을 리포트할 수 있습니다. 디폴트의 동작에서는 아무것도 실행되지 않습니다.

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

파라미터:

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

예외:

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

관련 항목:

TransformerException

error

void error(TransformerException  exception)
           throws TransformerException 

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

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

파라미터:

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

예외:

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

관련 항목:

TransformerException

fatalError

void fatalError(TransformerException  exception)
                throws TransformerException 

회복할 수 없는 에러의 통지를 받습니다.

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

파라미터:

exception - TransformerException에 캡슐화된 에러 정보

예외:

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

관련 항목:

TransformerException