javax.xml.validation
클래스 ValidatorHandler

java.lang.Object 
  javax.xml.validation.ValidatorHandler

모든 구현된 인터페이스:

ContentHandler

public abstract class ValidatorHandler
extends Object 
implements ContentHandler 

SAX 스트림에 유효한 스트리밍 발리 데이터.

ValidatorHandler 객체는 thread 세이프가 아니고, 재입 불가능한 객체입니다. 즉, 어플리케이션측에서 항상 복수의 thread로부터 1개 ValidatorHandler 객체가 사용되지 않게 확인할 필요가 있습니다.

ValidatorHandler 는 SAX 이벤트가 관련된 Schema에 기술된 일련의 제약에 따르고 있는지를 체크해, 또한 SAX 이벤트를 변경할 수도 있습니다. 예를 들어 디폴트의 값의 추가등을 할 수 있습니다.

ValidatorHandler 는 ContentHandler 로부터 확장되고 있습니다만, 아래와 같이 기본이 되는 ContentHandler를 세련 시키고 있습니다.

1. startElement/endElement 이벤트는 uri, localName 및 qname에 SAX 로 그것들이 null 인 것이 허가되고 있는 경우에서도 null 이외의 String를 받을 필요가 있다. 같이 사용자 지정 ContentHandler 는 3 개 모든 파라미터에 null 이외의 String를 받는다
2. 어플리케이션에서는 ValidatorHandler ContentHandler.startPrefixMapping(String, String) 및 ContentHandler.endPrefixMapping(String) 가 올바르게 불려가 고 있는지를 확인할 필요가 있다. 같이 사용자 지정 ContentHandler 은 startPrefixMapping/endPrefixMapping 이벤트를 받는다. ValidatorHandler 가 추가의 이름 공간 바인딩을 얻는인 경우, 사용자 지정 ContentHandler 은 추가된 startPrefixMapping/endPrefixMapping 이벤트를 받는다
3. ContentHandler.startElement(String, String, String, Attributes) 메서드 Attributes 는 xmlns* 속성을 포함한 경우와 포함하지 않는 경우가 있다

startDocument 메서드가 불려 갈 때마다 ValidatorHandler 는 자동적으로 리셋 됩니다.

인식되는 프로퍼티와 기능

이 사양에서는 ValidatorHandler 모든 구현으로 인식할 필요가 있는 다음의 기능을 정의하고 있습니다.

http://xml.org/sax/features/namespace-prefixes

이 기능은 ValidatorHandler 가 원의 SAX 이벤트 스트림에 존재하지 않는 이름 공간 바인딩을 얻는 방법을 제어합니다. 이 기능이 true 로 설정되어 있는 경우는 사용자 ContentHandler 로 ContentHandler.startElement(String, String, String, Attributes) 콜백 Attributes 객체의 대응하는 xmlns* 속성을 확인할 필요가 있습니다. 그렇지 않은 경우는 사용자 지정 ContentHandler 에게 건네지는 Attributes 에xmlns* 속성이 추가되지 않습니다.

이 변환에 관계없이, 이름 공간 바인딩은 항상 사용자 지정 ContentHandler ContentHandler.startPrefixMapping(String, String) 및 ContentHandler.endPrefixMapping(String)를 개입시켜 어플리케이션에 통지됩니다.

이 기능은 ValidatorHandler 로 SAX 이벤트를 받는 방법에는 영향을 주지 않습니다. SAX 이벤트의 확장 방법을 변경할 뿐입니다.

이 기능은 디폴트로 false로 설정됩니다.

도입된 버전 :

1.5

생성자 개요

protected

ValidatorHandler () 상속 클래스의 생성자 입니다.

메서드 개요

