Validator

Validator

javax.xml.validation

---

Java 5.0

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( )