com.zaxxer.hikari

Class HikariDataSource

java.lang.Object

com.zaxxer.hikari.AbstractHikariConfig

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() close() and shutdown() are synonymous.
void	evictConnection(Connection connection) Evict a connection from the pool.
Connection	getConnection()
Connection	getConnection(String username, String password) Deprecated.
int	getLoginTimeout()
PrintWriter	getLogWriter()
Logger	getParentLogger()
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	shutdown() Shutdown the DataSource and its associated pool.
void	suspendPool() Suspend allocation of connections from the pool.
String	toString()
<T> T	unwrap(Class<T> iface)

Methods inherited from class com.zaxxer.hikari.AbstractHikariConfig

addDataSourceProperty, addHealthCheckProperty, copyState, getCatalog, getConnectionCustomizer, getConnectionCustomizerClassName, getConnectionInitSql, getConnectionTestQuery, getConnectionTimeout, getDataSource, getDataSourceClassName, getDataSourceJNDI, getDataSourceProperties, getDriverClassName, getHealthCheckProperties, getHealthCheckRegistry, getIdleTimeout, getJdbcUrl, getLeakDetectionThreshold, getMaximumPoolSize, getMaxLifetime, getMetricRegistry, getMinimumIdle, getPassword, getPoolName, getThreadFactory, getTransactionIsolation, getUsername, getValidationTimeout, isAllowPoolSuspension, isAutoCommit, isInitializationFailFast, isIsolateInternalQueries, isJdbc4ConnectionTest, isReadOnly, isRegisterMbeans, setAllowPoolSuspension, setAutoCommit, setCatalog, setConnectionCustomizer, setConnectionCustomizerClassName, setConnectionInitSql, setConnectionTestQuery, setConnectionTimeout, setDataSource, setDataSourceClassName, setDataSourceJNDI, setDataSourceProperties, setDriverClassName, setHealthCheckProperties, setIdleTimeout, setInitializationFailFast, setIsolateInternalQueries, setJdbc4ConnectionTest, setJdbcUrl, setLeakDetectionThreshold, setMaximumPoolSize, setMaxLifetime, setMinimumIdle, setPassword, setPoolName, setReadOnly, setRegisterMbeans, 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

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

Deprecated.

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 AbstractHikariConfig

Parameters:

metricRegistry - the Codahale MetricRegistry to set

setHealthCheckRegistry

public void setHealthCheckRegistry(Object healthCheckRegistry)

Set a Codahale HealthCheckRegistry to use for HikariCP.

Overrides:

setHealthCheckRegistry in class AbstractHikariConfig

Parameters:

healthCheckRegistry - the Codahale HealthCheckRegistry to set

evictConnection

public void evictConnection(Connection connection)

Evict a connection from the pool. Use caution using this method, if you evict the same connection more than one time, the internal pool accounting will become invalid and the pool may stop functioning.

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

close() and shutdown() are synonymous.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

shutdown

public void shutdown()

Shutdown the DataSource and its associated pool.

toString

public String toString()

Overrides:

toString in class Object