org.apache.derby.jdbc

Class ClientConnectionPoolDataSource

java.lang.Object

org.apache.derby.jdbc.BasicClientDataSource40

org.apache.derby.jdbc.ClientDataSource

org.apache.derby.jdbc.ClientConnectionPoolDataSource

All Implemented Interfaces:

java.io.Serializable, java.sql.Wrapper, javax.naming.Referenceable, javax.sql.CommonDataSource, javax.sql.ConnectionPoolDataSource, javax.sql.DataSource, ClientConnectionPoolDataSourceInterface, ClientDataSourceInterface

Direct Known Subclasses:

ClientConnectionPoolDataSource40

public class ClientConnectionPoolDataSource
extends ClientDataSource
implements ClientConnectionPoolDataSourceInterface

This datasource is suitable for a client/server use of Derby, running on full Java SE 6 and higher, corresponding to JDBC 4.0 and higher.

ClientConnectionPoolDataSource is a factory for PooledConnection objects. An object that implements this interface will typically be registered with a naming service that is based on the Java Naming and Directory Interface (JNDI).

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	className__

Fields inherited from class org.apache.derby.jdbc.BasicClientDataSource40

CLEAR_TEXT_PASSWORD_SECURITY, ENCRYPTED_PASSWORD_SECURITY, ENCRYPTED_USER_AND_PASSWORD_SECURITY, propertyDefault_traceLevel, SSL_BASIC, SSL_OFF, SSL_PEER_AUTHENTICATION, STRONG_PASSWORD_SUBSTITUTE_SECURITY, TRACE_ALL, TRACE_CONNECTION_CALLS, TRACE_CONNECTS, TRACE_DIAGNOSTICS, TRACE_DRIVER_CONFIGURATION, TRACE_NONE, TRACE_PARAMETER_META_DATA, TRACE_PROTOCOL_FLOWS, TRACE_RESULT_SET_CALLS, TRACE_RESULT_SET_META_DATA, TRACE_STATEMENT_CALLS, TRACE_XA_CALLS, USER_ONLY_SECURITY

Fields inherited from interface org.apache.derby.jdbc.ClientDataSourceInterface

CLEAR_TEXT_PASSWORD_SECURITY, ENCRYPTED_PASSWORD_SECURITY, ENCRYPTED_USER_AND_PASSWORD_SECURITY, propertyDefault_portNumber, propertyDefault_retrieveMessageText, propertyDefault_securityMechanism, propertyDefault_serverName, propertyDefault_traceFileAppend, propertyDefault_user, STRONG_PASSWORD_SUBSTITUTE_SECURITY, USER_ONLY_SECURITY

Constructor Summary

Constructors

Constructor and Description
ClientConnectionPoolDataSource()

Method Summary

Modifier and Type	Method and Description
int	getMaxStatements() Returns the maximum number of JDBC prepared statements a connection is allowed to cache.
javax.sql.PooledConnection	getPooledConnection()
javax.sql.PooledConnection	getPooledConnection(java.lang.String user, java.lang.String password)
int	maxStatementsToPool() Internally used method.
void	setMaxStatements(int maxStatements) Specifies the maximum size of the statement cache.

Methods inherited from class org.apache.derby.jdbc.ClientDataSource

getReference

Methods inherited from class org.apache.derby.jdbc.BasicClientDataSource40

getClientSSLMode, getConnection, getConnection, getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getLoginTimeout, getLogWriter, getParentLogger, getPassword, getPassword, getPortNumber, getProperties, getRetrieveMessageText, getRetrieveMessageText, getSecurityMechanism, getSecurityMechanism, getSecurityMechanism, getServerName, getShutdownDatabase, getSsl, getSSLModeFromString, getTraceDirectory, getTraceFile, getTraceFileAppend, getTraceLevel, getUser, getUser, isWrapperFor, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setLoginTimeout, setLogWriter, setPassword, setPortNumber, setRetrieveMessageText, setSecurityMechanism, setServerName, setShutdownDatabase, setSsl, setTraceDirectory, setTraceFile, setTraceFileAppend, setTraceLevel, setUser, unwrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.derby.jdbc.ClientDataSourceInterface

getConnectionAttributes, getCreateDatabase, getDatabaseName, getDataSourceName, getDescription, getPassword, getPortNumber, getRetrieveMessageText, getSecurityMechanism, getSecurityMechanism, getServerName, getShutdownDatabase, getSsl, getTraceDirectory, getTraceFile, getTraceFileAppend, getTraceLevel, getUser, setConnectionAttributes, setCreateDatabase, setDatabaseName, setDataSourceName, setDescription, setPassword, setPortNumber, setRetrieveMessageText, setSecurityMechanism, setServerName, setShutdownDatabase, setSsl, setTraceDirectory, setTraceFile, setTraceFileAppend, setTraceLevel, setUser

Methods inherited from interface javax.sql.DataSource

getConnection, getConnection

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Field Detail

className__

public static final java.lang.String className__

See Also:

Constant Field Values

Constructor Detail

ClientConnectionPoolDataSource

public ClientConnectionPoolDataSource()

Method Detail

getPooledConnection

public javax.sql.PooledConnection getPooledConnection()
                                               throws java.sql.SQLException

Specified by:

getPooledConnection in interface javax.sql.ConnectionPoolDataSource

Throws:

java.sql.SQLException

getPooledConnection

public javax.sql.PooledConnection getPooledConnection(java.lang.String user,
                                                      java.lang.String password)
                                               throws java.sql.SQLException

Specified by:

getPooledConnection in interface javax.sql.ConnectionPoolDataSource

Throws:

java.sql.SQLException

setMaxStatements

public void setMaxStatements(int maxStatements)

Specifies the maximum size of the statement cache.

Specified by:

setMaxStatements in interface ClientConnectionPoolDataSourceInterface

Parameters:

maxStatements - maximum number of cached statements

Throws:

java.lang.IllegalArgumentException - if maxStatements is negative

getMaxStatements

public int getMaxStatements()

Returns the maximum number of JDBC prepared statements a connection is allowed to cache.

Specified by:

getMaxStatements in interface ClientConnectionPoolDataSourceInterface

Returns:

Maximum number of statements to cache, or 0 if caching is disabled (default).

maxStatementsToPool

public int maxStatementsToPool()

Internally used method.

Overrides:

maxStatementsToPool in class BasicClientDataSource40

Returns:

Maximum number of statements to cache, or 0 if caching is disabled (default).

See Also:

BasicClientDataSource40.maxStatementsToPool()