This class converts Oracle Spatial geometries retrieved from an Oracle database (9i and above), into IlvMapFeature objects. More...

#include <ilviews/maps/format/oracle/objectmodel/8iread.h>

Inheritance diagram for IlvObjectSDOFeatureIterator:

Public Member Functions
	IlvObjectSDOFeatureIterator (IldDbms dbms, const char request, const char geometryName="GEOMETRY", const char keyColumnName=0, const char xDimensionName=0, const char yDimensionName=0)
	Creates a new feature iterator to read geometries from the specified request. More...

	IlvObjectSDOFeatureIterator (IldRequest request, const char geometryName="GEOMETRY", const char keyColumnName=0, const char xDimensionName=0, const char *yDimensionName=0)
	Creates a new feature iterator to read geometries from the specified request, using the column named geometryName. More...

	IlvObjectSDOFeatureIterator (IldRequest request, const char geometryName, IlvObjectSDOKeyExtractor keyExtractor, const char xDimensionName=0, const char *yDimensionName=0)
	Creates a new feature iterator to read geometries from the specified request. More...

virtual IlvFeatureRenderer *	getDefaultFeatureRenderer (IlvDisplay *)
	Returns the default renderer for this feature iterator. More...

virtual IlvMapsError	getInitStatus () const
	Returns the error code that may have happened during the iterator initialization. More...

virtual IlBoolean	getLowerRightCorner (IlvCoordinate &coord) const
	Returns `IlFalse`. More...

virtual const IlvMapFeature *	getNextFeature (IlvMapsError &status)
	Converts the next SDO geometry of the iterator into an `IlvMapFeature` object. More...

virtual IlvMapFeatureId *	getNextFeatureId (IlvMapsError &status)
	Returns the feature ID for the next object. More...

const IlvProjection *	getProjection () const
	Returns the projection of the data source.

virtual IlBoolean	getUpperLeftCorner (IlvCoordinate &coord) const
	Returns `IlFalse`. More...

IlBoolean	isGeoreferenced () const
	Returns `IlTrue` if a source projection has been assigned to the iterator. More...

IlBoolean	isLoadingAttributes () const
	Returns `IlTrue` if this feature iterator is loading attributes. More...

void	setLoadingAttributes (IlBoolean loadAttributes)
	If loadAttributes is set to `IlTrue`, the iterator will attach attributes to the features read. More...

void	setSourceProjection (IlvProjection *projection)
	Used to specify the source projection of the geometries stored in the SDO database. More...

virtual IlBoolean	skipNextFeature (IlvMapsError &status)
	Skips the next feature. More...

Public Member Functions inherited from IlvMapFeatureIterator
virtual IlvClassInfo *	getClassInfo () const =0
	Returns the class information for this feature iterator. More...

Protected Member Functions
virtual IlvFeatureAttributeProperty *	makeAttributes (IldRequest *req, IlvMapsError &status)
	Reads attributes from the specified result set row. More...

virtual IlvMapGeometry *	makeGeometry (IldADTValue *geomADT, IlvMapsError &status)
	Creates a geometry from the specified object. More...

Friends
class	IlvDefaultObjectSDOTileLoader

Additional Inherited Members
Static Public Member Functions inherited from IlvMapFeatureIterator
static IlvClassInfo *	ClassInfo ()
	Returns the class information of the class. More...

static IlvClassInfo **	ClassInfoRef ()
	Returns the address of the class information of the class. More...

Detailed Description

This class converts Oracle Spatial geometries retrieved from an Oracle database (9i and above), into IlvMapFeature objects.

Library: ilvdbmaps

It supports the object implementation of Oracle Spatial.

It can use an IlvObjectSDOKeyExtractor in order to extract IlvMapFeatureIds from the current request from where it extracts the map features too.

See also: IlvObjectSDOWriter.

Constructor & Destructor Documentation

§ IlvObjectSDOFeatureIterator() [1/3]

IlvObjectSDOFeatureIterator::IlvObjectSDOFeatureIterator	(	IldDbms *	dbms,
		const char *	request,
		const char *	geometryName = `"GEOMETRY"`,
		const char *	keyColumnName = `0`,
		const char *	xDimensionName = `0`,
		const char *	yDimensionName = `0`
	)

Creates a new feature iterator to read geometries from the specified request.

