com.luciad.format.db2.spatial

Database ConnectorsClass TLcdDB2SpatialModelDescriptor

java.lang.Object

com.luciad.model.TLcdModelDescriptor

com.luciad.model.TLcdFeaturedModelDescriptor

com.luciad.format.database.TLcdDatabaseModelDescriptor

com.luciad.format.db2.spatial.TLcdDB2SpatialModelDescriptor

All Implemented Interfaces:

ILcdAnnotatedElement, ILcdDatabaseModelDescriptor, com.luciad.internal.format.database.ILinDatabaseModelDescriptor2, ILcdDataModelDescriptor, ILcdModelDescriptor, ILcdFeaturedDescriptor , ILcdFeaturedDescriptorProvider , Serializable, Cloneable

public class TLcdDB2SpatialModelDescriptor
extends TLcdDatabaseModelDescriptor
implements ILcdDatabaseModelDescriptor

This ILcdDatabaseModelDescriptor describes a layer from an DB2 Spatial database.

For accessing an existing Spatial layer, the following information is required:

• a database driver,
• a database URL,
• connection properties,
• a table name,
• a column name containing the geometries,
• a display names,
• an optional list of feature names,
• an optional selection filter, with additional selection tables.

For creating a new Spatial layer, the following additional information is required:

• a list of data types corresponding to the optional feature names.

Since:

8.3.03

See Also:

"IBM DB2 Spatial Extender Module with the Geodetic Management Feature, versions 9.x.", Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	TYPE_NAME

Fields inherited from class com.luciad.format.database.TLcdDatabaseModelDescriptor

fConnection

Fields inherited from class com.luciad.model.TLcdFeaturedModelDescriptor

fFeatureClasses, fFeatureNames

Constructor Summary

Constructors

Constructor and Description
TLcdDB2SpatialModelDescriptor() Constructs a new (invalid) DB2 Spatial layer descriptor with default properties.
TLcdDB2SpatialModelDescriptor(String aDriver, String aURL, Properties aConnectionProperties, String aTableName, String aGeometryColumnName) Constructs a new DB2 Spatial table descriptor that does not specify any feature columns.
TLcdDB2SpatialModelDescriptor(String aDriver, String aURL, Properties aConnectionProperties, String aTableName, String aGeometryColumnName, String[] aFeatureNames, int aPrimaryFeatureIndex) Constructs a new DB2 Spatial table descriptor specifying the names of the columns to be used as features.
TLcdDB2SpatialModelDescriptor(String aDriver, String aURL, Properties aConnectionProperties, String aTableName, String aGeometryColumnName, String[] aFeatureNames, int aPrimaryFeatureIndex, boolean aPrimaryFeatureAutoGenerated) Constructs a new DB2 Spatial table descriptor specifying the names of the columns to be used as features.

Method Summary

Modifier and Type	Method and Description
String	getWKTReference() Deprecated.
boolean	isGeodetic() Deprecated.
void	setEllipsoid(ILcdEllipsoid aEllipsoid) Sets the ellipsoid of the database object's reference.
void	setWKTReference(String aWKTReference) Deprecated.

Methods inherited from class com.luciad.format.database.TLcdDatabaseModelDescriptor

addAnnotation, clone, close, getAnnotation, getAnnotations, getBounds, getColumnNames, getColumnNames, getColumnNamesAndTypes, getColumnNamesAndTypes, getConnection, getConnectionProperties, getDataModel, getDriver, getEllipsoid, getFeatureDisplayName, getFeatureType, getGeometryColumnName, getGeometryQueryColumnName, getGeometryType, getModelElementType, getModelElementTypes, getModelTypes, getPrimaryFeatureIndex, getSelectionFilter, getSelectionTables, getSRID, getTableName, getURL, isAlwaysCloseConnection, isAnnotationPresent, isPrimaryFeatureAutoGenerated, removeAnnotation, setAlwaysCloseConnection, setBounds, setConnectionProperties, setDriver, setFeatureClasses, setFeatureDisplayNames, setFeatureNames, setFeatureTypes, setGeometryColumnName, setGeometryQueryColumnName, setGeometryType, setPrimaryFeatureAutoGenerated, setPrimaryFeatureIndex, setSelectionFilter, setSelectionTables, setSRID, setTableName, setTypeName, setURL

Methods inherited from class com.luciad.model.TLcdFeaturedModelDescriptor

getFeatureClass, getFeatureCount, getFeaturedDescriptor, getFeatureIndex, getFeatureName

Methods inherited from class com.luciad.model.TLcdModelDescriptor

getDisplayName, getSourceName, getTypeName, setDisplayName, setSourceName, sourceNameToDisplayName

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.luciad.format.database.ILcdDatabaseModelDescriptor

