/* * Validates the specified input. * * <p/> * This is just a convenience method of: * <pre> * validate(source,null); * </pre> * * @see #setErrorHandler(ErrorHandler) */ public void validate(javax.xml.transform.Source source) { //throws SAXException, IOException { validate(source, null); }
/* * Validates the specified input and send the augmented validation * result to the specified output. * * <p/> * This method places the following restrictions on the types of * the {@link Source}/{@link Result} accepted. * * <h4>{@link Source}/{@link Result} accepted:</h4> * <table border='1'> * <thead> * <tr> * <td></td> * <td>{@link javax.xml.transform.sax.SAXSource}</td> * <td>{@link javax.xml.transform.dom.DOMSource}</td> * <td>{@link javax.xml.transform.stax.StAXSource}</td> * <td>{@link javax.xml.transform.stream.StreamSource}</td> * </tr> * </thead> * <tbody> * <tr> * <td><tt>null</tt></td> * <td>OK</td> * <td>OK</td> * <td>OK</td> * <td>OK</td> * </tr> * <tr> * <td>{@link javax.xml.transform.sax.SAXResult}</td> * <td>OK</td> * <td>Err</td> * <td>Err</td> * <td>Err</td> * </tr> * <tr> * <td>{@link javax.xml.transform.dom.DOMResult}</td> * <td>Err</td> * <td>OK</td> * <td>Err</td> * <td>Err</td> * </tr> * <tr> * <td>{@link javax.xml.transform.stax.StAXResult}</td> * <td>Err</td> * <td>Err</td> * <td>OK</td> * <td>Err</td> * </tr> * <tr> * <td>{@link javax.xml.transform.stream.StreamResult}</td> * <td>Err</td> * <td>Err</td> * <td>Err</td> * <td>OK</td> * </tr> * </tbody> * </table> * * <p/> * To validate one {@link Source} into another kind of {@link Result}, use the identity transformer * (see {@link javax.xml.transform.TransformerFactory#newTransformer()}). * * <p/> * Errors found during the validation is sent to the specified * {@link ErrorHandler}. * * <p/> * If a document is valid, or if a document contains some errors * but none of them were fatal and the {@link ErrorHandler} didn't * throw any exception, then the method returns normally. * * @param source * XML to be validated. Must not be null. * * @param result * The {@link Result} object that receives (possibly augmented) * XML. This parameter can be null if the caller is not interested * in it. * * Note that when a {@link javax.xml.transform.dom.DOMResult} is used, * a validator might just pass the same DOM node from * {@link javax.xml.transform.dom.DOMSource} to * {@link javax.xml.transform.dom.DOMResult} * (in which case <tt>source.getNode()==result.getNode()</tt>), * it might copy the entire DOM tree, or it might alter the * node given by the source. * * @throws IllegalArgumentException * If the {@link Result} type doesn't match the {@link Source} type, * or if the specified source is not a * {@link javax.xml.transform.sax.SAXSource}, * {@link javax.xml.transform.dom.DOMSource}, * {@link javax.xml.transform.stax.StAXSource} or * {@link javax.xml.transform.stream.StreamSource}. * * @throws SAXException * If the {@link ErrorHandler} throws a {@link SAXException} or * if a fatal error is found and the {@link ErrorHandler} returns * normally. * * @throws IOException * If the validator is processing a * {@link javax.xml.transform.sax.SAXSource} and the * underlying {@link org.xml.sax.XMLReader} throws an * {@link IOException}. * * @throws NullPointerException * If the <tt>source</tt> parameter is null. * * @see #validate(Source) */ public abstract void validate(javax.xml.transform.Source source, javax.xml.transform.Result result);