org.deegree.ogcwebservices.wfs
Class FeatureDisambiguator

java.lang.Object
  org.deegree.ogcwebservices.wfs.FeatureDisambiguator

 class FeatureDisambiguator
extends Object

Responsible for the normalization of feature collections that are going to be persisted (i.e. inserted into a Datastore). This is necessary, because it is up to WFS clients whether feature ids (gml:id attribute) are provided in an insert/update request or not.

After processing, the resulting feature collection meets the following requirements:

• Every member feature (and subfeature) has a unique feature id that uniquely identifies it. Note that this id is only momentarily valid, and that the final feature id used for storing it is generated by the FeatureIdAssigner class in a later step.
• Features that are equal according to the annotated schema (deegreewfs:IdentityPart declarations) are represented by the same feature instance.
• Complex feature properties use xlink to specify their content if necessary.
• Root features in the feature collection never use xlinks.

Version:

$Revision: 18195 $, $Date: 2009-06-18 17:55:39 +0200 (Do, 18. Jun 2009) $

Author:

Markus Schneider, last edited by: $Author: mschneider $

Constructor Summary

FeatureDisambiguator(FeatureCollection fc)
Creates a new FeatureDisambiguator to disambiguate the given feature collection.

Method Summary

(package private) boolean	checkForAnonymousFeatures() Checks if any anonymous features (without id) are present in the feature collection.
(package private) FeatureCollection	mergeFeatures() Merges all "equal" feature (and subfeature) instances in the associated feature collection that do not have a feature id.

Methods inherited from class java.lang.Object

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

Constructor Detail

FeatureDisambiguator

FeatureDisambiguator(FeatureCollection fc)

Creates a new FeatureDisambiguator to disambiguate the given feature collection.

Parameters:

fc - feature collection to disambiguate

Method Detail

checkForAnonymousFeatures

boolean checkForAnonymousFeatures()

Checks if any anonymous features (without id) are present in the feature collection.

Returns:

true, if one or more anonymous features are present, false otherwise

mergeFeatures

FeatureCollection mergeFeatures()
                          throws DatastoreException

Merges all "equal" feature (and subfeature) instances in the associated feature collection that do not have a feature id. Afterwards, every feature (and subfeature) in the collection has a unique feature id.

It is considered an error if there is more than root feature with the same id after the identification of equal features.

Furthermore, there is always only one feature instance with a certain id, i.e. "equal" features are represented by the same feature instance.

Returns:

"merged" feature collection

Throws:

DatastoreException