IlvSDOFeatureIterator Class Reference

This class converts Oracle SDO geometries retrieved from an Oracle database into IlvMapFeature objects. More...

#include <ilviews/maps/format/oracle/sdoread.h>

Inheritance diagram for IlvSDOFeatureIterator:

List of all members.

Public Member Functions
	IlvSDOFeatureIterator (IldDbms *dbms, const char *query)
	Initializes a feature iterator that can iterate over the result of a specified query.
	IlvSDOFeatureIterator (IldRequest *resultSet)
	Initializes a feature iterator that can iterate over an IldRequest and returns the SDO geometries as IlvMapFeature instances.
virtual IlvFeatureRenderer *	getDefaultFeatureRenderer (IlvDisplay *display)
	Returns the default renderer for this feature iterator.
IlvMapsError	getInitStatus () const
	Returns the error code that may have happened during the iterator initialization.
virtual IlBoolean	getLowerRightCorner (IlvCoordinate &coord) const
	Returns IlFalse.
virtual const IlvMapFeature *	getNextFeature (IlvMapsError &status)
	Converts the next SDO geometry of the iterator into an IlvMapFeature object.
virtual IlvMapFeatureId *	getNextFeatureId (IlvMapsError &status)
	Returns the feature ID for the next object.
const IlvProjection *	getProjection () const
	Returns 0 unless a source projection has been assigned to the iterator.
virtual IlBoolean	getUpperLeftCorner (IlvCoordinate &coord) const
	Returns IlFalse.
IlBoolean	isGeoreferenced () const
	Returns IlTrue if a source projection has been assigned to the iterator.
void	setSourceProjection (IlvProjection *projection)
	Used to specify the source projection of the geometries stored in the SDO database.
virtual IlBoolean	skipNextFeature (IlvMapsError &status)
	Skips the next feature.
Static Public Member Functions
static IlvMapsError	BadRequestError ()
	Returns the error indicating that the request passed to the constructor is invalid.
static IlvMapsError	NoMoreRowError ()
	Returns the error indicating that there is no more row.
Friends
class	IlvDefaultSDOTileLoader

---

Detailed Description

This class converts Oracle SDO geometries retrieved from an Oracle database into IlvMapFeature objects.

Library: ilvdbmaps

It supports the relational implementation of Oracle SDO. The supported Oracle geometries are: POINT, LINESTRING and POLYGON.

See also:

IlvSDOWriter

IlvMapFeature

---

Constructor & Destructor Documentation

IlvSDOFeatureIterator::IlvSDOFeatureIterator

(

IldRequest *

resultSet

)

Initializes a feature iterator that can iterate over an IldRequest and returns the SDO geometries as IlvMapFeature instances.

Parameters:

resultSet

The IldRequest containing the result set of an SDO layer query. A typical query is for instance select from ROADS_SDOGEOM order by 1, 2, 4.

See also:

IlvMapFeature

IlvSDOFeatureIterator::IlvSDOFeatureIterator	(	IldDbms *	dbms,
		const char *	query
	)

Initializes a feature iterator that can iterate over the result of a specified query.

Parameters:

	dbms	The IldDbms connected to the Oracle Data Base.
	query	An SQL query to an SDO layer. A typical query is for instance select from ROADS_SDOGEOM order by 1, 2, 4.

---

Member Function Documentation

virtual IlvFeatureRenderer* IlvSDOFeatureIterator::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.

virtual const IlvMapFeature* IlvSDOFeatureIterator::getNextFeature

(

IlvMapsError &

status

)

[virtual]

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

The ID of the returned map feature is set to the SDO_GID of the SDO geometry.

Parameters:

status

The error that may have been produced by the method.

Implements IlvMapFeatureIterator.

virtual IlvMapFeatureId* IlvSDOFeatureIterator::getNextFeatureId

(

IlvMapsError &

status

)

[virtual]

Returns the feature ID for the next object.

Returns:

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

Parameters:

status

The error that may have been produced by the method. It can be a NoMoreRowError() error.

const IlvProjection* IlvSDOFeatureIterator::getProjection

(

)

const [virtual]

Returns 0 unless a source projection has been assigned to the iterator.

See also:

IlvSDOFeatureIterator::setSourceProjection

Implements IlvMapFeatureIterator.

void IlvSDOFeatureIterator::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.

virtual IlBoolean IlvSDOFeatureIterator::skipNextFeature

(

IlvMapsError &

status

)

[virtual]

Skips the next feature.

Returns:

IlFalse if no more feature is available.

Parameters:

status

The error that may have been produced by the method. It can be a NoMoreRowError() error.