org.apache.avalon.excalibur.datasource

Class J2eeDataSource

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.apache.avalon.excalibur.datasource.J2eeDataSource

All Implemented Interfaces:

DataSourceComponent, org.apache.avalon.framework.component.Component, org.apache.avalon.framework.configuration.Configurable, org.apache.avalon.framework.logger.LogEnabled, org.apache.avalon.framework.thread.ThreadSafe

public class J2eeDataSource
extends org.apache.avalon.framework.logger.AbstractLogEnabled
implements DataSourceComponent

The J2EE implementation for DataSources in Cocoon. This uses the javax.sql.DataSource object and assumes that the J2EE container pools the datasources properly.

Since:

4.0

Version:

CVS $Revision: 1.4 $ $Date: 2004/02/28 11:47:14 $

Author:

Avalon Development Team

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	JDBC_NAME
protected javax.sql.DataSource	m_dataSource
protected java.lang.String	m_password
protected java.lang.String	m_user

Fields inherited from interface org.apache.avalon.excalibur.datasource.DataSourceComponent

ROLE

Constructor Summary

Constructors

Constructor and Description
J2eeDataSource()

Method Summary

Methods

Modifier and Type	Method and Description
void	configure(org.apache.avalon.framework.configuration.Configuration configuration) Configure and set up DB connection.
java.sql.Connection	getConnection() Get the database connection

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

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

Field Detail

JDBC_NAME

public static final java.lang.String JDBC_NAME

See Also:

Constant Field Values

m_dataSource

protected javax.sql.DataSource m_dataSource

m_user

protected java.lang.String m_user

m_password

protected java.lang.String m_password

Constructor Detail

J2eeDataSource

public J2eeDataSource()

Method Detail

configure

public void configure(org.apache.avalon.framework.configuration.Configuration configuration)
               throws org.apache.avalon.framework.configuration.ConfigurationException

Configure and set up DB connection. Here we set the connection information needed to create the Connection objects. It must be called only once.

Specified by:

configure in interface org.apache.avalon.framework.configuration.Configurable

Parameters:

conf - The Configuration object needed to describe the connection.

Throws:

org.apache.avalon.framework.configuration.ConfigurationException

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException

Get the database connection

Specified by:

getConnection in interface DataSourceComponent

Returns:

Connection a valid connection for you to use

Throws:

NoValidConnectionException - when there is no valid Connection wrapper available in the classloader.

NoAvailableConnectionException - when there are no more available Connections in the pool.

java.sql.SQLException