Package net.sf.saxon.lib

Interface InvalidityHandler

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      Sequence<?> endReporting()
      At the end of a validation episode, do any closedown actions, and optionally return information collected in the course of validation (for example a list of error messages).
      void reportInvalidity​(Invalidity failure)
      Report a validation error found during validation of an instance document against a schema
      void startReporting​(String systemId)
      At the start of a validation episode, initialize the handler

    • Method Detail

      • startReporting

        void startReporting​(String systemId)
             throws XPathException
        At the start of a validation episode, initialize the handler
        Parameters:
        systemId - optional; may be used to represent the destination of any report produced
        Throws:
        XPathException - if initialization of the invalidity handler fails for any reason

      • reportInvalidity

        void reportInvalidity​(Invalidity failure)
               throws XPathException
        Report a validation error found during validation of an instance document against a schema
        Parameters:
        failure - details of the validation error
        Throws:
        XPathException - - if the validation error cannot be reported. This is fatal and will cause the validation run to be abandoned

      • endReporting

        Sequence<?> endReporting()
                  throws XPathException
        At the end of a validation episode, do any closedown actions, and optionally return information collected in the course of validation (for example a list of error messages).
        Returns:
        a value to be associated with a validation exception. May be the empty sequence. In the case of the InvalidityReportGenerator, this returns the XML document containing the validation report. This will be the value returned as the value of the variable $err:value during try/catch processing
        Throws:
        XPathException - if an error occurs creating any validation report