com.datastax.driver.core.exceptions

Class BusyPoolException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.datastax.driver.core.exceptions.DriverException

com.datastax.driver.core.exceptions.BusyPoolException

All Implemented Interfaces:

CoordinatorException, Serializable

public class BusyPoolException
extends DriverException
implements CoordinatorException

Indicates that a connection pool has run out of available connections.

This happens if the pool has no connections (for example if it's currently reconnecting to its host), or if all connections have reached their maximum number of in flight queries. The query will be retried on the next host in the query plan.

This exception is a symptom that the driver is experiencing a high workload. If it happens regularly on all hosts, you should consider tuning one (or a combination of) the following pooling options:

• PoolingOptions.setMaxRequestsPerConnection(HostDistance, int): maximum number of requests per connection;
• PoolingOptions.setMaxConnectionsPerHost(HostDistance, int): maximum number of connections in the pool;
• PoolingOptions.setMaxQueueSize(int): maximum number of enqueued requests before this exception is thrown.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
BusyPoolException(InetSocketAddress address, int queueSize)
BusyPoolException(InetSocketAddress address, long timeout, TimeUnit unit)

Method Summary

Modifier and Type	Method and Description
BusyPoolException	copy() Copy the exception.
InetSocketAddress	getAddress() The full address of the coordinator host that was contacted.
InetAddress	getHost() The coordinator host that was contacted.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

BusyPoolException

public BusyPoolException(InetSocketAddress address,
                         int queueSize)

BusyPoolException

public BusyPoolException(InetSocketAddress address,
                         long timeout,
                         TimeUnit unit)

Method Detail

getHost

public InetAddress getHost()

Description copied from interface: CoordinatorException

The coordinator host that was contacted.

This is a shortcut for getAddress().getAddress().

Specified by:

getHost in interface CoordinatorException

Returns:

The coordinator host that was contacted; may be null if the coordinator is not known.

getAddress

public InetSocketAddress getAddress()

Description copied from interface: CoordinatorException

The full address of the coordinator host that was contacted.

Specified by:

getAddress in interface CoordinatorException

Returns:

the full address of the coordinator host that was contacted; may be null if the coordinator is not known.

copy

public BusyPoolException copy()

Description copied from class: DriverException

Copy the exception.

This returns a new exception, equivalent to the original one, except that because a new object is created in the current thread, the top-most element in the stacktrace of the exception will refer to the current thread (this is mainly intended for internal use by the driver). The cause of the copied exception will be the original exception.

Overrides:

copy in class DriverException

Returns:

a copy/clone of this exception.