| Set the
Schema to be used by parsers created
from this factory.
When a
Schema is non-null, a parser will use a validator
created from it to validate documents before it passes information
down to the application.
When warnings/errors/fatal errors are found by the validator, the parser must
handle them as if those errors were found by the parser itself.
In other words, if the user-specified
org.xml.sax.ErrorHandler is set, it must receive those errors, and if not, they must be
treated according to the implementation specific
default error handling rules.
A validator may modify the SAX event stream (for example by
adding default values that were missing in documents), and a parser
is responsible to make sure that the application will receive
those modified event stream.
Initialy, null is set as the
Schema .
This processing will take effect even if
the
SAXParserFactory.isValidating() method returns false.
It is an error to use
the http://java.sun.com/xml/jaxp/properties/schemaSource
property and/or the http://java.sun.com/xml/jaxp/properties/schemaLanguage
property in conjunction with a non-null
Schema object.
Such configuration will cause a
SAXException exception when those properties are set on a
SAXParser .
Note for implmentors
A parser must be able to work with any
Schema implementation. However, parsers and schemas are allowed
to use implementation-specific custom mechanisms
as long as they yield the result described in the specification.
Parameters:
schema - Schema to use, null to remove a schema.
throws:
UnsupportedOperationException - When implementation does notoverride this method
since:
1.5 | 