ilog.views.maps.datasource.ibm

Class IlvDBDataSource

java.lang.Object

ilog.views.maps.datasource.IlvMapDataSource

ilog.views.maps.datasource.IlvHierarchicalDataSource

ilog.views.maps.tiling.IlvTilableDataSource

ilog.views.maps.datasource.ibm.IlvDBDataSource

All Implemented Interfaces:

IlvPersistentObject, Serializable

Direct Known Subclasses:

IlvDB2DataSource, IlvInformixDataSource

public abstract class IlvDBDataSource
extends IlvTilableDataSource

An abstract a data source used to read map data from an DB2 and INFORMIX databases.

Since:

JViews 8.7

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class ilog.views.maps.datasource.IlvHierarchicalDataSource

IlvHierarchicalDataSource.CriterionFilter, IlvHierarchicalDataSource.SingleAttributeFilter

Field Summary

Fields inherited from class ilog.views.maps.datasource.IlvHierarchicalDataSource

filename, nameMap, styleMap

Fields inherited from class ilog.views.maps.datasource.IlvMapDataSource

renderer, usingGeodeticComputation

Constructor Summary

Constructors

Constructor and Description
IlvDBDataSource(IlvDBConnectionInfo connection, String layerName) Creates a new IlvDBDataSource.
IlvDBDataSource(IlvInputStream stream) Reads an object from an IlvInputStream.

Method Summary

Modifier and Type	Method and Description
protected abstract IlvDBFeatureIterator	createFeatureIterator() Creates and returns an iterator on the database feature.
protected IlvMapRegionOfInterestIterator	createTiledIterator(IlvMapLayer arg0) Creates an iterator that will iterate through the map features for a specific area of interest.
protected void	createTiledLayers() Creates all the possible map layers that may be needed when load on demand occurs in the data source insertion layer.
IlvCoordinateSystem	getCoordinateSystem() Retrieves the coordinate system of this data source.
protected IlvDBConnectionInfo	getDBConnectionInfo() Returns the database connection used for that data source.
IlvMapReusableFeatureIterator	getFeatureIterator() Retrieves the feature iterator used by this data source.
protected ilog.views.maps.datasource.ibm.internal.DBGeometryColumn	getGeometryColumn() Fetches or returns the database information about the selected geometry column.
IlvMapLayer	getInsertionLayer() Retrieves the insertion layer.
protected abstract ilog.views.maps.datasource.ibm.internal.DBLayerMetaData	getLayerMetaData() Fetches the layer meta data.
int	getRowLimit() Gets the optional limit.
protected void	initInsertionLayer(IlvMapLayer layer) Initializes the insertion IlvMapLayer of this data source and inserts a new IlvManagerLayer in the specified IlvMapLayer.
void	setRowLimit(int rowLimit) Indicates an optional limit to the number of features this data source will retrieve from the database.
void	write(IlvOutputStream stream) Writes this DataSource to an IlvOutputStream;

Methods inherited from class ilog.views.maps.tiling.IlvTilableDataSource

createGenericTiles, getColumnCount, getLatMax, getLatMin, getLonMax, getLonMin, getRowCount, isMultiThreaded, reset, setAreaOfinterest, setMultiThreaded, setTilingParameters, setupTiledLoaders, start, useTiling

Methods inherited from class ilog.views.maps.datasource.IlvHierarchicalDataSource

addCriterionFilter, addLayer, createFeatureRenderer, createInsertionLayer, createStyle, getCriterionFilters, getFeatureRenderer, getFeatureRenderer, getKey, getMapLayer, getStyle, isAcceptNullValues, readInfo, removeAllCriterionFilters, removeCriterionFilter, setAcceptNullValues, setupLayer

Methods inherited from class ilog.views.maps.datasource.IlvMapDataSource

addDataSourceListener, callListeners, getBackupDataSources, getDescription, getManager, getName, getNode, getValidExtentions, hasInsertionLayer, initBackupDataSource, isAttachingAttributes, isGrapherMode, isSaveBackupDataSources, isSourceDataAvailable, isUsingBackupDataSource, isUsingGeodeticComputation, mapIntersects, removeDataSourceListener, setAttachingAttributes, setCoordinateSystem, setDescription, setFeatureRenderer, setForceUsingBackupDataSource, setGrapherMode, setInsertionLayer, setManager, setName, setSaveBackupDataSources, setValidExtentions, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

