TSLGMLUnhandledFeatureCallback Class Reference

Detailed Description

This callback class allows the user to handle cases where a feature instance is not supported. This may occur in the following scenarios:

• The feature is an instance of a feature type that the schema loader reported as being unsupported.
• The feature type is supported, but this instance contains a GML geometry type that is not supported.
• When loading instance data without a schema, a feature instance was encountered that was more complex than SF-0 permits.

When one of these scenarios occurs, a subset of the original instance data containing the feature instance in question is passed to the user. The XML instance data will be fully formatted.

Public Member Functions
virtual void	unhandledFeature (const char *feature, unsigned int featureLength, const TSLGMLPropertyMapping *propertyMapping, const TSLGMLPropertyMappingSet *propertyMappingSet)=0

Member Function Documentation

unhandledFeature()

virtual void TSLGMLUnhandledFeatureCallback::unhandledFeature ( const char * feature, unsigned int featureLength, const TSLGMLPropertyMapping * propertyMapping, const TSLGMLPropertyMappingSet * propertyMappingSet )

pure virtual

This callback class allows the user to handle cases where a feature instance is not supported. This may occur in the following scenarios:

• The feature is an instance of a feature type that the schema loader reported as being unsupported.
• The feature type is supported, but this instance contains a GML geometry type that is not supported.
• When loading instance data without a schema, a feature instance was encountered that was more complex than SF-0 permits.

When one of these scenarios occurs, a subset of the original instance data containing the feature instance in question is passed to the user. The XML instance data will be fully formatted, will contain any namespace references that are required and any schema imports that the original data contained.

As the TSLGMLInstanceDataLoader may have either a TSLGMLPropertyMapping, a TSLGMLPropertyMappingSet or no property mapping object set upon it, the propertyMapping and propertyMappingSet parameters may be null.

Parameters

featureInstance	A null terminated buffer contain the feature instance.
featureInstanceLength	Although the featureInstance parameter will be null terminated, the parameter will be provided to indicate the length of the string passed. This length will not include the null terminator.
propertyMapping	If a TSLGMLPropertyMapping object has been set on the TSLGMLInstanceDataLoader, then it will be passed through this callback, otherwise this will be null.
propertyMappingSet	If a TSLGMLPropertyMappingSet object has been set on the TSLGMLInstanceDataLoader, then it will be passed through this callback, otherwise this will be null.