DODS 7.6 API

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

java.lang.Object
  extended by com.lutris.appserver.server.sql.standard.StandardLogicalDatabase
      extended by 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.

DODS 7.6 API