com.lutris.appserver.server.sql.informix
Class InformixLogicalDatabase

java.lang.Object
  com.lutris.appserver.server.sql.standard.StandardLogicalDatabase
      com.lutris.appserver.server.sql.informix.InformixLogicalDatabase

All Implemented Interfaces:

LogicalDatabase, DriverSpecificConstants, CacheConstants

public class InformixLogicalDatabase
extends StandardLogicalDatabase

Represents a logical database with Informix capabilities.

Since:

LBS1.8

Version:

$Revision: 1.1 $

Author:

Kyle Clark

Field Summary

protected int	defaultQueryTimeout The amount of time (in seconds) that a query will block before throwing an exception.
protected int	defaultTransactionTimeout The amount of time (in seconds) that a transaction will block before throwing an exception.

Fields inherited from class com.lutris.appserver.server.sql.standard.StandardLogicalDatabase

connectionAllocator, dbName, dbType, driver, driverClassName, objectIdAllocator, PARAMNAME_DRIV_DEP_CLASS, transactionFactory

Fields inherited from interface org.enhydra.dods.cache.CacheConstants

COMPLEX_QUERY_CACHE, DATA_CACHE, DATA_CACHING, DEFAULT_All_READONLY, DEFAULT_APP_NAME, DEFAULT_ASYNCH_LOAD_PRIORITY, DEFAULT_ASYNCH_LOAD_THREAD_NUM, DEFAULT_AUTO_SAVE, DEFAULT_AUTO_SAVE_CREATE_VIRGIN, DEFAULT_AUTO_WRITE, DEFAULT_CACHE_PERCENTAGE, DEFAULT_CACHE_PERSISTENCE_ON_DISABLE_CACHING, DEFAULT_CACHE_PERSISTENCE_ON_SHUTDOWN, DEFAULT_CASE_SENSITIVE, DEFAULT_DEADLOCK_READ_TIME, DEFAULT_DEADLOCK_RETRY_NUMBER, DEFAULT_DEFAULT_FETCH_SIZE, DEFAULT_DELETE_CHECK_VERSION, DEFAULT_DODS_CACHE_FACTORY, DEFAULT_FULL_CACHE_COUNT_LIMIT, DEFAULT_INCREMENT_VERSIONS, DEFAULT_INITIAL_ALL_CACHES, DEFAULT_INITIAL_CACHE_FETCH_SIZE, DEFAULT_INITIAL_CONDITION, DEFAULT_INITIAL_DS_CACHE_SIZE, DEFAULT_LAZY_LOADING, DEFAULT_MAX_CACHE_SIZE, DEFAULT_MAX_COMPLEX_QUERY_CACHE_SIZE, DEFAULT_MAX_EXECUTE_TIME, DEFAULT_MAX_EXECUTE_TIME_CACHE_INIT, DEFAULT_MAX_MULTI_JOIN_QUERY_CACHE_SIZE, DEFAULT_MAX_SIMPLE_QUERY_CACHE_SIZE, DEFAULT_QUERY_TIME_LIMIT_CACHE_INIT, DEFAULT_QUERY_TIMEOUT, DEFAULT_QUERY_TIMEOUT_CACHE_INIT, DEFAULT_READONLY, DEFAULT_RESERVE_FACTOR, DEFAULT_SELECT_OIDS, DEFAULT_SIMPLE_CACHE_ROW_COUNT_LIMIT, DEFAULT_SYNCH_LOAD_ROW_COUNT_LIMIT, DEFAULT_TRANSACTION_CACHES, DEFAULT_TRANSACTION_CHECK, FULL_CACHE_COUNT_LIMIT, MULTI_JOIN_QUERY_CACHE, PARAMNAME_ALL_READ_ONLY, PARAMNAME_APP_NAME, PARAMNAME_ASYNCH_LOAD_PRIORITY, PARAMNAME_ASYNCH_LOAD_THREAD_NUM, PARAMNAME_AUTO_SAVE, PARAMNAME_AUTO_SAVE_CREATE_VIRGIN, PARAMNAME_AUTO_WRITE, PARAMNAME_CACHE_PERCENTAGE, PARAMNAME_CACHE_PERSISTENCE_ON_DISABLE_CACHING, PARAMNAME_CACHE_PERSISTENCE_ON_SHUTDOWN, PARAMNAME_CACHE_PERSISTENCE_ROOT, PARAMNAME_CASE_SENSITIVE, PARAMNAME_DEADLOCK_READ_TIME, PARAMNAME_DEADLOCK_RETRY_NUMBER, PARAMNAME_DEFAULT_FETCH_SIZE, PARAMNAME_DELETE_CHECK_VERSION, PARAMNAME_DODS_CACHE_FACTORY, PARAMNAME_INCREMENT_VERSIONS, PARAMNAME_INITIAL_ALL_CACHES, PARAMNAME_INITIAL_CACHE_FETCH_SIZE, PARAMNAME_INITIAL_CONDITION, PARAMNAME_INITIAL_DS_CACHE_SIZE, PARAMNAME_LAZY_LOADING, PARAMNAME_MAX_CACHE_SIZE, PARAMNAME_MAX_COMPLEX_CACHE_SIZE, PARAMNAME_MAX_EXECUTE_TIME, PARAMNAME_MAX_EXECUTE_TIME_CACHE_INIT, PARAMNAME_MAX_MULTI_JOIN_CACHE_SIZE, PARAMNAME_MAX_SIMPLE_CACHE_SIZE, PARAMNAME_QUERY_TIME_LIMIT_CACHE_INIT, PARAMNAME_QUERY_TIMEOUT, PARAMNAME_QUERY_TIMEOUT_CACHE_INIT, PARAMNAME_READ_ONLY, PARAMNAME_RESERVE_FACTOR, PARAMNAME_SELECT_OIDS, PARAMNAME_SIMPLE_CACHE_ROW_COUNT_LIMIT, PARAMNAME_SYNCH_LOAD_ROW_COUNT_LIMIT, PARAMNAME_TRANSACTION_CACHES, PARAMNAME_TRANSACTION_CHECK, QUERY_CACHING, SIMPLE_QUERY_CACHE

