com.helger.schematron

Interface ISchematronResource

All Superinterfaces:

com.helger.commons.id.IHasID<String>

All Known Implementing Classes:

AbstractSchematronResource, AbstractSchematronXSLTBasedResource, SchematronResourcePure, SchematronResourceSCH, SchematronResourceXSLT

public interface ISchematronResource
extends com.helger.commons.id.IHasID<String>

Base interface for a Schematron resource. The implementation can e.g. be a SCH file that needs preprocessing to XSLT or an already precompiled XSLT file.

Author:

Philip Helger

Method Summary

Modifier and Type	Method and Description
Document	applySchematronValidation(com.helger.commons.io.IHasInputStream aXMLResource) Apply the Schematron validation on the passed XML resource and return an SVRL XML DOM Document.
Document	applySchematronValidation(Source aXMLSource) Apply the Schematron validation on the passed XML source and return an SVRL XML DOM Document.
SchematronOutputType	applySchematronValidationToSVRL(com.helger.commons.io.IHasInputStream aXMLResource) Apply the Schematron validation on the passed XML resource and return a SchematronOutputType object.
SchematronOutputType	applySchematronValidationToSVRL(Source aXMLSource) Apply the Schematron validation on the passed XML source and return a SchematronOutputType object.
com.helger.commons.io.resource.IReadableResource	getResource()
com.helger.commons.state.EValidity	getSchematronValidity(com.helger.commons.io.IHasInputStream aXMLResource) A method to check if the passed XML DOM node matches the Schematron rules or not.
com.helger.commons.state.EValidity	getSchematronValidity(Source aXMLSource) A method to check if the passed XML DOM node matches the Schematron rules or not.
boolean	isValidSchematron()

Methods inherited from interface com.helger.commons.id.IHasID

getComparatorID, getID

Method Detail

getResource

@Nonnull
com.helger.commons.io.resource.IReadableResource getResource()

Returns:

The non-null resource from which to read the Schematron rules.

isValidSchematron

boolean isValidSchematron()

Returns:

true if this Schematron can be used to validate XML instances. If not, the Schematron is invalid and the log files must be investigated.

getSchematronValidity

@Nonnull
com.helger.commons.state.EValidity getSchematronValidity(@Nonnull
                                                                   com.helger.commons.io.IHasInputStream aXMLResource)
                                                            throws Exception

A method to check if the passed XML DOM node matches the Schematron rules or not. This is the quick check method, as it breaks upon the first failed assertion or the first successful report, if the implementation supports it (as e.g. the native pure Schematron version).

Parameters:

aXMLResource - The source XML to read and validate against the Schematron. May not be null.

Returns:

EValidity.VALID if the document is valid, EValidity.INVALID if it is invalid.

Throws:

Exception - in case of a sever error validating the schema

getSchematronValidity

@Nonnull
com.helger.commons.state.EValidity getSchematronValidity(@Nonnull
                                                                   Source aXMLSource)
                                                            throws Exception

A method to check if the passed XML DOM node matches the Schematron rules or not. This is the quick check method, as it breaks upon the first failed assertion or the first successful report, if the implementation supports it (as e.g. the native pure Schematron version).

Parameters:

aXMLSource - The source XML to be validated against the Schematron. May not be null.

Returns:

EValidity.VALID if the document is valid, EValidity.INVALID if it is invalid.

Throws:

Exception - in case of a sever error validating the schema

applySchematronValidation

@Nullable
Document applySchematronValidation(@Nonnull
                                              com.helger.commons.io.IHasInputStream aXMLResource)
                                       throws Exception

Apply the Schematron validation on the passed XML resource and return an SVRL XML DOM Document.

Parameters:

aXMLResource - The XML resource to validate via Schematron. May not be null.

Returns:

null if the passed resource does not exist or the non- null SVRL document otherwise.

Throws:

Exception - In case the transformation somehow goes wrong.

See Also:

on how to convert the document into a domain object

applySchematronValidation

@Nullable
Document applySchematronValidation(@Nonnull
                                              Source aXMLSource)
                                       throws Exception

Apply the Schematron validation on the passed XML source and return an SVRL XML DOM Document.

Parameters:

aXMLSource - The XML source to validate via Schematron. May not be null.

Returns:

The SVRL XML document containing the result. May be null when interpreting the Schematron failed.

Throws:

Exception - In case the transformation somehow goes wrong.

See Also:

on how to convert the document into a domain object

applySchematronValidationToSVRL

@Nullable
SchematronOutputType applySchematronValidationToSVRL(@Nonnull
                                                                com.helger.commons.io.IHasInputStream aXMLResource)
                                                         throws Exception

Apply the Schematron validation on the passed XML resource and return a SchematronOutputType object.

Parameters:

aXMLResource - The XML resource to validate via Schematron. May not be null.

Returns:

The SVRL object containing the result. May be null when interpreting the Schematron failed.

Throws:

Exception - In case the transformation somehow goes wrong.

applySchematronValidationToSVRL

@Nullable
SchematronOutputType applySchematronValidationToSVRL(@Nonnull
                                                                Source aXMLSource)
                                                         throws Exception

Apply the Schematron validation on the passed XML source and return a SchematronOutputType object.

Parameters:

aXMLSource - The XML source to validate via Schematron. May not be null.

Returns:

The SVRL object containing the result. May be null when interpreting the Schematron failed.

Throws:

Exception - In case the transformation somehow goes wrong.