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
String	getQueryString() Returns the query string for this statement.
abstract String	getQueryString(CodecRegistry codecRegistry) Returns the query string for this statement.
abstract ByteBuffer[]	getValues(ProtocolVersion protocolVersion, CodecRegistry codecRegistry) The values to use for this statement.
boolean	hasValues() Whether or not this statement has values, that is if getValues will return null or not.
abstract boolean	hasValues(CodecRegistry codecRegistry) 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, 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(CodecRegistry codecRegistry)

Returns the query string for this statement.

Parameters:

codecRegistry - the codec registry that will be used if the actual implementation needs to serialize Java objects in the process of generating the query. Note that it might be possible to use the no-arg getQueryString() depending on the type of statement this is called on.

Returns:

a valid CQL query string.

See Also:

getQueryString()

getQueryString

public String getQueryString()

Returns the query string for this statement.

This method calls getQueryString(CodecRegistry) with CodecRegistry.DEFAULT_INSTANCE. Whether you should use this or the other variant depends on the type of statement this is called on:

• for a SimpleStatement or SchemaStatement, the codec registry isn't actually needed, so it's always safe to use this method;
• for a BuiltStatement you can use this method if you use no custom codecs, or if your custom codecs are registered with the default registry. Otherwise, use the other method and provide the registry that contains your codecs (see BuiltStatement for more explanations on why this is so);
• for a BatchStatement, use the first rule if it contains no built statements, or the second rule otherwise.

Returns:

a valid CQL query string.

getValues

public abstract ByteBuffer[] getValues(ProtocolVersion protocolVersion,
                                       CodecRegistry codecRegistry)

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).

Parameters:

protocolVersion - the protocol version that will be used to serialize the values.

codecRegistry - the codec registry that will be used to serialize the values.

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, Object...)

hasValues

public abstract boolean hasValues(CodecRegistry codecRegistry)

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

Parameters:

codecRegistry - the codec registry that will be used if the actual implementation needs to serialize Java objects in the process of determining if the query has values. Note that it might be possible to use the no-arg hasValues() depending on the type of statement this is called on.

Returns:

false if getValues(com.datastax.driver.core.ProtocolVersion, com.datastax.driver.core.CodecRegistry) returns null, true otherwise.

See Also:

hasValues()

hasValues

public boolean hasValues()

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

This method calls hasValues(CodecRegistry) with ProtocolVersion.NEWEST_SUPPORTED. Whether you should use this or the other variant depends on the type of statement this is called on:

• for a SimpleStatement or SchemaStatement, the codec registry isn't actually needed, so it's always safe to use this method;
• for a BuiltStatement you can use this method if you use no custom codecs, or if your custom codecs are registered with the default registry. Otherwise, use the other method and provide the registry that contains your codecs (see BuiltStatement for more explanations on why this is so);
• for a BatchStatement, use the first rule if it contains no built statements, or the second rule otherwise.

Returns:

false if getValues(com.datastax.driver.core.ProtocolVersion, com.datastax.driver.core.CodecRegistry) returns null, true otherwise.

toString

public String toString()

Overrides:

toString in class Object