gov.nasa.pds.tools.label

Class LabelValidator

java.lang.Object

gov.nasa.pds.tools.label.LabelValidator

public class LabelValidator
extends Object

This class is responsible for providing utility functions for validating PDS XML Labels.

Author:

pramirez

Field Summary

Fields

Modifier and Type	Field and Description
static String	SCHEMA_CHECK
static String	SCHEMATRON_CHECK

Constructor Summary

Constructors

Constructor and Description
LabelValidator() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addValidator(DocumentValidator validator)
void	addValidator(ExternalValidator validator)
Boolean	getConfiguration(String key)
String	getModelVersion()
List<String>	getSchematrons(NodeList nodeList, URL url, ExceptionHandler exceptionHandler)
static void	main(String[] args)
Document	parseAndValidate(ExceptionHandler exceptionHandler, URL url) Parses and validates a label against the schema and Schematron files, and returns the parsed XML.
Boolean	performsSchematronValidation()
Boolean	performsSchemaValidation()
void	setCachedEntityResolver(CachedEntityResolver resolver)
void	setCachedLSResourceResolver(CachedLSResourceResolver resolver)
void	setCatalogs(String[] catalogFiles) Pass in a list of Catalog files to use during the validation step.
void	setConfiguration(String key, Boolean value)
void	setLabelSchematrons(Map<String,Transformer> schematronMap) Pass in a hash map of schematron URLs to its transformed schematron object.
void	setModelVersion(String modelVersion)
void	setSchema(List<URL> schemaFiles) Pass in a list of schemas to validate against.
void	setSchemaCheck(Boolean value)
void	setSchemaCheck(Boolean value, Boolean useLabelSchema)
void	setSchematronCheck(Boolean value)
void	setSchematronCheck(Boolean value, Boolean useLabelSchematron)
void	setSchematronFiles(List<URL> schematronFiles) Pass in a list of schematron files to validate against.
void	setSchematrons(List<Transformer> schematrons) Pass in a list of transformed schematrons to validate against.
void	validate(ExceptionHandler exceptionHandler, File labelFile)
void	validate(ExceptionHandler exceptionHandler, URL url) Validates the label against schema and schematron constraints.
void	validate(File labelFile)

Methods inherited from class java.lang.Object

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

Field Detail

SCHEMA_CHECK

public static final String SCHEMA_CHECK

See Also:

Constant Field Values

SCHEMATRON_CHECK

public static final String SCHEMATRON_CHECK

See Also:

Constant Field Values

Constructor Detail

LabelValidator

public LabelValidator()
               throws ParserConfigurationException,
                      TransformerConfigurationException

Default constructor.

Throws:

ParserConfigurationException - If there was an error setting up the configuration of the parser that is reposnible for doing the label validation.

TransformerConfigurationException - If there was an error setting up the Transformer responsible for doing the transformations of the schematrons.

Method Detail

setSchema

public void setSchema(List<URL> schemaFiles)

Pass in a list of schemas to validate against.

Parameters:

schemaFiles - A list of schema URLs.

setSchematrons

public void setSchematrons(List<Transformer> schematrons)

Pass in a list of transformed schematrons to validate against.

Parameters:

schematrons - A list of transformed schematrons.

setLabelSchematrons

public void setLabelSchematrons(Map<String,Transformer> schematronMap)

Pass in a hash map of schematron URLs to its transformed schematron object. This is used when validating a label against it's referenced schematron.

Parameters:

schematronMap -

setSchematronFiles

public void setSchematronFiles(List<URL> schematronFiles)

Pass in a list of schematron files to validate against.

Parameters:

schematronFiles - A list of schematron URLs.

setCatalogs

public void setCatalogs(String[] catalogFiles)

Pass in a list of Catalog files to use during the validation step.

Parameters:

catalogFiles -

validate

public void validate(ExceptionHandler exceptionHandler,
            File labelFile)
              throws SAXException,
                     IOException,
                     ParserConfigurationException,
                     TransformerException,
                     MissingLabelSchemaException

Throws:

SAXException

IOException

ParserConfigurationException

TransformerException

MissingLabelSchemaException

validate

public void validate(ExceptionHandler exceptionHandler,
            URL url)
              throws SAXException,
                     IOException,
                     ParserConfigurationException,
                     TransformerException,
                     MissingLabelSchemaException

Validates the label against schema and schematron constraints.

Parameters:

exceptionHandler - a handler to receive errors during the validation

url - label to validate

Throws:

SAXException - if there are parsing exceptions

IOException - if there are I/O errors during the parse

ParserConfigurationException - if the parser configuration is invalid

TransformerException - if there is an error during Schematron transformation

MissingLabelSchemaException - if the label schema cannot be found

parseAndValidate

public Document parseAndValidate(ExceptionHandler exceptionHandler,
                        URL url)
                          throws SAXException,
                                 IOException,
                                 ParserConfigurationException,
                                 TransformerException,
                                 MissingLabelSchemaException

Parses and validates a label against the schema and Schematron files, and returns the parsed XML.

Parameters:

exceptionHandler - an exception handler to receive errors during the validation

url - the URL of the label to validate

Returns:

the XML document represented by the label

Throws:

SAXException - if there are parsing exceptions

IOException - if there are I/O errors during the parse

ParserConfigurationException - if the parser configuration is invalid

TransformerException - if there is an error during Schematron transformation

MissingLabelSchemaException - if the label schema cannot be found

validate

public void validate(File labelFile)
              throws SAXException,
                     IOException,
                     ParserConfigurationException,
                     TransformerException,
                     MissingLabelSchemaException

Throws:

SAXException

IOException

ParserConfigurationException

TransformerException

MissingLabelSchemaException

getSchematrons

public List<String> getSchematrons(NodeList nodeList,
                          URL url,
                          ExceptionHandler exceptionHandler)

getModelVersion

public String getModelVersion()

setModelVersion

public void setModelVersion(String modelVersion)
                     throws ValidatorException

Throws:

ValidatorException

performsSchemaValidation

public Boolean performsSchemaValidation()

setSchemaCheck

public void setSchemaCheck(Boolean value)

setSchemaCheck

public void setSchemaCheck(Boolean value,
                  Boolean useLabelSchema)

performsSchematronValidation

public Boolean performsSchematronValidation()

setSchematronCheck

public void setSchematronCheck(Boolean value)

setSchematronCheck

public void setSchematronCheck(Boolean value,
                      Boolean useLabelSchematron)

getConfiguration

public Boolean getConfiguration(String key)

setConfiguration

public void setConfiguration(String key,
                    Boolean value)

addValidator

public void addValidator(ExternalValidator validator)

addValidator

public void addValidator(DocumentValidator validator)

setCachedEntityResolver

public void setCachedEntityResolver(CachedEntityResolver resolver)

setCachedLSResourceResolver

public void setCachedLSResourceResolver(CachedLSResourceResolver resolver)

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception