org.apache.commons.dbcp
Class PoolingDataSource

java.lang.Object
  org.apache.commons.dbcp.PoolingDataSource

All Implemented Interfaces:

javax.sql.DataSource

public class PoolingDataSource

extends java.lang.Object

implements javax.sql.DataSource

A simple DataSource implementation that obtains Connections from the specified ObjectPool.

Version:

$Revision: 1.13 $ $Date: 2004/02/28 12:18:17 $

Author:

Rodney Waldhoff, Glenn L. Nielsen, James House, Dirk Verbeeck

Constructor Summary

PoolingDataSource()

PoolingDataSource(ObjectPool pool)

Method Summary

java.sql.Connection	getConnection() Return a Connection from my pool, according to the contract specified by ObjectPool#borrowObject.
java.sql.Connection	getConnection(java.lang.String uname, java.lang.String passwd) Throws UnsupportedOperationException
int	getLoginTimeout() Throws UnsupportedOperationException.
java.io.PrintWriter	getLogWriter() Returns my log writer.
boolean	isAccessToUnderlyingConnectionAllowed() Returns the value of the accessToUnderlyingConnectionAllowed property.
void	setAccessToUnderlyingConnectionAllowed(boolean allow) Sets the value of the accessToUnderlyingConnectionAllowed property.
void	setLoginTimeout(int seconds) Throws UnsupportedOperationException.
void	setLogWriter(java.io.PrintWriter out) Sets my log writer.
void	setPool(ObjectPool pool)

Methods inherited from class java.lang.Object

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

Constructor Detail

PoolingDataSource

public PoolingDataSource()

PoolingDataSource

public PoolingDataSource(ObjectPool pool)

Method Detail

getConnection

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

Return a Connection from my pool, according to the contract specified by ObjectPool#borrowObject.

Specified by:

getConnection in interface javax.sql.DataSource

Throws:

java.sql.SQLException

getConnection

public java.sql.Connection getConnection(java.lang.String uname,
                                         java.lang.String passwd)
                                  throws java.sql.SQLException

Throws UnsupportedOperationException

Specified by:

getConnection in interface javax.sql.DataSource

Throws:

java.lang.UnsupportedOperationException

java.sql.SQLException

getLoginTimeout

public int getLoginTimeout()

Throws UnsupportedOperationException. Do this configuration within my ObjectPool.

Specified by:

getLoginTimeout in interface javax.sql.DataSource

Throws:

java.lang.UnsupportedOperationException

getLogWriter

public java.io.PrintWriter getLogWriter()

Returns my log writer.

Specified by:

getLogWriter in interface javax.sql.DataSource

Returns:

my log writer

See Also:

DataSource.getLogWriter()

isAccessToUnderlyingConnectionAllowed

public boolean isAccessToUnderlyingConnectionAllowed()

Returns the value of the accessToUnderlyingConnectionAllowed property.

Returns:

true if access to the underlying is allowed, false otherwise.

setAccessToUnderlyingConnectionAllowed

public void setAccessToUnderlyingConnectionAllowed(boolean allow)

Sets the value of the accessToUnderlyingConnectionAllowed property. It controls if the PoolGuard allows access to the underlying connection. (Default: false)

Parameters:

allow - Access to the underlying connection is granted when true.

setLoginTimeout

public void setLoginTimeout(int seconds)

Throws UnsupportedOperationException. Do this configuration within my ObjectPool.

Specified by:

setLoginTimeout in interface javax.sql.DataSource

Throws:

java.lang.UnsupportedOperationException

setLogWriter

public void setLogWriter(java.io.PrintWriter out)

Sets my log writer.

Specified by:

setLogWriter in interface javax.sql.DataSource

See Also:

DataSource.setLogWriter(java.io.PrintWriter)

setPool

public void setPool(ObjectPool pool)
             throws java.lang.IllegalStateException,
                    java.lang.NullPointerException

Throws:

java.lang.IllegalStateException

java.lang.NullPointerException