public class PerUserPoolDataSource 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. This datasource uses individual pools per
user, and some properties can be set specifically for a given user, if the
deployment environment can support initialization of mapped properties.
So for example, a pool of admin or write-access Connections can be
guaranteed a certain number of connections, separate from a maximum
set for users with read-only connections.
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, the existing
pool is cleared and a new pool is created for connections using the new password.
Constructor | Description |
---|---|
PerUserPoolDataSource() |
Default no-arg constructor for Serialization
|
Modifier and Type | Method | Description |
---|---|---|
void |
close() |
Close pool(s) being maintained by this datasource.
|
int |
getDefaultMaxActive() |
The maximum number of active connections that can be allocated from
this pool at the same time, or non-positive for no limit.
|
int |
getDefaultMaxIdle() |
The maximum number of active connections that can remain idle in the
pool, without extra ones being released, or negative for no limit.
|
int |
getDefaultMaxWait() |
The maximum number of milliseconds that the pool will wait (when there
are no available connections) for a connection to be returned before
throwing an exception, or -1 to wait indefinitely.
|
int |
getNumActive() |
Get the number of active connections in the default pool.
|
int |
getNumActive(java.lang.String username,
java.lang.String password) |
Get the number of active connections in the pool for a given user.
|
int |
getNumIdle() |
Get the number of idle connections in the default pool.
|
int |
getNumIdle(java.lang.String username,
java.lang.String password) |
Get the number of idle connections in the pool for a given user.
|
java.util.logging.Logger |
getParentLogger() |
|
java.lang.Boolean |
getPerUserDefaultAutoCommit(java.lang.String key) |
The keys are usernames and the value is the --.
|
java.lang.Boolean |
getPerUserDefaultReadOnly(java.lang.String username) |
The keys are usernames and the value is the --.
|
java.lang.Integer |
getPerUserDefaultTransactionIsolation(java.lang.String username) |
The isolation level of connections when returned from getConnection.
|
java.lang.Integer |
getPerUserMaxActive(java.lang.String username) |
The maximum number of active connections that can be allocated from
this pool at the same time, or non-positive for no limit.
|
java.lang.Integer |
getPerUserMaxIdle(java.lang.String username) |
The maximum number of active connections that can remain idle in the
pool, without extra ones being released, or negative for no limit.
|
java.lang.Integer |
getPerUserMaxWait(java.lang.String username) |
The maximum number of milliseconds that the pool will wait (when there
are no available connections) for a connection to be returned before
throwing an exception, or -1 to wait indefinitely.
|
javax.naming.Reference |
getReference() |
Returns a
PerUserPoolDataSource Reference . |
void |
setDefaultMaxActive(int maxActive) |
The maximum number of active connections that can be allocated from
this pool at the same time, or non-positive for no limit.
|
void |
setDefaultMaxIdle(int defaultMaxIdle) |
The maximum number of active connections that can remain idle in the
pool, without extra ones being released, or negative for no limit.
|
void |
setDefaultMaxWait(int defaultMaxWait) |
The maximum number of milliseconds that the pool will wait (when there
are no available connections) for a connection to be returned before
throwing an exception, or -1 to wait indefinitely.
|
void |
setPerUserDefaultAutoCommit(java.lang.String username,
java.lang.Boolean value) |
The keys are usernames and the value is the --.
|
void |
setPerUserDefaultReadOnly(java.lang.String username,
java.lang.Boolean value) |
The keys are usernames and the value is the --.
|
void |
setPerUserDefaultTransactionIsolation(java.lang.String username,
java.lang.Integer value) |
The isolation level of connections when returned from getConnection.
|
void |
setPerUserMaxActive(java.lang.String username,
java.lang.Integer value) |
The maximum number of active connections that can be allocated from
this pool at the same time, or non-positive for no limit.
|
void |
setPerUserMaxIdle(java.lang.String username,
java.lang.Integer value) |
The maximum number of active connections that can remain idle in the
pool, without extra ones being released, or negative for no limit.
|
void |
setPerUserMaxWait(java.lang.String username,
java.lang.Integer value) |
The maximum number of milliseconds that the pool will wait (when there
are no available connections) for a connection to be returned before
throwing an exception, or -1 to wait indefinitely.
|
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, unwrap
public PerUserPoolDataSource()
public void close()
close
in class InstanceKeyDataSource
public int getDefaultMaxActive()
public int getDefaultMaxIdle()
public int getDefaultMaxWait()
public int getNumActive()
public int getNumActive(java.lang.String username, java.lang.String password)
public int getNumIdle()
public int getNumIdle(java.lang.String username, java.lang.String password)
public java.util.logging.Logger getParentLogger() throws java.sql.SQLFeatureNotSupportedException
java.sql.SQLFeatureNotSupportedException
public java.lang.Boolean getPerUserDefaultAutoCommit(java.lang.String key)
public java.lang.Boolean getPerUserDefaultReadOnly(java.lang.String username)
public java.lang.Integer getPerUserDefaultTransactionIsolation(java.lang.String username)
public java.lang.Integer getPerUserMaxActive(java.lang.String username)
public java.lang.Integer getPerUserMaxIdle(java.lang.String username)
public java.lang.Integer getPerUserMaxWait(java.lang.String username)
public javax.naming.Reference getReference() throws javax.naming.NamingException
PerUserPoolDataSource
Reference
.getReference
in class InstanceKeyDataSource
javax.naming.NamingException
- If a naming exception was encountered
while retrieving the reference.public void setDefaultMaxActive(int maxActive)
public void setDefaultMaxIdle(int defaultMaxIdle)
public void setDefaultMaxWait(int defaultMaxWait)
public void setPerUserDefaultAutoCommit(java.lang.String username, java.lang.Boolean value)
public void setPerUserDefaultReadOnly(java.lang.String username, java.lang.Boolean value)
public void setPerUserDefaultTransactionIsolation(java.lang.String username, java.lang.Integer value)
public void setPerUserMaxActive(java.lang.String username, java.lang.Integer value)
public void setPerUserMaxIdle(java.lang.String username, java.lang.Integer value)
public void setPerUserMaxWait(java.lang.String username, java.lang.Integer value)
Copyright © 2001-2004 Apache Software Foundation. Documenation generated April 15 2019.