Serialized Form (BoneCP :: Core Library 0.8.0.RELEASE API)

Package com.jolbox.bonecp
- Class com.jolbox.bonecp.AbstractConnectionStrategy extends Object implements Serializable
  
  serialVersionUID:
  
  27805973487155497L
  - Serialized Fields
    - pool
```
BoneCP pool
```
      Pool handle
    - terminationLock
```
Lock terminationLock
```
      Prevent repeated termination of all connections when the DB goes down.
- Class com.jolbox.bonecp.BoneCP extends Object implements Serializable
  
  serialVersionUID:
  
  -8386816681977604817L
  - Serialized Fields
    - poolAvailabilityThreshold
```
int poolAvailabilityThreshold
```
      Create more connections when we hit x% of our possible number of connections.
    - partitionCount
```
int partitionCount
```
      Number of partitions passed in constructor.
    - partitions
```
ConnectionPartition[] partitions
```
      Partitions handle.
    - keepAliveScheduler
```
ScheduledExecutorService keepAliveScheduler
```
      Handle to factory that creates 1 thread per partition that periodically wakes up and performs some activity on the connection.
    - maxAliveScheduler
```
ScheduledExecutorService maxAliveScheduler
```
      Handle to factory that creates 1 thread per partition that periodically wakes up and performs some activity on the connection.
    - connectionsScheduler
```
ExecutorService connectionsScheduler
```
      Executor for threads watching each partition to dynamically create new threads/kill off excess ones.
    - config
```
BoneCPConfig config
```
      Configuration object used in constructor.
    - asyncExecutor
```
com.google.common.util.concurrent.ListeningExecutorService asyncExecutor
```
      Executor service for obtaining a connection in an asynchronous fashion.
    - mbs
```
MBeanServer mbs
```
      JMX support.
    - closeConnectionWatch
```
boolean closeConnectionWatch
```
      If set to true, create a new thread that monitors a connection and displays warnings if application failed to close the connection.
    - closeConnectionExecutor
```
ExecutorService closeConnectionExecutor
```
      Threads monitoring for bad connection requests.
    - poolShuttingDown
```
boolean poolShuttingDown
```
      set to true if the connection pool has been flagged as shutting down.
    - shutdownStackTrace
```
String shutdownStackTrace
```
      Placeholder to give more useful info in case of a double shutdown.
    - finalizableRefs
```
Map<K,V> finalizableRefs
```
      Reference of objects that are to be watched.
    - connectionTimeoutInMs
```
long connectionTimeoutInMs
```
      Time to wait before timing out the connection. Default in config is Long.MAX_VALUE milliseconds.
    - closeConnectionWatchTimeoutInMs
```
long closeConnectionWatchTimeoutInMs
```
      No of ms to wait for thread.join() in connection watch thread.
    - statisticsEnabled
```
boolean statisticsEnabled
```
      if true, we care about statistics.
    - statistics
```
Statistics statistics
```
      statistics handle.
    - nullOnConnectionTimeout
```
boolean nullOnConnectionTimeout
```
      Config setting.
    - resetConnectionOnClose
```
boolean resetConnectionOnClose
```
      Config setting.
    - cachedPoolStrategy
```
boolean cachedPoolStrategy
```
      Config setting.
    - connectionStrategy
```
ConnectionStrategy connectionStrategy
```
      Currently active get connection strategy class to use.
    - dbIsDown
```
AtomicBoolean dbIsDown
```
      If true, there are no connections to be taken.
    - clientInfo
```
Properties clientInfo
```
      Config setting.
    - driverInitialized
```
boolean driverInitialized
```
      If false, we haven't made a dummy driver call first.
    - jvmMajorVersion
```
int jvmMajorVersion
```
      Keep track of our jvm version.
- Class com.jolbox.bonecp.BoneCPConfig extends Object implements Serializable
  
  serialVersionUID:
  
  6090570773474131622L
  - Serialized Fields
    - minConnectionsPerPartition
```
int minConnectionsPerPartition
```
      Min number of connections per partition.
    - maxConnectionsPerPartition
```
int maxConnectionsPerPartition
```
      Max number of connections per partition.
    - acquireIncrement
