src/javax/xml/parsers/SAXParser.java

Print this page




 424      */
 425 
 426     public abstract boolean isNamespaceAware();
 427 
 428     /**
 429      * Indicates whether or not this parser is configured to
 430      * validate XML documents.
 431      *
 432      * @return true if this parser is configured to
 433      *         validate XML documents; false otherwise.
 434      */
 435 
 436     public abstract boolean isValidating();
 437 
 438     /**
 439      * <p>Sets the particular property in the underlying implementation of
 440      * {@link org.xml.sax.XMLReader}.
 441      * A list of the core features and properties can be found at
 442      * <a href="http://sax.sourceforge.net/?selected=get-set">
 443      * http://sax.sourceforge.net/?selected=get-set</a>.</p>























 444      *
 445      * @param name The name of the property to be set.
 446      * @param value The value of the property to be set.
 447      *
 448      * @throws SAXNotRecognizedException When the underlying XMLReader does
 449      *   not recognize the property name.
 450      * @throws SAXNotSupportedException When the underlying XMLReader
 451      *  recognizes the property name but doesn't support the property.
 452      *
 453      * @see org.xml.sax.XMLReader#setProperty
 454      */
 455     public abstract void setProperty(String name, Object value)
 456         throws SAXNotRecognizedException, SAXNotSupportedException;
 457 
 458     /**
 459      * <p>Returns the particular property requested for in the underlying
 460      * implementation of {@link org.xml.sax.XMLReader}.</p>
 461      *
 462      * @param name The name of the property to be retrieved.
 463      * @return Value of the requested property.




 424      */
 425 
 426     public abstract boolean isNamespaceAware();
 427 
 428     /**
 429      * Indicates whether or not this parser is configured to
 430      * validate XML documents.
 431      *
 432      * @return true if this parser is configured to
 433      *         validate XML documents; false otherwise.
 434      */
 435 
 436     public abstract boolean isValidating();
 437 
 438     /**
 439      * <p>Sets the particular property in the underlying implementation of
 440      * {@link org.xml.sax.XMLReader}.
 441      * A list of the core features and properties can be found at
 442      * <a href="http://sax.sourceforge.net/?selected=get-set">
 443      * http://sax.sourceforge.net/?selected=get-set</a>.</p>
 444      * <p>
 445      * All implementations that implement JAXP 1.5 or newer are required to 
 446      * support the {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_DTD} and 
 447      * {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_SCHEMA} properties. 
 448      * </p>
 449      * <ul>
 450      *   <li>
 451      *      <p>
 452      *      Setting the {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_DTD} property 
 453      *      restricts the access to external DTDs, external Entity References to 
 454      *      the protocols specified by the property.  If access is denied during parsing 
 455      *      due to the restriction of this property, {@link org.xml.sax.SAXException} 
 456      *      will be thrown by the parse methods defined by {@link javax.xml.parsers.SAXParser}.
 457      *      </p>
 458      *      <p>
 459      *      Setting the {@link javax.xml.XMLConstants#ACCESS_EXTERNAL_SCHEMA} property 
 460      *      restricts the access to external Schema set by the schemaLocation attribute to 
 461      *      the protocols specified by the property.  If access is denied during parsing 
 462      *      due to the restriction of this property, {@link org.xml.sax.SAXException} 
 463      *      will be thrown by the parse methods defined by the {@link javax.xml.parsers.SAXParser}.
 464      *      </p>
 465      *   </li>
 466      * </ul>
 467      *
 468      * @param name The name of the property to be set.
 469      * @param value The value of the property to be set.
 470      *
 471      * @throws SAXNotRecognizedException When the underlying XMLReader does
 472      *   not recognize the property name.
 473      * @throws SAXNotSupportedException When the underlying XMLReader
 474      *  recognizes the property name but doesn't support the property.
 475      *
 476      * @see org.xml.sax.XMLReader#setProperty
 477      */
 478     public abstract void setProperty(String name, Object value)
 479         throws SAXNotRecognizedException, SAXNotSupportedException;
 480 
 481     /**
 482      * <p>Returns the particular property requested for in the underlying
 483      * implementation of {@link org.xml.sax.XMLReader}.</p>
 484      *
 485      * @param name The name of the property to be retrieved.
 486      * @return Value of the requested property.