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	Description
`static java.lang.String`	`className__`
`private int`	`maxStatements`	Specifies the maximum number of statements that can be cached per connection by the JDBC driver.
`private static MessageUtil`	`msgUtil`	Message utility used to obtain localized messages.
`private static long`	`serialVersionUID`

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 Description

ClientConnectionPoolDataSource()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	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.
`private void`	`readObject(java.io.ObjectInputStream inputStream)`	Read an object from the ObjectInputStream.
`void`	`setMaxStatements(int maxStatements)`	Specifies the maximum size of the statement cache.
`private void`	`validateState()`	Make sure the state of the de-serialized object is valid.

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

Methods inherited from class org.apache.derby.jdbc.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 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.sql.CommonDataSource
createShardingKeyBuilder, getParentLogger

Methods inherited from interface javax.sql.ConnectionPoolDataSource
createPooledConnectionBuilder, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface javax.sql.DataSource
createConnectionBuilder, getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface java.sql.Wrapper
isWrapperFor, unwrap

- Field Detail
  - 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 java.lang.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 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()
  - validateState
```
private final void validateState()
```
    Make sure the state of the de-serialized object is valid.
  - readObject
```
private void readObject(java.io.ObjectInputStream inputStream)
                 throws java.lang.ClassNotFoundException,
                        java.io.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:
    
    java.lang.ClassNotFoundException - if instantiating a class fails
    
    java.io.IOException - if reading from the stream fails

Class ClientConnectionPoolDataSource

Field Summary

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

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

Constructor Summary

Method Summary

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

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sql.CommonDataSource

Methods inherited from interface javax.sql.ConnectionPoolDataSource

Methods inherited from interface javax.sql.DataSource

Methods inherited from interface java.sql.Wrapper

Field Detail

serialVersionUID

msgUtil

className__

maxStatements

Constructor Detail

ClientConnectionPoolDataSource

Method Detail

getPooledConnection

getPooledConnection

setMaxStatements

getMaxStatements

maxStatementsToPool

validateState

readObject