com.singlestore.jdbc.pool

Class Pool

java.lang.Object

com.singlestore.jdbc.pool.Pool

All Implemented Interfaces:

PoolMBean, AutoCloseable

public class Pool
extends Object
implements AutoCloseable, PoolMBean

Constructor Summary

Constructors

Constructor and Description
Pool(Configuration conf, int poolIndex, ScheduledThreadPoolExecutor poolExecutor) Create pool from configuration.

Method Summary

Modifier and Type	Method and Description
void	close() Close pool and underlying connections.
long	getActiveConnections() get pool active connection number
Configuration	getConf()
long	getConnectionRequests() get connection waiting request number
long	getIdleConnections() get idle connection number
InternalPoolConnection	getPoolConnection() Retrieve new connection.
InternalPoolConnection	getPoolConnection(String username, String password) Get new connection from pool if user and password correspond to pool.
String	getPoolTag()
long	getTotalConnections() get pool total connection
List<Long>	testGetConnectionIdleThreadIds() For testing purpose only.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Pool

public Pool(Configuration conf,
            int poolIndex,
            ScheduledThreadPoolExecutor poolExecutor)

Create pool from configuration.

Parameters:

conf - configuration parser

poolIndex - pool index to permit distinction of thread name

poolExecutor - pools common executor

Method Detail

getPoolConnection

public InternalPoolConnection getPoolConnection()
                                         throws SQLException

Retrieve new connection. If possible return idle connection, if not, stack connection query, ask for a connection creation, and loop until a connection become idle / a new connection is created.

Returns:

a connection object

Throws:

SQLException - if no connection is created when reaching timeout (connectTimeout option)

getPoolConnection

public InternalPoolConnection getPoolConnection(String username,
                                                String password)
                                         throws SQLException

Get new connection from pool if user and password correspond to pool. If username and password are different from pool, will return a dedicated connection.

Parameters:

username - username

password - password

Returns:

connection

Throws:

SQLException - if any error occur during connection

getConf

public Configuration getConf()

close

public void close()

Close pool and underlying connections.

Specified by:

close in interface AutoCloseable

getPoolTag

public String getPoolTag()

getActiveConnections

public long getActiveConnections()

Description copied from interface: PoolMBean

get pool active connection number

Specified by:

getActiveConnections in interface PoolMBean

Returns:

pool active connection number

getTotalConnections

public long getTotalConnections()

Description copied from interface: PoolMBean

get pool total connection

Specified by:

getTotalConnections in interface PoolMBean

Returns:

pool total connection number

getIdleConnections

public long getIdleConnections()

Description copied from interface: PoolMBean

get idle connection number

Specified by:

getIdleConnections in interface PoolMBean

Returns:

idle connection number

getConnectionRequests

public long getConnectionRequests()

Description copied from interface: PoolMBean

get connection waiting request number

Specified by:

getConnectionRequests in interface PoolMBean

Returns:

request number

testGetConnectionIdleThreadIds

public List<Long> testGetConnectionIdleThreadIds()

For testing purpose only.

Returns:

current thread id's