ParseOptions

java.lang.Object
- net.sf.saxon.lib.ParseOptions

```
public class ParseOptions
extends java.lang.Object
```
This class defines options for parsing and/or validating a source document. Some of the options are relevant only when parsing, some only when validating, but they are combined into a single class because the two operations are often performed together.

Constructor Summary

Constructors
Constructor and Description
`ParseOptions()` Create a ParseOptions object with default options set
`ParseOptions(ParseOptions p)` Create a ParseOptions object as a copy of another ParseOptions

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addFilter(FilterFactory filterFactory)` Add a filter to the list of filters to be applied to the raw input
`void`	`addParserFeature(java.lang.String uri, boolean value)` Add a parser feature to a map, which will be applied to the XML parser later
`void`	`addParserProperties(java.lang.String uri, java.lang.Object value)` Add a parser property to a map, which is applied to the XML parser later
`void`	`applyDefaults(Configuration config)` Merge settings from the Configuration object into these parseOptions
`static void`	`close(javax.xml.transform.Source source)` Close any resources held by a given Source.
`java.util.Set<? extends Accumulator>`	`getApplicableAccumulators()` Set the list of XSLT 3.0 accumulators that apply to this tree.
`int`	`getDTDValidationMode()` Get whether or not DTD validation of this source is required
`org.xml.sax.EntityResolver`	`getEntityResolver()` Get the EntityResolver that will be used when parsing
`org.xml.sax.ErrorHandler`	`getErrorHandler()` Get the ErrorHandler that will be used when parsing
`UnfailingErrorListener`	`getErrorListener()` Get the ErrorListener that will be used when parsing
`java.util.List<FilterFactory>`	`getFilters()` Get the list of filters to be applied to the input.
`InvalidityHandler`	`getInvalidityHandler()` Get the callback for reporting validation errors
`TreeModel`	`getModel()` Get the tree model that will be used.
`boolean`	`getParserFeature(java.lang.String uri)` Get a particular parser feature added
`java.util.Map<java.lang.String,java.lang.Boolean>`	`getParserFeatures()` Get all the parser features added
`java.util.Map<java.lang.String,java.lang.Object>`	`getParserProperties()` Get all the parser properties added
`java.lang.Object`	`getParserProperty(java.lang.String name)` Get a particular parser property added
`int`	`getSchemaValidationMode()` Get whether or not schema validation of this source is required
`SpaceStrippingRule`	`getSpaceStrippingRule()`
`int`	`getStripSpace()` Deprecated. since 9.8. Use `getSpaceStrippingRule()`
`StructuredQName`	`getTopLevelElement()` Get the name of the top-level element for validation.
`SchemaType`	`getTopLevelType()` Get the type of the document element for validation.
`int`	`getTreeModel()` Get the tree model that will be used.
`int`	`getValidationErrorLimit()` Get the limit on the number of errors reported before schema validation is abandoned.
`ValidationParams`	`getValidationParams()` Get the validation parameters.
`ValidationStatisticsRecipient`	`getValidationStatisticsRecipient()` Ask whether statistics of component usage are maintained during schema validation, and where they will be sent
`java.lang.Boolean`	`getWrapDocument()` Assuming that the contained Source is a node in a tree, determine whether a tree will be created as a view of this supplied tree, or as a copy.
`org.xml.sax.XMLReader`	`getXMLReader()` Get the SAX parser (XMLReader) to be used.
`Maker<org.xml.sax.XMLReader>`	`getXMLReaderMaker()` Get the parser factory class to be used
`boolean`	`isAddCommentsAfterValidationErrors()` Ask whether on validation errors, messages explaining the error should (where possible) be written as comments in the validated source document.
`boolean`	`isCheckEntityReferences()` Ask whether to check elements and attributes of type xs:ENTITY (or xs:ENTITIES) against the unparsed entities declared in the document's DTD.
`boolean`	`isContinueAfterValidationErrors()` Ask whether processing should continue after a validation error.
`boolean`	`isExpandAttributeDefaults()` Ask whether to expand default attributes defined in a DTD or schema.
`boolean`	`isLineNumbering()` Get whether line numbers are to be maintained in the constructed document
`boolean`	`isLineNumberingSet()` Determine whether setLineNumbering() has been called
`boolean`	`isPleaseCloseAfterUse()` Determine whether or not the user of this Source is encouraged to close it as soon as reading is finished.
`boolean`	`isStable()` Ask whether the document (or collection) should be stable, that is, if repeated attempts to dereference the same URI are guaranteed to return the same result.
`boolean`	`isUseXsiSchemaLocation()` Ask whether or not to use the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes in an instance document to locate a schema for validation.
`boolean`	`isXIncludeAware()` Get state of XInclude processing.
`boolean`	`isXIncludeAwareSet()` Determine whether setXIncludeAware() has been called.
`void`	`merge(ParseOptions options)` Merge another set of `ParseOptions` into these `ParseOptions`.
`org.xml.sax.XMLReader`	`obtainXMLReader()` Obtain an XMLReader (parser), by making one using the XMLReaderMaker if available, or by returning the registered XMLReader if available, or failing that, return null
`void`	`setAddCommentsAfterValidationErrors(boolean keepGoing)` Say that on validation errors, messages explaining the error should (where possible) be written as comments in the validated source document.
`void`	`setApplicableAccumulators(java.util.Set<? extends Accumulator> accumulators)` Set the list of XSLT 3.0 accumulators that apply to this tree.
`void`	`setCheckEntityReferences(boolean check)` Say whether to check elements and attributes of type xs:ENTITY (or xs:ENTITIES) against the unparsed entities declared in the document's DTD.
`void`	`setContinueAfterValidationErrors(boolean keepGoing)` Say that processing should continue after a validation error.
`void`	`setDTDValidationMode(int option)` Set whether or not DTD validation of this source is required
`void`	`setEntityResolver(org.xml.sax.EntityResolver resolver)` Set an EntityResolver to be used when parsing.
`void`	`setErrorHandler(org.xml.sax.ErrorHandler handler)` Set an ErrorHandler to be used when parsing.
`void`	`setErrorListener(javax.xml.transform.ErrorListener listener)` Set an ErrorListener to be used when parsing
`void`	`setExpandAttributeDefaults(boolean expand)` Set whether to expand default attributes defined in a DTD or schema.
`void`	`setInvalidityHandler(InvalidityHandler invalidityHandler)` Set the callback for reporting validation errors
`void`	`setLineNumbering(boolean lineNumbering)` Set whether line numbers are to be maintained in the constructed document
`void`	`setModel(TreeModel model)` Set the tree model to use.
`void`	`setPleaseCloseAfterUse(boolean close)` Set whether or not the user of this Source is encouraged to close it as soon as reading is finished.
`void`	`setSchemaValidationMode(int option)` Set whether or not schema validation of this source is required
`void`	`setSpaceStrippingRule(SpaceStrippingRule rule)`
`void`	`setStable(boolean stable)` Say whether the document (or collection) should be stable, that is, if repeated attempts to dereference the same URI are guaranteed to return the same result.
`void`	`setStripSpace(int stripAction)` Deprecated. since 9.8. Use `setSpaceStrippingRule(net.sf.saxon.om.SpaceStrippingRule)`
`void`	`setTopLevelElement(StructuredQName elementName)` Set the name of the top-level element for validation.
`void`	`setTopLevelType(SchemaType type)` Set the type of the top-level element for validation.
`void`	`setTreeModel(int model)` Set the tree model to use.
`void`	`setUseXsiSchemaLocation(boolean use)` Set whether or not to use the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes in an instance document to locate a schema for validation.
`void`	`setValidationErrorLimit(int validationErrorLimit)` Set a limit on the number of errors reported before schema validation is abandoned.
`void`	`setValidationParams(ValidationParams params)` Set the validation parameters.
`void`	`setValidationStatisticsRecipient(ValidationStatisticsRecipient recipient)` Say that statistics of component usage are maintained during schema validation, and indicate where they should be sent
`void`	`setWrapDocument(java.lang.Boolean wrap)` Assuming that the contained Source is a node in a tree, indicate whether a tree should be created as a view of this supplied tree, or as a copy.
`void`	`setXIncludeAware(boolean state)` Set state of XInclude processing.
`void`	`setXMLReader(org.xml.sax.XMLReader parser)` Set the SAX parser (XMLReader) to be used.
`void`	`setXMLReaderMaker(Maker<org.xml.sax.XMLReader> parserMaker)` Set the parser factory class to be used.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ParseOptions
```
public ParseOptions()
```
    Create a ParseOptions object with default options set
  - ParseOptions
```
public ParseOptions(ParseOptions p)
```
    Create a ParseOptions object as a copy of another ParseOptions
    
    Parameters:
    
    p - the ParseOptions to be copied
- Method Detail
  - merge
```
public void merge(ParseOptions options)
```
    Merge another set of ParseOptions into these ParseOptions. Properties in the other ParseOptions take precedence over properties in these ParseOptions. "Taking precedence" here means:
    - If a non-default value for a property is present in one ParseOptions and the default value is present in the other, the non-default value is used.
    - If both ParseOptions objects have non-default values for a property, then the value is taken from the one that "takes precedence".
    Parameters:
    
    options - the set of ParseOptions properties to be merged in.
  - applyDefaults
```
public void applyDefaults(Configuration config)
```
    Merge settings from the Configuration object into these parseOptions
    
    Parameters:
    
    config - the Configuration. Settings from the Configuration are used only where no setting is present in this ParseOptions object
  - addFilter
```
public void addFilter(FilterFactory filterFactory)
```
    Add a filter to the list of filters to be applied to the raw input
    
    Parameters:
    
    filterFactory - the filterFactory to be added
  - getFilters
```
public java.util.List<FilterFactory> getFilters()
```
    Get the list of filters to be applied to the input. Returns null if there are no filters.
    
    Returns:
    
    the list of filters, if there are any
  - setStripSpace
```
public void setStripSpace(int stripAction)
```
    Deprecated. since 9.8. Use setSpaceStrippingRule(net.sf.saxon.om.SpaceStrippingRule)
    
    Set the space-stripping action to be applied to the source document
    
    Parameters:
    
    stripAction - one of Whitespace.IGNORABLE, Whitespace.ALL, or Whitespace.NONE
  - getStripSpace
```
public int getStripSpace()
```
    Deprecated. since 9.8. Use getSpaceStrippingRule()
    
    Get the space-stripping action to be applied to the source document
    
    Returns:
    
    one of Whitespace.IGNORABLE, Whitespace.ALL, or Whitespace.NONE
  - getSpaceStrippingRule
```
public SpaceStrippingRule getSpaceStrippingRule()
```
  - setSpaceStrippingRule
```
public void setSpaceStrippingRule(SpaceStrippingRule rule)
```
  - setTreeModel
```
public void setTreeModel(int model)
```
    Set the tree model to use. Default is the tiny tree
    
    Parameters:
    
    model - one of Builder.TINY_TREE, Builder.LINKED_TREE or Builder.TINY_TREE_CONDENSED
  - addParserFeature
```
public void addParserFeature(java.lang.String uri,
                             boolean value)
