com.saxonica.schema
Class SchemaCompiler

java.lang.Object
  extended by com.saxonica.schema.SchemaCompiler
All Implemented Interfaces:
ISchemaCompiler

public class SchemaCompiler
extends Object
implements ISchemaCompiler

A SchemaCompiler is capable of reading source schema documents and converting them into collections of schema components. The Compiler holds all the options relating to schema compilation, including maintaining information about the schema documents involved in a compilation.

A default SchemaCompiler is available as part of the SchemaAwareConfiguration

Since:
8.9

Constructor Summary
SchemaCompiler(SchemaAwareConfiguration config)
          Create a SchemaCompiler
 
Method Summary
 void addPendingTypeCheck(IdentityConstraint constraint, SchemaType contextItemType)
          Register an identity constraint that needs to be type-checked
 void error(String message, SourceLocator locator)
          Report an error
 SchemaAwareConfiguration getConfiguration()
          Get the configuration
 int getErrorCount()
          Test whether errors have been reported
 ErrorListener getErrorListener()
          Get the ErrorListener used in this configuration.
 XSDSchema getExistingSchemaDocument(String systemId)
          Get the root element of the tree representing a schema document that has already been read
 NamePool getNamePool()
          Get the NamePool
 int[] getOccurrenceLimits()
          Get the occurrence limits previously set using setOccurrenceLimits (or the default)
 PipelineConfiguration getPipelineConfiguration()
          Get the pipeline configuration
 PreparedSchema getPreparedSchema()
          Get the PreparedSchema.
 SchemaURIResolver getSchemaURIResolver()
          Get the user-defined SchemaURIResolver for resolving URIs used in "import schema" declarations; if none has been explicitly set, returns the standard schema URI resolver.
 boolean isBeingRead(String systemId)
          Determine whether a particular URI is currently being read
 void markAsRead(String systemId, XSDSchema schema)
          Mark a document as having been read
 String readInlineSchema(NodeInfo root, String expected, ErrorListener errorListener)
          Read an inline schema from a stylesheet
 void readMultipleSchemas(PipelineConfiguration pipe, String baseURI, List schemaLocations, String expected)
          Read schemas from a list of schema locations
 String readSchema(PipelineConfiguration pipe, String baseURI, String schemaLocation, String expected)
          Read a schema from a given schema location
 void setBeingRead(String systemId)
          Mark a URI as currently being read
 void setErrorListener(ErrorListener listener)
          Set the ErrorListener to be used in this compiler.
 void setOccurrenceLimits(int minimum, int maximum)
          Set the occurrence limits to be used when compiling a finite state automaton.
 void setPipelineConfiguration(PipelineConfiguration pipelineConfiguration)
          Set the pipeline configuration
 void setPreparedSchema(PreparedSchema schema)
          Set the PreparedSchema.
 void typeCheckIdentityConstraints()
          Do all the pending type-checking
 PreparedSchema validate(SchemaDocument doc)
          Validate the schema represented by a schema document.
 void warning(String message, SourceLocator locator)
          Report a warning
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SchemaCompiler

public SchemaCompiler(SchemaAwareConfiguration config)
Create a SchemaCompiler

Parameters:
config - the Saxon Configuration
Method Detail

getConfiguration

public SchemaAwareConfiguration getConfiguration()
Get the configuration

Returns:
the configuration (which is always schema-aware)

getNamePool

public NamePool getNamePool()
Get the NamePool

Returns:
the name pool

setPreparedSchema

public void setPreparedSchema(PreparedSchema schema)
Set the PreparedSchema. Used when validating a schema loaded using the SchemaModelLoader

Parameters:
schema - the schema that has been loaded

getPreparedSchema

public PreparedSchema getPreparedSchema()
Get the PreparedSchema. This is a callback available only during a schema validation episode

Returns:
the PreparedSchema containing all the schema components

getErrorListener

public ErrorListener getErrorListener()
Get the ErrorListener used in this configuration. If no ErrorListener has been supplied explicitly, the default ErrorListener is used.

Returns:
the ErrorListener.
Since:
8.9

setErrorListener

public void setErrorListener(ErrorListener listener)
Set the ErrorListener to be used in this compiler. The ErrorListener is informed of all errors detected during schema processing.

Parameters:
listener - the ErrorListener to be used
Since:
8.9

getErrorCount

public int getErrorCount()
Test whether errors have been reported

Returns:
the number of errors reported

setOccurrenceLimits

public void setOccurrenceLimits(int minimum,
                                int maximum)
Set the occurrence limits to be used when compiling a finite state automaton.