```
int acquireIncrement
```
      Number of new connections to create in 1 batch.
    - partitionCount
```
int partitionCount
```
      Number of partitions.
    - jdbcUrl
```
String jdbcUrl
```
      DB connection string.
    - username
```
String username
```
      User name to use.
    - password
```
String password
```
      Password to use.
    - idleConnectionTestPeriodInSeconds
```
long idleConnectionTestPeriodInSeconds
```
      Connections older than this are sent a keep-alive statement.
    - idleMaxAgeInSeconds
```
long idleMaxAgeInSeconds
```
      Maximum age of an unused connection before it is closed off.
    - connectionTestStatement
```
String connectionTestStatement
```
      SQL statement to use for keep-alive/test of connection.
    - statementsCacheSize
```
int statementsCacheSize
```
      Min no of prepared statements to cache.
    - statementsCachedPerConnection
```
int statementsCachedPerConnection
```
      No of statements that can be cached per connection. Deprecated.
    - releaseHelperThreads
```
int releaseHelperThreads
```
      Number of release-connection helper threads to create per partition.
    - statementReleaseHelperThreads
```
int statementReleaseHelperThreads
```
      Number of statement release helper threads to create.
    - connectionHook
```
ConnectionHook connectionHook
```
      Hook class (external).
    - initSQL
```
String initSQL
```
      Query to send once per connection to the database.
    - closeConnectionWatch
```
boolean closeConnectionWatch
```
      If set to true, create a new thread that monitors a connection and displays warnings if application failed to close the connection. FOR DEBUG PURPOSES ONLY!
    - logStatementsEnabled
```
boolean logStatementsEnabled
```
      If set to true, log SQL statements being executed.
    - acquireRetryDelayInMs
```
long acquireRetryDelayInMs
```
      After attempting to acquire a connection and failing, wait for this value before attempting to acquire a new connection again.
    - acquireRetryAttempts
```
int acquireRetryAttempts
```
      After attempting to acquire a connection and failing, try to connect these many times before giving up.
    - lazyInit
```
boolean lazyInit
```
      If set to true, the connection pool will remain empty until the first connection is obtained.
    - transactionRecoveryEnabled
```
boolean transactionRecoveryEnabled
```
      If set to true, stores all activity on this connection to allow for replaying it again.
    - connectionHookClassName
```
String connectionHookClassName
```
      Connection hook class name.
    - classLoader
```
ClassLoader classLoader
```
      Classloader to use when loading the JDBC driver.
    - poolName
```
String poolName
```
      Name of the pool for JMX and thread names.
    - disableJMX
```
boolean disableJMX
```
      Set to true to disable JMX.
    - datasourceBean
```
DataSource datasourceBean
```
      If set, use datasourceBean.getConnection() to obtain a new connection.
    - queryExecuteTimeLimitInMs
```
long queryExecuteTimeLimitInMs
```
      Queries taking longer than this limit to execute are logged.
    - poolAvailabilityThreshold
```
int poolAvailabilityThreshold
```
      Create more connections when we hit x% of our possible number of connections.
    - disableConnectionTracking
```
boolean disableConnectionTracking
```
      Disable connection tracking.
    - driverProperties
```
Properties driverProperties
```
      Used when the alternate way of obtaining a connection is required
    - connectionTimeoutInMs
```
long connectionTimeoutInMs
```
      Time to wait before a call to getConnection() times out and returns an error.
    - closeConnectionWatchTimeoutInMs
```
long closeConnectionWatchTimeoutInMs
```
      Time in ms to wait for close connection watch thread.
    - maxConnectionAgeInSeconds
```
long maxConnectionAgeInSeconds
```
      A connection older than maxConnectionAge will be destroyed and purged from the pool.
    - configFile
```
String configFile
```
      Config property.
    - serviceOrder
```
String serviceOrder
```
      Queue mode. Values currently understood are FIFO and LIFO.
    - statisticsEnabled
```
boolean statisticsEnabled
```
      If true, keep track of some statistics.
    - defaultAutoCommit
```
boolean defaultAutoCommit
```
      The default auto-commit state of created connections.
    - defaultReadOnly
