The <global> element
The global
input element of the configuration file contains properties defining
global configuration options.
Attribute |
Values |
Effect |
allowExternalFunctions |
true|false |
True if calls to external Java or .NET functions are allowed |
allowMultiThreading |
true|false |
True if |
allowOldJavaUriFormat |
true|false |
True if reflexive calls to external Java functions are allowed to use the "liberal" syntax (for example "http://my.com/extensions/java.util.Date"). The default is to allow only the "strict" form of URI such as "java:java.util.Date" |
collationUriResolver |
Name of a class implementing CollationURIResolver |
User-supplied class used to intepret collation URIs |
collectionUriResolver |
Name of a class implementing CollectionURIResolver |
User-supplied class used for resolving the URI supplied to the |
compileWithTracing |
true|false |
generates trace code in the expression tree, allowing a TraceListener to be used at run-time |
defaultCollation |
A collation URI |
(Requires Saxon-PE.) The collation URI to be used when no explicit collation is requested. |
defaultCollection |
A collection URI |
The collection URI to be used when no argument is passed to the |
dtdValidation |
true|false |
Controls whether DTD validation is applied to input files. |
dtdValidationRecoverable |
true|false |
Controls whether DTD validation errors are recoverable or fatal. |
errorListener |
A Java class that implements javax.xml.transform.ErrorListener |
Defines the default ErrorListener for reporting both compile-time and run-time errors |
expandAttributeDefaults |
true|false |
Controls whether attribute default values found in a DTD or schema are expanded or not. |
lazyConstructionMode |
true|false |
If true, causes temporary trees to be constructed lazily |
lineNumbering |
true|false |
Controls whether line and column number information is maintained for input files |
optimizationLevel |
integer, 0 to 10 |
Defines the level of code optimization to be applied |
preEvaluateDocFunction |
true|false |
If true, allows calls on |
preferJaxpParser |
true|false |
Relevant only on .NET, determines whether the Java Classpath parser is used in preference to the Microsoft .NET parser |
recognizeUriQueryParameters |
true|false |
If true, and the standard URIResolver is in use, query parameters such as |
schemaValidation |
strict|lax|preserve|skip |
Controls whether schema validation is applied to input files |
serializerFactory |
Java class that extends net.sf.saxon.event.SerializerFactory |
Allows the serialization pipeline to be customized, for example to handle user-defined serialization parameters |
sourceParser |
Java class implementing XMLReader |
The SAX parser to be used for reading source files. |
sourceResolver |
Java class name implementing net.sf.saxon.SourceResolver |
Name of a user-supplied class that resolves unknown implementations of the JAXP Source class into a known implementation. |
stripWhitespace |
all|none|ignorable |
Controls what whitespace is removed from input documents (all inter-element whitespace, no inter-element whitespace, or all inter-element whitespace in elements having element-only content models) |
styleParser |
Java Class implementing XMLReader |
XML parser used for stylesheets and schema documents |
timing |
true|false |
Outputs progress messages to System.err. Equivalent to the -t option on the command line |
traceExternalFunctions |
true|false |
Provides diagnostics when external functions are dynamically loaded |
traceListener |
Java Class implementing net.sf.saxon.trace.TraceListener |
User-defined class to be used for handling run-time trace output |
traceOptimizerDecisions |
true|false |
Causes tracing of decisions made by the optimizer |
treeModel |
linkedTree|tinyTree|tinyTreeCondensed |
Determines the tree model implementation used for input files: TinyTree, LinkedTree, or TinyTree(condensed) |
uriResolver |
Name of a JAXP URIResolver |
The URIResolver to be used for deferencing URIs used in |
usePiDisableOutputEscaping |
true|false |
When sending output to a user-defined content handler, indicates whether JAXP-defined processing instructions are used to signal the start and end of text in which output escaping is disabled |
useTypedValueCache |
true|false |
If true, typed values of element and attribute nodes are cached in the TinyTree. Uses extra memory, may make execution faster. |
validationComments |
true|false |
Only relevant when validationWarnings=true, indicates that validation error messages should where possible be added as comments in the document instance being validated rather than fatal errors. |
validationWarnings |
true|false |
For result trees subjected to schema validation, indicates whether validation failures should be treated as warnings rather than fatal errors. |
versionOfXml |
1.0|1.1 |
Determines whether XML 1.0 or XML 1.1 rules are used for names. (1.0 means the rules before Edition 5) |
xInclude |
true|false |
Controls whether XInclude processing is applied to input files |