Parameters:
minimum - The highest value of minOccurs that will be strictly enforced. If the actual value of minOccurs in a schema is higher than this value, it will be treated as if this value had been specified. The default is 100.
maximum - The highest value of maxOccurs that will be strictly enforced. If the actual value of maxOccurs in a schema is higher than this value, it will be treated as if "unbounded" had been specified. The default is 250.
Since:
8.9

getOccurrenceLimits

public int[] getOccurrenceLimits()
Get the occurrence limits previously set using setOccurrenceLimits (or the default)

Returns:
an array of two integers, the minimum occurrence limit and the maximum occurrence limit
Since:
8.9

setBeingRead

public void setBeingRead(String systemId)
Mark a URI as currently being read

Parameters:
systemId - the URI of the schema document being read

isBeingRead

public boolean isBeingRead(String systemId)
Determine whether a particular URI is currently being read

Parameters:
systemId - the URI of the document in question
Returns:
true if the document is currently being read

markAsRead

public void markAsRead(String systemId,
                       XSDSchema schema)
Mark a document as having been read

Parameters:
systemId - the URI of the schema document that has been read
schema - the root element of the schema document contstructed from this URI

getExistingSchemaDocument

public XSDSchema getExistingSchemaDocument(String systemId)
Get the root element of the tree representing a schema document that has already been read

Parameters:
systemId - the URI of the required schema document
Returns:
the root element of the tree representing this schema document

getPipelineConfiguration

public PipelineConfiguration getPipelineConfiguration()
Get the pipeline configuration

Returns:
the pipeline configuration

setPipelineConfiguration

public void setPipelineConfiguration(PipelineConfiguration pipelineConfiguration)
Set the pipeline configuration

Parameters:
pipelineConfiguration - the pipeline configuration

getSchemaURIResolver

public SchemaURIResolver getSchemaURIResolver()
Get the user-defined SchemaURIResolver for resolving URIs used in "import schema" declarations; if none has been explicitly set, returns the standard schema URI resolver.

Returns:
the SchemaURIResolver

readSchema

public String readSchema(PipelineConfiguration pipe,
                         String baseURI,
                         String schemaLocation,
                         String expected)
                  throws SchemaException
Read a schema from a given schema location

Parameters:
pipe - the pipeline configuration
baseURI - the base URI for resolving relative URIs
schemaLocation - the location "hint" where to find the schema document. Must not be null.
expected - the target namespace expected; null if there is no expectation
Returns:
the actual target namespace of the schema
Throws:
SchemaException

readMultipleSchemas

public void readMultipleSchemas(PipelineConfiguration pipe,
                                String baseURI,
                                List schemaLocations,
                                String expected)
                         throws SchemaException
Read schemas from a list of schema locations

Parameters:
pipe - the PipelineConfiguration
baseURI - the base URI for resolving relative URIs
schemaLocations - the list of location "hints" where to find the schema document. Must not be null.
expected - the target namespace expected in each of the schema documents; null if there is no expectation
Throws:
SchemaException

readInlineSchema

public String readInlineSchema(NodeInfo root,
                               String expected,
                               ErrorListener errorListener)
                        throws SchemaException
Read an inline schema from a stylesheet

Parameters:
root - the xs:schema element in the stylesheet
expected - the target namespace expected; "" if there is no expectation
errorListener - The destination for error messages. May be null, in which case the errorListener registered with this Configuration is used.
Returns:
the actual target namespace of the schema
Throws:
SchemaException

validate

public PreparedSchema validate(SchemaDocument doc)
                        throws SchemaException
Validate the schema represented by a schema document. This method validates the schema components associated with this schema document: that is, the components defined in this document, together with any components referenced by these components if they have not already been validated.

Parameters:
doc - the schema document to be validated
Returns:
schema the schema, if it is valid
Throws:
SchemaException - if the schema is invalid

error

public void error(String message,
                  SourceLocator locator)
           throws SchemaException
Report an error

Parameters:
message - the error message
locator - the location of the error
Throws:
SchemaException

warning

public void warning(String message,
                    SourceLocator locator)
Report a warning

Parameters:
message - the warning message
locator - the location of the error

addPendingTypeCheck

public void addPendingTypeCheck(IdentityConstraint constraint,
                                SchemaType contextItemType)
Register an identity constraint that needs to be type-checked

Parameters:
constraint - the constraint to be checked
contextItemType - the type of the context node for the XPath expression to be checked

typeCheckIdentityConstraints

public void typeCheckIdentityConstraints()
Do all the pending type-checking



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