Class PipelineConfiguration


  • public class PipelineConfiguration
    extends java.lang.Object
    A PipelineConfiguration sets options that apply to all the operations in a pipeline. Unlike the global Configuration, these options are always local to a process.
    • Constructor Detail

      • PipelineConfiguration

        public PipelineConfiguration​(PipelineConfiguration p)
        Create a PipelineConfiguration as a copy of an existing PipelineConfiguration
        Parameters:
        p - the existing PipelineConfiguration
    • Method Detail

      • getConfiguration

        public Configuration getConfiguration()
        Get the Saxon Configuration object
        Returns:
        the Saxon Configuration
      • setConfiguration

        public void setConfiguration​(Configuration config)
        Set the Saxon Configuration object
        Parameters:
        config - the Saxon Configuration
      • getErrorReporter

        public ErrorReporter getErrorReporter()
        Get an ErrorListener for reporting errors in processing this pipeline; this will be the ErrorListener set locally in the PipelineConfiguration if there is one, or the ErrorListener from the Configuration otherwise.
        Returns:
        the ErrorListener to be used; never null
      • setErrorReporter

        public void setErrorReporter​(ErrorReporter errorReporter)
        Set the ErrorListener used for reporting errors in processing this pipeline
        Parameters:
        errorReporter - the ErrorListener
      • setParseOptions

        public void setParseOptions​(ParseOptions options)
        Set the document parsing and building options to be used on this pipeline
        Parameters:
        options - the options to be used
      • getParseOptions

        public ParseOptions getParseOptions()
        Get the document parsing and building options to be used on this pipeline return the options to be used
        Returns:
        the parser options for this pipeline
      • setUseXsiSchemaLocation

        public void setUseXsiSchemaLocation​(boolean recognize)
        Say whether xsi:schemaLocation and xsi:noNamespaceSchemaLocation attributes should be recognized while validating an instance document
        Parameters:
        recognize - true if these attributes should be recognized
      • setRecoverFromValidationErrors

        public void setRecoverFromValidationErrors​(boolean recover)
        Say whether validation errors encountered on this pipeline should be treated as fatal or as recoverable.

        Note this is a shortcut for getParseOptions().setContinueAfterValidationErrors(), retained for backwards compatibility.

        Parameters:
        recover - set to true if validation errors are to be treated as recoverable. If this option is set to true, such errors will be reported to the ErrorListener using the error() method, and validation will continue. If it is set to false, errors will be reported using the fatalError() method, and validation will be abandoned. The default depends on the circumstances: typically during standalone instance validation the default is true, but during XSLT and XQuery processing it is false.
      • isRecoverFromValidationErrors

        public boolean isRecoverFromValidationErrors()
        Ask if this pipeline recovers from validation errors

        Note this is a shortcut for getParseOptions().isContinueAfterValidationErrors(), retained for backwards compatibility.

        Returns:
        true if validation errors on this pipeline are treated as recoverable; false if they are treated as fatal
      • getController

        public Controller getController()
        Get the controller associated with this pipelineConfiguration
        Returns:
        the controller if it is known; otherwise null.
      • setController

        public void setController​(Controller controller)
        Set the Controller associated with this pipelineConfiguration
        Parameters:
        controller - the Controller
      • isXSLT

        public boolean isXSLT()
        Ask if the host language is XSLT
        Returns:
        true if the host language is XSLT
      • setExpandAttributeDefaults

        public void setExpandAttributeDefaults​(boolean expand)
        Set whether attribute defaults defined in a schema or DTD are to be expanded or not (by default, fixed and default attribute values are expanded, that is, they are inserted into the document during validation as if they were present in the instance being validated)
        Parameters:
        expand - true if defaults are to be expanded, false if not
      • setComponent

        public void setComponent​(java.lang.String name,
                                 java.lang.Object value)
        Set a named component of the pipeline
        Parameters:
        name - string the component name
        value - the component value
      • setCopyInformee

        public void setCopyInformee​(java.util.function.Function<NodeInfo,​java.lang.Object> informee)
      • getCopyInformee

        public java.util.function.Function<NodeInfo,​java.lang.Object> getCopyInformee()
      • getComponent

        public java.lang.Object getComponent​(java.lang.String name)
        Get a named component of the pipeline
        Parameters:
        name - string the component name
        Returns:
        the component value, or null if absent
      • setXPathContext

        public void setXPathContext​(XPathContext context)
        Set the XPathContext. Used during validation, for diagnostics, to identify the source node that was being processed at the time a validation error in the result document was found
        Parameters:
        context - the XPath dynamic context.
      • getXPathContext

        public XPathContext getXPathContext()
        Get the XPathContext. Used during validation, for diagnostics, to identify the source node that was being processed at the time a validation error in the result document was found
        Returns:
        the XPath dynamic context.