DataSourceConfig (avaje-datasource-api 3.2 API)

java.lang.Object
- org.avaje.datasource.DataSourceConfig

public class DataSourceConfig
extends Object

Configuration information for a DataSource.

Constructor Summary

Constructors
Constructor and Description

DataSourceConfig()

Constructors
Constructor and Description
`DataSourceConfig()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`DataSourceAlert`	`getAlert()` Return the alert implementation to use.
`int`	`getCstmtCacheSize()` Return the size of the CallableStatement cache (per connection).
`Map<String,String>`	`getCustomProperties()` Return a map of custom properties for the jdbc driver connection.
`String`	`getDriver()` Return the database driver.
`int`	`getHeartbeatFreqSecs()` Return the heartbeat frequency in seconds.
`String`	`getHeartbeatSql()` Return a SQL statement used to test the database is accessible.
`int`	`getHeartbeatTimeoutSeconds()` Return the heart beat timeout in seconds.
`int`	`getIsolationLevel()` Return the transaction isolation level.
`int`	`getLeakTimeMinutes()` Return the time in minutes after which a connection could be considered to have leaked.
`DataSourcePoolListener`	`getListener()` Return the listener to use.
`int`	`getMaxAgeMinutes()` Return the maximum age a connection is allowed to be before it is closed.
`int`	`getMaxConnections()` Return the maximum number of connections the pool can reach.
`int`	`getMaxInactiveTimeSecs()` Return the time in seconds a connection can be idle after which it can be trimmed from the pool.
`int`	`getMaxStackTraceSize()` Return the max size for reporting stack traces on busy connections.
`int`	`getMinConnections()` Return the minimum number of connections the pool should maintain.
`String`	`getPassword()` Return the database password.
`String`	`getPoolListener()` Return the pool listener.
`int`	`getPstmtCacheSize()` Return the size of the PreparedStatement cache (per connection).
`int`	`getTrimPoolFreqSecs()` Return the minimum time gap between pool trim checks.
`String`	`getUrl()` Return the connection URL.
`String`	`getUsername()` Return the database username.
`int`	`getWaitTimeoutMillis()` Return the time in millis to wait for a connection before timing out once the pool has reached its maximum size.
`boolean`	`isAutoCommit()` Return autoCommit setting.
`boolean`	`isCaptureStackTrace()` Return true if a stack trace should be captured when obtaining a connection from the pool.
`boolean`	`isEmpty()` Return true if there are no values set for any of url, driver, username and password.
`boolean`	`isOffline()` Return true if the DataSource should be left offline.
`boolean`	`isReadOnly()` Return the read only setting.
`void`	`loadSettings(Properties properties, String serverName)` Load the settings from the properties supplied.
`void`	`setAlert(DataSourceAlert alert)` Set the alert implementation to use.
`void`	`setAutoCommit(boolean autoCommit)` Set to true to turn on autoCommit.
`void`	`setCaptureStackTrace(boolean captureStackTrace)` Set to true if a stack trace should be captured when obtaining a connection from the pool.
`void`	`setCstmtCacheSize(int cstmtCacheSize)` Set the size of the CallableStatement cache (per connection).
`void`	`setCustomProperties(Map<String,String> customProperties)` Set custom properties for the jdbc driver connection.
`void`	`setDefaults(DataSourceConfig other)` Default the values for driver, url, username and password from another config if they have not been set.
`void`	`setDriver(String driver)` Set the database driver.
`void`	`setHeartbeatFreqSecs(int heartbeatFreqSecs)` Set the expected heartbeat frequency in seconds.
`void`	`setHeartbeatSql(String heartbeatSql)` Set a SQL statement used to test the database is accessible.
`void`	`setHeartbeatTimeoutSeconds(int heartbeatTimeoutSeconds)` Set the heart beat timeout in seconds.
`void`	`setIsolationLevel(int isolationLevel)` Set the transaction isolation level.
`void`	`setLeakTimeMinutes(int leakTimeMinutes)` Set the time in minutes after which a connection could be considered to have leaked.
`void`	`setListener(DataSourcePoolListener listener)` Set the listener to use.
`void`	`setMaxAgeMinutes(int maxAgeMinutes)` Set the maximum age a connection can be in minutes.
`void`	`setMaxConnections(int maxConnections)` Set the maximum number of connections the pool can reach.
`void`	`setMaxInactiveTimeSecs(int maxInactiveTimeSecs)` Set the time in seconds a connection can be idle after which it can be trimmed from the pool.
`void`	`setMaxStackTraceSize(int maxStackTraceSize)` Set the max size for reporting stack traces on busy connections.
`void`	`setMinConnections(int minConnections)` Set the minimum number of connections the pool should maintain.
`void`	`setOffline(boolean offline)` Set to true if the DataSource should be left offline.
`void`	`setPassword(String password)` Set the database password.
`void`	`setPoolListener(String poolListener)` Set a pool listener.
`void`	`setPstmtCacheSize(int pstmtCacheSize)` Set the size of the PreparedStatement cache (per connection).
`void`	`setReadOnly(boolean readOnly)` Set to true to for read only.
`void`	`setTrimPoolFreqSecs(int trimPoolFreqSecs)` Set the minimum trim gap between pool trim checks.
`void`	`setUrl(String url)` Set the connection URL.
`void`	`setUsername(String username)` Set the database username.
`void`	`setWaitTimeoutMillis(int waitTimeoutMillis)` Set the time in millis to wait for a connection before timing out once the pool has reached its maximum size.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - DataSourceConfig
```
public DataSourceConfig()
```
- Method Detail
  - setDefaults
```
public void setDefaults(DataSourceConfig other)
```
    Default the values for driver, url, username and password from another config if they have not been set.
  - isEmpty
```
public boolean isEmpty()
```
    Return true if there are no values set for any of url, driver, username and password.
  - getUrl
```
public String getUrl()
```
    Return the connection URL.
  - setUrl
```
public void setUrl(String url)
```
    Set the connection URL.
  - getUsername
```
public String getUsername()
```
    Return the database username.
  - setUsername
```
public void setUsername(String username)
```
    Set the database username.
  - getPassword
```
public String getPassword()
```
    Return the database password.
  - setPassword
```
public void setPassword(String password)
```
    Set the database password.
  - getDriver
```
public String getDriver()
```
    Return the database driver.
  - setDriver
```
public void setDriver(String driver)
```
    Set the database driver.
  - getIsolationLevel
```
public int getIsolationLevel()
```
    Return the transaction isolation level.
  - setIsolationLevel
```
public void setIsolationLevel(int isolationLevel)
```
    Set the transaction isolation level.
  - isAutoCommit
```
public boolean isAutoCommit()
```
    Return autoCommit setting.
  - setAutoCommit
```
public void setAutoCommit(boolean autoCommit)
```
    Set to true to turn on autoCommit.
  - isReadOnly
```
public boolean isReadOnly()
```
    Return the read only setting.
  - setReadOnly
```
public void setReadOnly(boolean readOnly)
```
    Set to true to for read only.
  - getMinConnections
```
public int getMinConnections()
```
    Return the minimum number of connections the pool should maintain.
  - setMinConnections
```
public void setMinConnections(int minConnections)
```
    Set the minimum number of connections the pool should maintain.
  - getMaxConnections
```
public int getMaxConnections()
```
    Return the maximum number of connections the pool can reach.
  - setMaxConnections
```
public void setMaxConnections(int maxConnections)
```
    Set the maximum number of connections the pool can reach.
  - getAlert
```
public DataSourceAlert getAlert()
```
    Return the alert implementation to use.
  - setAlert
```
public void setAlert(DataSourceAlert alert)
```
    Set the alert implementation to use.
  - getListener
```
public DataSourcePoolListener getListener()
```
    Return the listener to use.
  - setListener
```
public void setListener(DataSourcePoolListener listener)
```
    Set the listener to use.
  - getHeartbeatSql
```
public String getHeartbeatSql()
```
    Return a SQL statement used to test the database is accessible.
    Note that if this is not set then it can get defaulted from the DatabasePlatform.
  - setHeartbeatSql
```
public void setHeartbeatSql(String heartbeatSql)
```
    Set a SQL statement used to test the database is accessible.
    Note that if this is not set then it can get defaulted from the DatabasePlatform.
  - getHeartbeatFreqSecs
```
public int getHeartbeatFreqSecs()
```
    Return the heartbeat frequency in seconds.
    This is the expected frequency in which the DataSource should be checked to make sure it is healthy and trim idle connections.
  - setHeartbeatFreqSecs
```
public void setHeartbeatFreqSecs(int heartbeatFreqSecs)
```
    Set the expected heartbeat frequency in seconds.
  - getHeartbeatTimeoutSeconds
```
public int getHeartbeatTimeoutSeconds()
```
    Return the heart beat timeout in seconds.
  - setHeartbeatTimeoutSeconds
```
public void setHeartbeatTimeoutSeconds(int heartbeatTimeoutSeconds)
```
    Set the heart beat timeout in seconds.
  - isCaptureStackTrace
```
public boolean isCaptureStackTrace()
```
    Return true if a stack trace should be captured when obtaining a connection from the pool.
    This can be used to diagnose a suspected connection pool leak.
    
    Obviously this has a performance overhead.
  - setCaptureStackTrace
```
public void setCaptureStackTrace(boolean captureStackTrace)
```
    Set to true if a stack trace should be captured when obtaining a connection from the pool.
    This can be used to diagnose a suspected connection pool leak.
    
    Obviously this has a performance overhead.
  - getMaxStackTraceSize
```
public int getMaxStackTraceSize()
```
    Return the max size for reporting stack traces on busy connections.
  - setMaxStackTraceSize
```
public void setMaxStackTraceSize(int maxStackTraceSize)
```
    Set the max size for reporting stack traces on busy connections.
  - getLeakTimeMinutes
```
public int getLeakTimeMinutes()
```
    Return the time in minutes after which a connection could be considered to have leaked.
  - setLeakTimeMinutes
```
public void setLeakTimeMinutes(int leakTimeMinutes)
```
    Set the time in minutes after which a connection could be considered to have leaked.
  - getPstmtCacheSize
```
public int getPstmtCacheSize()
```
    Return the size of the PreparedStatement cache (per connection).
  - setPstmtCacheSize
```
public void setPstmtCacheSize(int pstmtCacheSize)
```
    Set the size of the PreparedStatement cache (per connection).
  - getCstmtCacheSize
```
public int getCstmtCacheSize()
```
    Return the size of the CallableStatement cache (per connection).
  - setCstmtCacheSize
```
public void setCstmtCacheSize(int cstmtCacheSize)
```
    Set the size of the CallableStatement cache (per connection).
  - getWaitTimeoutMillis
```
public int getWaitTimeoutMillis()
```
    Return the time in millis to wait for a connection before timing out once the pool has reached its maximum size.
  - setWaitTimeoutMillis
```
public void setWaitTimeoutMillis(int waitTimeoutMillis)
```
    Set the time in millis to wait for a connection before timing out once the pool has reached its maximum size.
  - getMaxInactiveTimeSecs
```
public int getMaxInactiveTimeSecs()
```
    Return the time in seconds a connection can be idle after which it can be trimmed from the pool.
    This is so that the pool after a busy period can trend over time back towards the minimum connections.
  - getMaxAgeMinutes
```
public int getMaxAgeMinutes()
```
    Return the maximum age a connection is allowed to be before it is closed.
    This can be used to close really old connections.
  - setMaxAgeMinutes
```
public void setMaxAgeMinutes(int maxAgeMinutes)
```
    Set the maximum age a connection can be in minutes.
  - setMaxInactiveTimeSecs
```
public void setMaxInactiveTimeSecs(int maxInactiveTimeSecs)
```
    Set the time in seconds a connection can be idle after which it can be trimmed from the pool.
    This is so that the pool after a busy period can trend over time back towards the minimum connections.
  - getTrimPoolFreqSecs
```
public int getTrimPoolFreqSecs()
```
    Return the minimum time gap between pool trim checks.
    This defaults to 59 seconds meaning that the pool trim check will run every minute assuming the heart beat check runs every 30 seconds.
  - setTrimPoolFreqSecs
```
public void setTrimPoolFreqSecs(int trimPoolFreqSecs)
```
    Set the minimum trim gap between pool trim checks.
  - getPoolListener
```
public String getPoolListener()
```
    Return the pool listener.
  - setPoolListener
```
public void setPoolListener(String poolListener)
```
    Set a pool listener.
  - isOffline
```
public boolean isOffline()
```
    Return true if the DataSource should be left offline.
    This is to support DDL generation etc without having a real database.
  - setOffline
```
public void setOffline(boolean offline)
```
    Set to true if the DataSource should be left offline.
  - getCustomProperties
```
public Map<String,String> getCustomProperties()
```
    Return a map of custom properties for the jdbc driver connection.
  - setCustomProperties
```
public void setCustomProperties(Map<String,String> customProperties)
```
    Set custom properties for the jdbc driver connection.
  - loadSettings
```
public void loadSettings(Properties properties,
                         String serverName)
