org.geotools.validation

Class ValidationProcessor

Object

ValidationProcessor

public class ValidationProcessor
extends Object

ValidationProcessor Runs validation tests against Features and reports the outcome of the tests.

The validation processor contains two main data structures. Each one is a HashMap of ArrayLists that hold Validations. The first one, featureLookup, holds per-feature validation tests (tests that operate on one feature at a time with no knowledge of any other features. The second one, integrityLookup, holds integrity validations (validations that span multiple features and/or multiple feature types).

Each HashMap of validations is hashed with a key whose value is a FeatureTypeName. This key provides access to an ArrayList of validations that are to be performed on this FeatureTypeInfo.

Validations are added via the two addValidation() methods.

The validations are run when runFeatureTests() and runIntegrityTests() are called. It is recommended that the user call runFeatureTests() before runIntegrityTests() as it is usually the case that integrity tests are much more time consuming. If a Feature is incorrect, it can probably be detected early on, and quickly, in the feature validation tests.

For validations that are performed on every FeatureTypeInfo, a value called ANYTYPENAME has been created and can be stored in the validationLookup tables if a validation specifies that it is run against all FeatureTypes. The value that causes a validation to be run against all FeatureTypes is null. Or Validation.ALL

Results of the validation tests are handled using a Visitor pattern. This visitor is a ValidationResults object that is passed into the runFeatureTests() and runIntegrityTests() methods. Each individual validation will record error messages in the ValidationResults visitor.

Example Use:

 ValidationProcessor processor = new ValidationProcessor();

 processor.addValidation(FeatureValidation1);

 processor.addValidation(FeatureValidation2);

 processor.addValidation(IntegrityValidation1);

 processor.addValidation(FeatureValidation3);

 

 processor.runFeatureTests(FeatureTypeInfo, Feature, ValidationResults);

 processor.runIntegrityTests(layers, Envelope, ValidationResults);

 

Author:

bowens, Refractions Research, Inc., $Author: jive $ (last modification)

Field Summary

Fields

Modifier and Type	Field and Description
protected Map	featureLookup Stores Lists of FeatureTests by featureType.
protected Map	integrityLookup Stores Lists of IntegrityValidation by featureType.
protected ArrayList	modifiedFeatureTypes List of feature types that have been modified.

Constructor Summary

Constructors

Constructor and Description
ValidationProcessor() ValidationProcessor constructor.

Method Summary

Modifier and Type	Method and Description
void	addValidation(FeatureValidation validation) addValidation Add a FeatureValidation to the list of Feature tests
void	addValidation(IntegrityValidation validation) addValidation Add an IntegrityValidation to the list of Integrity tests
Set	getDependencies(String typeName) getDependencies purpose.
void	load(File plugins, File testsuites) Load testsuites from provided directories.
void	load(Map plugInDTOs, Map testSuiteDTOs) Populates this validation processor against the provided DTO objects.
protected static Set	queryPlugInNames(Map testSuiteDTOs)
void	runFeatureTests(String dsID, SimpleFeatureCollection collection, ValidationResults results) runFeatureTests Change: Uses a SimpleFeatureIterator now instead of a FeatureCollection.
void	runIntegrityTests(Set<Name> typeRefs, Map stores, ReferencedEnvelope envelope, ValidationResults results) runIntegrityTests Performs a lookup on the FeatureTypeInfo name to determine what IntegrityTests need to be performed.
protected String	typeRef(Name name) Convert a Name to a type reference (namespace ":" name)

Methods inherited from class Object

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

Field Detail

featureLookup

protected Map featureLookup

Stores Lists of FeatureTests by featureType.

Map of ArrayLists by featureType (the lists contain FeatureValidation instances)

integrityLookup

protected Map integrityLookup

Stores Lists of IntegrityValidation by featureType.

A Map with featureTypes as keys that map to array lists of integrity validation tests.

How are tests that map against all FeatureTypes stored?

modifiedFeatureTypes

protected ArrayList modifiedFeatureTypes

List of feature types that have been modified.

Constructor Detail

ValidationProcessor

public ValidationProcessor()

ValidationProcessor constructor.

Initializes the data structure to hold the validations.

Method Detail

addValidation

public void addValidation(FeatureValidation validation)

addValidation

Add a FeatureValidation to the list of Feature tests

Parameters:

validation -

addValidation

public void addValidation(IntegrityValidation validation)

addValidation

Add an IntegrityValidation to the list of Integrity tests

Parameters:

validation -

getDependencies

public Set getDependencies(String typeName)

getDependencies purpose.

Gets all the FeatureTypes that this FeatureTypeInfo uses.

Parameters:

typeName - the FeatureTypeName

Returns:

all the FeatureTypes that this FeatureTypeInfo uses.

runFeatureTests

public void runFeatureTests(String dsID,
                            SimpleFeatureCollection collection,
                            ValidationResults results)
                     throws Exception

runFeatureTests Change: Uses a SimpleFeatureIterator now instead of a FeatureCollection.

Performs a lookup on the FeatureTypeInfo name to determine what FeatureTests need to be performed. Once these tests are gathered, they are run on each feature in the FeatureCollection. The first validation test lookup checks to see if there are any validations that are to be performed on every FeatureTypeInfo. An example of this could be an isValid() test on all geometries in all FeatureTypes. Once those tests have been gathered, a lookup is performed on the TypeName of the FeatureTypeInfo to check for specific FeatureTypeInfo validation tests. A list of validation tests is returned from each lookup, if any exist. When all the validation tests have been gathered, each test is iterated through then run on each Feature, with the ValidationResults coming along for the ride, collecting error information. Parameter "SimpleFeatureCollection collection" should be changed later to take in a SimpleFeatureSource so not everything is loaded into memory.

Parameters:

dsID - data Store id.

type - The FeatureTypeInfo of the features being tested.

features - The collection of features, of a particulare FeatureTypeInfo "type", that are to be validated.

results - Storage for the results of the validation tests.

Throws:

Exception - FeatureValidations throw Exceptions

runIntegrityTests

public void runIntegrityTests(Set<Name> typeRefs,
                              Map stores,
                              ReferencedEnvelope envelope,
                              ValidationResults results)
                       throws Exception

runIntegrityTests

Performs a lookup on the FeatureTypeInfo name to determine what IntegrityTests need to be performed. Once these tests are gathered, they are run on the collection features in the Envelope, defined by a SimpleFeatureSource (not a FeatureCollection!). The first validation test lookup checks to see if there are any validations that are to be performed on every FeatureTypeInfo. An example of this could be a uniqueID() test on a unique column value in all FeatureTypes. Once those tests have been gathered, a lookup is performed on the TypeName of the FeatureTypeInfo to check for specific Integrity validation tests. A list of validation tests is returned from each lookup, if any exist. When all the validation tests have been gathered, each test is iterated through then run on each Feature, with the ValidationResults coming along for the ride, collecting error information.

Parameters:

typeRefs - List of modified features, or null to use stores.keySet()

stores - the Map of effected features (Map of key=typeRef, value="featureSource"

envelope - The bounding box that contains all modified Features

results - Storage for the results of the validation tests.

Throws:

Exception - Throws an exception if the HashMap contains a value that is not a FeatureSource

typeRef

protected String typeRef(Name name)

Convert a Name to a type reference (namespace ":" name)

queryPlugInNames

protected static final Set queryPlugInNames(Map testSuiteDTOs)

load

public void load(File plugins,
                 File testsuites)
          throws Exception

Load testsuites from provided directories.

This is mostly useful for testing, you may want to write your own load method with enhanced error reporting.

Parameters:

plugins - DOCUMENT ME!

testsuites - DOCUMENT ME!

Throws:

Exception - DOCUMENT ME!

load

public void load(Map plugInDTOs,
                 Map testSuiteDTOs)
          throws Exception

Populates this validation processor against the provided DTO objects.

This method is useful for testing, it is not forgiving and will error out if things go bad.

Parameters:

plugInDTOs -

testSuiteDTOs -

Throws:

Exception

ClassNotFoundException - DOCUMENT ME!