```
boolean defaultReadOnly
```
      The default read-only state of created connections.
    - defaultTransactionIsolation
```
String defaultTransactionIsolation
```
      The default transaction isolation state of created connections.
    - defaultCatalog
```
String defaultCatalog
```
      The default catalog state of created connections.
    - defaultTransactionIsolationValue
```
int defaultTransactionIsolationValue
```
      The parsed transaction isolation value. Default = driver value
    - externalAuth
```
boolean externalAuth
```
      If true, stop caring about username/password when obtaining raw connections.
    - deregisterDriverOnClose
```
boolean deregisterDriverOnClose
```
      If true, try to unregister the JDBC driver when pool is shutdown.
    - nullOnConnectionTimeout
```
boolean nullOnConnectionTimeout
```
      If true, return null on connection timeout rather than throw an exception.
    - resetConnectionOnClose
```
boolean resetConnectionOnClose
```
      If true, issue a reset (rollback) on connection close in case client forgot it.
    - detectUnresolvedTransactions
```
boolean detectUnresolvedTransactions
```
      Detect uncommitted transactions. If true, and resetConnectionOnClose is also true, the pool will print out a stack trace of the location where you had a connection that specified setAutoCommit(false) but then forgot to call commit/rollback before closing it off. This feature is intended for debugging only.
    - poolStrategy
```
String poolStrategy
```
      Determines pool operation Recognised strategies are: DEFAULT, CACHED.
    - closeOpenStatements
```
boolean closeOpenStatements
```
      If true, track statements and close them if application forgot to do so. See also: detectUnclosedStatements.
    - detectUnclosedStatements
```
boolean detectUnclosedStatements
```
      If true, print out a stack trace of where a statement was opened but not closed before the connection was closed. See also: closeOpenStatements.
    - clientInfo
```
Properties clientInfo
```
      If set, pool will call this for every new connection that's created.
- Class com.jolbox.bonecp.BoneCPDataSource extends BoneCPConfig implements Serializable
  
  serialVersionUID:
  
  -1561804548443209469L
  - Serialized Fields
    - driverClass
```
String driverClass
```
      JDBC driver to use.
    - multiDataSource
```
com.google.common.cache.LoadingCache<K,V> multiDataSource
```
      Constructs (and caches) a datasource on the fly based on the given username/password.
- Class com.jolbox.bonecp.CachedConnectionStrategy extends AbstractConnectionStrategy implements Serializable
  
  serialVersionUID:
  
  -4725640468699097218L
  - Serialized Fields
    - warnApp
```
AtomicBoolean warnApp
```
      Just to give out a warning once.
    - threadFinalizableRefs
```
Map<K,V> threadFinalizableRefs
```
      Keep track of connections tied to thread.
    - finalizableRefQueue
```
com.google.common.base.FinalizableReferenceQueue finalizableRefQueue
```
      Keep track of connections tied to thread.
    - fallbackStrategy
