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 

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

　

프로세서는 처리를 계속하는 일도 있습니다만, 일반적으로은 정상적으로 종료하지 않습니다.

　

메소드는, 에러를 처리할 수 없는 경우, 또는 곧바로 처리를 종료하는 경우, 예외를 throw 합니다. 프로세서는 반드시 이 요구를 받아들이지 않습니다.

파라미터:

exception - TransformerException 예외에 캡슐화되었다 에러 정보

예외:

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

관련 항목:

TransformerException