src/javax/xml/validation/SchemaFactory.java

Print this page




 341      *
 342      * <p>Implementors and developers should pay particular attention
 343      * to how the special {@link Schema} object returned by {@link
 344      * #newSchema()} is processed. In some cases, for example, when the
 345      * <code>SchemaFactory</code> and the class actually loading the
 346      * schema come from different implementations, it may not be possible
 347      * for <code>SchemaFactory</code> features to be inherited automatically.
 348      * Developers should
 349      * make sure that features, such as secure processing, are explicitly
 350      * set in both places.</p>
 351      *
 352      * <p>The feature name is any fully-qualified URI. It is
 353      * possible for a {@link SchemaFactory} to expose a feature value but
 354      * to be unable to change the current value.</p>
 355      *
 356      * <p>All implementations are required to support the {@link javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING} feature.
 357      * When the feature is:</p>
 358      * <ul>
 359      *   <li>
 360      *     <code>true</code>: the implementation will limit XML processing to conform to implementation limits.
 361      *     Examples include enity expansion limits and XML Schema constructs that would consume large amounts of resources.
 362      *     If XML processing is limited for security reasons, it will be reported via a call to the registered
 363      *    {@link ErrorHandler#fatalError(SAXParseException exception)}.
 364      *     See {@link #setErrorHandler(ErrorHandler errorHandler)}.
 365      *   </li>
 366      *   <li>
 367      *     <code>false</code>: the implementation will processing XML according to the XML specifications without
 368      *     regard to possible implementation limits.
 369      *   </li>
 370      * </ul>
 371      *
 372      * @param name The feature name, which is a non-null fully-qualified URI.
 373      * @param value The requested value of the feature (true or false).
 374      *
 375      * @throws SAXNotRecognizedException If the feature
 376      *   value can't be assigned or retrieved.
 377      * @throws SAXNotSupportedException When the
 378      *   {@link SchemaFactory} recognizes the feature name but
 379      *   cannot set the requested value.
 380      * @throws NullPointerException If <code>name</code> is <code>null</code>.
 381      *




 341      *
 342      * <p>Implementors and developers should pay particular attention
 343      * to how the special {@link Schema} object returned by {@link
 344      * #newSchema()} is processed. In some cases, for example, when the
 345      * <code>SchemaFactory</code> and the class actually loading the
 346      * schema come from different implementations, it may not be possible
 347      * for <code>SchemaFactory</code> features to be inherited automatically.
 348      * Developers should
 349      * make sure that features, such as secure processing, are explicitly
 350      * set in both places.</p>
 351      *
 352      * <p>The feature name is any fully-qualified URI. It is
 353      * possible for a {@link SchemaFactory} to expose a feature value but
 354      * to be unable to change the current value.</p>
 355      *
 356      * <p>All implementations are required to support the {@link javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING} feature.
 357      * When the feature is:</p>
 358      * <ul>
 359      *   <li>
 360      *     <code>true</code>: the implementation will limit XML processing to conform to implementation limits.
 361      *     Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources.
 362      *     If XML processing is limited for security reasons, it will be reported via a call to the registered
 363      *    {@link ErrorHandler#fatalError(SAXParseException exception)}.
 364      *     See {@link #setErrorHandler(ErrorHandler errorHandler)}.
 365      *   </li>
 366      *   <li>
 367      *     <code>false</code>: the implementation will processing XML according to the XML specifications without
 368      *     regard to possible implementation limits.
 369      *   </li>
 370      * </ul>
 371      *
 372      * @param name The feature name, which is a non-null fully-qualified URI.
 373      * @param value The requested value of the feature (true or false).
 374      *
 375      * @throws SAXNotRecognizedException If the feature
 376      *   value can't be assigned or retrieved.
 377      * @throws SAXNotSupportedException When the
 378      *   {@link SchemaFactory} recognizes the feature name but
 379      *   cannot set the requested value.
 380      * @throws NullPointerException If <code>name</code> is <code>null</code>.
 381      *