com.zaxxer.hikari

Class HikariDataSource

java.lang.Object

com.zaxxer.hikari.HikariConfig

com.zaxxer.hikari.HikariDataSource

All Implemented Interfaces:

HikariConfigMXBean, Closeable, AutoCloseable, Wrapper, CommonDataSource, DataSource

public class HikariDataSource
extends HikariConfig
implements DataSource, Closeable

The HikariCP pooled DataSource.

Author:

Brett Wooldridge

Constructor Summary

Constructors

Constructor and Description
HikariDataSource() Default constructor.
HikariDataSource(HikariConfig configuration) Construct a HikariDataSource with the specified configuration.

Method Summary

Modifier and Type	Method and Description
void	close() Shutdown the DataSource and its associated pool.
void	evictConnection(Connection connection) Evict a connection from the pool.
Connection	getConnection()
Connection	getConnection(String username, String password)
int	getLoginTimeout()
PrintWriter	getLogWriter()
Logger	getParentLogger()
boolean	isClosed() Determine whether the HikariDataSource has been closed.
boolean	isWrapperFor(Class<?> iface)
void	resumePool() Resume allocation of connections from the pool.
void	setHealthCheckRegistry(Object healthCheckRegistry) Set a Codahale HealthCheckRegistry to use for HikariCP.
void	setLoginTimeout(int seconds)
void	setLogWriter(PrintWriter out)
void	setMetricRegistry(Object metricRegistry) Set a Codahale MetricRegistry to use for HikariCP.
void	setMetricsTrackerFactory(MetricsTrackerFactory metricsTrackerFactory)
void	shutdown() Deprecated. This method has been deprecated, please use close() instead
void	suspendPool() Suspend allocation of connections from the pool.
String	toString()
<T> T	unwrap(Class<T> iface)

Methods inherited from class com.zaxxer.hikari.HikariConfig

addDataSourceProperty, addHealthCheckProperty, copyState, getCatalog, getConnectionInitSql, getConnectionTestQuery, getConnectionTimeout, getDataSource, getDataSourceClassName, getDataSourceJNDI, getDataSourceProperties, getDriverClassName, getHealthCheckProperties, getHealthCheckRegistry, getIdleTimeout, getJdbcUrl, getLeakDetectionThreshold, getMaximumPoolSize, getMaxLifetime, getMetricRegistry, getMetricsTrackerFactory, getMinimumIdle, getPassword, getPoolName, getScheduledExecutorService, getThreadFactory, getTransactionIsolation, getUsername, getValidationTimeout, isAllowPoolSuspension, isAutoCommit, isInitializationFailFast, isIsolateInternalQueries, isJdbc4ConnectionTest, isReadOnly, isRegisterMbeans, setAllowPoolSuspension, setAutoCommit, setCatalog, setConnectionInitSql, setConnectionTestQuery, setConnectionTimeout, setDataSource, setDataSourceClassName, setDataSourceJNDI, setDataSourceProperties, setDriverClassName, setHealthCheckProperties, setIdleTimeout, setInitializationFailFast, setIsolateInternalQueries, setJdbc4ConnectionTest, setJdbcUrl, setLeakDetectionThreshold, setMaximumPoolSize, setMaxLifetime, setMinimumIdle, setPassword, setPoolName, setReadOnly, setRegisterMbeans, setScheduledExecutorService, setThreadFactory, setTransactionIsolation, setUsername, setValidationTimeout, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

HikariDataSource

public HikariDataSource()

Default constructor. Setters be used to configure the pool. Using this constructor vs. HikariDataSource(HikariConfig) will result in getConnection() performance that is slightly lower due to lazy initialization checks.

HikariDataSource

public HikariDataSource(HikariConfig configuration)

Construct a HikariDataSource with the specified configuration.

Parameters:

configuration - a HikariConfig instance

Method Detail

getConnection

public Connection getConnection()
                         throws SQLException

Specified by:

getConnection in interface DataSource

Throws:

SQLException

getConnection

public Connection getConnection(String username,
                                String password)
                         throws SQLException

Specified by:

getConnection in interface DataSource

Throws:

SQLException

getLogWriter

public PrintWriter getLogWriter()
                         throws SQLException

Specified by:

getLogWriter in interface CommonDataSource

Throws:

SQLException

setLogWriter

public void setLogWriter(PrintWriter out)
                  throws SQLException

Specified by:

setLogWriter in interface CommonDataSource

Throws:

SQLException

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws SQLException

Specified by:

setLoginTimeout in interface CommonDataSource

Throws:

SQLException

getLoginTimeout

public int getLoginTimeout()
                    throws SQLException

Specified by:

getLoginTimeout in interface CommonDataSource

Throws:

SQLException

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface CommonDataSource

Throws:

SQLFeatureNotSupportedException

unwrap

public <T> T unwrap(Class<T> iface)
             throws SQLException

Specified by:

unwrap in interface Wrapper

Throws:

SQLException

isWrapperFor

public boolean isWrapperFor(Class<?> iface)
                     throws SQLException

Specified by:

isWrapperFor in interface Wrapper

Throws:

SQLException

setMetricRegistry

public void setMetricRegistry(Object metricRegistry)

Set a Codahale MetricRegistry to use for HikariCP.

Overrides:

setMetricRegistry in class HikariConfig

Parameters:

metricRegistry - the Codahale MetricRegistry to set

setMetricsTrackerFactory

public void setMetricsTrackerFactory(MetricsTrackerFactory metricsTrackerFactory)

Overrides:

setMetricsTrackerFactory in class HikariConfig

setHealthCheckRegistry

public void setHealthCheckRegistry(Object healthCheckRegistry)

Set a Codahale HealthCheckRegistry to use for HikariCP.

Overrides:

setHealthCheckRegistry in class HikariConfig

Parameters:

healthCheckRegistry - the Codahale HealthCheckRegistry to set

evictConnection

public void evictConnection(Connection connection)

Evict a connection from the pool. If the connection has already been closed (returned to the pool) this may result in a "soft" eviction; the connection will be evicted sometime in the future if it is currently in use. If the connection has not been closed, the eviction is immediate.

Parameters:

connection - the connection to evict from the pool

suspendPool

public void suspendPool()

Suspend allocation of connections from the pool. All callers to getConnection() will block indefinitely until resumePool() is called.

resumePool

public void resumePool()

Resume allocation of connections from the pool.

close

public void close()

Shutdown the DataSource and its associated pool.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

isClosed

public boolean isClosed()

Determine whether the HikariDataSource has been closed.

Returns:

true if the HikariDataSource has been closed, false otherwise

shutdown

@Deprecated
public void shutdown()

Deprecated. This method has been deprecated, please use close() instead

Shutdown the DataSource and its associated pool.

toString

public String toString()

Overrides:

toString in class Object