Class BasicClientConnectionPoolDataSource40

java.lang.Object

org.apache.derby.jdbc.BasicClientDataSource40

org.apache.derby.jdbc.BasicClientConnectionPoolDataSource40

All Implemented Interfaces:

Serializable, Wrapper, CommonDataSource, ConnectionPoolDataSource, DataSource, ClientConnectionPoolDataSourceInterface, ClientDataSourceInterface

public class BasicClientConnectionPoolDataSource40
extends BasicClientDataSource40
implements ConnectionPoolDataSource, ClientConnectionPoolDataSourceInterface

This data source is suitable for client/server use of Derby, running on Java 8 Compact Profile 2 or higher.

BasicClientConnectionPoolDataSource40 is similar to ClientConnectionPoolDataSource except that it does not support JNDI, i.e. it does not implement javax.naming.Referenceable.

See Also:

• ClientConnectionPoolDataSource40
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	className__
private int	maxStatements	Specifies the maximum number of statements that can be cached per connection by the JDBC driver.
private static final MessageUtil	msgUtil	Message utility used to obtain localized messages.
private static final long	serialVersionUID

Fields inherited from class 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 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	Description
BasicClientConnectionPoolDataSource40()

Method Summary

Modifier and Type	Method	Description
int	getMaxStatements()	Returns the maximum number of JDBC prepared statements a connection is allowed to cache.
PooledConnection	getPooledConnection()
PooledConnection	getPooledConnection(String user, String password)
int	maxStatementsToPool()	Internally used method.
private void	readObject(ObjectInputStream inputStream)	Read an object from the ObjectInputStream.
void	setMaxStatements(int maxStatements)	Specifies the maximum size of the statement cache.
private final void	validateState()	Make sure the state of the de-serialized object is valid.

Methods inherited from class BasicClientDataSource40

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

Methods inherited from class Object

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

Methods inherited from interface 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 CommonDataSource

createShardingKeyBuilder, getParentLogger

Methods inherited from interface ConnectionPoolDataSource

createPooledConnectionBuilder, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface DataSource

createConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface Wrapper

isWrapperFor, unwrap

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

msgUtil

private static final MessageUtil msgUtil

Message utility used to obtain localized messages.

className__

public static final String className__

See Also:

• Constant Field Values

maxStatements

private int maxStatements

Specifies the maximum number of statements that can be cached per connection by the JDBC driver.

A value of 0 disables statement caching, negative values are not allowed. The default is that caching is disabled.

Constructor Details

BasicClientConnectionPoolDataSource40

public BasicClientConnectionPoolDataSource40()

Method Details

getPooledConnection

public PooledConnection getPooledConnection()
                                     throws SQLException

Specified by:

getPooledConnection in interface ConnectionPoolDataSource

Throws:

SQLException

See Also:

• ConnectionPoolDataSource.getPooledConnection()

getPooledConnection

public PooledConnection getPooledConnection(String user,
 String password)
                                     throws SQLException

Specified by:

getPooledConnection in interface ConnectionPoolDataSource

Throws:

SQLException

See Also:

• ConnectionPoolDataSource.getPooledConnection(java.lang.String, java.lang.String)

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:

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()

validateState

private final void validateState()

Make sure the state of the de-serialized object is valid.

readObject

private void readObject(ObjectInputStream inputStream)
                 throws ClassNotFoundException,
IOException

Read an object from the ObjectInputStream.

This implementation differs from the default one by initiating state validation of the object created.

Parameters:

inputStream - data stream to read objects from

Throws:

ClassNotFoundException - if instantiating a class fails

IOException - if reading from the stream fails