|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.geotools.validation.ValidationProcessor
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);
Field Summary | |
static java.lang.Object |
ANYTYPENAME
|
Constructor Summary | |
ValidationProcessor()
ValidationProcessor constructor. |
|
ValidationProcessor(java.util.Map testSuites,
java.util.Map plugIns)
ValidationProcessor constructor. |
Method Summary | |
void |
addValidation(FeatureValidation validation)
addValidation |
void |
addValidation(IntegrityValidation validation)
addValidation |
java.util.Set |
getDependencies(java.lang.String typeName)
getDependencies purpose. |
void |
runFeatureTests(org.geotools.feature.FeatureType type,
org.geotools.feature.FeatureCollection collection,
ValidationResults results)
runFeatureTests |
void |
runIntegrityTests(java.util.Map stores,
com.vividsolutions.jts.geom.Envelope envelope,
ValidationResults results)
runIntegrityTests |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
public static final java.lang.Object ANYTYPENAME
Constructor Detail |
public ValidationProcessor()
Initializes the data structure to hold the validations.
public ValidationProcessor(java.util.Map testSuites, java.util.Map plugIns)
Builds a ValidationProcessor with the DTO provided.
testSuites
- Map a map of names -> TestSuiteDTO objectsplugIns
- Map a map of names -> PlugInDTO objectsMethod Detail |
public void addValidation(FeatureValidation validation)
Add a FeatureValidation to the list of Feature tests
validation
- public void addValidation(IntegrityValidation validation)
Add an IntegrityValidation to the list of Integrity tests
validation
- public java.util.Set getDependencies(java.lang.String typeName)
Gets all the FeatureTypes that this FeatureTypeInfo uses.
typeName
- the FeatureTypeName
public void runFeatureTests(org.geotools.feature.FeatureType type, org.geotools.feature.FeatureCollection collection, ValidationResults results) throws java.lang.Exception
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 "FeatureCollection collection" should be changed later to take in a FeatureSource so not everything is loaded into memory.
type
- The FeatureTypeInfo of the features being tested.collection
- The collection of features, of a particulare
FeatureTypeInfo "type", that are to be validated.results
- Storage for the results of the validation tests.
java.lang.Exception
- FeatureValidations throw Exceptionspublic void runIntegrityTests(java.util.Map stores, com.vividsolutions.jts.geom.Envelope envelope, ValidationResults results) throws java.lang.Exception
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 FeatureSource (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.
stores
- the Map of modified features (Map of key=featureTypeName,
value="featureSource"envelope
- The bounding box that contains all modified Featuresresults
- Storage for the results of the validation tests.
java.lang.Exception
- Throws an exception if the HashMap contains a value
that is not a FeatureSource
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |