net.sf.saxon.lib

Interface InvalidityHandler

All Known Implementing Classes:

InvalidityHandlerWrappingErrorListener, InvalidityReportGenerator, InvalidityReportGeneratorEE, StandardInvalidityHandler, ValidatorImpl.InvalidityHandlerWrappingErrorHandler

public interface InvalidityHandler

Interface for reporting validation errors found during validation of an instance document against a schema.

Method Summary

Modifier and Type	Method and 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(java.lang.String systemId) At the start of a validation episode, initialize the handler

Method Detail

startReporting

void startReporting(java.lang.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