rwlogo
Rogue Wave Views 5.5.1

Rogue Wave Views
Maps Package API Reference Guide

Product Documentation:

Rogue Wave Views
Documentation Home

IlvObjectSDOLayer Class Reference

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

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

Inheritance diagram for IlvObjectSDOLayer:
IlvSDOLayer IlvTiledLayer IlvManagerLayer IlvIndexedSet

List of all members.

Public Member Functions

 IlvObjectSDOLayer (IlvSDOTileLoader *sdoTileLoader, IlvTileCache *cache, const char *password=0)
 Initializes an instance of IlvObjectSDOLayer to load data by using the specified tile loader.
 IlvObjectSDOLayer (const IlvMapAdapter *mapAdapter, IldDbms *dbms, const char *tableName, const char *geometryColumnName, IlDouble tileWidth, IlDouble tileHeight, const char *xCoordinateColumnName=0, const char *yCoordinateColumnName=0, const char *keyColumnName=0, const char *password=0)
 Initializes an instance of IlvObjectSDOLayer.
IlBoolean isAttachingAttributes () const
void setAttachingAttributes (IlBoolean attachAttributes)

Detailed Description

Implements load-on-demand layer for an Oracle Spatial data source.

Library: ilvdbmaps


Constructor & Destructor Documentation

IlvObjectSDOLayer::IlvObjectSDOLayer ( const IlvMapAdapter mapAdapter,
IldDbms *  dbms,
const char *  tableName,
const char *  geometryColumnName,
IlDouble  tileWidth,
IlDouble  tileHeight,
const char *  xCoordinateColumnName = 0,
const char *  yCoordinateColumnName = 0,
const char *  keyColumnName = 0,
const char *  password = 0 
)

Initializes an instance of IlvObjectSDOLayer.

Initializes an instance of IlvObjectSDOLayer to load data from the layer, specified by tableName, the name of the table containing the layer and geometryColumnName, the name of the column containing the geometry. This constructor will use an IlvDefaultObjectSDOTileLoader which has some optimizations.

Parameters:
mapAdapter The map adapter used by the layer.
dbms The IldDbms connection to an Oracle database.
tableName The name of the layer table to be loaded.
geometryColumnName The name of the geometry column of the layer. This parameter is useful if the layer has more than one geometry column. If your layer has only one geometry column, just set this parameter to 0.
tileWidth The width of one load-on-demand tile. The width must be given in manager coordinate system (it will be adapted by the map adapter passed as argument).
tileHeight The height of one load-on-demand tile. The Height must be given in manager coordinate system (it will be adapted by the map adapter passed as argument).
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 <ode>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.
keyColumnName The name of the column containing an ID considered as a Key for each geometry. If this parameter is set, then the key value extracted from the keyColumnName column is associated to the IlvMapFeature as its IlvMapFeaturId. The interest of this is that a map feature containing a geometry that belongs to multiple tiles will be loaded just once.
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.
IlvObjectSDOLayer::IlvObjectSDOLayer ( IlvSDOTileLoader sdoTileLoader,
IlvTileCache cache,
const char *  password = 0 
)

Initializes an instance of IlvObjectSDOLayer to load data by using 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.

Member Function Documentation

IlBoolean IlvObjectSDOLayer::isAttachingAttributes (  )  const

Returns IlTrue if the attributes read from the SDO layer are attached to the IlvGraphic objects.

Returns:
IlTrue if the attributes read from the SDO layer are attached to the IlvGraphic objects, IlFalse otherwise.
void IlvObjectSDOLayer::setAttachingAttributes ( IlBoolean  attachAttributes  ) 

Specifies whether the attributes read from the SDO layer should be attached to the IlvGraphic objects as IlvFeatureAttributeProperty. By default, the attributes are not attached to the graphic objects. The attribute of the IlvGraphic can be retreived this way:

 IlvFeatureAttributeProperty* ap =
     (IlvFeatureAttributeProperty*)theGraphic->getNamedProperty(IlvFeatureAttributeProperty::GetName());
 
Parameters:
attachAttributes If set to IlTrue, the attributes are attached to the graphic objects.

© Copyright 2012, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.