TSLGMLPropertyMappingSet Class Reference

Detailed Description

This class is used to hold a set of TSLGMLPropertyMapping objects, with each one linked to a specific feature name. This allows different property mappings to be applied to each feature type when reading or writing GML instance data.

Each feature name may only be mapping to once in each property mapping set.

Instances of this class may optionally be used when loading GML instance data, when creating a GML application schema through the TSLGMLApplication SchemaFactory and when writing GML instance data using the TSLGMLInstanceData Writer. Additionally instances may be added to a TSLGMLPropertyMappingSet, to allow difference mappings to be used for each GML feature type.

Public Member Functions
	TSLGMLPropertyMappingSet ()
bool	addMapping (const TSLSimpleString &featureName, TSLGMLPropertyMapping *mapping)
void	destroy ()
const TSLGMLPropertyMapping *	getMapping (const TSLSimpleString &featureName) const
bool	removeMapping (const TSLSimpleString &featureName)
void *	operator new (size_t size)
void *	operator new (size_t size, char *filename, int line)

Constructor & Destructor Documentation

TSLGMLPropertyMappingSet()

TSLGMLPropertyMappingSet::TSLGMLPropertyMappingSet

(

)

Constructor

Member Function Documentation

addMapping()

bool TSLGMLPropertyMappingSet::addMapping	(	const TSLSimpleString &	featureName,
		TSLGMLPropertyMapping *	mapping )

Adds an entry to this property mapping set. If the feature name passed already exists in the set, then this method will fail and return false. If the feature name does not exist in the set, then a new entry is added to the set.

Parameters

featureName	The name of the GML feature/feature class to add a mapping for.
mapping	The property mapping object. If this value is null, then the call to this method will fail. This class takes ownership of the object passed if the call succeeds.

Returns

true on success, false otherwise.

destroy()

void TSLGMLPropertyMappingSet::destroy

(

)

Destroy this object.

This method must be used instead of delete.

getMapping()

const TSLGMLPropertyMapping * TSLGMLPropertyMappingSet::getMapping

(

const TSLSimpleString &

featureName

)

const

Queries an entry in this property mapping set. If an entry exists for the feature name passed, then the corresponding mapping is returned, otherwise null.

Parameters

featureName

The name of the GML feature/feature class to query if an entry exists for.

Returns

the property mapping that corresponds to the feature name passed should one exist, null otherwise.

operator new() [1/2]

void * TSLGMLPropertyMappingSet::operator new

(

size_t

size

)

operator new() [2/2]

void * TSLGMLPropertyMappingSet::operator new	(	size_t	size,
		char *	filename,
		int	line )

When included in an MFC application in debug mode, the debug new expects this to be here. Override it and return the same as the normal one. The library must include it when compiled in release mode, since the user's application may be in debug mode.

removeMapping()

bool TSLGMLPropertyMappingSet::removeMapping

(

const TSLSimpleString &

featureName

)

Removes an entry in this property mapping set.

Parameters

featureName

The name of the GML feature/feature class of the entry that is to be removed.

Returns

true if the entry was successfully removed, false otherwise.