javax.xml.validation
클래스 Validator

java.lang.Object 
  javax.xml.validation.Validator

public abstract class Validator
extends Object 

Schema 와 조합해 XML 문서를 체크하는 프로세서입니다.

발리 데이터는 thread 세이프가 아니고, 재입 불가능한 객체입니다. 즉, 어플리케이션측에서 항상 복수의 thread로부터 1개 Validator 객체가 사용되지 않게 확인할 필요가 있어, validate 메서드가 불려가 고 있는 동안, 어플리케이션은 재귀적으로 validate 메서드를 호출할 수가 없습니다.

validate(javax.xml.transform.Source) 및 validate(javax.xml.transform.Source, javax.xml.transform.Result) 메서드가 Source 인스턴스를 취득할 때, Source인스턴스는 SAXSource 또는 DOMSource 일 필요가 있습니다.

도입된 버전 :

1.5

생성자 개요

protected

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

메서드 개요

abstract ErrorHandler	getErrorHandler () 이 Validator 로 설정된 현재 ErrorHandler를 취득합니다.
boolean	getFeature (String name) 기능 플래그의 값을 검색합니다.
Object	getProperty (String name) 프로퍼티치를 검색합니다.
abstract LSResourceResolver	getResourceResolver () 이 Validator 로 설정된 현재 LSResourceResolver를 취득합니다.
abstract void	reset () 이 Validator를 원의 설정에 리셋 합니다.
abstract void	setErrorHandler (ErrorHandler errorHandler) validate 메서드의 호출로 발생한 에러를 받도록 ErrorHandler를 설정합니다.
void	setFeature (String name, boolean value) 기능 플래그의 값을 설정합니다.
void	setProperty (String name, Object object) 프로퍼티치를 설정합니다.
abstract void	setResourceResolver (LSResourceResolver resourceResolver) 검증시의 자원 해결을 커스터마이즈 하도록 LSResourceResolver를 설정합니다.
void	validate (Source source) 지정된 입력을 검증합니다.
abstract void	validate (Source source, Result result) 지정된 입력을 검증해, 추가된 검증 결과가 지정된 출력에 보냅니다.

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

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

생성자 상세

Validator

protected Validator()

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

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

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

메서드의 상세

reset

public abstract void reset()

이 Validator를 원의 설정에 리셋 합니다.

Validator는 Schema.newValidator() 로 작성된 시점 상태에 리셋 됩니다. reset()는 기존의 Validator 재사용을 허가하도록 설정되어 있기 때문에 새로운 Validator 작성에 관련된 자원을 절약할 수 있습니다.

Validator를 리셋 했을 경우, 같은 LSResourceResolver 또는 ErrorHandler Object를 가지는 것은 보증되지 않습니다. 예를 들어, Object.equals(Object obj) 등입니다. 기능적으로 같은 LSResourceResolver 나 ErrorHandler를 가지는 것은 보증됩니다.

validate

public void validate(Source  source)
              throws SAXException,

                     IOException 

지정된 입력을 검증합니다.

이 메서드는 다음의 간이 메서드에 지나지 않습니다.

 validate(source, null);
 

예외:

SAXException

IOException

관련 항목:

setErrorHandler(ErrorHandler)

validate

public abstract void validate(Source  source,
                              Result  result)
                       throws SAXException,

                              IOException 

지정된 입력을 검증해, 추가된 검증 결과가 지정된 출력에 보냅니다.

이 메서드는 받아들이는 Source /Result 형태에 관해서, 다음의 제약을 마련하고 있습니다.

받아들일 수 있는 Source /Result

	SAXSource	DOMSource
null	OK	OK
SAXResult	OK	에러
DOMResult	에러	OK

StreamSource 인스턴스는 허가되지 않습니다. StreamSource를 처리하는지, 또는 1개 Source를 다른 종류 Result에 검증하려면, 항등변환을 사용합니다 (TransformerFactory.newTransformer()를 참조).

검증으로 발견된 에러는 지정된 ErrorHandler에 보내집니다.

문서가 유효하다, 또는 문서에 얼마인가의 에러가 있지만, 그것들은 모두 치명적이지 않고, ErrorHandler 로 예외가 Throw되어 있지 않은 경우, 메서드는 정상적으로 돌아옵니다.

파라미터:

source - 검증되는 XML. null은 불가

result - 확장된 가능성이 있는 XML를 받는 Result 객체. 호출측에서 필요가 없으면, 이 파라미터는 null도 가능. DOMResult 가 사용되어 발리 데이터가 DOMSource 로부터 DOMResult에 같은 DOM를 건네줄 뿐 때는 (source.getNode() ==result.getNode()인 경우), DOM 트리 전체가 카피되는지, 소스로 지정된 노드가 변경되는 일이 있다

예외:

IllegalArgumentException - Result 형태가 Source 형태와 일치하지 않는 경우, 또는 지정된 소스가 SAXSource 에서도 DOMSource 도 아닌 경우

SAXException - ErrorHandler 가 SAXException를 Throw 했을 경우, 또는 치명적 에러가 발견되고 ErrorHandler 가 정상적으로 돌아왔을 경우

IOException - 발리 데이터가 SAXSource를 처리중에서 기본이 되는 XMLReader 가 IOException를 Throw 했을 경우

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

관련 항목:

validate(Source)

setErrorHandler

public abstract void setErrorHandler(ErrorHandler  errorHandler)

validate 메서드의 호출로 발생한 에러를 받도록 ErrorHandler를 설정합니다.

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

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

ErrorHandler 로부터 Throwable 가 Throw 되었을 경우, validate 메서드의 호출 측에 같은 Throwable 객체가 발생 됩니다.

Validator 는 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
     }
 }
 

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

파라미터:

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

getErrorHandler

public abstract ErrorHandler  getErrorHandler()

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

반환값:

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

관련 항목:

setErrorHandler(ErrorHandler)

setResourceResolver

public abstract void setResourceResolver(LSResourceResolver  resourceResolver)

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

Validator 는 검증시에 외부 자원을 검색할 필요가 있는 경우에 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 하면, Validator 는 구문 분석을 중지해, validate 메서드의 호출측은 같은 RuntimeException를 받습니다.

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

파라미터:

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

getResourceResolver

public abstract LSResourceResolver  getResourceResolver()

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

반환값:

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

관련 항목:

setErrorHandler(ErrorHandler)

getFeature

public boolean getFeature(String  name)
                   throws SAXNotRecognizedException,

                          SAXNotSupportedException 

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

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

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

파라미터:

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

반환값:

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

예외:

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

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

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

관련 항목:

setFeature(String, boolean)

setFeature

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

                       SAXNotSupportedException 

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

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

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

파라미터:

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

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

예외:

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

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

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

관련 항목:

getFeature(String)

setProperty

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

                        SAXNotSupportedException 

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

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

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

파라미터:

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

object - 요구된 프로퍼티치

예외:

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

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

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

getProperty

public Object  getProperty(String  name)
                   throws SAXNotRecognizedException,

                          SAXNotSupportedException 

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

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

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

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

파라미터:

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

반환값:

현재의 프로퍼티치

예외:

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

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

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

관련 항목:

setProperty(String, Object)