org.xml.sax
인터페이스 ErrorHandler

기존의 구현 클래스의 일람:

DefaultHandler , HandlerBase , XMLFilterImpl

public interface ErrorHandler

SAX 에러 핸들러의 기본 인터페이스입니다.

이 모듈은 원시 코드, 문서 모두 공개 도메인에 놓여져 있습니다. 따라서, 내용에 관한프로텍션은 일절 제공되지 않습니다.

커스텀 에러 처리를 구현할 필요가 있는 경우, SAX 어플리케이션은 이 인터페이스를 구현해,setErrorHandler 메소드를 사용해 XML 리더에게 인스턴스를 등록할 필요가 있습니다. 이것으로, 파서는 이 인터페이스를 개입시켜 모든 에러 및 경고를 보고하게 됩니다.

경고: 어플리케이션이 ErrorHandler 를 등록하지 않는 경우, XML 구문 분석 에러는 보고되지 않고 불규칙한 동작을 볼 수 있게 됩니다.

SAX 드라이버는 XML 처리 에러에 대해서는 예외를 슬로우 하는 대신에 이 인터페이스를 사용할 필요가 있습니다. 다양한 형태의 에러나 경고에 대해서 예외를 슬로우 할지 어떨지는 어플리케이션측에서 결정됩니다. 다만,fatalError 의 호출 후는 파서가 유익한 정보를 제공하지 않게 되는 경우가 있습니다. 이것은 SAX 드라이버 클래스가 예외를 캐치 해 fatalError 를 보고할 가능성이 있다고 하는 것입니다.

도입된 버젼:

SAX 1.0

관련 항목:

Parser.setErrorHandler(org.xml.sax.ErrorHandler) , SAXParseException

메소드의 개요

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

메소드의 상세

warning

public void warning(SAXParseException  exception)
             throws SAXException 

경고의 통지를 받습니다.

SAX 파서는 이 메소드를 사용해, XML 1.0 권고에 정의된 에러 또는 치명적인 에러 이외의 조건을 보고합니다. 디폴트에서는 이것에 대해서 어떤 액션도 빼앗기지 않습니다.

SAX 파서는 이 메소드의 호출 후도 표준 구문 분석 이벤트를 계속 제공하지 않으면 안됩니다. 이것은 어플리케이션이 문서를 끝까지 처리할 수가 없으면 안 되기 때문입니다.

필터는 이 메소드를 사용해 그 외의 비 XML 경고도 보고할 수 있습니다.

파라미터:

exception - SAX 구문 분석 예외에 캡슐화된 경고 정보

예외:

SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는

관련 항목:

SAXParseException

error

public void error(SAXParseException  exception)
           throws SAXException 

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

이것은 W3C XML 1.0 권고 섹션 1.2 의 「에러」의 정의에 상당합니다. 예를 들어, 타당성을 검증하는 파서는 이 콜백을 사용해 타당성 제약 위반을 보고합니다. 디폴트에서는 이것에 대해서 어떤 액션도 빼앗기지 않습니다.

SAX 파서는 이 메소드의 호출 후도 표준 구문 분석 이벤트를 계속 제공하지 않으면 안됩니다. 이것은 어플리케이션이 문서를 끝까지 처리할 수가 없으면 안 되기 때문입니다. 어플리케이션이 문서를 끝까지 처리할 수가 없는 경우, 필수 사항으로서 XML 1.0 권고에 정의되고 있는 것은 아닙니다만, 파서는 치명적인 에러를 보고합니다.

필터는 이 메소드를 사용해 그 외의 비 XML 에러도 보고할 수 있습니다.

파라미터:

exception - SAX 구문 분석 예외에 캡슐화된 에러 정보

예외:

SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는

관련 항목:

SAXParseException

fatalError

public void fatalError(SAXParseException  exception)
                throws SAXException 

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

이것은 W3C XML 1.0 권고 섹션 1.2 의 「치명적인 에러」의 정의에 상당합니다. 예를 들어, 파서는 이 콜백을 사용해 정형식 제약 위반을 보고합니다.

파서가 이 메소드를 호출한 뒤, 어플리케이션은 문서를 사용할 수 없게 되었다고 판단해, 그 외의 에러 메세지를 수집할 뿐(만큼)의 목적으로 처리를 속행합니다. 실제의 곳, SAX 파서는 이 메소드를 호출한 뒤, 그 외의 이벤트의 보고를 정지해도 괜찮습니다.

파라미터:

exception - SAX 구문 분석 예외에 캡슐화된 에러 정보

예외:

SAXException - SAX 예외. 다른 예외를 랩 하고 있을 가능성이 있는

관련 항목:

SAXParseException