jaxp/src/javax/xml/parsers/DocumentBuilderFactory.java
changeset 24887 47b6d4800c64
parent 20581 65d17ea72da3
child 25262 1fe892ba017a
equal deleted inserted replaced
24801:410bccbded9e 24887:47b6d4800c64
   421      * All implementations are required to support the {@link javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING} feature.
   421      * All implementations are required to support the {@link javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING} feature.
   422      * When the feature is:</p>
   422      * When the feature is:</p>
   423      * <ul>
   423      * <ul>
   424      *   <li>
   424      *   <li>
   425      *     <code>true</code>: the implementation will limit XML processing to conform to implementation limits.
   425      *     <code>true</code>: the implementation will limit XML processing to conform to implementation limits.
   426      *     Examples include enity expansion limits and XML Schema constructs that would consume large amounts of resources.
   426      *     Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources.
   427      *     If XML processing is limited for security reasons, it will be reported via a call to the registered
   427      *     If XML processing is limited for security reasons, it will be reported via a call to the registered
   428      *    {@link org.xml.sax.ErrorHandler#fatalError(SAXParseException exception)}.
   428      *    {@link org.xml.sax.ErrorHandler#fatalError(SAXParseException exception)}.
   429      *     See {@link  DocumentBuilder#setErrorHandler(org.xml.sax.ErrorHandler errorHandler)}.
   429      *     See {@link  DocumentBuilder#setErrorHandler(org.xml.sax.ErrorHandler errorHandler)}.
   430      *   </li>
   430      *   </li>
   431      *   <li>
   431      *   <li>
   515      * adding default values that were missing in documents), and a parser
   515      * adding default values that were missing in documents), and a parser
   516      * is responsible to make sure that the application will receive
   516      * is responsible to make sure that the application will receive
   517      * modified DOM trees.
   517      * modified DOM trees.
   518      *
   518      *
   519      * <p>
   519      * <p>
   520      * Initialy, null is set as the {@link Schema}.
   520      * Initially, null is set as the {@link Schema}.
   521      *
   521      *
   522      * <p>
   522      * <p>
   523      * This processing will take effect even if
   523      * This processing will take effect even if
   524      * the {@link #isValidating()} method returns <code>false</code>.
   524      * the {@link #isValidating()} method returns <code>false</code>.
   525      *
   525      *
   529      * property in conjunction with a {@link Schema} object.
   529      * property in conjunction with a {@link Schema} object.
   530      * Such configuration will cause a {@link ParserConfigurationException}
   530      * Such configuration will cause a {@link ParserConfigurationException}
   531      * exception when the {@link #newDocumentBuilder()} is invoked.</p>
   531      * exception when the {@link #newDocumentBuilder()} is invoked.</p>
   532      *
   532      *
   533      *
   533      *
   534      * <h4>Note for implmentors</h4>
   534      * <h4>Note for implementors</h4>
   535      *
   535      *
   536      * <p>
   536      * <p>
   537      * A parser must be able to work with any {@link Schema}
   537      * A parser must be able to work with any {@link Schema}
   538      * implementation. However, parsers and schemas are allowed
   538      * implementation. However, parsers and schemas are allowed
   539      * to use implementation-specific custom mechanisms
   539      * to use implementation-specific custom mechanisms