abstract ContentHandler	getContentHandler () 확장된 검증 결과를 받는 ContentHandler를 취득합니다.
abstract ErrorHandler	getErrorHandler () 이 ValidatorHandler 로 설정된 현재 ErrorHandler를 취득합니다.
boolean	getFeature (String name) 기능 플래그의 값을 검색합니다.
Object	getProperty (String name) 프로퍼티치를 검색합니다.
abstract LSResourceResolver	getResourceResolver () 이 ValidatorHandler 로 설정된 현재 LSResourceResolver를 취득합니다.
abstract TypeInfoProvider	getTypeInfoProvider () 이 ValidatorHandler TypeInfoProvider 구현을 취득합니다.
abstract void	setContentHandler (ContentHandler receiver) 확장된 검증 결과를 받는 ContentHandler를 설정합니다.
abstract void	setErrorHandler (ErrorHandler errorHandler) 검증으로 발생한 에러를 받도록 ErrorHandler를 설정합니다.
void	setFeature (String name, boolean value) 기능 플래그의 값을 설정합니다.
void	setProperty (String name, Object object) 프로퍼티치를 설정합니다.
abstract void	setResourceResolver (LSResourceResolver resourceResolver) 검증시의 자원 해결을 커스터마이즈 하도록 LSResourceResolver를 설정합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

인터페이스 org.xml.sax. ContentHandler 로부터 상속된 메서드

characters, endDocument, endElement, endPrefixMapping, ignorableWhitespace, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping

생성자 상세

ValidatorHandler

protected ValidatorHandler()

상속 클래스의 생성자 입니다.

이 생성자는 아무것도 실시하지 않습니다.

상속 클래스에서는 null ErrorHandler 및 null LSResourceResolver ValidatorHandler 객체를 작성할 필요가 있습니다.

메서드의 상세

setContentHandler

public abstract void setContentHandler(ContentHandler  receiver)

확장된 검증 결과를 받는 ContentHandler를 설정합니다.

ContentHandler를 지정했을 경우, ValidatorHandler 는 필터로서 기능해, 기본적으로 수신 이벤트가 지정된 ContentHandler에 카피합니다.

이 실행으로 ValidatorHandler 는 예를 들어 디폴트의 속성을 추가해, 이벤트를 변경할 수도 있습니다.

ValidatorHandler 는 어느 정도 이벤트를 버퍼 할 수 있습니다 만, 파서로 ValidatorHandler를 사용할 수 있도록 하려면, 아래의 요건이 채워지고 있을 필요가 있습니다.

1. ValidatorHandler 로 ContentHandler.startElement(String, String, String, Attributes), ContentHandler.endElement(String, String, String), ContentHandler.startDocument(), 또는 ContentHandler.endDocument()를 호출하는 경우에 콜백이 돌아오기 전에 사용자 지정 ContentHandler 로 같은 이벤트에 대해서 같은 메서드를 호출할 필요가 있다
2. ValidatorHandler 는 입력에 존재하고 있지 않는 새로운 요소를 취득할 수 없다
3. ValidatorHandler 는 입력에 존재하고 있지 않는 속성을 삭제할 수 없다

지정된 ContentHandler 콜백 메서드가 예외를 Throw 했을 경우, ValidatorHandler 로부터 같은 예외 객체를 Throw 할 필요가 있습니다. ErrorHandler 에는 그러한 예외를 통지하지 말아 주세요.

이 메서드는 검증의 도중에도 호출할 수 있습니다 .

파라미터:

receiver - ContentHandler 또는 null 치

getContentHandler

public abstract ContentHandler  getContentHandler()

확장된 검증 결과를 받는 ContentHandler를 취득합니다.

반환값:

이 메서드는 getContentHandler() 메서드에 의해 마지막에 설정된 객체, 또는 이 ValidatorHandler 가 작성되고 나서, 그 메서드가 불려가 지 않은 경우는 null을 돌려주는

관련 항목:

setContentHandler(ContentHandler)

setErrorHandler

public abstract void setErrorHandler(ErrorHandler  errorHandler)

검증으로 발생한 에러를 받도록 ErrorHandler를 설정합니다.

에 러 핸들러를 사용해, 검증시의 에러 처리 프로세스를 커스터마이즈 할 수 있습니다. ErrorHandler를 설정하면, 검증으로 발견된 에러는 우선 ErrorHandler에 보내집니다.

에 러 핸들러는 핸들러로부터 SAXException를 Throw 해, 검증을 즉시 중단할 수 있습니다 . 또는 에러를 화면에 출력하거나ErrorHandler 로부터 정상적으로 돌아와 검증을 속행시키거나 할 수도 있습니다.

ErrorHandler 로부터 Throwable 가 Throw 되었을 경우, 같은 Throwable 객체가 Call Stack의 루트에 대해서 발생 됩니다.

ValidatorHandler 는 ErrorHandler에 최초로 보고하기 전에 SAXException를 Throw 할 수 없습니다.