```
    Load the settings from the properties supplied.
    You can use this when you have your own properties to use for configuration.
    
    Parameters:
    
    properties - the properties to configure the dataSource
    
    serverName - the name of the specific dataSource (optional)

Class DataSourceConfig

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

DataSourceConfig

Method Detail

setDefaults

isEmpty

getUrl

setUrl

getUsername

setUsername

getPassword

setPassword

getDriver

setDriver

getIsolationLevel

setIsolationLevel

isAutoCommit

setAutoCommit

isReadOnly

setReadOnly

getMinConnections

setMinConnections

getMaxConnections

setMaxConnections

getAlert

setAlert

getListener

setListener

getHeartbeatSql

setHeartbeatSql

getHeartbeatFreqSecs

setHeartbeatFreqSecs

getHeartbeatTimeoutSeconds

setHeartbeatTimeoutSeconds

isCaptureStackTrace

setCaptureStackTrace

getMaxStackTraceSize

setMaxStackTraceSize

getLeakTimeMinutes

setLeakTimeMinutes

getPstmtCacheSize

setPstmtCacheSize

getCstmtCacheSize

setCstmtCacheSize

getWaitTimeoutMillis

setWaitTimeoutMillis

getMaxInactiveTimeSecs

getMaxAgeMinutes

setMaxAgeMinutes

setMaxInactiveTimeSecs

getTrimPoolFreqSecs

setTrimPoolFreqSecs

getPoolListener

setPoolListener

isOffline

setOffline

getCustomProperties

setCustomProperties

loadSettings