com.saxonica.jaxp
Class SchemaFactoryImpl

java.lang.Object
  extended by javax.xml.validation.SchemaFactory
      extended by com.saxonica.jaxp.SchemaFactoryImpl

public class SchemaFactoryImpl
extends SchemaFactory

This is the Saxon implementation of the JAXP 1.3 SchemaFactory interface.


Constructor Summary
SchemaFactoryImpl()
          Default constructor.
SchemaFactoryImpl(SchemaAwareConfiguration config)
          Constructor supplying a SchemaAwareConfiguration
 
Method Summary
 SchemaAwareConfiguration 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, newSchema, newSchema, newSchema, setFeature
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SchemaFactoryImpl

public SchemaFactoryImpl()
Default constructor. This is designed to be invoked via the JAXP SchemaFactory.newInstance() mechanism, but it can also be invoked directly if the application will always be using the Saxon implementation. Instantiating a SchemaFactory directly in this way is likely to be a lot faster than the JAXP mechanism, because it avoid the expensive search of all JARs on the classpath.

This constructor creates a SchemaAwareConfiguration, and verifies that it is usable by checking that a license key is installed.


SchemaFactoryImpl

public SchemaFactoryImpl(SchemaAwareConfiguration config)
Constructor supplying a SchemaAwareConfiguration

Parameters:
config - The SchemaAwareConfiguration. The method verifies that this is usable by checking that a license key is available.
Method Detail

isSchemaLanguageSupported

public boolean isSchemaLanguageSupported(String language)
Tests whether a particular schema language is supported.

Specified by:
isSchemaLanguageSupported in class SchemaFactory
Parameters:
language - URI identifying the language (see JAXP specifications for details).
Returns:
true if the requested language is XML Schema (XMLConstants.W3C_XML_SCHEMA_NS_URI), otherwise false.

setErrorHandler

public void setErrorHandler(ErrorHandler errorHandler)
Set an error handler to which all schema processing and validation errors will be notified.

Specified by:
setErrorHandler in class SchemaFactory
Parameters:
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).

getErrorHandler

public ErrorHandler getErrorHandler()
Get the error handler in use

Specified by:
getErrorHandler in class SchemaFactory
Returns:
the error handler previously registered using setErrorHandler(org.xml.sax.ErrorHandler) if available; otherwise null.

setResourceResolver

public void setResourceResolver(LSResourceResolver lsResourceResolver)
Set a resolver to be used for dereferencing URIs encountered during schema processing and validation.

Specified by:
setResourceResolver in class SchemaFactory
Parameters:
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.

getResourceResolver

public LSResourceResolver getResourceResolver()
Get the resolver used for dereferencing URIs encountered during schema processing and validation.

Specified by:
getResourceResolver in class SchemaFactory
Returns:
the resolver in use. If no resolver has been registered, or if the resolver registered with the Configuration is not a wrapped LSResourceResolver, return null.

newSchema

public Schema newSchema(Source[] sources)
                 throws SAXException
Parses the specified source(s) as a schema and returns it as a schema.

The callee will read all the Sources 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.

W3C XML Schema 1.0

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.

RELAX NG

The Saxon implementation does not support RELAX NG.

Specified by:
newSchema in class SchemaFactory
Parameters:
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
Returns:
Always return a non-null valid Schema object. Note that when an error has been reported, there is no guarantee that the returned Schema object is meaningful.
Throws:
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.

newSchema

public Schema newSchema()
Returns the 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.

Specified by:
newSchema in class SchemaFactory
Returns:
Always return a non-null valid Schema object.

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException
Look up the value of a property.

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.

SchemaFactorys 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

Overrides:
getProperty in class SchemaFactory
Parameters:
name - The property name, which is a non-null fully-qualified URI.
Returns:
The current value of the property.
Throws:
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.
See Also:
setProperty(String, Object)

setProperty

public void setProperty(String name,
                        Object object)
                 throws SAXNotRecognizedException,
                        SAXNotSupportedException
Set the value of a property.

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

Overrides:
setProperty in class SchemaFactory
Parameters:
name - The property name, which is a non-null fully-qualified URI.
object - The requested value for the property.
Throws:
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.

getConfiguration

public SchemaAwareConfiguration getConfiguration()
Get the underlying Saxon Configuration object

Returns:
the underlying Saxon Configuration object, which will always be a SchemaAwareConfiguration


Copyright (C) Michael H. Kay. All rights reserved.