org.datanucleus.store.rdbms.datasource.dbcp.datasources

Class SharedPoolDataSource

java.lang.Object

org.datanucleus.store.rdbms.datasource.dbcp.datasources.InstanceKeyDataSource

org.datanucleus.store.rdbms.datasource.dbcp.datasources.SharedPoolDataSource

All Implemented Interfaces:

Serializable, Wrapper, Referenceable, CommonDataSource, DataSource

public class SharedPoolDataSource
extends InstanceKeyDataSource

A pooling DataSource appropriate for deployment within J2EE environment. There are many configuration options, most of which are defined in the parent class. All users (based on username) share a single maximum number of Connections in this datasource.

User passwords can be changed without re-initializing the datasource. When a getConnection(username, password) request is processed with a password that is different from those used to create connections in the pool associated with username, an attempt is made to create a new connection using the supplied password and if this succeeds, idle connections created using the old password are destroyed and new connections are created using the new password.

Version:

$Revision: 907288 $ $Date: 2010-02-06 14:42:58 -0500 (Sat, 06 Feb 2010) $

Author:

John D. McNally

See Also:

Serialized Form

Field Summary

Fields inherited from class org.datanucleus.store.rdbms.datasource.dbcp.datasources.InstanceKeyDataSource

instanceKey, UNKNOWN_TRANSACTIONISOLATION

Constructor Summary

Constructors

Constructor and Description
SharedPoolDataSource() Default no-arg constructor for Serialization

Method Summary

Modifier and Type	Method and Description
void	close() Close pool being maintained by this datasource.
protected org.datanucleus.store.rdbms.datasource.dbcp.datasources.PooledConnectionManager	getConnectionManager(org.datanucleus.store.rdbms.datasource.dbcp.datasources.UserPassKey upkey)
int	getMaxActive()
int	getMaxIdle()
int	getMaxWait()
int	getNumActive()
int	getNumIdle()
Logger	getParentLogger()
protected org.datanucleus.store.rdbms.datasource.dbcp.datasources.PooledConnectionAndInfo	getPooledConnectionAndInfo(String username, String password)
Reference	getReference()
void	setMaxActive(int maxActive)
void	setMaxIdle(int maxIdle)
void	setMaxWait(int maxWait)
protected void	setupDefaults(Connection con, String username)

Methods inherited from class org.datanucleus.store.rdbms.datasource.dbcp.datasources.InstanceKeyDataSource

assertInitializationAllowed, getConnection, getConnection, getConnectionPoolDataSource, getDataSourceName, getDefaultTransactionIsolation, getDescription, getJndiEnvironment, getLoginTimeout, getLogWriter, getMinEvictableIdleTimeMillis, getNumTestsPerEvictionRun, getTestOnBorrow, getTestOnReturn, getTestWhileIdle, getTimeBetweenEvictionRunsMillis, getValidationQuery, isDefaultAutoCommit, isDefaultReadOnly, isRollbackAfterValidation, isTestOnBorrow, isTestOnReturn, isTestWhileIdle, isWrapperFor, setConnectionPoolDataSource, setDataSourceName, setDefaultAutoCommit, setDefaultReadOnly, setDefaultTransactionIsolation, setDescription, setJndiEnvironment, setLoginTimeout, setLogWriter, setMinEvictableIdleTimeMillis, setNumTestsPerEvictionRun, setRollbackAfterValidation, setTestOnBorrow, setTestOnReturn, setTestWhileIdle, setTimeBetweenEvictionRunsMillis, setValidationQuery, testCPDS, unwrap, whenExhaustedAction

Methods inherited from class java.lang.Object

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

Constructor Detail

SharedPoolDataSource

public SharedPoolDataSource()

Default no-arg constructor for Serialization

Method Detail

close

public void close()
           throws Exception

Close pool being maintained by this datasource.

Specified by:

close in class InstanceKeyDataSource

Throws:

Exception

getMaxActive

public int getMaxActive()

setMaxActive

public void setMaxActive(int maxActive)

getMaxIdle

public int getMaxIdle()

setMaxIdle

public void setMaxIdle(int maxIdle)

getMaxWait

public int getMaxWait()

setMaxWait

public void setMaxWait(int maxWait)

getNumActive

public int getNumActive()

getNumIdle

public int getNumIdle()

getPooledConnectionAndInfo

protected org.datanucleus.store.rdbms.datasource.dbcp.datasources.PooledConnectionAndInfo getPooledConnectionAndInfo(String username,
                                                                                                                     String password)
                                                                                                              throws SQLException

Specified by:

getPooledConnectionAndInfo in class InstanceKeyDataSource

Throws:

SQLException

getConnectionManager

protected org.datanucleus.store.rdbms.datasource.dbcp.datasources.PooledConnectionManager getConnectionManager(org.datanucleus.store.rdbms.datasource.dbcp.datasources.UserPassKey upkey)

Specified by:

getConnectionManager in class InstanceKeyDataSource

getReference

public Reference getReference()
                       throws NamingException

Specified by:

getReference in interface Referenceable

Overrides:

getReference in class InstanceKeyDataSource

Throws:

NamingException

setupDefaults

protected void setupDefaults(Connection con,
                             String username)
                      throws SQLException

Specified by:

setupDefaults in class InstanceKeyDataSource

Throws:

SQLException

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Throws:

SQLFeatureNotSupportedException