IlvSDOLayer Class Reference

Implements load-on-demand for an Oracle SDO data source. More...

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

Inheritance diagram for IlvSDOLayer:

List of all members.

Public Member Functions
	IlvSDOLayer (IlvSDOTileLoader *sdoTileLoader, IlvTileCache *cache, const char *password=0)
	Initializes an instance of IlvSDOLayer that loads the data with the specified tile loader.
	IlvSDOLayer (const IlvMapAdapter *mapAdapter, IldDbms *dbms, const char *layerName, IlvTileCache *cache=0, const char *password=0)
	Initializes an instance of IlvSDOLayer that loads the data with the default SDO tile loader which has some optimizations in order to retrieve data more quickly.
virtual	~IlvSDOLayer ()
	Deletes the SDO layer.
IldDbms *	getDbms () const
	Returns the IldDbms of this layer.
IlvFeatureRenderer *	getFeatureRenderer () const
	Returns the feature renderer used to create graphic objects representing the SDO geometries.
IlvMapsError	getInitStatus () const
	Returns the error code that may have happened during the iterator initialization.
void	setFeatureRenderer (IlvFeatureRenderer *renderer)
	Sets the feature renderer used to create graphic objects representing the SDO geometries.
Static Public Member Functions
static IlvMapsError	DbmsUpdate (IldDbms *dbms, const char *userName, const char *oracleSidName, const char *dblinkDriverName)
	When an IlvSDOLayer is read from an .ilv file, its connection (IldDbms) may not be realized immediately. Call this function in order to notify all the objects (the layer itself for instance) waiting for the IldDbms to be connected.

---

Detailed Description

Implements load-on-demand for an Oracle SDO data source.

Library: ilvdbmaps

See also:

IlvTiledLayer

---

Constructor & Destructor Documentation

IlvSDOLayer::IlvSDOLayer	(	const IlvMapAdapter *	mapAdapter,
		IldDbms *	dbms,
		const char *	layerName,
		IlvTileCache *	cache = 0,
		const char *	password = 0
	)

Initializes an instance of IlvSDOLayer that loads the data with the default SDO tile loader which has some optimizations in order to retrieve data more quickly.

Parameters:

	mapadapter	The map adapter used by the layer.
	dbms	The IldDbms.
	layerName	The name of the SDO layer to be loaded on demand.
	cache	The object that manages the release of invisible tiles.
	password	The password the user gives in order to get connected to the Database. This parameter is also necessary to the IldNewDbms function which creates an instance of IldDbms. You can set this parameter for the user's password if you need this password to be saved in your .ilv file when saving your layer. If you don't want your password to be saved, just set this parameter to 0.

See also:

IlvDefaultSDOTileLoader

IlvSDOLayer::IlvSDOLayer	(	IlvSDOTileLoader *	sdoTileLoader,
		IlvTileCache *	cache,
		const char *	password = 0
	)

Initializes an instance of IlvSDOLayer that loads the data with the specified tile loader.

Parameters:

	sdoTileLoader	The tile loader that generates the SQL queries and defines the size of the tiling grid. This tile loader is owned by the layer so that its destructor deletes also the tile loader.
	cache	The object that manages the release of invisible tiles.
	password	The password the user gives in order to get connected to the Database. This parameter is also necessary to the IldNewDbms function which creates an instance of IldDbms. You can set this parameter for the user's password if you need this password to be saved in your .ilv file while saving your layer. If you don't want your password to be saved, just set this parameter to 0.

virtual IlvSDOLayer::~IlvSDOLayer

(

)

[virtual]

Deletes the SDO layer.

It also deletes the tile loader passed as argument to the constructor.

---

Member Function Documentation

static IlvMapsError IlvSDOLayer::DbmsUpdate	(	IldDbms *	dbms,
		const char *	userName,
		const char *	oracleSidName,
		const char *	dblinkDriverName
	)			[static]

When an IlvSDOLayer is read from an .ilv file, its connection (IldDbms) may not be realized immediately. Call this function in order to notify all the objects (the layer itself for instance) waiting for the IldDbms to be connected.

The connection string to create the IldDbms is of the following shape: userName/password.

Parameters:

	dbms	The IldDbms that has to be connected.
	userName	The name of the user (that has been used to create the IldDbms).
	oracleSidName	The sid (that has been used to create the IldDbms).
	dblinkDriverName	The DbLink oracle driver (can be oracle9, oracle10 or oracle11). The function IldNewDbms uses this parameter as its first parameter (dbmsName).

IlvFeatureRenderer* IlvSDOLayer::getFeatureRenderer

(

)

const

Returns the feature renderer used to create graphic objects representing the SDO geometries.

The layer is the owner of the returned renderer and will delete it.

By default, it is an IlvDefaultFeatureRenderer.

void IlvSDOLayer::setFeatureRenderer

(

IlvFeatureRenderer *

renderer

)

Sets the feature renderer used to create graphic objects representing the SDO geometries.

The layer is the owner of the renderer and will delete it.

Parameters:

renderer

The renderer of the layer.