org.apache.avalon.excalibur.datasource
Class InformixDataSource
java.lang.Object
org.apache.avalon.framework.logger.AbstractLogEnabled
org.apache.avalon.excalibur.datasource.InformixDataSource
- All Implemented Interfaces:
- Component, Configurable, DataSourceComponent, LogEnabled, ThreadSafe
- public class InformixDataSource
- extends AbstractLogEnabled
- implements DataSourceComponent
The Informix implementation for DataSources in Excalibur. This uses the com.informix.jdbcx.IfxConnectionPoolDataSource object. It uses the following format for configuration (italics mark information you change):
<informix>
<pool-controller init="5" min="5" max="10"/>
<dbname>dbname</dbname>
<servername>servername</servername>
<host port="2000">host</host>
<user>user</user>
<password>password</password>
<tracing>
<jdbc> file="filename" level="level"</jdbc>
<sqli> file="filename" level="level"</sqli>
</tracing>
<informix>
Informix doesn't like the JdbcDataSource Component, so we gave it it's own. Do not use this datasource if you are planning on using your J2EE server's connection pooling.
You must have Informix's JDBC 2.2 or higher jar file, as well as the extensions jar file (ifxjdbc.jar and ifxjdbcx.jar). Also, this DataSource requires the Avalon Cadastre package because it uses the MemoryContext.
The tracing settings optionally enable Informix's tracing support within the jdbc driver. Note, for this to work, the ifxjdbc-g.jar and ifxjdbcx-g.jar jar files are required (the options have no effect when using the non -g jar files).
jdbc tracing enables general logging information about the driver itself. sqli tracing enables logging of native sqli messages sent between the jdbc driver and the database server.
The attribute file specifies where to write tracing information to, and level specifies the tracing level to be used, as documented in the Informix JDBC programmers guide.
- Since:
- 4.0
- Version:
- CVS $Revision: 1.4 $ $Date: 2004/02/28 11:47:14 $
- Author:
| Constructor Summary |
InformixDataSource()
Set up the system property for the context factory if it hasn't been done already. |
| Method Summary |
void |
configure(Configuration conf)
Set up the Informix driver for direct use. |
private void |
configureTracing(Configuration config)
Helper method to enable tracing support in the Informix driver. |
java.sql.Connection |
getConnection()
Return an Informix Connection object |
private java.lang.Object |
getInstance(java.lang.String className)
|
private void |
setProperty(java.lang.Object obj, java.lang.String propertyName, java.lang.Object value)
|
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
m_dataSource
private javax.sql.DataSource m_dataSource
-
m_autocommit
private boolean m_autocommit
-
INIT_FACTORY
private static boolean INIT_FACTORY
-
InformixDataSource
public InformixDataSource()
-
Set up the system property for the context factory if it hasn't been done already. This is not done in a static initializer due to the existence of the J2eeDataSource.
getConnection
public java.sql.Connection getConnection()
throws java.sql.SQLException
-
Return an Informix Connection object
-
- Specified by:
getConnection in interface DataSourceComponent
-
- Returns:
- Connection a valid connection for you to use
- Throws:
java.sql.SQLException
configure
public void configure(Configuration conf)
throws ConfigurationException
-
Set up the Informix driver for direct use.
-
- Specified by:
configure in interface Configurable
-
- Parameters:
conf - the class configurations. Must not be null.
- Throws:
ConfigurationException - if an error occurs
configureTracing
private void configureTracing(Configuration config)
throws ConfigurationException
-
Helper method to enable tracing support in the Informix driver.
-
-
- Parameters:
config - a Configuration value
- Throws:
ConfigurationException - if an error occurs
getInstance
private java.lang.Object getInstance(java.lang.String className)
throws ConfigurationException
-
-
- Throws:
ConfigurationException
setProperty
private void setProperty(java.lang.Object obj,
java.lang.String propertyName,
java.lang.Object value)
throws ConfigurationException
-
-
- Throws:
ConfigurationException
Please see keelframework.org for information about new Keel releases.