src/javax/xml/validation/ValidatorHandler.java

Print this page




 362         throw new SAXNotRecognizedException(name);
 363     }
 364 
 365     /**
 366      * <p>Set a feature for this <code>ValidatorHandler</code>.</p>
 367      *
 368      * <p>Feature can be used to control the way a
 369      * {@link ValidatorHandler} parses schemas. The feature name is
 370      * any fully-qualified URI. It is possible for a
 371      * {@link SchemaFactory} to
 372      * expose a feature value but to be unable to change the current
 373      * value. Some feature values may be immutable or mutable only in
 374      * specific contexts, such as before, during, or after a
 375      * validation.</p>
 376      *
 377      * <p>All implementations are required to support the {@link javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING} feature.
 378      * When the feature is:</p>
 379      * <ul>
 380      *   <li>
 381      *     <code>true</code>: the implementation will limit XML processing to conform to implementation limits.
 382      *     Examples include enity expansion limits and XML Schema constructs that would consume large amounts of resources.
 383      *     If XML processing is limited for security reasons, it will be reported via a call to the registered
 384      *    {@link ErrorHandler#fatalError(SAXParseException exception)}.
 385      *     See {@link #setErrorHandler(ErrorHandler errorHandler)}.
 386      *   </li>
 387      *   <li>
 388      *     <code>false</code>: the implementation will processing XML according to the XML specifications without
 389      *     regard to possible implementation limits.
 390      *   </li>
 391      * </ul>
 392      *
 393      * @param name The feature name, which is a non-null fully-qualified URI.
 394      * @param value The requested value of the feature (true or false).
 395      *
 396      * @throws SAXNotRecognizedException If the feature
 397      *   value can't be assigned or retrieved.
 398      * @throws SAXNotSupportedException When the
 399      *   {@link ValidatorHandler} recognizes the feature name but
 400      *   cannot set the requested value.
 401      * @throws NullPointerException When <code>name</code> is <code>null</code>.
 402      *




 362         throw new SAXNotRecognizedException(name);
 363     }
 364 
 365     /**
 366      * <p>Set a feature for this <code>ValidatorHandler</code>.</p>
 367      *
 368      * <p>Feature can be used to control the way a
 369      * {@link ValidatorHandler} parses schemas. The feature name is
 370      * any fully-qualified URI. It is possible for a
 371      * {@link SchemaFactory} to
 372      * expose a feature value but to be unable to change the current
 373      * value. Some feature values may be immutable or mutable only in
 374      * specific contexts, such as before, during, or after a
 375      * validation.</p>
 376      *
 377      * <p>All implementations are required to support the {@link javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING} feature.
 378      * When the feature is:</p>
 379      * <ul>
 380      *   <li>
 381      *     <code>true</code>: the implementation will limit XML processing to conform to implementation limits.
 382      *     Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources.
 383      *     If XML processing is limited for security reasons, it will be reported via a call to the registered
 384      *    {@link ErrorHandler#fatalError(SAXParseException exception)}.
 385      *     See {@link #setErrorHandler(ErrorHandler errorHandler)}.
 386      *   </li>
 387      *   <li>
 388      *     <code>false</code>: the implementation will processing XML according to the XML specifications without
 389      *     regard to possible implementation limits.
 390      *   </li>
 391      * </ul>
 392      *
 393      * @param name The feature name, which is a non-null fully-qualified URI.
 394      * @param value The requested value of the feature (true or false).
 395      *
 396      * @throws SAXNotRecognizedException If the feature
 397      *   value can't be assigned or retrieved.
 398      * @throws SAXNotSupportedException When the
 399      *   {@link ValidatorHandler} recognizes the feature name but
 400      *   cannot set the requested value.
 401      * @throws NullPointerException When <code>name</code> is <code>null</code>.
 402      *