clone, close, getBounds, getColumnNames, getColumnNamesAndTypes, getEllipsoid, getFeatureName, getFeatureType, getGeometryColumnName, getGeometryType, getPrimaryFeatureIndex, getSelectionFilter, getSelectionTables, getSRID, getTableName, setBounds, setFeatureNames, setFeatureTypes, setGeometryColumnName, setGeometryType, setPrimaryFeatureIndex, setSelectionFilter, setSelectionTables, setSRID, setTableName

Methods inherited from interface com.luciad.model.ILcdDataModelDescriptor

getDataModel, getModelElementTypes, getModelTypes

Methods inherited from interface com.luciad.model.ILcdModelDescriptor

getDisplayName, getSourceName, getTypeName

Methods inherited from interface com.luciad.util.ILcdFeaturedDescriptor

getFeatureClass, getFeatureCount, getFeatureIndex, getFeatureUnitOfMeasure

Methods inherited from interface com.luciad.internal.format.database.ILinDatabaseModelDescriptor2

closeConnection

Field Detail

TYPE_NAME

public static final String TYPE_NAME

See Also:

Constant Field Values

Constructor Detail

TLcdDB2SpatialModelDescriptor

public TLcdDB2SpatialModelDescriptor()

Constructs a new (invalid) DB2 Spatial layer descriptor with default properties.

TLcdDB2SpatialModelDescriptor

public TLcdDB2SpatialModelDescriptor(String aDriver,
                                     String aURL,
                                     Properties aConnectionProperties,
                                     String aTableName,
                                     String aGeometryColumnName)

Constructs a new DB2 Spatial table descriptor that does not specify any feature columns.

Parameters:

aDriver - the JDBC driver name.

aURL - the JDBC connection URL.

aConnectionProperties - the connection properties, including 'user' and 'password'.

aTableName - the spatial layer name.

aGeometryColumnName - the name of the column containing spatial objects.

TLcdDB2SpatialModelDescriptor

public TLcdDB2SpatialModelDescriptor(String aDriver,
                                     String aURL,
                                     Properties aConnectionProperties,
                                     String aTableName,
                                     String aGeometryColumnName,
                                     String[] aFeatureNames,
                                     int aPrimaryFeatureIndex)

Constructs a new DB2 Spatial table descriptor specifying the names of the columns to be used as features.

Parameters:

aDriver - the JDBC driver name.

aURL - the JDBC connection URL.

aConnectionProperties - the connection properties, including 'user' and 'password'.

aTableName - the spatial layer name.

aGeometryColumnName - the name of the column containing spatial objects.

aFeatureNames - the column names of the features that should be retrieved.

aPrimaryFeatureIndex - the index of the feature that can be used a a primary key on the spatial table.

TLcdDB2SpatialModelDescriptor

public TLcdDB2SpatialModelDescriptor(String aDriver,
                                     String aURL,
                                     Properties aConnectionProperties,
                                     String aTableName,
                                     String aGeometryColumnName,
                                     String[] aFeatureNames,
                                     int aPrimaryFeatureIndex,
                                     boolean aPrimaryFeatureAutoGenerated)

Constructs a new DB2 Spatial table descriptor specifying the names of the columns to be used as features.

Parameters:

aDriver - the JDBC driver name.

aURL - the JDBC connection URL.

aConnectionProperties - the connection properties, including 'user' and 'password'.

aTableName - the spatial layer name.

aGeometryColumnName - the name of the column containing spatial objects.

aFeatureNames - the column names of the features that should be retrieved.

aPrimaryFeatureIndex - the index of the feature that can be used a a primary key on the spatial table.

aPrimaryFeatureAutoGenerated - specifies whether the primary key is automatically generated by the database.

Method Detail

getWKTReference

public String getWKTReference()

Deprecated.

Retrieves the Well-Known-Text specified in the database.

Do not use this method - it is deprecated and will be removed in the future.

Returns:

the WKT

setWKTReference

public void setWKTReference(String aWKTReference)

Deprecated.

Sets the Well-Known-Text used for creating the model reference.

Do not use this method - it is deprecated and will be removed in the future.

Parameters:

aWKTReference - the well-known-text.

isGeodetic

public boolean isGeodetic()

Deprecated.

Returns true if the Spatial Reference ID number (SRID) corresponds to DB2 geodetic data, or false otherwise. Note that in this context "geodetic" means that the database is using a round-Earth representation for keeping geometry information. This property is not necessarily related to the returned model reference, which may be overridden by the user (see TLcdDB2SpatialModelDecoder).

Do not use this method - it is deprecated and will be removed in the future.

Returns:

true if the SRID corresponds to DB2 geodetic data, false otherwise.

setEllipsoid

public void setEllipsoid(ILcdEllipsoid aEllipsoid)

Description copied from interface: ILcdDatabaseModelDescriptor

Sets the ellipsoid of the database object's reference.

Specified by:

setEllipsoid in interface ILcdDatabaseModelDescriptor

Overrides:

setEllipsoid in class TLcdDatabaseModelDescriptor

Parameters:

aEllipsoid - the ellipsoid of the database object's reference.