com.datastax.driver.core.exceptions

Class AlreadyExistsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.datastax.driver.core.exceptions.DriverException

com.datastax.driver.core.exceptions.QueryValidationException

com.datastax.driver.core.exceptions.AlreadyExistsException

All Implemented Interfaces:

CoordinatorException, Serializable

public class AlreadyExistsException
extends QueryValidationException
implements CoordinatorException

Exception thrown when a query attempts to create a keyspace or table that already exists.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AlreadyExistsException(InetSocketAddress address, String keyspace, String table)
AlreadyExistsException(String keyspace, String table)

Method Summary

Methods

Modifier and Type	Method and Description
DriverException	copy() Copy the exception.
AlreadyExistsException	copy(InetSocketAddress address) Create a copy of this exception with a nicer stack trace, and including the coordinator address that caused this exception to be raised.
InetSocketAddress	getAddress() The full address of the coordinator host that caused this exception to be raised.
InetAddress	getHost() The coordinator host that caused this exception to be raised.
String	getKeyspace() The name of keyspace that either already exists or is home to the table that already exists.
String	getTable() If the failed creation was a table creation, the name of the table that already exists.
boolean	wasTableCreation() Returns whether the query yielding this exception was a table creation attempt.

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

AlreadyExistsException

public AlreadyExistsException(String keyspace,
                      String table)

AlreadyExistsException

public AlreadyExistsException(InetSocketAddress address,
                      String keyspace,
                      String table)

Method Detail

getHost

public InetAddress getHost()

The coordinator host that caused this exception to be raised.

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

Specified by:

getHost in interface CoordinatorException

Returns:

The coordinator host that caused this exception to be raised; may be null if the coordinator is not known.

getAddress

public InetSocketAddress getAddress()

The full address of the coordinator host that caused this exception to be raised.

Specified by:

getAddress in interface CoordinatorException

Returns:

the full address of the coordinator host that caused this exception to be raised; may be null if the coordinator is not known.

wasTableCreation

public boolean wasTableCreation()

Returns whether the query yielding this exception was a table creation attempt.

Returns:

true if this exception is raised following a table creation attempt, false if it was a keyspace creation attempt.

getKeyspace

public String getKeyspace()

The name of keyspace that either already exists or is home to the table that already exists.

Returns:

a keyspace name that is either the keyspace whose creation attempt failed because a keyspace of the same name already exists (in that case, table will return null), or the keyspace of the table creation attempt (in which case table will return the name of said table).

getTable

public String getTable()

If the failed creation was a table creation, the name of the table that already exists.

Returns:

the name of table whose creation attempt failed because a table of this name already exists, or null if the query was a keyspace creation query.

copy

public DriverException copy()

Description copied from class: DriverException

Copy the exception.

This return 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 AlreadyExistsException copy(InetSocketAddress address)

Create a copy of this exception with a nicer stack trace, and including the coordinator address that caused this exception to be raised.

This method is mainly intended for internal use by the driver and exists mainly because:

1. the original exception was decoded from a response frame and at that time, the coordinator address was not available; and
2. the newly-created exception will refer to the current thread in its stack trace, which generally yields a more user-friendly stack trace that the original one.

Parameters:

address - The full address of the host that caused this exception to be thrown.

Returns:

a copy/clone of this exception, but with the given host address instead of the original one.