Overview | Package | Class | Deprecated | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.saxonica.jaxp
Class SchemaFactoryImpl

    java.lang.Object
      javax.xml.validation.SchemaFactory
          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 `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.

  ## 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.

  `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`

  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

Overview | Package | Class | Deprecated | Help
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

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