Note that if you pass an keyColumnName (that should represent a DB column whose datatype corresponds to IldIntegerType, IldByteType, IldStringType or IldLongTextType and that has to be a unique Key), the iterator will use a default key extractor in order to associate the column value as an IlvMapFeatureId of the map feature returned. You can use IlvMapFeature::getId() in order to retrieve this value.

Parameters

dbms	The `IldDbms` containing the connection to Oracle.
request	The string representing the query to be executed.
geometryName	The name of the column containing geometries.
keyColumnName	The name of the column containing an ID considered as a Key for each geometry. If set to `0`, no ID is associated to this feature.
xDimensionName	The name of the X dimension. If set to `0`, the index of the X dimension in the metadata table (in the SDO_DIM_ARRAY) will be considered as `0`.
yDimensionName	The name of the Y dimension. If set to `0`, the index of the Y dimension in the metadata table (in the SDO_DIM_ARRAY) will be considered as `1`.

See also: IlvObjectSDOKeyExtractor.

§ IlvObjectSDOFeatureIterator() [2/3]

IlvObjectSDOFeatureIterator::IlvObjectSDOFeatureIterator	(	IldRequest *	request,
		const char *	geometryName = `"GEOMETRY"`,
		const char *	keyColumnName = `0`,
		const char *	xDimensionName = `0`,
		const char *	yDimensionName = `0`
	)

Creates a new feature iterator to read geometries from the specified request, using the column named geometryName.

Note that if you pass an keyColumnName (that should represent a DB column whose datatype corresponds to IldIntegerType, IldByteType, IldStringType or IldLongTextType and that has to be a unique Key), the iterator will use a default key extractor in order to associate the column value as an IlvMapFeatureId of the map feature returned. You can use IlvMapFeature::getId() in order to retrieve this value.

Parameters

request	The `IldRequest` from which geometries are read.
geometryName	The name of the column containing geometries.
keyColumnName	The name of the column containing an ID considered as a Key for each geometry. If set to `0`, no ID is associated to this feature.
xDimensionName	The name of the X dimension. If set to 0, the index of the X dimension in the metadata table (in the SDO_DIM_ARRAY) will be considered as 0.
yDimensionName	The name of the Y dimension. If set to 0, the index of the Y dimension in the metadata table (in the SDO_DIM_ARRAY) will be considered as 1.

See also: IlvObjectSDOKeyExtractor.

§ IlvObjectSDOFeatureIterator() [3/3]

IlvObjectSDOFeatureIterator::IlvObjectSDOFeatureIterator	(	IldRequest *	request,
		const char *	geometryName,
		IlvObjectSDOKeyExtractor *	keyExtractor,
		const char *	xDimensionName = `0`,
		const char *	yDimensionName = `0`
	)

Creates a new feature iterator to read geometries from the specified request.

Parameters

request	The `IldRequest` from which geometries are read.
geometryName	The name of the column containing geometries
keyExtractor	The extractor that can extract features ID from the request rows.
xDimensionName	The name of the X dimension. If set to `0`, the index of the X dimension in the metadata table (in the SDO_DIM_ARRAY) will be considered as `0`.
yDimensionName	The name of the Y dimension. If set to 0, the index of the Y dimension in the metadata table (in the SDO_DIM_ARRAY) will be considered as `1`.

See also: IlvObjectSDOKeyExtractor.

Member Function Documentation

§ getDefaultFeatureRenderer()

virtual IlvFeatureRenderer* IlvObjectSDOFeatureIterator::getDefaultFeatureRenderer ( IlvDisplay * display )

virtual

Returns the default renderer for this feature iterator.

Returns a renderer that can be used to translate the map features returned by this iterator into graphic objects. Feature iterators that store some rendering information in the attributes of the map features, such as color, text font, line thickness and so on, can return a specific renderer which is able to take these attributes into account during the rendering process.

Returns: The default renderer for this feature iterator.

Implements IlvMapFeatureIterator.

§ getInitStatus()

virtual IlvMapsError IlvObjectSDOFeatureIterator::getInitStatus ( ) const

virtual

Returns the error code that may have happened during the iterator initialization.

Returns: The init status of the iterator.

Implements IlvMapFeatureIterator.

§ getLowerRightCorner()

virtual IlBoolean IlvObjectSDOFeatureIterator::getLowerRightCorner ( IlvCoordinate & coord ) const

virtual

Returns IlFalse.

Returns: IlFalse.

Implements IlvMapFeatureIterator.

§ getNextFeature()

virtual const IlvMapFeature* IlvObjectSDOFeatureIterator::getNextFeature ( IlvMapsError & status )

