Class SharedPoolDataSource

java.lang.Object

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

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

All Implemented Interfaces:

Serializable, AutoCloseable, 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 user name) share a single maximum number of Connections in this data source.

User passwords can be changed without re-initializing the data source. When a getConnection(user name, password) request is processed with a password that is different from those used to create connections in the pool associated with user name, 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.

Since:

2.0

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private KeyedCPDSConnectionFactory	factory
private int	maxTotal
private KeyedObjectPool<UserPassKey, PooledConnectionAndInfo>	pool
private static final long	serialVersionUID

Fields inherited from class InstanceKeyDataSource

UNKNOWN_TRANSACTIONISOLATION

Constructor Summary

Constructors

Constructor	Description
SharedPoolDataSource()	Default no-argument constructor for Serialization

Method Summary

Modifier and Type	Method	Description
void	close()	Closes pool being maintained by this data source.
protected PooledConnectionManager	getConnectionManager(UserPassKey upkey)
int	getMaxTotal()	Gets BaseGenericObjectPool.getMaxTotal() for this pool.
int	getNumActive()	Gets the number of active connections in the pool.
int	getNumIdle()	Gets the number of idle connections in the pool.
protected PooledConnectionAndInfo	getPooledConnectionAndInfo(String userName, String userPassword)
Reference	getReference()	Returns a SharedPoolDataSource Reference.
private void	readObject(ObjectInputStream in)	Supports Serialization interface.
private void	registerPool(String userName, String password)
void	setMaxTotal(int maxTotal)	Sets BaseGenericObjectPool.getMaxTotal() for this pool.
protected void	setupDefaults(Connection connection, String userName)
protected void	toStringFields(StringBuilder builder)

Methods inherited from class InstanceKeyDataSource

assertInitializationAllowed, getConnection, getConnection, getConnectionPoolDataSource, getDataSourceName, getDefaultBlockWhenExhausted, getDefaultEvictionPolicyClassName, getDefaultLifo, getDefaultMaxIdle, getDefaultMaxTotal, getDefaultMaxWaitMillis, getDefaultMinEvictableIdleTimeMillis, getDefaultMinIdle, getDefaultNumTestsPerEvictionRun, getDefaultSoftMinEvictableIdleTimeMillis, getDefaultTestOnBorrow, getDefaultTestOnCreate, getDefaultTestOnReturn, getDefaultTestWhileIdle, getDefaultTimeBetweenEvictionRunsMillis, getDefaultTransactionIsolation, getDescription, getInstanceKey, getJndiEnvironment, getLoginTimeout, getLogWriter, getMaxConnLifetimeMillis, getParentLogger, getValidationQuery, getValidationQueryTimeout, isDefaultAutoCommit, isDefaultReadOnly, isRollbackAfterValidation, isWrapperFor, setConnectionPoolDataSource, setDataSourceName, setDefaultAutoCommit, setDefaultBlockWhenExhausted, setDefaultEvictionPolicyClassName, setDefaultLifo, setDefaultMaxIdle, setDefaultMaxTotal, setDefaultMaxWaitMillis, setDefaultMinEvictableIdleTimeMillis, setDefaultMinIdle, setDefaultNumTestsPerEvictionRun, setDefaultReadOnly, setDefaultSoftMinEvictableIdleTimeMillis, setDefaultTestOnBorrow, setDefaultTestOnCreate, setDefaultTestOnReturn, setDefaultTestWhileIdle, setDefaultTimeBetweenEvictionRunsMillis, setDefaultTransactionIsolation, setDescription, setJndiEnvironment, setJndiEnvironment, setLoginTimeout, setLogWriter, setMaxConnLifetimeMillis, setRollbackAfterValidation, setValidationQuery, setValidationQueryTimeout, testCPDS, toString, unwrap

Methods inherited from class Object

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

Methods inherited from interface CommonDataSource

createShardingKeyBuilder

Methods inherited from interface DataSource

createConnectionBuilder

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

maxTotal

private int maxTotal

pool

private transient KeyedObjectPool<UserPassKey, PooledConnectionAndInfo> pool

factory

private transient KeyedCPDSConnectionFactory factory

Constructor Details

SharedPoolDataSource

public SharedPoolDataSource()

Default no-argument constructor for Serialization

Method Details

close

public void close()
           throws Exception

Closes pool being maintained by this data source.

Specified by:

close in interface AutoCloseable

Specified by:

close in class InstanceKeyDataSource

Throws:

Exception

getMaxTotal

public int getMaxTotal()

Gets BaseGenericObjectPool.getMaxTotal() for this pool.

Returns:

BaseGenericObjectPool.getMaxTotal() for this pool.

setMaxTotal

public void setMaxTotal(int maxTotal)

Sets BaseGenericObjectPool.getMaxTotal() for this pool.

Parameters:

maxTotal - BaseGenericObjectPool.getMaxTotal() for this pool.

getNumActive

public int getNumActive()

Gets the number of active connections in the pool.

Returns:

The number of active connections in the pool.

getNumIdle

public int getNumIdle()

Gets the number of idle connections in the pool.

Returns:

The number of idle connections in the pool.

getPooledConnectionAndInfo

protected PooledConnectionAndInfo getPooledConnectionAndInfo(String userName,
 String userPassword)
                                                      throws SQLException

Specified by:

getPooledConnectionAndInfo in class InstanceKeyDataSource

Throws:

SQLException

getConnectionManager

protected PooledConnectionManager getConnectionManager(UserPassKey upkey)

Specified by:

getConnectionManager in class InstanceKeyDataSource

getReference

public Reference getReference()
                       throws NamingException

Returns a SharedPoolDataSource Reference.

Throws:

NamingException

registerPool

private void registerPool(String userName,
 String password)
                   throws NamingException,
SQLException

Throws:

NamingException

SQLException

setupDefaults

protected void setupDefaults(Connection connection,
 String userName)
                      throws SQLException

Specified by:

setupDefaults in class InstanceKeyDataSource

Throws:

SQLException

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
ClassNotFoundException

Supports Serialization interface.

Parameters:

in - a java.io.ObjectInputStream value

Throws:

IOException - if an error occurs

ClassNotFoundException - if an error occurs

toStringFields

protected void toStringFields(StringBuilder builder)

Overrides:

toStringFields in class InstanceKeyDataSource