```
    Add a parser feature to a map, which will be applied to the XML parser later
    
    Parameters:
    
    uri - The features as a URIs
    
    value - The value given to the feature as boolean
  - addParserProperties
```
public void addParserProperties(java.lang.String uri,
                                java.lang.Object value)
```
    Add a parser property to a map, which is applied to the XML parser later
    
    Parameters:
    
    uri - The properties as a URIs
    
    value - The value given to the properties as a string
  - getParserFeature
```
public boolean getParserFeature(java.lang.String uri)
```
    Get a particular parser feature added
    
    Parameters:
    
    uri - The feature name as a URIs
    
    Returns:
    
    The feature value as boolean
  - getParserProperty
```
public java.lang.Object getParserProperty(java.lang.String name)
```
    Get a particular parser property added
    
    Parameters:
    
    name - The properties as a URIs
    
    Returns:
    
    The property value (which may be any object)
  - getParserFeatures
```
public java.util.Map<java.lang.String,java.lang.Boolean> getParserFeatures()
```
    Get all the parser features added
    
    Returns:
    
    A map of (feature, value) pairs
  - getParserProperties
```
public java.util.Map<java.lang.String,java.lang.Object> getParserProperties()
```
    Get all the parser properties added
    
    Returns:
    
    A map of (feature, string) pairs
  - getTreeModel
```
public int getTreeModel()
```
    Get the tree model that will be used.
    
    Returns:
    
    one of Builder.TINY_TREE, Builder.LINKED_TREE, or Builder.TINY_TREE_CONDENSED, or Builder.UNSPECIFIED_TREE_MODEL if no call on setTreeModel() has been made
  - setModel
```
public void setModel(TreeModel model)
```
    Set the tree model to use. Default is the tiny tree
    
    Parameters:
    
    model - typically one of the constants TreeModel.TINY_TREE, TreeModel.TINY_TREE_CONDENSED, or TreeModel.LINKED_TREE. However, in principle a user-defined tree model can be used.
    
    Since:
    
    9.2
  - getModel
```
public TreeModel getModel()
```
    Get the tree model that will be used.
    
    Returns:
    
    typically one of the constants TreeModel.TINY_TREE, TreeModel.TINY_TREE_CONDENSED, or TreeModel.LINKED_TREE. However, in principle a user-defined tree model can be used.
  - setSchemaValidationMode
```
public void setSchemaValidationMode(int option)
```
    Set whether or not schema validation of this source is required
    
    Parameters:
    
    option - one of Validation.STRICT, Validation.LAX, Validation.STRIP, Validation.PRESERVE, Validation.DEFAULT
  - getSchemaValidationMode
```
public int getSchemaValidationMode()
```
    Get whether or not schema validation of this source is required
    
    Returns:
    
    the validation mode requested, or Validation.DEFAULT to use the default validation mode from the Configuration.
  - setExpandAttributeDefaults
```
public void setExpandAttributeDefaults(boolean expand)
```
    Set whether to expand default attributes defined in a DTD or schema. By default, default attribute values are expanded
    
    Parameters:
    
    expand - true if missing attribute values are to take the default value supplied in a DTD or schema, false if they are to be left as absent
  - isExpandAttributeDefaults
```
public boolean isExpandAttributeDefaults()
```
    Ask whether to expand default attributes defined in a DTD or schema. By default, default attribute values are expanded
    
    Returns:
    
    true if missing attribute values are to take the default value supplied in a DTD or schema, false if they are to be left as absent
  - setTopLevelElement
```
public void setTopLevelElement(StructuredQName elementName)
```
    Set the name of the top-level element for validation. If a top-level element is set then the document being validated must have this as its outermost element
    
    Parameters:
    
    elementName - the QName of the required top-level element, or null to unset the value
  - getTopLevelElement
```
public StructuredQName getTopLevelElement()
```
    Get the name of the top-level element for validation. If a top-level element is set then the document being validated must have this as its outermost element
    
    Returns:
    
    the QName of the required top-level element, or null if no value is set
    
    Since:
    
    9.0
  - setTopLevelType
```
public void setTopLevelType(SchemaType type)
```
    Set the type of the top-level element for validation. If this is set then the document element is validated against this type
    
    Parameters:
    
    type - the schema type required for the document element, or null to unset the value
  - getTopLevelType
```
public SchemaType getTopLevelType()
```
    Get the type of the document element for validation. If this is set then the document element of the document being validated must have this type
    
    Returns:
    
    the type of the required top-level element, or null if no value is set
  - setUseXsiSchemaLocation
```
public void setUseXsiSchemaLocation(boolean use)
```
    Set whether or not to use the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes in an instance document to locate a schema for validation. Note, these attribute are only used if validation is requested.
    
    Parameters:
    
    use - true if these attributes are to be used, false if they are to be ignored
  - isUseXsiSchemaLocation
```
public boolean isUseXsiSchemaLocation()
```
    Ask whether or not to use the xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes in an instance document to locate a schema for validation. Note, these attribute are only used if validation is requested.
    
    Returns:
    
    true (the default) if these attributes are to be used, false if they are to be ignored
  - getValidationErrorLimit
```
public int getValidationErrorLimit()
```
    Get the limit on the number of errors reported before schema validation is abandoned. Default is unlimited (Integer.MAX_VALUE)
    
    Returns:
    
    the limit on the number of errors
  - setValidationErrorLimit
```
public void setValidationErrorLimit(int validationErrorLimit)
```
    Set a limit on the number of errors reported before schema validation is abandoned. Default is unlimited (Integer.MAX_VALUE). If set to one, validation is terminated as soon as a single validation error is detected.
    
    Parameters:
    
    validationErrorLimit - the limit on the number of errors
  - setDTDValidationMode
```
public void setDTDValidationMode(int option)
```
    Set whether or not DTD validation of this source is required
    
    Parameters:
    
    option - one of Validation.STRICT, Validation.LAX, Validation.STRIP, Validation.DEFAULT.
    The value Validation.LAX indicates that DTD validation is requested, but validation failures are treated as warnings only.
  - getDTDValidationMode
```
public int getDTDValidationMode()
```
    Get whether or not DTD validation of this source is required
    
    Returns:
    
    the validation mode requested, or Validation.DEFAULT to use the default validation mode from the Configuration.
    The value Validation.LAX indicates that DTD validation is requested, but validation failures are treated as warnings only.
  - setValidationStatisticsRecipient
```
public void setValidationStatisticsRecipient(ValidationStatisticsRecipient recipient)
```
    Say that statistics of component usage are maintained during schema validation, and indicate where they should be sent
    
    Parameters:
    
    recipient - the agent to be notified of the validation statistics on completion of the validation episode, May be set to null if no agent is to be notified.
  - getValidationStatisticsRecipient
```
public ValidationStatisticsRecipient getValidationStatisticsRecipient()
```
    Ask whether statistics of component usage are maintained during schema validation, and where they will be sent
    
    Returns:
    
    the agent to be notified of the validation statistics on completion of the validation episode, or null if none has been nominated
  - setLineNumbering
```
public void setLineNumbering(boolean lineNumbering)
```
    Set whether line numbers are to be maintained in the constructed document
    
    Parameters:
    
    lineNumbering - true if line numbers are to be maintained
  - isLineNumbering
```
public boolean isLineNumbering()
```
    Get whether line numbers are to be maintained in the constructed document
    
    Returns:
    
    true if line numbers are maintained
  - isLineNumberingSet
```
public boolean isLineNumberingSet()
```
    Determine whether setLineNumbering() has been called
    
    Returns:
    
    true if setLineNumbering() has been called
  - setXMLReader
```
public void setXMLReader(org.xml.sax.XMLReader parser)
```
    Set the SAX parser (XMLReader) to be used. This method must be used with care, because an XMLReader is not thread-safe. If there is any chance that this ParseOptions object will be used in multiple threads, then this property should not be set. Instead, set the XMLReaderMaker property, which allows a new parser to be created each time it is needed.
    
    Parameters:
    
    parser - the SAX parser
  - getXMLReader
```
public org.xml.sax.XMLReader getXMLReader()
```
    Get the SAX parser (XMLReader) to be used.
    
    Returns:
    
    the parser
  - setXMLReaderMaker
```
public void setXMLReaderMaker(Maker<org.xml.sax.XMLReader> parserMaker)
```
    Set the parser factory class to be used.
    
    Parameters:
    
    parserMaker - a factory object that delivers an XMLReader on demand
  - getXMLReaderMaker
```
public Maker<org.xml.sax.XMLReader> getXMLReaderMaker()
```
    Get the parser factory class to be used
    
    Returns:
    
    a factory object that delivers an XMLReader on demand, or null if none has been set
  - obtainXMLReader
```
public org.xml.sax.XMLReader obtainXMLReader()
                                      throws XPathException
