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(EndPoint endPoint, int queueSize)
BusyPoolException(EndPoint endPoint, long timeout, TimeUnit unit)

Method Summary

Modifier and Type	Method and Description
BusyPoolException	copy() Copy the exception.
InetSocketAddress	getAddress() Deprecated.
EndPoint	getEndPoint() The connection information of the coordinator host that was contacted.
InetAddress	getHost() Deprecated.

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(EndPoint endPoint,
                         int queueSize)

BusyPoolException

public BusyPoolException(EndPoint endPoint,
                         long timeout,
                         TimeUnit unit)

Method Detail

getEndPoint

public EndPoint getEndPoint()

Description copied from interface: CoordinatorException

The connection information of the coordinator host that was contacted. May be null if the coordinator is not known.

Specified by:

getEndPoint in interface CoordinatorException

getAddress

@Deprecated
public InetSocketAddress getAddress()

Deprecated.

Description copied from interface: CoordinatorException

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

Specified by:

getAddress in interface CoordinatorException

getHost

@Deprecated
public InetAddress getHost()

Deprecated.

Description copied from interface: CoordinatorException

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

Specified by:

getHost in interface CoordinatorException

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.