```
ConnectionStrategy fallbackStrategy
```
      Obtain connections using this fallback strategy at first (or if this strategy cannot succeed.
    - tlConnections
```
CachedConnectionStrategy.CachedConnectionStrategyThreadLocal<T> tlConnections
```
      Connections are stored here.
- Class com.jolbox.bonecp.ConnectionHandle extends Object implements Serializable
  
  serialVersionUID:
  
  5969210523116801522L
  - Serialized Fields
    - connection
```
Connection connection
```
      Connection handle.
    - connectionLastUsedInMs
```
long connectionLastUsedInMs
```
      Last time this connection was used by an application.
    - connectionLastResetInMs
```
long connectionLastResetInMs
```
      Last time we sent a reset to this connection.
    - connectionCreationTimeInMs
```
long connectionCreationTimeInMs
```
      Time when this connection was created.
    - pool
```
BoneCP pool
```
      Pool handle.
    - defaultReadOnly
```
Boolean defaultReadOnly
```
      Config setting.
    - defaultCatalog
```
String defaultCatalog
```
      Config setting.
    - defaultTransactionIsolationValue
```
int defaultTransactionIsolationValue
```
      Config setting.
    - defaultAutoCommit
```
Boolean defaultAutoCommit
```
      Config setting.
    - resetConnectionOnClose
```
boolean resetConnectionOnClose
```
      Config setting.
    - possiblyBroken
```
boolean possiblyBroken
```
      If true, this connection might have failed communicating with the database. We assume that exceptions should be rare here i.e. the normal case is assumed to succeed.
    - logicallyClosed
```
AtomicBoolean logicallyClosed
```
      If true, we've called close() on this connection.
    - originatingPartition
```
ConnectionPartition originatingPartition
```
      Original partition.
    - preparedStatementCache
```
IStatementCache preparedStatementCache
```
      Prepared Statement Cache.
    - callableStatementCache
```
IStatementCache callableStatementCache
```
      Prepared Statement Cache.
    - debugHandle
```
Object debugHandle
```
      An opaque handle for an application to use in any way it deems fit.
    - connectionHook
```
ConnectionHook connectionHook
```
      Handle to the connection hook as defined in the config.
    - doubleCloseCheck
```
boolean doubleCloseCheck
```
      If true, give warnings if application tried to issue a close twice (for debugging only).
    - doubleCloseException
```
String doubleCloseException
```
      exception trace if doubleCloseCheck is enabled.
    - logStatementsEnabled
```
boolean logStatementsEnabled
```
      If true, log sql statements.
    - statementCachingEnabled
```
boolean statementCachingEnabled
```
      Set to true if we have statement caching enabled.
    - replayLog
```
List<E> replayLog
```
      The recorded actions list used to replay the transaction.
    - inReplayMode
```
boolean inReplayMode
```
      If true, connection is currently playing back a saved transaction.
    - recoveryResult
```
TransactionRecoveryResult recoveryResult
```
      Map of translations + result from last recovery.
    - url
```
String url
```
      Connection url.
    - threadUsingConnection
```
Thread threadUsingConnection
```
      Keep track of the thread.
    - maxConnectionAgeInMs
```
long maxConnectionAgeInMs
```
      Configured max connection age.
    - statisticsEnabled
```
boolean statisticsEnabled
```
      if true, we care about statistics.
    - statistics
```
Statistics statistics
```
      Statistics handle.
    - threadWatch
```
Thread threadWatch
```
      Pointer to a thread that is monitoring this connection (for the case where closeConnectionWatch) is enabled.
    - finalizableRefs
```
Map<K,V> finalizableRefs
```
      Handle to pool.finalizationRefs.
    - connectionTrackingDisabled
```
boolean connectionTrackingDisabled
```
      If true, connection tracking is disabled in the config.
    - txResolved
```
boolean txResolved
```
      If true, transaction has been marked as COMMITed or ROLLBACKed.
    - detectUnresolvedTransactions
```
boolean detectUnresolvedTransactions
```
      Config setting.
    - autoCommitStackTrace
```
String autoCommitStackTrace
```
      Stack track dump.
    - detectUnclosedStatements
```
boolean detectUnclosedStatements
```
      Config setting.
    - closeOpenStatements
```
boolean closeOpenStatements
```
      Config setting.
    - trackedStatement
```
ConcurrentMap<K,V> trackedStatement
```
      Keep track of open statements.
    - noStackTrace
```
String noStackTrace
```
      Avoid creating a new string object each time.
- Class com.jolbox.bonecp.ConnectionPartition extends Object implements Serializable
  
  serialVersionUID:
  
  -7864443421028454573L
  - Serialized Fields
    - freeConnections
```
BlockingQueue<E> freeConnections
```
      Connections available to be taken
    - acquireIncrement
```
int acquireIncrement
```
      When connections start running out, add these number of new connections.
    - minConnections
```
int minConnections
```
      Minimum number of connections to start off with.
    - maxConnections
```
int maxConnections
```
      Maximum number of connections that will ever be created.
    - statsLock
```
ReentrantReadWriteLock statsLock
```
      Statistics lock.
    - createdConnections
```
int createdConnections
```
      Number of connections that have been created.
    - url
```
String url
```
      DB details.
    - username
```
String username
```
      DB details.
    - password
```
String password
```
      DB details.
    - unableToCreateMoreTransactions
```
boolean unableToCreateMoreTransactions
```
      If set to true, don't bother calling method to attempt to create more connections because we've hit our limit.
    - disableTracking
```
boolean disableTracking
```
      Config setting.
    - poolWatchThreadSignalQueue
```
BlockingQueue<E> poolWatchThreadSignalQueue
```
      Signal trigger to pool watch thread. Making it a queue means our signal is persistent.
    - queryExecuteTimeLimitInNanoSeconds
```
long queryExecuteTimeLimitInNanoSeconds
```
      Store the unit translation here to avoid recalculating it in statement handles.
    - poolName
```
String poolName
```
      Cached copy of the config-specified pool name.
    - pool
```
BoneCP pool
```
      Handle to the pool.
- Class com.jolbox.bonecp.DefaultConnectionStrategy extends AbstractConnectionStrategy implements Serializable
  
  serialVersionUID:
  
  962520166486807512L
- Class com.jolbox.bonecp.Statistics extends Object implements Serializable
  
  serialVersionUID:
  
  -5819368300823149669L
  - Serialized Fields
    - cacheHits
```
AtomicLong cacheHits
```
      No of cache hits.
    - cacheMiss
```
AtomicLong cacheMiss
```
      No of cache misses.
    - statementsCached
```
AtomicLong statementsCached
```
      No of statements cached.
    - connectionsRequested
```
AtomicLong connectionsRequested
```
      Connections obtained.
    - cumulativeConnectionWaitTime
```
AtomicLong cumulativeConnectionWaitTime
```
      Time taken to give a connection to the application.
    - cumulativeStatementExecuteTime
```
AtomicLong cumulativeStatementExecuteTime
```
      Time taken to execute statements.
    - cumulativeStatementPrepareTime
```
AtomicLong cumulativeStatementPrepareTime
```
      Time taken to prepare statements (or obtain from cache).
    - statementsExecuted
```
AtomicLong statementsExecuted
```
      Number of statements that have been executed.
    - statementsPrepared
```
AtomicLong statementsPrepared
```
      Number of statements that have been prepared.
    - pool
```
BoneCP pool
```
      Pool handle.

Serialized Form

Package com.jolbox.bonecp

Class com.jolbox.bonecp.AbstractConnectionStrategy extends Object implements Serializable

Serialized Fields

pool

terminationLock

Class com.jolbox.bonecp.BoneCP extends Object implements Serializable

Serialized Fields

poolAvailabilityThreshold

partitionCount

partitions

keepAliveScheduler

maxAliveScheduler

connectionsScheduler

config

asyncExecutor

mbs

closeConnectionWatch

closeConnectionExecutor

poolShuttingDown

shutdownStackTrace

finalizableRefs

connectionTimeoutInMs

closeConnectionWatchTimeoutInMs

statisticsEnabled

statistics

nullOnConnectionTimeout

resetConnectionOnClose

cachedPoolStrategy

connectionStrategy

dbIsDown

clientInfo

driverInitialized

jvmMajorVersion

Class com.jolbox.bonecp.BoneCPConfig extends Object implements Serializable

Serialized Fields

minConnectionsPerPartition

maxConnectionsPerPartition

acquireIncrement

partitionCount

jdbcUrl

username

password

idleConnectionTestPeriodInSeconds

idleMaxAgeInSeconds

connectionTestStatement

statementsCacheSize

statementsCachedPerConnection

releaseHelperThreads

statementReleaseHelperThreads

connectionHook

initSQL

closeConnectionWatch

logStatementsEnabled

acquireRetryDelayInMs

acquireRetryAttempts

lazyInit

transactionRecoveryEnabled

connectionHookClassName

classLoader

poolName

disableJMX

datasourceBean

queryExecuteTimeLimitInMs

poolAvailabilityThreshold

disableConnectionTracking

driverProperties

connectionTimeoutInMs

closeConnectionWatchTimeoutInMs

maxConnectionAgeInSeconds

configFile

serviceOrder

statisticsEnabled

defaultAutoCommit

defaultReadOnly

defaultTransactionIsolation

defaultCatalog

defaultTransactionIsolationValue

externalAuth

deregisterDriverOnClose