Fields inherited from interface com.lutris.appserver.server.sql.standard.DriverSpecificConstants

DEFAULT_CUSTOM_NOT_EQUAL_SQL_OPERATOR, DEFAULT_DISABLE_FETCH_SIZE_WITH_MAX_ROWS, DEFAULT_PREPARE_STATEMENT_CACHE_LATENCY, DEFAULT_RESULT_SET_CONCURRENCY, DEFAULT_RESULT_SET_TYPE, DEFAULT_SET_BOOLEAN_AS_STRING, DEFAULT_SET_BYTES_AS_BINARY_STREAM, DEFAULT_SET_BYTES_AS_LONGVARBINARY, DEFAULT_SET_NULL_AS_VARCHAR, DEFAULT_USE_BINARY_STREAM_FOR_LONGVARCHAR, DEFAULT_USE_CURSOR_NAME, DEFAULT_USE_PREFIX_WITH_UPDATE, DEFAULT_USE_TOP_SYNTAX, PARAMNAME_CUSTOM_NOT_EQUAL_SQL_OPERATOR, PARAMNAME_DISABLE_FETCH_SIZE_WITH_MAX_ROWS, PARAMNAME_PREPARE_STATEMENT_CACHE_LATENCY, PARAMNAME_RESULT_SET_CONCURRENCY, PARAMNAME_RESULT_SET_TYPE, PARAMNAME_SET_BOOLEAN_AS_STRING, PARAMNAME_SET_BYTES_AS_BINARY_STREAM, PARAMNAME_SET_BYTES_AS_LONGVARBINARY, PARAMNAME_SET_NULL_AS_VARCHAR, PARAMNAME_USE_BINARY_STREAM_FOR_LONGVARCHAR, PARAMNAME_USE_CURSOR_NAME, PARAMNAME_USE_PREFIX_WITH_UPDATE, PARAMNAME_USE_TOP_SYNTAX, UNDEFINED_PREPARE_STATEMENT_CACHE_LATENCY

Constructor Summary

InformixLogicalDatabase()
Default constructor to configure a single logical database.

InformixLogicalDatabase(java.lang.String dbName, Config dbConfig)
Creates and configures a single logical database.

InformixLogicalDatabase(java.lang.String dbName, Config dbConfig, DatabaseManagerConfiguration DbManagerConf)
Creates and configures a single logical database.

Method Summary

protected int	getDefaultQueryTimeout() Returns the configured default amount of time (in seconds) that a query should block before throwing an exception.
protected int	getDefaultTransactionTimeout() Returns the configured default amount of time (in seconds) that a transaction should block before throwing an exception.
java.lang.String	getType() Return a description of the logical database type.
ConnectionAllocator	loadConnectionAllocator(Config connectionConfig) Return the connection allocator.
ObjectIdAllocator	loadObjectIdAllocator(Config objIdConfig) Return the object id allocator.

Methods inherited from class com.lutris.appserver.server.sql.standard.StandardLogicalDatabase