ErrorHandler 가 null인 경우, 구현은 다음 ErrorHandler 가 설정되어 있는 것과 같게 동작합니다.

 class DraconianErrorHandler implements ErrorHandler  {
     public void fatalError( SAXParseException  e ) throws SAXException  {
         throw e;
     }
     public void error( SAXParseException  e ) throws SAXException  {
         throw e;
     }
     public void warning( SAXParseException  e ) throws SAXException  {
         // noop
     }
 }
 

새로운 ValidatorHandler 객체가 작성되면, 최초로 이 필드는 null 로 설정됩니다.

파라미터:

errorHandler - 설정하는 새로운 에러 핸들러. 이 파라미터는 null도 가능

getErrorHandler

public abstract ErrorHandler  getErrorHandler()

이 ValidatorHandler 로 설정된 현재 ErrorHandler를 취득합니다.

반환값:

이 메서드는 setErrorHandler(ErrorHandler) 메서드에 의해 마지막에 설정된 객체, 또는 이 ValidatorHandler 가 작성되고 나서, 그 메서드가 불려가 지 않은 경우는 null을 돌려주는

관련 항목:

setErrorHandler(ErrorHandler)

setResourceResolver

public abstract void setResourceResolver(LSResourceResolver  resourceResolver)

검증시의 자원 해결을 커스터마이즈 하도록 LSResourceResolver를 설정합니다.

ValidatorHandler 는 검증시에 외부 자원을 검색할 필요가 있는 경우에 LSResourceResolver를 사용합니다만, 엄밀하게 「외부 자원의 검색」을 구성하는 것은 schema 언어에 의해 다릅니다.

LSResourceResolver 가 null인 경우, 구현은 다음 LSResourceResolver 가 설정되어 있는 것과 같게 동작합니다.

 class DumbLSResourceResolver implements LSResourceResolver  {
     public LSInput  resolveResource(         String publicId, String systemId, String baseURI) {
         
         return null; // always return null
     }
 }
 

LSResourceResolver 가 RuntimeException (또는 그 상속 클래스의 인스턴스)를 Throw 하면, ValidatorHandler 는 구문 분석을 중지해, validate 메서드의 호출측은 같은 RuntimeException를 받습니다.

새로운 ValidatorHandler 객체가 작성되면, 최초로 이 필드는 null 로 설정됩니다.

파라미터:

resourceResolver - 설정하는 새로운 자원 리절버. 이 파라미터는 null도 가능

getResourceResolver

public abstract LSResourceResolver  getResourceResolver()

이 ValidatorHandler 로 설정된 현재 LSResourceResolver를 취득합니다.

반환값:

이 메서드는 setResourceResolver(LSResourceResolver) 메서드에 의해 마지막에 설정된 객체, 또는 이 ValidatorHandler 가 작성되고 나서, 그 메서드가 불려가 지 않은 경우는 null을 돌려주는

관련 항목:

setErrorHandler(ErrorHandler)

getTypeInfoProvider

public abstract TypeInfoProvider  getTypeInfoProvider()

이 ValidatorHandler TypeInfoProvider 구현을 취득합니다.

취득한 TypeInfoProvider 는 구문 분석시에 조회해, 발리 데이터에 의해 판단된 형태 정보에 액세스 할 수 있습니다.

schema 언어에 따라서는 형태의 개념을 정의하고 있지 않는 것도 있어, 그러한 언어의 경우, 이 메서드가 지원 되지 않는 것도 있습니다. 그러나, 이 사양에 준거하기 위해, W3C XML Schema 1.0 구현에서는 이 처리를 지원 할 필요가 있습니다.

반환값:

발리 데이터 / schema 언어로 TypeInfo 개념을 지원 하고 있지 않는 경우. 지원 하고 있는 경우는 null 이외의 유효한 TypeInfoProvider

getFeature

public boolean getFeature(String  name)
                   throws SAXNotRecognizedException,

                          SAXNotSupportedException 

기능 플래그의 값을 검색합니다.

기능명은 완전 수식 URI 입니다. ValidatorHandler 는 기능명을 인식할 수 있습니다만, 일시적으로 그 값을 돌려줄 수 없습니다. 기능의 값에 따라서는 검증의 실행전, 실행중, 실행 후등의 특정의 컨텍스트 으로 밖에 사용할 수 없는 경우가 있습니다.