```
    Obtain an XMLReader (parser), by making one using the XMLReaderMaker if available, or by returning the registered XMLReader if available, or failing that, return null
    
    Throws:
    
    XPathException
  - setEntityResolver
```
public void setEntityResolver(org.xml.sax.EntityResolver resolver)
```
    Set an EntityResolver to be used when parsing. Note that this will not be used if an XMLReader has been supplied (in that case, the XMLReader should be initialized with the EntityResolver already set.)
    
    Parameters:
    
    resolver - the EntityResolver to be used. May be null, in which case any existing EntityResolver is removed from the options
  - getEntityResolver
```
public org.xml.sax.EntityResolver getEntityResolver()
```
    Get the EntityResolver that will be used when parsing
    
    Returns:
    
    the EntityResolver, if one has been set using setEntityResolver(org.xml.sax.EntityResolver), otherwise null.
  - setErrorHandler
```
public void setErrorHandler(org.xml.sax.ErrorHandler handler)
```
    Set an ErrorHandler to be used when parsing. Note that this will not be used if an XMLReader has been supplied (in that case, the XMLReader should be initialized with the ErrorHandler already set.)
    
    Parameters:
    
    handler - the ErrorHandler to be used, or null to indicate that no ErrorHandler is to be used.
  - getErrorHandler
```
public org.xml.sax.ErrorHandler getErrorHandler()
```
    Get the ErrorHandler that will be used when parsing
    
    Returns:
    
    the ErrorHandler, if one has been set using setErrorHandler(org.xml.sax.ErrorHandler), otherwise null.
  - setWrapDocument
```
public void setWrapDocument(java.lang.Boolean wrap)
```
    Assuming that the contained Source is a node in a tree, indicate whether a tree should be created as a view of this supplied tree, or as a copy.
    
    Parameters:
    
    wrap - if true, the node in the supplied Source is wrapped, to create a view. If false, the node and its contained subtree is copied. If null, the system default is chosen.
  - getWrapDocument
```
public java.lang.Boolean getWrapDocument()
```
    Assuming that the contained Source is a node in a tree, determine whether a tree will be created as a view of this supplied tree, or as a copy.
    
    Returns:
    
    if true, the node in the supplied Source is wrapped, to create a view. If false, the node and its contained subtree is copied. If null, the system default is chosen.
    
    Since:
    
    8.8
  - setXIncludeAware
```
public void setXIncludeAware(boolean state)
```
    Set state of XInclude processing.
    
    If XInclude markup is found in the document instance, should it be processed as specified in XML Inclusions (XInclude) Version 1.0.
    
    XInclude processing defaults to false.
    
    Parameters:
    
    state - Set XInclude processing to true or false
    
    Since:
    
    8.9
  - isXIncludeAwareSet
```
public boolean isXIncludeAwareSet()
```
    Determine whether setXIncludeAware() has been called.
    
    Returns:
    
    true if setXIncludeAware() has been called
  - isXIncludeAware
```
public boolean isXIncludeAware()
```
    Get state of XInclude processing.
    
    Returns:
    
    current state of XInclude processing. Default value is false.
  - setErrorListener
```
public void setErrorListener(javax.xml.transform.ErrorListener listener)
```
    Set an ErrorListener to be used when parsing
    
    Parameters:
    
    listener - the ErrorListener to be used; or null, to indicate that the standard ErrorListener is to be used. If necessary the supplied ErrorListener will be wrapped with one that suppresses any checked Exceptions thrown by its methods.
  - getErrorListener
```
public UnfailingErrorListener getErrorListener()
```
    Get the ErrorListener that will be used when parsing
    
    Returns:
    
    the ErrorListener, if one has been set using setErrorListener(javax.xml.transform.ErrorListener), otherwise null.
  - setContinueAfterValidationErrors
```
public void setContinueAfterValidationErrors(boolean keepGoing)
```
    Say that processing should continue after a validation error. Note that all validation errors are reported to the error() method of the ErrorListener, and processing always continues except when this method chooses to throw an exception. At the end of the document, a fatal error is thrown if (a) there have been any validation errors, and (b) this option is not set.
    
    Parameters:
    
    keepGoing - true if processing should continue
  - isContinueAfterValidationErrors
```
public boolean isContinueAfterValidationErrors()
```
    Ask whether processing should continue after a validation error. Note that all validation errors are reported to the error() method of the ErrorListener, and processing always continues except when this method chooses to throw an exception. At the end of the document, a fatal error is thrown if (a) there have been any validation errors, and (b) this option is not set.
    
    Returns:
    
    true if processing should continue
  - setAddCommentsAfterValidationErrors
```
public void setAddCommentsAfterValidationErrors(boolean keepGoing)
```
    Say that on validation errors, messages explaining the error should (where possible) be written as comments in the validated source document. This option is only relevant when processing continues after a validation error
    
    Parameters:
    
    keepGoing - true if comments should be added
    
    Since:
    
    9.3. Default is now false; in previous releases this option was always on.
  - isAddCommentsAfterValidationErrors
```
public boolean isAddCommentsAfterValidationErrors()
```
    Ask whether on validation errors, messages explaining the error should (where possible) be written as comments in the validated source document. This option is only relevant when processing continues after a validation error
    
    Returns:
    
    true if comments should be added
    
    Since:
    
    9.3
  - setValidationParams
```
public void setValidationParams(ValidationParams params)
```
    Set the validation parameters. These are the values of variables declared in the schema using the saxon:param extension, and referenced in XSD assertions (or CTA expressions) associated with user-defined types
    
    Parameters:
    
    params - the validation parameters
  - getValidationParams
```
public ValidationParams getValidationParams()
```
    Get the validation parameters. These are the values of variables declared in the schema using the saxon:param extension, and referenced in XSD assertions (or CTA expressions) associated with user-defined types
    
    Returns:
    
    the validation parameters
  - setCheckEntityReferences
```
public void setCheckEntityReferences(boolean check)
```
    Say whether to check elements and attributes of type xs:ENTITY (or xs:ENTITIES) against the unparsed entities declared in the document's DTD. This is normally true when performing standalone schema validation, false when invoking validation from XSLT or XQuery.
    
    Parameters:
    
    check - true if entities are to be checked, false otherwise
  - isCheckEntityReferences
```
public boolean isCheckEntityReferences()
```
    Ask whether to check elements and attributes of type xs:ENTITY (or xs:ENTITIES) against the unparsed entities declared in the document's DTD. This is normally true when performing standalone schema validation, false when invoking validation from XSLT or XQuery.
    
    Returns:
    
    true if entities are to be checked, false otherwise
  - isStable
```
public boolean isStable()
```
    Ask whether the document (or collection) should be stable, that is, if repeated attempts to dereference the same URI are guaranteed to return the same result. By default, documents and collections are stable.
    
    Returns:
    
    true if the document or collection is stable
  - setStable
```
public void setStable(boolean stable)
```
    Say whether the document (or collection) should be stable, that is, if repeated attempts to dereference the same URI are guaranteed to return the same result. By default, documents and collections are stable.
    
    Parameters:
    
    stable - true if the document or collection is stable
  - getInvalidityHandler
```
public InvalidityHandler getInvalidityHandler()
```
    Get the callback for reporting validation errors
    
    Returns:
    
    the registered InvalidityHandler
  - setInvalidityHandler
```
public void setInvalidityHandler(InvalidityHandler invalidityHandler)
```
    Set the callback for reporting validation errors
    
    Parameters:
    
    invalidityHandler - the InvalidityHandler to be used for reporting validation failures
  - setApplicableAccumulators
```
public void setApplicableAccumulators(java.util.Set<? extends Accumulator> accumulators)
```
    Set the list of XSLT 3.0 accumulators that apply to this tree.
    
    Parameters:
    
    accumulators - the accumulators that apply; or null if all accumulators apply. (Note, this is not the same as the meaning of #all in the use-accumulators attribute, which refers to all accumulators declared in a given package).
  - getApplicableAccumulators
```
public java.util.Set<? extends Accumulator> getApplicableAccumulators()
```
    Set the list of XSLT 3.0 accumulators that apply to this tree.
    
    Returns:
    
    the accumulators that apply; or null if all accumulators apply. (Note, this is not the same as the meaning of #all in the use-accumulators attribute, which refers to all accumulators declared in a given package).
  - setPleaseCloseAfterUse
```
public void setPleaseCloseAfterUse(boolean close)
```
    Set whether or not the user of this Source is encouraged to close it as soon as reading is finished. Normally the expectation is that any Stream in a StreamSource will be closed by the component that created the Stream. However, in the case of a Source returned by a URIResolver, there is no suitable interface (the URIResolver has no opportunity to close the stream). Also, in some cases such as reading of stylesheet modules, it is possible to close the stream long before control is returned to the caller who supplied it. This tends to make a difference on .NET, where a file often can't be opened if there is a stream attached to it.
    
    Parameters:
    
    close - true if the source should be closed as soon as it has been consumed
  - isPleaseCloseAfterUse
```
public boolean isPleaseCloseAfterUse()
```
    Determine whether or not the user of this Source is encouraged to close it as soon as reading is finished.
    
    Returns:
    
    true if the source should be closed as soon as it has been consumed
  - close
```
public static void close(javax.xml.transform.Source source)
```
    Close any resources held by a given Source. This only works if the underlying Source is one that is recognized as holding closable resources.
    
    Parameters:
    
    source - the source to be closed
    
    Since:
    
    9.2

Class ParseOptions

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ParseOptions

ParseOptions

Method Detail

merge

applyDefaults

addFilter

getFilters

setStripSpace

getStripSpace

getSpaceStrippingRule

setSpaceStrippingRule

setTreeModel

addParserFeature

addParserProperties

getParserFeature

getParserProperty

getParserFeatures

getParserProperties

getTreeModel

setModel

getModel

setSchemaValidationMode

getSchemaValidationMode

setExpandAttributeDefaults

isExpandAttributeDefaults

setTopLevelElement

getTopLevelElement

setTopLevelType

getTopLevelType

setUseXsiSchemaLocation

isUseXsiSchemaLocation

getValidationErrorLimit

setValidationErrorLimit

setDTDValidationMode

getDTDValidationMode

setValidationStatisticsRecipient

getValidationStatisticsRecipient

setLineNumbering

isLineNumbering

isLineNumberingSet

setXMLReader

getXMLReader

setXMLReaderMaker

getXMLReaderMaker

obtainXMLReader

setEntityResolver

getEntityResolver

setErrorHandler

getErrorHandler

setWrapDocument

getWrapDocument

setXIncludeAware

isXIncludeAwareSet

isXIncludeAware

setErrorListener

getErrorListener

setContinueAfterValidationErrors

isContinueAfterValidationErrors

setAddCommentsAfterValidationErrors

isAddCommentsAfterValidationErrors

setValidationParams

getValidationParams

setCheckEntityReferences

isCheckEntityReferences

isStable

setStable

getInvalidityHandler

setInvalidityHandler

setApplicableAccumulators

getApplicableAccumulators

setPleaseCloseAfterUse

isPleaseCloseAfterUse

close