Package com.luciad.format.database

Interface ILcdDatabaseFactory

public interface ILcdDatabaseFactory

This interface specifies a set of methods that create a basis for accessing a spatial database.

Method Summary

Modifier and Type	Method	Description
ILcdDatabaseDecoder	createDatabaseDecoder(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)	Creates a proper ILcdDatabaseDecoder for the model.
ILcdDatabaseEncoder	createDatabaseEncoder(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)	Creates a proper ILcdDatabaseEncoder for the model.
ILcdDatabaseModelDescriptor	createDatabaseModelDescriptor(String aPrefix, Properties aProperties)	Creates a ILcdDatabaseModelDescriptor based on the given Properties.
ILcdModelReference	createModelReference(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)	Creates a new ILcdModelReference object, based on the ILcdDatabaseModelDescriptor.
void	createTable(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)	Connects to the database and creates a new empty spatial table, based on the information in the given ILcdDatabaseModelDescriptor.
void	decodeInfo(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)	Opens the given ILcdDatabaseModelDescriptor by connecting to the Database database and retrieving necessary information on the spatial table.

Method Details

createDatabaseModelDescriptor

ILcdDatabaseModelDescriptor createDatabaseModelDescriptor(String aPrefix,
 Properties aProperties)

Creates a ILcdDatabaseModelDescriptor based on the given Properties.

createDatabaseDecoder

ILcdDatabaseDecoder createDatabaseDecoder(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)

Creates a proper ILcdDatabaseDecoder for the model.

Parameters:

aDatabaseModelDescriptor - the ILcdDatabaseModelDescriptor of the model

createDatabaseEncoder

ILcdDatabaseEncoder createDatabaseEncoder(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)

Creates a proper ILcdDatabaseEncoder for the model.

Parameters:

aDatabaseModelDescriptor - the ILcdDatabaseModelDescriptor of the model

createModelReference

ILcdModelReference createModelReference(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)

Creates a new ILcdModelReference object, based on the ILcdDatabaseModelDescriptor.

decodeInfo

void decodeInfo(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)
         throws IOException

Opens the given ILcdDatabaseModelDescriptor by connecting to the Database database and retrieving necessary information on the spatial table.

Parameters:

aDatabaseModelDescriptor - the ILcdDatabaseModelDescriptor with a valid driver, URL, connection properties, table name, and column name.

Throws:

IOException

createTable

void createTable(ILcdDatabaseModelDescriptor aDatabaseModelDescriptor)
          throws IOException,
IllegalArgumentException

Connects to the database and creates a new empty spatial table, based on the information in the given ILcdDatabaseModelDescriptor.

Parameters:

aDatabaseModelDescriptor - a fully specified ILcdDatabaseModelDescriptor.

Throws:

IOException - if a database access error occurs. This includes the case where the database table already exists.

IllegalArgumentException - if aDatabaseModelDescriptor contains insufficient information to create a new database.