독자적인 URI에 근거해 작성된 이름을 사용해, 구현자가 독자적인 기능을 작성할 수도 있습니다 (추천).

파라미터:

name - 기능명. null 이외의 완전 수식 URI 로 나타내진다

반환값:

기능의 현재의 값 (true 또는 false)

예외:

SAXNotRecognizedException - 기능의 값을 할당해 또는 취득할 수 없는 경우

SAXNotSupportedException - ValidatorHandler 가 기능명을 인식하는 것만으로 현시점에서는 그 값을 판단할 수 없는 경우

NullPointerException - name 파라미터가 null인 경우

관련 항목:

setFeature(String, boolean)

setFeature

public void setFeature(String  name,
                       boolean value)
                throws SAXNotRecognizedException,

                       SAXNotSupportedException 

기능 플래그의 값을 설정합니다.

기능을 사용해, ValidatorHandler 가 schema를 구문 분석 하는 방법을 제어할 수 있습니다만, ValidatorHandler 는 특정의 프로퍼티명을 인식할 필요는 없습니다.

기능명은 완전 수식 URI 입니다. ValidatorHandler 는 기능의 값을 표시할 수 있습니다만, 현재의 값을 변경할 수 없습니다. 기능의 값에 따라서는 검증의 실행전, 실행중, 실행 후등의 특정의 컨텍스트에 서만 불변 또는 가변인 경우가 있습니다.

파라미터:

name - 기능명. null 이외의 완전 수식 URI 로 나타내지는

value - 기능의 요구된 값 (true 또는 false)

예외:

SAXNotRecognizedException - 기능의 값을 할당해 또는 취득할 수 없는 경우

SAXNotSupportedException - ValidatorHandler 가 기능명을 인식하는 것만으로 요구된 값을 설정할 수 없는 경우

NullPointerException - name 파라미터가 null인 경우

관련 항목:

getFeature(String)

setProperty

public void setProperty(String  name,
                        Object  object)
                 throws SAXNotRecognizedException,

                        SAXNotSupportedException 

프로퍼티치를 설정합니다.

프로퍼티명은 완전 수식 URI 입니다. ValidatorHandler 는 프로퍼티명을 인식할 수 있습니다만, 현재의 값을 변경할 수 없습니다. 프로퍼티의 값에 따라서는 검증의 실행전, 실행중, 실행 후등의 특정의 컨텍스트에 서만 불변 또는 가변인 경우가 있습니다.

ValidatorHandler 는 특정의 프로퍼티명의 설정을 인식할 필요는 없습니다.

파라미터:

name - 프로퍼티명. null 이외의 완전 수식 URI 로 나타내지는

object - 요구된 프로퍼티치

예외:

SAXNotRecognizedException - 프로퍼티의 값을 할당해 또는 취득할 수 없는 경우

SAXNotSupportedException - ValidatorHandler 가 프로퍼티명을 인식하는 것만으로 요구된 값을 설정할 수 없는 경우

NullPointerException - name 파라미터가 null인 경우

getProperty

public Object  getProperty(String  name)
                   throws SAXNotRecognizedException,

                          SAXNotSupportedException 

프로퍼티치를 검색합니다.

프로퍼티명은 완전 수식 URI 입니다. ValidatorHandler 는 프로퍼티명을 인식할 수 있습니다만, 일시적으로 그 값을 돌려줄 수 없습니다. 프로퍼티의 값에 따라서는 검증의 실행전, 실행중, 실행 후등의 특정의 컨텍스트 으로 밖에 사용할 수 없는 경우가 있습니다.

ValidatorHandler 는 특정의 프로퍼티명을 인식할 필요는 없습니다.

독자적인 URI에 근거해 작성된 이름을 사용해, 구현자가 독자적인 프로퍼티를 작성할 수도 있습니다 (추천).

파라미터:

name - 프로퍼티명. null 이외의 완전 수식 URI 로 나타내진다

반환값:

현재의 프로퍼티치

예외:

SAXNotRecognizedException - 프로퍼티의 값을 할당해 또는 취득할 수 없는 경우

SAXNotSupportedException - XMLReader가 프로퍼티명을 인식하는 것만으로 현시점에서는 그 값을 판단할 수 없는 경우

NullPointerException - name 파라미터가 null인 경우

관련 항목:

setProperty(String, Object)