net.sf.saxon
public class Configuration extends Object implements Serializable, SourceResolver
Since Saxon 8.4, the JavaDoc documentation for Saxon attempts to identify interfaces that are considered stable, and will only be changed in a backwards-incompatible way if there is an overriding reason to do so. These interfaces and methods are labelled with the JavaDoc "since" tag. The value 8.n indicates a method in this category that was introduced in Saxon version 8.n: or in the case of 8.4, that was present in Saxon 8.4 and possibly in earlier releases. (In some cases, these methods have been unchanged for a long time.) Methods without a "since" tag, although public, are provided for internal use or for use by advanced users, and are subject to change from one release to the next. The presence of a "since" tag on a class or interface indicates that there are one or more methods in the class that are considered stable; it does not mean that all methods are stable.
Since: 8.4
Field Summary | |
---|---|
static int | DO_NOT_RECOVER
Constant indicating that when a recoverable error occurs, the
processor should not attempt to take the defined recovery action,
but should terminate with an error. |
static int | JAVA_APPLICATION
Constant indicating that the host language is Java: that is, this is a free-standing
Java application with no XSLT or XQuery content |
protected ErrorListener | listener |
protected Optimizer | optimizer |
protected int | recoveryPolicy |
static int | RECOVER_SILENTLY
Constant indicating that the processor should take the recovery action
when a recoverable error occurs, with no warning message. |
static int | RECOVER_WITH_WARNINGS
Constant indicating that the processor should produce a warning
when a recoverable error occurs, and should then take the recovery
action and continue. |
protected VendorFunctionLibrary | vendorFunctionLibrary |
static int | XML10
Constant indicating the XML Version 1.0 |
static int | XML11
Constant indicating the XML Version 1.1 |
static int | XML_SCHEMA
Constant indicating that the "host language" is XML Schema |
static int | XPATH
Constant indicating that the host language is XPATH itself - that is, a free-standing XPath environment |
static int | XQUERY
Constant indicating that the host language is XQuery |
static int | XSLT
Constant indicating that the host language is XSLT |
Constructor Summary | |
---|---|
Configuration()
Create a configuration object with default settings for all options. |
Method Summary | |
---|---|
void | addSchema(Object schema)
Add a schema to the cache.
|
void | addSchemaSource(Source schemaSource)
Load a schema, which will be available for use by all subsequent operations using
this Configuration. |
boolean | areAllNodesUntyped()
Determine whether all nodes encountered within this query or transformation are guaranteed to be
untyped |
void | displayLicenseMessage()
Display a message about the license status |
ExternalObjectModel | findExternalObjectModel(Object node)
Find the external object model corresponding to a given node.
|
Receiver | getAnnotationStripper(Receiver destination)
Add to a pipeline a receiver that strips all type annotations. |
SchemaDeclaration | getAttributeDeclaration(int fingerprint)
Get a global attribute declaration.
|
Class | getClass(String className, boolean tracing, ClassLoader classLoader)
Load a class using the class name provided.
|
ClassLoader | getClassLoader()
Get the ClassLoader supplied using the method Configuration.
|
CollationURIResolver | getCollationURIResolver()
Get the collation URI resolver associated with this configuration. |
CollectionURIResolver | getCollectionURIResolver()
Get the collection URI resolver associated with this configuration. |
static Configuration | getConfiguration(XPathContext context)
Get the configuration, given the context. |
Object | getConfigurationProperty(String name)
Get a property of the configuration |
XPathContext | getConversionContext()
Get an XPathContext object with sufficient capability to perform comparisons and conversions |
Debugger | getDebugger()
Get the debugger in use. |
DocumentNumberAllocator | getDocumentNumberAllocator()
Get the document number allocator.
|
Receiver | getDocumentValidator(Receiver receiver, String systemId, NamePool namePool, int validationMode, int stripSpace, SchemaType schemaType)
Get a document-level validator to add to a Receiver pipeline.
|
SchemaDeclaration | getElementDeclaration(int fingerprint)
Get a global element declaration.
|
Receiver | getElementValidator(Receiver receiver, int nameCode, int locationId, SchemaType schemaType, int validation, NamePool pool)
Get a Receiver that can be used to validate an element, and that passes the validated
element on to a target receiver. |
ErrorListener | getErrorListener()
Get the ErrorListener used in this configuration. |
FunctionLibrary | getExtensionBinder()
Get the FunctionLibrary used to bind calls on extension functions.
|
ExtensionFunctionFactory | getExtensionFunctionFactory()
Get an ExtensionFunctionFactory. |
List | getExternalObjectModels()
Get all the registered external object models.
|
int | getHostLanguage()
Get the host language used in this configuration. |
int | getImplicitTimezone()
Get the implicit timezone, as a positive or negative offset from UTC in minutes.
|
Set | getImportedNamespaces()
Get the set of namespaces of imported schemas |
Object | getInstance(String className, ClassLoader classLoader)
Instantiate a class using the class name provided.
|
static Locale | getLocale(String lang)
Get a locale given a language code in XML format.
|
String | getMessageEmitterClass()
Get the name of the class that will be instantiated to create a MessageEmitter,
to process the output of xsl:message instructions in XSLT. |
ModuleURIResolver | getModuleURIResolver()
Get the user-defined ModuleURIResolver for resolving URIs used in "import module"
declarations in the XQuery prolog; returns null if none has been explicitly set. |
NameChecker | getNameChecker()
Get a class that can be used to check names against the selected XML version |
NamePool | getNamePool()
Get the target namepool to be used for stylesheets/queries and for source documents. |
Optimizer | getOptimizer()
Factory method to get an Optimizer.
|
Receiver | getOutputMethod(String clarkName)
Get a configuration-defined output method. |
OutputURIResolver | getOutputURIResolver()
Get the OutputURIResolver that will be used to resolve URIs used in the
href attribute of the xsl:result-document instruction. |
Platform | getPlatform()
Get the Platform to be used for platform-dependent methods |
String | getProductTitle()
Get a message used to identify this product when a transformation is run using the -t option |
int | getRecoveryPolicy()
Determine how recoverable run-time errors are to be handled. |
Object | getSchema(String namespace)
Get a schema from the cache. |
SchemaType | getSchemaType(int fingerprint)
Get the top-level schema type definition with a given fingerprint.
|
SchemaURIResolver | getSchemaURIResolver()
Get the user-defined SchemaURIResolver for resolving URIs used in "import schema"
declarations; if none has been explicitly set, returns null. |
int | getSchemaValidationMode()
Determine whether source documents (supplied as a StreamSource or SAXSource)
should be subjected to schema validation |
XMLReader | getSourceParser()
Get a parser for source documents. |
String | getSourceParserClass()
Get the name of the class that will be instantiated to create an XML parser
for parsing source documents (for example, documents loaded using the document()
or doc() functions).
|
SourceResolver | getSourceResolver()
Get the current SourceResolver. |
ModuleURIResolver | getStandardModuleURIResolver()
Get the standard system-defined ModuleURIResolver for resolving URIs used in "import module"
declarations in the XQuery prolog. |
int | getStripsWhiteSpace()
Set which kinds of whitespace-only text node should be stripped. |
XMLReader | getStyleParser()
Get the parser for stylesheet documents. |
String | getStyleParserClass()
Get the name of the class that will be instantiated to create an XML parser
for parsing stylesheet modules.
|
StandardURIResolver | getSystemURIResolver()
Get the system-defined URI Resolver. |
TraceListener | getTraceListener()
Get the TraceListener used for run-time tracing of instruction execution. |
int | getTreeModel()
Get the Tree Model used by this Configuration. |
URIResolver | getURIResolver()
Get the URIResolver used in this configuration |
VendorFunctionLibrary | getVendorFunctionLibrary()
Get the FunctionLibrary used to bind calls on Saxon-defined extension functions.
|
int | getXMLVersion()
Get the XML version to be used by default for validating characters and names |
protected void | init() |
boolean | isAllowExternalFunctions()
Determine whether calls to external Java functions are permitted. |
boolean | isLazyConstructionMode()
Determine whether lazy construction mode is on or off. |
boolean | isLineNumbering()
Determine whether source documents will maintain line numbers, for the
benefit of the saxon:line-number() extension function as well as run-time
tracing. |
boolean | isMultiThreading()
Determine whether multithreading optimizations are allowed |
boolean | isRetainDTDAttributeTypes()
Determine whether attribute types obtained from a DTD are to be used to set type annotations
on the resulting nodes
|
boolean | isSchemaAware(int language)
Determine if the configuration is schema-aware, for the given host language |
boolean | isSealedNamespace(String namespace)
Test whether a schema namespace is sealed. |
boolean | isStripsAllWhiteSpace()
Determine whether whitespace-only text nodes are to be stripped unconditionally
from source documents. |
boolean | isTiming()
Determine whether brief progress messages and timing information will be output
to System.err.
|
boolean | isTraceExternalFunctions()
Determine whether calls on external functions are to be traced for diagnostic
purposes. |
boolean | isValidation()
Determine whether the XML parser for source documents will be asked to perform
DTD validation of source documents |
boolean | isValidationWarnings()
Determine whether schema validation failures on result documents are to be treated
as fatal errors or as warnings. |
boolean | isVersionWarning()
Determine whether a warning is to be output when running against a stylesheet labelled
as version="1.0". |
Comparator | makeCollator(String className)
Load a named collator class and check it is OK.
|
XMLReader | makeParser(String className)
Create a new SAX XMLReader object using the class name provided. |
PipelineConfiguration | makePipelineConfiguration()
Make a PipelineConfiguration from the properties of this Configuration |
static Configuration | makeSchemaAwareConfiguration(ClassLoader classLoader)
Static method to instantiate a schema-aware configuration. |
SlotManager | makeSlotManager()
Factory method to create a SlotManager.
|
NodeTest | makeSubstitutionGroupTest(SchemaDeclaration elementDecl)
Make a test for elements corresponding to a give element declaration.
|
TraceListener | makeTraceListener(String className) Create an instance of a TraceListener with a specified class name
|
URIResolver | makeURIResolver(String className)
Create an instance of a URIResolver with a specified class name
|
String | readInlineSchema(NodeInfo root, String expected)
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 | registerExternalObjectModel(ExternalObjectModel model)
Register an external object model with this Configuration. |
void | reportFatalError(XPathException err)
Report a fatal error |
Source | resolveSource(Source source, Configuration config)
Implement the SourceResolver interface |
void | reuseSourceParser(XMLReader parser)
Return a source parser to the pool, for reuse |
void | reuseStyleParser(XMLReader parser)
Return a stylesheet (or schema) parser to the pool, for reuse |
void | sealNamespace(String namespace)
Mark a schema namespace as being sealed. |
void | setAllNodesUntyped(boolean allUntyped)
Specify that all nodes encountered within this query or transformation will be untyped |
void | setAllowExternalFunctions(boolean allowExternalFunctions)
Determine whether calls to external Java functions are permitted. |
void | setClassLoader(ClassLoader loader)
Set a ClassLoader to be used when loading external classes. |
void | setCollationURIResolver(CollationURIResolver resolver)
Set a CollationURIResolver to be used to resolve collation URIs (that is,
to take a URI identifying a collation, and return the corresponding collation).
|
void | setCollectionURIResolver(CollectionURIResolver resolver)
Set a CollectionURIResolver to be used to resolve collection URIs (that is,
the URI supplied in a call to the collection() function).
|
void | setConfigurationProperty(String name, Object value)
Set a property of the configuration. |
void | setDebugger(Debugger debugger)
Set the debugger to be used.
|
void | setErrorListener(ErrorListener listener)
Set the ErrorListener to be used in this configuration. |
void | setExtensionBinder(FunctionLibrary binder)
Set the FunctionLibrary used to bind calls on extension functions. |
void | setExtensionFunctionFactory(ExtensionFunctionFactory factory)
Set an ExtensionFunctionFactory. |
void | setHostLanguage(int hostLanguage)
Set the host language used in this configuration. |
void | setImplicitTimezone(int minutes)
Set the implicit timezone, as a positive or negative offset from UTC in minutes.
|
void | setLazyConstructionMode(boolean lazy)
Set lazy construction mode on or off. |
void | setLineNumbering(boolean lineNumbering)
Determine whether source documents will maintain line numbers, for the
benefit of the saxon:line-number() extension function as well as run-time
tracing. |
void | setMessageEmitterClass(String messageEmitterClass)
Set the name of the class that will be instantiated to create a MessageEmitter,
to process the output of xsl:message instructions in XSLT. |
void | setModuleURIResolver(ModuleURIResolver resolver)
Set a user-defined ModuleURIResolver for resolving URIs used in "import module"
declarations in an XQuery prolog.
|
void | setModuleURIResolver(String className)
Create and register an instance of a ModuleURIResolver with a specified class name.
|
void | setMultiThreading(boolean multithreading)
Set whether multithreading optimizations are allowed |
void | setNamePool(NamePool targetNamePool)
Set the NamePool to be used for stylesheets/queries and for source documents.
|
void | setOutputURIResolver(OutputURIResolver outputURIResolver)
Set the OutputURIResolver that will be used to resolve URIs used in the
href attribute of the xsl:result-document instruction. |
void | setPlatform(Platform platform)
Set the Platform to be used for platform-dependent methods |
void | setRecoveryPolicy(int recoveryPolicy)
Determine how recoverable run-time errors are to be handled. |
void | setRetainDTDAttributeTypes(boolean useTypes)
Determine whether attribute types obtained from a DTD are to be used to set type annotations
on the resulting nodes.
|
void | setSchemaURIResolver(SchemaURIResolver resolver)
Set a user-defined SchemaURIResolver for resolving URIs used in "import schema"
declarations. |
void | setSchemaValidationMode(int validationMode)
Indicate whether source documents (supplied as a StreamSource or SAXSource)
should be subjected to schema validation |
void | setSourceParserClass(String sourceParserClass)
Set the name of the class that will be instantiated to create an XML parser
for parsing source documents (for example, documents loaded using the document()
or doc() functions).
|
void | setSourceResolver(SourceResolver resolver)
Supply a SourceResolver |
void | setStripsAllWhiteSpace(boolean stripsAllWhiteSpace)
Determine whether whitespace-only text nodes are to be stripped unconditionally
from source documents. |
void | setStripsWhiteSpace(int kind)
Set which kinds of whitespace-only text node should be stripped. |
void | setStyleParserClass(String styleParserClass)
Set the name of the class that will be instantiated to create an XML parser
for parsing stylesheet modules.
|
void | setTiming(boolean timing)
Determine whether brief progress messages and timing information will be output
to System.err.
|
void | setTraceExternalFunctions(boolean traceExternalFunctions)
Determine whether calls on external functions are to be traced for diagnostic
purposes. |
void | setTraceListener(TraceListener traceListener)
Set the TraceListener to be used for run-time tracing of instruction execution. |
void | setTreeModel(int treeModel)
Set the Tree Model used by this Configuration. |
void | setURIResolver(URIResolver resolver)
Set the URIResolver to be used in this configuration. |
void | setValidation(boolean validation)
Determine whether the XML parser for source documents will be asked to perform
DTD validation of source documents |
void | setValidationWarnings(boolean warn)
Indicate whether schema validation failures on result documents are to be treated
as fatal errors or as warnings.
|
void | setVersionWarning(boolean warn)
Determine whether a warning is to be output when running against a stylesheet labelled
as version="1.0". |
void | setXMLVersion(int version)
Set the XML version to be used by default for validating characters and names |
int | validateAttribute(int nameCode, CharSequence value, int validation)
Validate an attribute value.
|
new Configuration(true)
.Since: 8.4
This method is intended for internal use
Parameters: schema an object of class javax.xml.validation.schema, which is not declared as such to avoid creating a dependency on this JDK 1.5 class
Parameters: schemaSource the JAXP Source object identifying the schema document to be loaded
Throws: SchemaException if the schema cannot be read or parsed or if it is invalid UnsupportedOperationException if the configuration is not schema-aware
Since: 8.4
This method is intended for internal use only.
Parameters: node a Node as implemented in some external object model
Returns: the first registered external object model that recognizes this node; or null if no-one will own up to it.
This method is intended for internal use.
This method is intended for internal use
Returns: the attribute declaration whose name matches the given fingerprint, or null if no element declaration with this name has been registered.
This method is intended for internal use only.
Parameters: className A string containing the name of the class, for example "com.microstar.sax.LarkDriver" classLoader The ClassLoader to be used to load the class. If this is null, then the classLoader used will be the first one available of: the classLoader registered with the Configuration using Configuration; the context class loader for the current thread; or failing that, the class loader invoked implicitly by a call of Class.forName() (which is the ClassLoader that was used to load the Configuration object itself).
Returns: an instance of the class named, or null if it is not loadable.
Throws: XPathException if the class cannot be loaded.
This method is intended for external use by advanced users, but should be regarded as experimental.
Returns: the registered CollationURIResolver
Since: 8.5
Returns: the registered CollationURIResolver
Since: 8.5
Parameters: name the name of the required property
Returns: the value of the property
Throws: IllegalArgumentException thrown if the property is not one that Saxon recognizes.
This method is provided for advanced users only, and is subject to change.
This is intended primarily for internal use
This method is intended for internal use.
Parameters: receiver The receiver to which events should be sent after validation systemId the base URI of the document being validated namePool the namePool to be used by the validator validationMode for example Validation.STRICT or Validation.STRIP. The integer may also have the bit Validation.VALIDATE_OUTPUT set, indicating that the strean being validated is to be treated as a final output stream (which means multiple errors can be reported) stripSpace schemaType The type against which the outermost element of the document must be validated (null if there is no constraint)
Returns: A Receiver to which events can be sent for validation
This method is intended for internal use.
Returns: the element declaration whose name matches the given fingerprint, or null if no element declaration with this name has been registered.
This method is intended for internal use.
Parameters: receiver the target receiver tp receive the validated element nameCode the nameCode of the element to be validated. This must correspond to the name of an element declaration in a loaded schema schemaType the schema type (typically a complex type) against which the element is to be validated validation The validation mode, for example Validation.STRICT or Validation.LAX pool The name pool
Returns: The target receiver, indicating that with this configuration, no validation is performed.
Returns: the ErrorListener.
Since: 8.4
This mechanism is for advanced users only, and the details are subject to change.
Returns: the registered FunctionLibrary for extension functions if one has been registered; or the default FunctionLibrary for extension functions otherwise
This mechanism is intended for advanced use only, and is subject to change.
Returns: the factory object registered to generate calls on extension functions, if one has been registered; if not, the default factory used by Saxon.
This method is intended for internal use only.
This method is problematic because it is possible to run multiple transformations or queries within the same configuration. The method is therefore best avoided. Instead, use Executable. Internally its only use is in deciding (in Saxon-SA only) which error listener to use by default at compile time, and since the standard XSLT and XQuery listeners have no differences when used for static errors, the choice is immaterial.
Returns: Configuration.XSLT or Configuration.XQUERY
Returns: the value set using Configuration, or failing that the timezone from the system clock at the time the Configuration was created.
This method is intended for internal use only.
Parameters: className A string containing the name of the class, for example "com.microstar.sax.LarkDriver" classLoader The ClassLoader to be used to load the class. If this is null, then the classLoader used will be the first one available of: the classLoader registered with the Configuration using Configuration; the context class loader for the current thread; or failing that, the class loader invoked implicitly by a call of Class.forName() (which is the ClassLoader that was used to load the Configuration object itself).
Returns: an instance of the class named, or null if it is not loadable.
Throws: XPathException if the class cannot be loaded.
This method is intended for internal use.
Returns: the full class name of the message emitter class.
Since: 8.4
Returns: a class that can be used for name checking
Since: 8.6
Returns: the target name pool. If no NamePool has been specified explicitly, the default NamePool is returned.
Since: 8.4
This method is intended for internal use only.
Returns: a Receiver that implements the method, or null if the method name is not recognized
Returns: the OutputURIResolver. If none has been supplied explicitly, the default OutputURIResolver is returned.
Since: 8.4
Returns: the platform to be used
Returns: A string containing both the product name and the product version
Since: 8.4
Returns: the current recovery policy. The options are RECOVER_SILENTLY, RECOVER_WITH_WARNINGS, or DO_NOT_RECOVER.
Since: 8.4
This method is intended for internal use.
Returns: an object of class javax.xml.validation.schema, which is not declared as such to avoid creating a dependency on this JDK 1.5 class
This method is intended for internal use and for use by advanced applications. (The SchemaType object returned cannot yet be considered a stable API, and may be superseded when a JAXP API for schema information is defined.)
Parameters: fingerprint the fingerprint of the schema type
Returns: the schema type , or null if there is none with this name.
Returns: the schema validation mode previously set using setSchemaValidationMode(), or the default mode STRIP otherwise.
This method is intended primarily for internal use.
Returns: a parser, in which the namespace properties must be set as follows: namespaces=true; namespace-prefixes=false. The DTD validation feature of the parser will be set on or off depending on the Configuration setting.
This method is retained in Saxon for backwards compatibility, but the preferred way of choosing an XML parser is to use JAXP interfaces, for example by supplying a JAXP Source object initialized with an appropriate implementation of org.xml.sax.XMLReader.
Returns: the fully qualified name of the XML parser class
Returns: the current SourceResolver
Returns: kind the kind of whitespace-only text node that should be stripped when building a source tree. One of Whitespace.NONE (none), Whitespace.ALL (all), or Whitespace.IGNORABLE (element-content whitespace as defined in a DTD or schema)
This method is intended for internal use only.
This method is retained in Saxon for backwards compatibility, but the preferred way of choosing an XML parser is to use JAXP interfaces, for example by supplying a JAXP Source object initialized with an appropriate implementation of org.xml.sax.XMLReader.
Returns: the fully qualified name of the XML parser class
Returns: the TraceListener, or null if none is in use.
Since: 8.4
Returns: the selected Tree Model
Since: 8.4
Returns: the URIResolver. If no URIResolver has been set explicitly, the default URIResolver is used.
Since: 8.4
This method is intended for internal use only.
Returns: one of the constants XML10 or XML11
Since: 8.6
Returns: true if such calls are permitted.
Since: 8.4
Returns: true if lazy construction mode is enabled
Returns: true if line numbers are maintained in source documents
Since: 8.4
Returns: true if DTD types are to be taken into account
Since: 8.4
Parameters: language the required host language: XSLT, XQUERY, or XML_SCHEMA
Since: 8.4
Parameters: namespace the namespace URI of the components to be tested
Returns: true if this namespace has been sealed, otherwise false
Returns: true if all whitespace-only text nodes are stripped.
Since: 8.4
This method is provided largely for internal use. Progress messages are normally controlled directly from the command line interfaces, and are not normally used when driving Saxon from the Java API.
Returns: true if these messages are to be output.
Returns: true if tracing is enabled for calls to external Java functions
Returns: true if DTD validation is requested.
Since: 8.4
Returns: true if validation errors are to be treated as warnings (that is, the validation failure is reported but processing continues as normal); false if validation errors are fatal.
Since: 8.4
Returns: true if these messages are to be output.
Since: 8.4
This method is intended for internal use only.
The named class must exist and must implement the
org.xml.sax.XMLReader or Parser interface.
This method returns an instance of the parser named.
This method is intended for internal use.
Parameters: className A string containing the name of the SAX parser class, for example "com.microstar.sax.LarkDriver"
Returns: an instance of the Parser class named, or null if it is not loadable or is not a Parser.
Since: 8.4
Parameters: classLoader - the class loader to be used. If null, the context class loader for the current thread is used.
Throws: RuntimeException if the Saxon-SA product cannot be loaded or if no license key is available.
This method is provided for advanced users only, and is subject to change.
This method is intended for internal use.
Parameters: className The fully qualified class name of the TraceListener to be constructed
Returns: the newly constructed TraceListener
Throws: net.sf.saxon.trans.XPathException if the requested class does not implement the net.sf.saxon.trace.TraceListener interface
Parameters: className The fully-qualified name of the URIResolver class
Returns: The newly created URIResolver
Throws: TransformerException if the requested class does not implement the javax.xml.transform.URIResolver interface
This method is intended for internal use.
Parameters: root the xs:schema element in the stylesheet expected the target namespace expected; null if there is no expectation.
Returns: the actual target namespace of the schema
This method is intended for internal use.
Returns: the target namespace of the schema
This method is intended for internal use.
Parameters: model The external object model.
This can either be one of the system-supplied external
object models for JDOM, XOM, or DOM, or a user-supplied external object model.
This method is intended for advanced users only, and is subject to change.
Parameters: parser The parser: the caller must not supply a parser that was obtained by any mechanism other than calling the getSourceParser() method.
Parameters: parser The parser: the caller must not supply a parser that was obtained by any mechanism other than calling the getStyleParser() method.
Parameters: namespace the namespace URI of the components to be sealed
Parameters: allowExternalFunctions true if external function calls are to be permitted.
Since: 8.4
This method is intended for external use by advanced users, but should be regarded as experimental.
Note that it is undefined whether collation URIs are resolved at compile time or at run-time. It is therefore inadvisable to change the CollationURIResolver after compiling a query or stylesheet and before running it.
Parameters: resolver the collation URI resolver to be used. This replaces any collation URI resolver previously registered.
Since: 8.5
Collection URIs are always resolved at run-time, using the CollectionURIResolver in force at the time the collection() function is called.
Parameters: resolver the collection URI resolver to be used. This replaces any collection URI resolver previously registered.
Since: 8.5
Parameters: name the URI identifying the property to be set value the value of the property
Throws: IllegalArgumentException if the property name is not recognized
This method is provided for advanced users only, and is subject to change.
Parameters: listener the ErrorListener to be used
Since: 8.4
When an application supplies its own FunctionLibrary for binding extension functions, this replaces the default binding mechanism for Java extension functions, namely JavaExtensionLibrary. It thus disables the function libraries for built-in Saxon extensions and for EXSLT extensions. It is possible to create a function library that adds to the existing mechanisms, rather than replacing them, by supplying as the FunctionLibrary a FunctionLibraryList that itself contains two FunctionLibrary objects: a JavaExtensionLibrary, and a user-written FunctionLibrary.
Parameters: binder The FunctionLibrary object used to locate implementations of extension functions, based on their name and arity
See Also: Configuration
This mechanism is intended for advanced use only, and is subject to change.
See Also: Configuration
Parameters: hostLanguage Configuration.XSLT or Configuration.XQUERY
Parameters: lazy true to switch lazy construction mode on, false to switch it off.
Parameters: lineNumbering true if line numbers are maintained in source documents
Since: 8.4
Parameters: messageEmitterClass the full class name of the message emitter class. This must implement net.sf.saxon.event.Emitter.
Since: 8.4
Parameters: className The fully-qualified name of the LocationHintResolver class
Throws: TransformerException if the requested class does not implement the net.sf.saxon.LocationHintResolver interface
Normally all transformations and queries run under a single Java VM share the same NamePool. This creates a potential bottleneck, since changes to the namepool are synchronized. It is possible therefore to allocate a distinct NamePool to each Configuration. This requires considerable care and should only be done when the default arrangement is found to cause problems. There is a basic rule to follow: any compiled stylesheet or query must use the same NamePool as its source and result documents.
Parameters: targetNamePool The NamePool to be used.
Since: 8.4
Parameters: outputURIResolver the OutputURIResolver to be used.
Since: 8.4
Parameters: platform the platform to be used
Parameters: recoveryPolicy the recovery policy to be used. The options are RECOVER_SILENTLY, RECOVER_WITH_WARNINGS, or DO_NOT_RECOVER.
Since: 8.4
Parameters: useTypes set to true if DTD types are to be taken into account
Since: 8.4
Parameters: validationMode the validation (or construction) mode to be used for source documents. One of STRIP, PRESERVE, STRICT, LAX
Since: 8.4
This method is retained in Saxon for backwards compatibility, but the preferred way of choosing an XML parser is to use JAXP interfaces, for example by supplying a JAXP Source object initialized with an appropriate implementation of org.xml.sax.XMLReader.
Parameters: sourceParserClass the fully qualified name of the XML parser class. This must implement the SAX2 XMLReader interface.
Parameters: stripsAllWhiteSpace if all whitespace-only text nodes are to be stripped.
Since: 8.4
Parameters: kind the kind of whitespace-only text node that should be stripped when building a source tree. One of Whitespace.NONE (none), Whitespace.ALL (all), or Whitespace.IGNORABLE (element-content whitespace as defined in a DTD or schema)
This method is retained in Saxon for backwards compatibility, but the preferred way of choosing an XML parser is to use JAXP interfaces, for example by supplying a JAXP Source object initialized with an appropriate implementation of org.xml.sax.XMLReader.
Parameters: styleParserClass the fully qualified name of the XML parser class
This method is provided largely for internal use. Progress messages are normally controlled directly from the command line interfaces, and are not normally used when
Parameters: timing true if these messages are to be output.
Parameters: traceExternalFunctions true if tracing is to be enabled for calls to external Java functions
Parameters: traceListener The TraceListener to be used.
Since: 8.4
Parameters: treeModel the selected Tree Model
Since: 8.4
Parameters: resolver The URIResolver to be used.
Since: 8.4
Parameters: validation true if DTD validation is to be requested.
Since: 8.4
Parameters: warn true if schema validation failures are to be treated as warnings; false if they are to be treated as fatal errors.
Since: 8.4
Parameters: warn true if these messages are to be output.
Since: 8.4
Parameters: version one of the constants XML10 or XML11
Since: 8.6
This method is intended for internal use.
Parameters: nameCode the name of the attribute value the value of the attribute as a string validation STRICT or LAX
Returns: the type annotation to apply to the attribute node
Throws: ValidationException if the value is invalid