virtual

Converts the next SDO geometry of the iterator into an IlvMapFeature object.

Parameters

status The error status raised by this function call.

Returns: The next available IlvMapFeature.

Implements IlvMapFeatureIterator.

§ getNextFeatureId()

virtual IlvMapFeatureId* IlvObjectSDOFeatureIterator::getNextFeatureId ( IlvMapsError & status )

virtual

Returns the feature ID for the next object.

Parameters

status The error that may have been produced by the method.

Returns: The next feature ID or 0 if no more feature ID is available.

§ getUpperLeftCorner()

virtual IlBoolean IlvObjectSDOFeatureIterator::getUpperLeftCorner ( IlvCoordinate & coord ) const

virtual

Returns IlFalse.

Returns: IlFalse.

Implements IlvMapFeatureIterator.

§ isGeoreferenced()

IlBoolean IlvObjectSDOFeatureIterator::isGeoreferenced ( ) const

Returns IlTrue if a source projection has been assigned to the iterator.

Returns: IlTrue if a source projection has been assigned to the iterator, IlFalse otherwise.

§ isLoadingAttributes()

IlBoolean IlvObjectSDOFeatureIterator::isLoadingAttributes ( ) const

Returns IlTrue if this feature iterator is loading attributes.

Returns: IlTrue if this feature iterator is loading attributes, IlFalse otherwise.

See also: setLoadingAttributes(), makeAttributes().

§ makeAttributes()

virtual IlvFeatureAttributeProperty* IlvObjectSDOFeatureIterator::makeAttributes	(	IldRequest *	req,
		IlvMapsError &	status
	)

protectedvirtual

Reads attributes from the specified result set row.

The default implementation of this method is to attach all columns of the current request to an IlvFeatureAttributeProperty.

The names of the resulting attributes is the same as the database column name of these attributes.

Only columns of known type (see below) are processed.

Types from Db Link IldColumnType are mapped the following way:

IldIntegerType and IldByteType are mapped to IlvIntegerAttribute.
IldRealType, IldMoneyType and IldNumericType are mapped to IlvDoubleAttribute.
IldStringType, IldLongTextType and IldDateType are mapped to IlvStringAttribute.

Parameters

req	The `IldRequest` that contains also the geometry.
status	Status returned: `IlvMaps::NoError()` if the operation was successful or an error code if it failed.

Returns: The created IlvFeatureAttributeProperty.

§ makeGeometry()

virtual IlvMapGeometry* IlvObjectSDOFeatureIterator::makeGeometry	(	IldADTValue *	geomADT,
		IlvMapsError &	status
	)

protectedvirtual

Creates a geometry from the specified object.

Parameters

geomADT	The DbLink `IldADTValue` representing a `MDSYS.SDO_GEOMETRY`.
status	Status returned: `IlvMaps::NoError()` if the operation was successful or an error code if it failed.

Returns: The created IlvMapGeometry.

§ setLoadingAttributes()

void IlvObjectSDOFeatureIterator::setLoadingAttributes ( IlBoolean loadAttributes )

If loadAttributes is set to IlTrue, the iterator will attach attributes to the features read.

See also: isLoadingAttributes(), makeAttributes().

§ setSourceProjection()

void IlvObjectSDOFeatureIterator::setSourceProjection ( IlvProjection * projection )

virtual

Used to specify the source projection of the geometries stored in the SDO database.

The projection will be assigned to the IlvMapFeature produced by this iterator.

Parameters

projection The projection of the geometries stored in the database.

Reimplemented from IlvMapFeatureIterator.

§ skipNextFeature()

virtual IlBoolean IlvObjectSDOFeatureIterator::skipNextFeature ( IlvMapsError & status )

virtual

Skips the next feature.

Parameters

status The error that may have been produced by the method.

Returns: IlFalse if no more features are available.

Public Member Functions

Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

§ IlvObjectSDOFeatureIterator() [1/3]

§ IlvObjectSDOFeatureIterator() [2/3]

§ IlvObjectSDOFeatureIterator() [3/3]

Member Function Documentation

§ getDefaultFeatureRenderer()

§ getInitStatus()

§ getLowerRightCorner()

§ getNextFeature()

§ getNextFeatureId()

§ getUpperLeftCorner()

§ isGeoreferenced()

§ isLoadingAttributes()

§ makeAttributes()

§ makeGeometry()

§ setLoadingAttributes()

§ setSourceProjection()

§ skipNextFeature()