com.datastax.driver.core

Class RegularStatement

java.lang.Object

com.datastax.driver.core.Statement

com.datastax.driver.core.RegularStatement

Direct Known Subclasses:

BuiltStatement, SchemaStatement, SimpleStatement

public abstract class RegularStatement
extends Statement

A regular (non-prepared and non batched) CQL statement.

This class represents a query string along with query options (and optionally binary values, see getValues). It can be extended but SimpleStatement is provided as a simple implementation to build a RegularStatement directly from its query string.

Field Summary

Fields inherited from class com.datastax.driver.core.Statement

idempotent, NULL_PAYLOAD_VALUE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RegularStatement() Creates a new RegularStatement.

Method Summary

Modifier and Type	Method and Description
abstract String	getQueryString() Returns the query string for this statement.
abstract ByteBuffer[]	getValues() The values to use for this statement.
abstract boolean	hasValues() Whether or not this statement has values, that is if getValues will return null or not.
String	toString()

Methods inherited from class com.datastax.driver.core.Statement

disableTracing, enableTracing, getConsistencyLevel, getDefaultTimestamp, getFetchSize, getKeyspace, getRetryPolicy, getRoutingKey, getSerialConsistencyLevel, isIdempotent, isTracing, setConsistencyLevel, setDefaultTimestamp, setFetchSize, setIdempotent, setOutgoingPayload, setPagingState, setPagingStateUnsafe, setRetryPolicy, setSerialConsistencyLevel

Methods inherited from class java.lang.Object

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

Constructor Detail

RegularStatement

protected RegularStatement()

Creates a new RegularStatement.

Method Detail

getQueryString

public abstract String getQueryString()

Returns the query string for this statement.

Returns:

a valid CQL query string.

getValues

public abstract ByteBuffer[] getValues()

The values to use for this statement.

Note: Values for a RegularStatement (i.e. if this method does not return null) are not supported with the native protocol version 1: you will get an UnsupportedProtocolVersionException when submitting one if version 1 of the protocol is in use (i.e. if you've force version 1 through Cluster.Builder.withProtocolVersion(com.datastax.driver.core.ProtocolVersion) or you use Cassandra 1.2).

Throws:

InvalidTypeException - if one of the values is not of a type that can be serialized to a CQL3 type

See Also:

SimpleStatement.SimpleStatement(String, Cluster, Object...)

hasValues

public abstract boolean hasValues()

Whether or not this statement has values, that is if getValues will return null or not.

Returns:

false if getValues() returns null, true otherwise.

toString

public String toString()

Overrides:

toString in class Object