xml/validation/SchemaFactory.java

45  * {@link SchemaFactory} is a schema compiler. It reads external
63  * This spec uses a namespace URI to designate a schema language.
68  * if it chooses to support other schema languages listed here,
75  * implementations for other schema languages at run-time.
135      * but may support additional <a href="#schemaLanguage">schema languages</a>.
148      * schema language and return it.
150      * <p>To find a {@code SchemaFactory} object for a given schema language,
193      *   The first service provider found that supports the specified schema
213      * need to be escaped in a property file, so make sure schema language
220      *      Specifies the schema language which the returned
223      *      schema languages</a> for the possible values.
228      *      If no implementation of the schema language is available.
250                     + " that implements the schema language specified by: " + schemaLanguage
258      * is returned if specified factory class name supports the specified schema language.
273      * @param schemaLanguage Specifies the schema language which the returned
276      *                          schema languages</a> for the possible values.
288      *                   support the schema language specified in {@code schemLanguage}
309                     + " could not be loaded to implement the schema language specified by: " + schemaLanguage);
317                     + " does not implement the schema language specified by: " + schemaLanguage);
323      * Is specified schema supported by this {@code SchemaFactory}?
325      * @param schemaLanguage Specifies the schema language which the returned {@code SchemaFactory} will understand.
326      *    {@code schemaLanguage} must specify a <a href="#schemaLanguage">valid</a> schema language.
332      *   or {@code schemaLanguage} does not specify a <a href="#schemaLanguage">valid</a> schema language.
378      * schema come from different implementations, it may not be possible
531      * during schema parsing. When an {@link ErrorHandler} is set,
536      * The error handler can abort the parsing of a schema immediately
605      * up to each schema language. For example, for W3C XML Schema,
607      * and DTD referenced from schema files, etc.
658      * Parses the specified source as a schema and returns it as a schema.
662      * @param schema Source that represents a schema.
664      * @return New {@code Schema} from parsing {@code schema}.
667      * @throws NullPointerException if {@code schema} is null.
669     public Schema newSchema(Source schema) throws SAXException {
670         return newSchema(new Source[]{schema});
674      * Parses the specified {@code File} as a schema and returns it as a {@code Schema}.
676      * <p>This is a convenience method for {@link #newSchema(Source schema)}.
678      * @param schema File that represents a schema.
680      * @return New {@code Schema} from parsing {@code schema}.
683      * @throws NullPointerException if {@code schema} is null.
685     public Schema newSchema(File schema) throws SAXException {
686         return newSchema(new StreamSource(schema));
690      * Parses the specified {@code URL} as a schema and returns it as a {@code Schema}.
692      * <p>This is a convenience method for {@link #newSchema(Source schema)}.
694      * @param schema {@code URL} that represents a schema.
696      * @return New {@code Schema} from parsing {@code schema}.
699      * @throws NullPointerException if {@code schema} is null.
701     public Schema newSchema(URL schema) throws SAXException {
702         return newSchema(new StreamSource(schema.toExternalForm()));
706      * Parses the specified source(s) as a schema and returns it as a schema.
710      * single schema. The exact semantics of the combination depends on the schema
716      * abort the schema compilation and the same exception will be thrown from
723      * The resulting schema contains components from the specified sources.
726      * into a single schema document with a different targetNamespace
731      * JAXP schema sources and XML Schema imports, the behaviour between
776      *      If the schema language doesn't support this operation.
784      * depend on the schema language for which this {@link SchemaFactory}
795      * schema come from different implementations, it may not be possible
808      * refer to the same URL in the schema location hints,
809      * they will always resolve to the same schema document. This
811      * schema documents so that multiple validations against the same
812      * schema will run faster.
815      * Note that the use of schema location hints introduces a