allocateConnection, allocateObjectId, allocateObjectId, checkOId, checkOId, createQuery, createTransaction, getActiveConnectionCount, getDatabaseConfiguration, getDisableFetchSizeWithMaxRows, getDriverClassName, getDriverDependencies, getDriverProperty, getMaxConnectionCount, getMaxConnectionCountDate, getName, getRequestCount, getResultSetConcurrency, getResultSetType, getUseCursorName, init, init, resetMaxConnectionCount, setUseCursorName, setUseCursorName, shutdown

Methods inherited from class java.lang.Object

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

Field Detail

defaultQueryTimeout

protected int defaultQueryTimeout

The amount of time (in seconds) that a query will block before throwing an exception. If <= 0 then the query will not block. Optional, if not specified, then the value defaults to 0.

defaultTransactionTimeout

protected int defaultTransactionTimeout

The amount of time (in seconds) that a transaction will block before throwing an exception. If <= 0 then the transaction will not block. Optional, if not specified, then the value defaults to 0.

Constructor Detail

InformixLogicalDatabase

public InformixLogicalDatabase()

Default constructor to configure a single logical database. Note that the init() method must be called to configure the database.

InformixLogicalDatabase

public InformixLogicalDatabase(java.lang.String dbName,
                               Config dbConfig)
                        throws ConfigException,
                               java.sql.SQLException

Creates and configures a single logical database.

Parameters:

dbName - The logical name of the database. Used to

dbConfig - The configuration object for this logical Informix database.

The configuration data is specified in the section: DatabaseManager.DB.dbName

The Informix specific configuration parameters are:

• QueryTimeout - The amount of time (in seconds) that a query will block before throwing an exception. If < 0 then the query will block indefinitly. Optional, if not specified, then the value defaults to 0.
• TransactionTimeout - The amount of time (in seconds) that a transaction will block before throwing an exception. If < 0 then the transaction will block indefinitly. Optional, if not specified, then the value defaults to 0.

Throws:

ConfigException - If there is an error in the configuration file.

java.sql.SQLException - If a SQL error occurs.

InformixLogicalDatabase

public InformixLogicalDatabase(java.lang.String dbName,
                               Config dbConfig,
                               DatabaseManagerConfiguration DbManagerConf)
                        throws ConfigException,
                               java.sql.SQLException

Creates and configures a single logical database.

Parameters:

dbName - The logical name of the database. Used to

dbConfig - The configuration object for this logical Informix database.

DbManagerConf - The configuration object of DatabaseManager.

The configuration data is specified in the section: DatabaseManager.DB.dbName

The Informix specific configuration parameters are:

• QueryTimeout - The amount of time (in seconds) that a query will block before throwing an exception. If < 0 then the query will block indefinitly. Optional, if not specified, then the value defaults to 0.
• TransactionTimeout - The amount of time (in seconds) that a transaction will block before throwing an exception. If < 0 then the transaction will block indefinitly. Optional, if not specified, then the value defaults to 0.

Throws:

ConfigException - If there is an error in the configuration file.

java.sql.SQLException - If a SQL error occurs.

Method Detail

loadConnectionAllocator

public ConnectionAllocator loadConnectionAllocator(Config connectionConfig)
                                            throws ConfigException

Return the connection allocator.

Overrides:

loadConnectionAllocator in class StandardLogicalDatabase

Parameters:

connectionConfig - The configuration object for the connection allocator.

Returns:

The connection allocator.

Throws:

ConfigException - If there is an error in the configuration file.

loadObjectIdAllocator

public ObjectIdAllocator loadObjectIdAllocator(Config objIdConfig)
                                        throws ConfigException

Return the object id allocator.

Overrides:

loadObjectIdAllocator in class StandardLogicalDatabase

Parameters:

objIdConfig - The configuration object for the object id allocator.

Returns:

The object id allocator.

Throws:

ConfigException - If there is an error in the configuration file.

getType

public java.lang.String getType()

Return a description of the logical database type.

Specified by:

getType in interface LogicalDatabase

Overrides:

getType in class StandardLogicalDatabase

Returns:

The type.

getDefaultQueryTimeout

protected int getDefaultQueryTimeout()

Returns the configured default amount of time (in seconds) that a query should block before throwing an exception. If < 0 then the query should block indefinitly.

Returns:

the default query timeout.

getDefaultTransactionTimeout

protected int getDefaultTransactionTimeout()

Returns the configured default amount of time (in seconds) that a transaction should block before throwing an exception. If less than zero then the transaction should block indefinitly.

Returns:

the default transaction timeout.