Java in a Nutshell, 5th Edition [Electronic resources] نسخه متنی

A Validator object
validates an XML document against the Schema from
which the Validator was created. The
validate( ) method
performs validation. Specify the document to be validated with a
DOMSource or SAXSource
object (from the javax.xml.transform.dom or
javax.xml.transform.sax packages). The
validate( ) method accepts any
javax.xml.transform.Source object as an argument,
but SAXSource and DOMSource are
the only two supported implementations.

The document validation process can also be used to augment the
source document by adding the default values of unspecified
attributes. If you want to capture this augmented form of the
document, pass a Result object to the two-argument
version of validate( ). If the source is a
SAXSource, the result must be a
SAXResult, and if the source is a
DOMSource, the result must be a
DOMResult object.

If the document is valid, the validate( ) method
returns normally. If the document is not valid, validate(
) throws an org.xml.sax.SAXException.
You can alter this somewhat by passing a custom
org.xml.sax.ErrorHandler to
setErrorHandler( ). Validation exceptions are
first passed to the error handler methods, which may throw the
exception or handle them in some other way, such as printing a
message. If the error handler does not throw an exception, the
validate( ) method attempts to continue
validation. The default error handler ignores exceptions passed to
its warn( ) method but throws exceptions passed to
its error( ) and fatalError(
) methods.

Before calling validate( ), a
Validator may also be configured with
setResourceResolver(
),
setFeature( ), and
setProperty( ).

public abstract class

Validator {
// Protected Constructors
protected

Validator ( );
// Public Instance Methods
public abstract org.xml.sax.ErrorHandler

getErrorHandler ( );
public boolean

getFeature (String

name )
throws org.xml.sax.SAXNotRecognizedException,
org.xml.sax.SAXNotSupportedException;
public Object

getProperty (String

name )
throws org.xml.sax.SAXNotRecognizedException,
org.xml.sax.SAXNotSupportedException;
public abstract org.w3c.dom.ls.LSResourceResolver

getResourceResolver ( );
public abstract void

reset ( );
public abstract void

setErrorHandler (org.xml.sax.ErrorHandler

errorHandler );
public void

setFeature (String

name , boolean

value )
throws org.xml.sax.SAXNotRecognizedException,
org.xml.sax.SAXNotSupportedException;
public void

setProperty (String

name , Object

object )
throws org.xml.sax.SAXNotRecognizedException,
org.xml.sax.SAXNotSupportedException;
public abstract void

setResourceResolver (org.w3c.dom.ls.LSResourceResolver

resourceResolver );
public void

validate (javax.xml.transform.Source

source )
throws org.xml.sax.SAXException, java.io.IOException;
public abstract void

validate (javax.xml.transform.Source

source ,
javax.xml.transform.Result

result )
throws org.xml.sax.SAXException, java.io.IOException;
}

Returned By

Schema.newValidator( )