TSLGMLApplicationSchemaFactory Class Reference

Detailed Description

This class is used for creating GML application schemas.

A GML application schema is created based upon the following 3 sets of information:

1. A TSLStandardDataLayer - The feature classes declared within the layer's feature class list are used to create the schema's feature definitions. The properties of those feature definitions are determined by the layer's data handler (TSLDataHandler) and, optionally, a property mapping object provided to the factory.
2. A TSLGMLApplicationSchemaCreationParameters - This object is used to provide such things as the target namespace, version and GML profile of the application schema.
3. A TSLGMLPropertyMapping or TSLGMLPropertyMappingSet - An instance of one of these classes may optionally be provided during the schema creation process to allow mapping of property and attributes of MapLink entities onto GML feature properties. The TSLGMLPropertyMappingSet class allows differing mappings to be used for each GML feature definition, whereas the TSLGMLPropertyMapping class should be used when the same mapping is desired for all feature definitions.

Public Member Functions
	TSLGMLApplicationSchemaFactory ()
void	destroy ()
TSLGMLApplicationSchema *	create (const TSLStandardDataLayer *layer, const TSLGMLApplicationSchemaCreationParameters *creationParams)
TSLGMLApplicationSchema *	create (const TSLStandardDataLayer *layer, const TSLGMLApplicationSchemaCreationParameters *creationParams, const TSLGMLPropertyMapping *mapping)
TSLGMLApplicationSchema *	create (const TSLStandardDataLayer *layer, const TSLGMLApplicationSchemaCreationParameters *creationParams, const TSLGMLPropertyMappingSet *mappingSet)
void *	operator new (size_t size)
void *	operator new (size_t size, char *filename, int line)

Constructor & Destructor Documentation

TSLGMLApplicationSchemaFactory()

TSLGMLApplicationSchemaFactory::TSLGMLApplicationSchemaFactory

(

)

Constructor

Member Function Documentation

create() [1/3]

TSLGMLApplicationSchema * TSLGMLApplicationSchemaFactory::create	(	const TSLStandardDataLayer *	layer,
		const TSLGMLApplicationSchemaCreationParameters *	creationParams )

Create a GML application schema using the parameters passed. This variant of the create method does not take either a TSLGMLPropertyMapping nor TSLGMLPropertyMappingSet object as a parameter.

Parameters

layer	The layer provides the names of the GML features that the schema will define as well as provide the properties that those definitions will contain.
creationParams	This object will provide other bits of information used when creating the schema such as the target namespace, version and profile to which the schema should conform.

On success, a TSLGMLApplicationSchema instance will be returned, null otherwise. The returned instance should be deleted when it is no longer required.

create() [2/3]

TSLGMLApplicationSchema * TSLGMLApplicationSchemaFactory::create	(	const TSLStandardDataLayer *	layer,
		const TSLGMLApplicationSchemaCreationParameters *	creationParams,
		const TSLGMLPropertyMapping *	mapping )

Create a GML application schema using the parameters passed. This variant of the create method takes a TSLGMLPropertyMapping object as a parameter.

Parameters

layer	The layer provides the names of the GML features that the schema will define as well as provide the properties that those definitions will contain.
creationParams	This object will provide other bits of information used when creating the schema such as the target namespace, version and profile to which the schema should conform.
mapping	The mapping object passed provides addition properties that each GML feature definition will contain. Those feature properties will be based upon properties and attibutes of the MapLink entities that the GML instance data is created from.

On success, a TSLGMLApplicationSchema instance will be returned, null otherwise. The returned instance should be deleted when it is no longer required.

create() [3/3]

TSLGMLApplicationSchema * TSLGMLApplicationSchemaFactory::create	(	const TSLStandardDataLayer *	layer,
		const TSLGMLApplicationSchemaCreationParameters *	creationParams,
		const TSLGMLPropertyMappingSet *	mappingSet )

Create a GML application schema using the parameters passed. This variant of the create method takes a TSLGMLPropertyMappingSet object as a parameter.

Parameters

layer	The layer provides the names of the GML features that the schema will define as well as provide the properties that those definitions will contain.
creationParams	This object will provide other bits of information used when creating the schema such as the target namespace, version and profile to which the schema should conform.
mappingSet	The mapping set object passed provides addition properties that the GML feature definitions will contain, with differing mappings for each feature defintion. Those feature properties will be based upon properties and attibutes of the MapLink entities that the GML instance data is created from.

On success, a TSLGMLApplicationSchema instance will be returned, null otherwise. The returned instance should be deleted when it is no longer required.

destroy()

void TSLGMLApplicationSchemaFactory::destroy

(

)

Destroy this object.

This method must be used instead of delete.

operator new() [1/2]

void * TSLGMLApplicationSchemaFactory::operator new

(

size_t

size

)

operator new() [2/2]

void * TSLGMLApplicationSchemaFactory::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.