com.datastax.driver.core.exceptions

Class WriteFailureException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.datastax.driver.core.exceptions.DriverException

com.datastax.driver.core.exceptions.QueryExecutionException

com.datastax.driver.core.exceptions.QueryConsistencyException

com.datastax.driver.core.exceptions.WriteFailureException

All Implemented Interfaces:

CoordinatorException, Serializable

public class WriteFailureException
extends QueryConsistencyException

A non-timeout error during a write query.

This happens when some of the replicas that were contacted by the coordinator replied with an error.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
WriteFailureException(ConsistencyLevel consistency, WriteType writeType, int received, int required, int failed) Deprecated. Legacy constructor for backward compatibility.
WriteFailureException(ConsistencyLevel consistency, WriteType writeType, int received, int required, int failed, Map<InetAddress,Integer> failuresMap) This constructor should only be used internally by the driver when decoding error responses.
WriteFailureException(InetSocketAddress address, ConsistencyLevel consistency, WriteType writeType, int received, int required, int failed) Deprecated. Legacy constructor for backward compatibility.
WriteFailureException(InetSocketAddress address, ConsistencyLevel consistency, WriteType writeType, int received, int required, int failed, Map<InetAddress,Integer> failuresMap)

Method Summary

Modifier and Type	Method and Description
WriteFailureException	copy() Copy the exception.
WriteFailureException	copy(InetSocketAddress address)
int	getFailures() Returns the number of replicas that experienced a failure while executing the request.
Map<InetAddress,Integer>	getFailuresMap() Returns the a failure reason code for each node that failed.
WriteType	getWriteType() The type of the write for which a timeout was raised.

Methods inherited from class com.datastax.driver.core.exceptions.QueryConsistencyException

getAddress, getConsistencyLevel, getHost, getReceivedAcknowledgements, getRequiredAcknowledgements

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

WriteFailureException

public WriteFailureException(ConsistencyLevel consistency,
                             WriteType writeType,
                             int received,
                             int required,
                             int failed,
                             Map<InetAddress,Integer> failuresMap)

This constructor should only be used internally by the driver when decoding error responses.

WriteFailureException

@Deprecated
public WriteFailureException(ConsistencyLevel consistency,
                                         WriteType writeType,
                                         int received,
                                         int required,
                                         int failed)

Deprecated. Legacy constructor for backward compatibility.

WriteFailureException

public WriteFailureException(InetSocketAddress address,
                             ConsistencyLevel consistency,
                             WriteType writeType,
                             int received,
                             int required,
                             int failed,
                             Map<InetAddress,Integer> failuresMap)

WriteFailureException

@Deprecated
public WriteFailureException(InetSocketAddress address,
                                         ConsistencyLevel consistency,
                                         WriteType writeType,
                                         int received,
                                         int required,
                                         int failed)

Deprecated. Legacy constructor for backward compatibility.

Method Detail

getWriteType

public WriteType getWriteType()

The type of the write for which a timeout was raised.

Returns:

the type of the write for which a timeout was raised.

getFailures

public int getFailures()

Returns the number of replicas that experienced a failure while executing the request.

Returns:

the number of failures.

getFailuresMap

public Map<InetAddress,Integer> getFailuresMap()

Returns the a failure reason code for each node that failed.

At the time of writing, the existing reason codes are:

• 0x0000: the error does not have a specific code assigned yet, or the cause is unknown.
• 0x0001: The read operation scanned too many tombstones (as defined by tombstone_failure_threshold in cassandra.yaml, causing a TombstoneOverwhelmingException.

(please refer to the Cassandra documentation for your version for the most up-to-date list of errors)

This feature is available for protocol v5 or above only. With lower protocol versions, the map will always be empty.

Returns:

a map of IP addresses to failure codes.

copy

public WriteFailureException 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.

copy

public WriteFailureException copy(InetSocketAddress address)