IlvDBDataSource

public IlvDBDataSource(IlvDBConnectionInfo connection,
                       String layerName)
                throws SQLException,
                       IOException

Creates a new IlvDBDataSource.

Parameters:

connection - The database connection.

layerName - the layer name. This name has to be in the form: tableSchema.tableName.spatialColumn

Throws:

SQLException - if layerName is incorrectly configured.

IOException - the database does not contain the layer.

IlvDBDataSource

public IlvDBDataSource(IlvInputStream stream)
                throws IlvReadFileException,
                       SQLException,
                       IOException

Reads an object from an IlvInputStream.

Parameters:

stream - The stream to read from.

Throws:

IlvReadFileException - if there is a problem reading from stream.

SQLException - if layerName is incorrectly configured.

IOException - the decoding went bad.

Method Detail

write

public void write(IlvOutputStream stream)
           throws IOException

Writes this DataSource to an IlvOutputStream;

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvTilableDataSource

Parameters:

stream - The stream to write to.

Throws:

IOException

createTiledIterator

protected IlvMapRegionOfInterestIterator createTiledIterator(IlvMapLayer arg0)

Creates an iterator that will iterate through the map features for a specific area of interest.

Specified by:

createTiledIterator in class IlvTilableDataSource

Parameters:

arg0 - The layer to create objects for.

Returns:

The feature iterator.

initInsertionLayer

protected void initInsertionLayer(IlvMapLayer layer)

Initializes the insertion IlvMapLayer of this data source and inserts a new IlvManagerLayer in the specified IlvMapLayer.

Overrides:

initInsertionLayer in class IlvMapDataSource

Parameters:

layer - The IlvMapLayer to initialize.

createTiledLayers

protected void createTiledLayers()

Creates all the possible map layers that may be needed when load on demand occurs in the data source insertion layer.

Specified by:

createTiledLayers in class IlvTilableDataSource

getCoordinateSystem

public IlvCoordinateSystem getCoordinateSystem()

Retrieves the coordinate system of this data source.

Overrides:

getCoordinateSystem in class IlvMapDataSource

Returns:

The coordinate system of this data source.

getDBConnectionInfo

protected IlvDBConnectionInfo getDBConnectionInfo()

Returns the database connection used for that data source.

Returns:

the database connection.

getFeatureIterator

public IlvMapReusableFeatureIterator getFeatureIterator()

Retrieves the feature iterator used by this data source.

Overrides:

getFeatureIterator in class IlvHierarchicalDataSource

Returns:

null.

getGeometryColumn

protected ilog.views.maps.datasource.ibm.internal.DBGeometryColumn getGeometryColumn()
                                                                              throws IOException,
                                                                                     SQLException

Fetches or returns the database information about the selected geometry column.

Returns:

the database information.

Throws:

IOException

SQLException

Internal: do not use!

getLayerMetaData

protected abstract ilog.views.maps.datasource.ibm.internal.DBLayerMetaData getLayerMetaData()
                                                                                     throws SQLException,
                                                                                            IOException

Fetches the layer meta data.

Returns:

the meta data.

Throws:

SQLException

IOException

Internal: do not use!

createFeatureIterator

protected abstract IlvDBFeatureIterator createFeatureIterator()
                                                       throws SQLException,
                                                              IOException

Creates and returns an iterator on the database feature.

Returns:

the iterator.

Throws:

SQLException - if database query is incorrect.

IOException - if the database connection went bad.

setRowLimit

public void setRowLimit(int rowLimit)

Indicates an optional limit to the number of features this data source will retrieve from the database. By default, this parameter is '0' which means inactivated.

Parameters:

rowLimit - the optional limit.

getRowLimit

public int getRowLimit()

Gets the optional limit.

Returns:

the optional limit.

getInsertionLayer

public IlvMapLayer getInsertionLayer()

Retrieves the insertion layer.

Overrides:

getInsertionLayer in class IlvMapDataSource

Returns:

The insertion layer.