com.saxonica.ee.validate

Class InvalidityReportGenerator

java.lang.Object

net.sf.saxon.lib.StandardInvalidityHandler

com.saxonica.ee.validate.InvalidityReportGenerator

All Implemented Interfaces:

InvalidityHandler

public class InvalidityReportGenerator
extends StandardInvalidityHandler

This class InvalidityReportGenerator extends the standard error handler for errors found during validation of an instance document against a schema, used if user specifies -report option on validate. Its effect is to output the validation errors found into the filename specified in an XML format.

Constructor Summary

Constructors

Constructor and Description
InvalidityReportGenerator(Configuration config, Destination destination) Create a Report Invalidity Handler writing to a s9api Destination
InvalidityReportGenerator(Configuration config, Receiver receiver) Create a Report Invalidity Handler writing to a Receiver

Method Summary

Methods

Modifier and Type	Method and Description
void	createMetaData() Create metedata element which contains summary information in the output XML document
Sequence	endReporting() Get the value to be associated with a validation exception.
Destination	getDestination()
int	getErrorCount()
int	getWarningCount()
XMLStreamWriter	getWriter()
void	reportInvalidity(Invalidity failure) Receive notification of a validity error.
void	setDestination(Destination destination) Set the writer
void	setSchemaName(String name) Set the XSD document used to validation process
void	setSystemId(String id) Set the XML document that is to be validated
void	setXsdVersion(String version)
void	startReporting(String systemId) At the start of a validation episode, initialize the handler

Methods inherited from class net.sf.saxon.lib.StandardInvalidityHandler

abbreviatePath, getConfiguration, getConstraintReferenceMessage, getExpandedMessage, getLocationMessage, getLogger, setLogger

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

InvalidityReportGenerator

public InvalidityReportGenerator(Configuration config,
                         Destination destination)
                          throws SaxonApiException

Create a Report Invalidity Handler writing to a s9api Destination

Parameters:

config - the Saxon configuration

destination - required to output the validation errors

Throws:

SaxonApiException

InvalidityReportGenerator

public InvalidityReportGenerator(Configuration config,
                         Receiver receiver)
                          throws XPathException

Create a Report Invalidity Handler writing to a Receiver

Parameters:

config - the Saxon configuration

receiver - required to output the validation errors

Throws:

XPathException

Method Detail

setDestination

public void setDestination(Destination destination)
                    throws SaxonApiException

Set the writer

Parameters:

destination - required to output the validation errors

Throws:

SaxonApiException

setSystemId

public void setSystemId(String id)

Set the XML document that is to be validated

Parameters:

id - of the source document

setSchemaName

public void setSchemaName(String name)

Set the XSD document used to validation process

Parameters:

name - of xsd file

getErrorCount

public int getErrorCount()

getWarningCount

public int getWarningCount()

setXsdVersion

public void setXsdVersion(String version)

getWriter

public XMLStreamWriter getWriter()

reportInvalidity

public void reportInvalidity(Invalidity failure)
                      throws XPathException

Receive notification of a validity error.

Specified by:

reportInvalidity in interface InvalidityHandler

Overrides:

reportInvalidity in class StandardInvalidityHandler

Parameters:

failure - Information about the nature of the invalidity

Throws:

XPathException - - if the validation error cannot be reported. This is fatal and will cause the validation run to be abandoned

getDestination

public Destination getDestination()

startReporting

public void startReporting(String systemId)
                    throws XPathException

Description copied from class: StandardInvalidityHandler

At the start of a validation episode, initialize the handler

Specified by:

startReporting in interface InvalidityHandler

Overrides:

startReporting in class StandardInvalidityHandler

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

endReporting

public Sequence endReporting()
                      throws XPathException

Description copied from class: StandardInvalidityHandler

Get the value to be associated with a validation exception. May return null. In the case of the InvalidityReportGenerator, this returns the XML document containing the validation report

Specified by:

endReporting in interface InvalidityHandler

Overrides:

endReporting in class StandardInvalidityHandler

Returns:

a value (or null). 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

createMetaData

public void createMetaData()
                    throws XPathException

Create metedata element which contains summary information in the output XML document

Throws:

XPathException