|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object javax.xml.validation.SchemaFactory com.saxonica.jaxp.SchemaFactoryImpl
public class SchemaFactoryImpl
This is the Saxon implementation of the JAXP 1.3 SchemaFactory interface.
Constructor Summary | |
---|---|
SchemaFactoryImpl()
Default constructor. |
|
SchemaFactoryImpl(EnterpriseConfiguration config)
Constructor supplying an EnterpriseConfiguration |
Method Summary | |
---|---|
EnterpriseConfiguration |
getConfiguration()
Get the underlying Saxon Configuration object |
ErrorHandler |
getErrorHandler()
Get the error handler in use |
Object |
getProperty(String name)
Look up the value of a property. |
LSResourceResolver |
getResourceResolver()
Get the resolver used for dereferencing URIs encountered during schema processing and validation. |
boolean |
isSchemaLanguageSupported(String language)
Tests whether a particular schema language is supported. |
Schema |
newSchema()
Returns the Schema object containing all the schema components
that have been loaded using the newSchema(javax.xml.transform.Source[]) method. |
Schema |
newSchema(Source[] sources)
Parses the specified source(s) as a schema and returns it as a schema. |
void |
setErrorHandler(ErrorHandler errorHandler)
Set an error handler to which all schema processing and validation errors will be notified. |
void |
setProperty(String name,
Object object)
Set the value of a property. |
void |
setResourceResolver(LSResourceResolver lsResourceResolver)
Set a resolver to be used for dereferencing URIs encountered during schema processing and validation. |
Methods inherited from class javax.xml.validation.SchemaFactory |
---|
getFeature, newInstance, newInstance, newSchema, newSchema, newSchema, setFeature |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public SchemaFactoryImpl()
This constructor creates an EnterpriseConfiguration, and verifies that it is usable by checking that a license key is installed.
public SchemaFactoryImpl(EnterpriseConfiguration config)
config
- The EnterpriseConfiguration. The method verifies that this is usable by checking that
a license key is available.Method Detail |
---|
public boolean isSchemaLanguageSupported(String language)
isSchemaLanguageSupported
in class SchemaFactory
language
- URI identifying the language (see JAXP specifications for details).
public void setErrorHandler(ErrorHandler errorHandler)
setErrorHandler
in class SchemaFactory
errorHandler
- The requested error handler. Note that this will be wrapped in an ErrorListener
and registered with the Configuration, overwriting any other ErrorListener that was previously
registered with the Configuration. (Equally, any call to setErrorListener() on the Configuration
will replace this ErrorHandler).public ErrorHandler getErrorHandler()
getErrorHandler
in class SchemaFactory
setErrorHandler(org.xml.sax.ErrorHandler)
if available; otherwise
null.public void setResourceResolver(LSResourceResolver lsResourceResolver)
setResourceResolver
in class SchemaFactory
lsResourceResolver
- The resolver to be used. This is wrapped in a URIResolver and registered
with the Configuration, overwriting any URIResolver or SchemaURIResolver that was previously
registered with the Configuration. Equally, any subsequent call on setURIResolver() or
setSchemaURIResolver() on the Configuration object will replace the resolver registered using
this method.public LSResourceResolver getResourceResolver()
getResourceResolver
in class SchemaFactory
public Schema newSchema(Source[] sources) throws SAXException
The callee will read all the Source
s and combine them into a
single schema. The exact semantics of the combination depends on the schema
language that this SchemaFactory
object is created for.
When an ErrorHandler
is set, the callee will report all the errors
found in sources to the handler. If the handler throws an exception, it will
abort the schema compilation and the same exception will be thrown from
this method. Also, after an error is reported to a handler, the callee is allowed
to abort the further processing by throwing it. If an error handler is not set,
the callee will throw the first error it finds in the sources.
The resulting schema contains components from the specified sources. The same result would be achieved if all these sources were imported, using appropriate values for schemaLocation and namespace, into a single schema document with a different targetNamespace and no components of its own, if the import elements were given in the same order as the sources. Section 4.2.3 of the XML Schema recommendation describes the options processors have in this regard. While a processor should be consistent in its treatment of JAXP schema sources and XML Schema imports, the behaviour between JAXP-compliant parsers may vary; in particular, parsers may choose to ignore all but the first <import> for a given namespace, regardless of information provided in schemaLocation.
If the parsed set of schemas includes error(s) as
specified in the section 5.1 of the XML Schema spec, then
the error must be reported to the ErrorHandler
.
The Saxon implementation does not support RELAX NG.
newSchema
in class SchemaFactory
sources
- inputs to be parsed as schema documents. The Saxon implementation recognizes not only
the standard SAXSource
,
StreamSource
, and DOMSource
,
but also any implementation of NodeInfo
Schema
object.
Note that when an error has been reported, there is no
guarantee that the returned Schema
object is
meaningful.
SAXException
- If an error is found during processing the specified inputs.
When an ErrorHandler
is set, errors are reported to
there first. See setErrorHandler(ErrorHandler)
. In the Saxon
implementation, if a SAXException is thrown, it will always wrap
an instance of SchemaException
NullPointerException
- If the schemas
parameter itself is null or
any item in the array is null.
IllegalArgumentException
- If any item in the array is not recognized by this method.public Schema newSchema()
Schema
object containing all the schema components
that have been loaded using the newSchema(javax.xml.transform.Source[])
method. If no schema
components have been loaded, the schema can still be used to validate
source documents provided that they specify the location of the required
schema components using the xsi:schemaLocation attribute.
The returned Schema
object assumes that if documents
refer to the same URL in the schema location hints,
they will always resolve to the same schema document. This
asusmption allows implementations to reuse parsed results of
schema documents so that multiple validations against the same
schema will run faster.
Note that the use of schema location hints introduces a vulnerability to denial-of-service attacks.
newSchema
in class SchemaFactory
Schema
object.public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException
The property name is any fully-qualified URI. It is
possible for a SchemaFactory
to recognize a property name but
temporarily be unable to return its value.
SchemaFactory
s are not required to recognize any specific
property names.
In the Saxon implementation, the property names that are recognized are the same as the
attribute names recognised by a TransformerFactory
.
These are listed as constant fields
in the class FeatureKeys
getProperty
in class SchemaFactory
name
- The property name, which is a non-null fully-qualified URI.
SAXNotRecognizedException
- If the property
value can't be assigned or retrieved.
SAXNotSupportedException
- When the
XMLReader recognizes the property name but
cannot determine its value at this time.
NullPointerException
- if the name parameter is null.setProperty(String, Object)
public void setProperty(String name, Object object) throws SAXNotRecognizedException, SAXNotSupportedException
The property name is any fully-qualified URI. It is
possible for a SchemaFactory
to recognize a property name but
to be unable to change the current value.
In the Saxon implementation, the property names that are recognized are the same as the
attribute names recognised by a TransformerFactory
.
These are listed as constant fields
in the class FeatureKeys
setProperty
in class SchemaFactory
name
- The property name, which is a non-null fully-qualified URI.object
- The requested value for the property.
SAXNotRecognizedException
- If the property
value can't be assigned or retrieved.
SAXNotSupportedException
- When the
SchemaFactory
recognizes the property name but
cannot set the requested value.
NullPointerException
- if the name parameter is null.public EnterpriseConfiguration getConfiguration()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |