com.datastax.driver.core.querybuilder
Class Update

java.lang.Object
  com.datastax.driver.core.Statement
      com.datastax.driver.core.RegularStatement
          com.datastax.driver.core.querybuilder.Update

public class Update
extends RegularStatement

A built UPDATE statement.

Nested Class Summary

static class	Update.Assignments The assignments of an UPDATE statement.
static class	Update.Conditions Conditions for an UDPATE statement.
static class	Update.Options The options of a UDPATE statement.
static class	Update.Where The WHERE clause of an UPDATE statement.

Field Summary

protected Boolean	isCounterOp
protected String	keyspace

Method Summary

protected StringBuilder	buildQueryString()
String	getKeyspace() Returns the keyspace this query operates on.
String	getQueryString() Returns the query string for this statement.
ByteBuffer	getRoutingKey() Returns the routing key (in binary raw form) to use for token aware routing of this query.
ByteBuffer[]	getValues() The values to use for this statement.
protected boolean	isCounterOp()
Update.Conditions	onlyIf() Adds a conditions clause (IF) to this statement.
Update.Conditions	onlyIf(Clause condition) Adds a conditions clause (IF) to this statement.
protected void	setCounterOp(boolean isCounterOp)
protected void	setDirty()
Update.Options	using(Using using) Adds a new options for this UPDATE statement.
Update.Where	where() Returns a Where statement for this query without adding clause.
Update.Where	where(Clause clause) Adds a WHERE clause to this statement.
Update.Assignments	with() Returns the assignments of this UPDATE statement.
Update.Assignments	with(Assignment assignment) Adds an assignment to this UPDATE statement.

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

toString

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

disableTracing, enableTracing, getConsistencyLevel, getFetchSize, getRetryPolicy, getSerialConsistencyLevel, isTracing, setConsistencyLevel, setFetchSize, setRetryPolicy, setSerialConsistencyLevel

Methods inherited from class java.lang.Object

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

Field Detail

keyspace

protected final String keyspace

isCounterOp

protected Boolean isCounterOp

Method Detail

buildQueryString

protected StringBuilder buildQueryString()

with

public Update.Assignments with(Assignment assignment)

Adds an assignment to this UPDATE statement. This is a shorter/more readable version for with().and(assignment).

Parameters:

assignment - the assignment to add.

Returns:

the Assignments of this UPDATE statement.

with

public Update.Assignments with()

Returns the assignments of this UPDATE statement.

Returns:

the assignments of this UPDATE statement.

where

public Update.Where where(Clause clause)

Adds a WHERE clause to this statement. This is a shorter/more readable version for where().and(clause).

Parameters:

clause - the clause to add.

Returns:

the where clause of this query to which more clause can be added.

where

public Update.Where where()

Returns a Where statement for this query without adding clause.

Returns:

the where clause of this query to which more clause can be added.

onlyIf

public Update.Conditions onlyIf(Clause condition)

Adds a conditions clause (IF) to this statement.

This is a shorter/more readable version for onlyIf().and(condition).

Parameters:

condition - the condition to add.

Returns:

the conditions of this query to which more conditions can be added.

onlyIf

public Update.Conditions onlyIf()

Adds a conditions clause (IF) to this statement.

Returns:

the conditions of this query to which more conditions can be added.

using

public Update.Options using(Using using)

Adds a new options for this UPDATE statement.

Parameters:

using - the option to add.

Returns:

the options of this UPDATE statement.

getQueryString

public String getQueryString()

Description copied from class: RegularStatement

Returns the query string for this statement.

Specified by:

getQueryString in class RegularStatement

Returns:

a valid CQL query string.

setDirty

protected void setDirty()

isCounterOp

protected boolean isCounterOp()

setCounterOp

protected void setCounterOp(boolean isCounterOp)

getRoutingKey

public ByteBuffer getRoutingKey()

Description copied from class: Statement

Returns the routing key (in binary raw form) to use for token aware routing of this query.

The routing key is optional in that implementers are free to return null. The routing key is an hint used for token-aware routing (see TokenAwarePolicy), and if provided should correspond to the binary value for the query partition key. However, not providing a routing key never causes a query to fail and if the load balancing policy used is not token aware, then the routing key can be safely ignored.

Specified by:

getRoutingKey in class Statement

Returns:

the routing key for this query or null.

getKeyspace

public String getKeyspace()

Description copied from class: Statement

Returns the keyspace this query operates on.

Note that not all query specify on which keyspace they operate on, and so this method can always reutrn null. Firstly, some queries do not operate inside a keyspace: keyspace creation, USE queries, user creation, etc. Secondly, even query that operate within a keyspace do not have to specify said keyspace directly, in which case the currently logged in keyspace (the one set through a USE query (or through the use of Cluster.connect(String))). Lastly, as for the routing key, this keyspace information is only a hint for token-aware routing (since replica placement depend on the replication strategy in use which is a per-keyspace property) and having this method return null (or even a bogus keyspace name) will never cause the query to fail.

Specified by:

getKeyspace in class Statement

Returns:

the keyspace this query operate on if relevant or null.

getValues

public ByteBuffer[] getValues()

Description copied from class: RegularStatement

The values to use for this statement.

Specified by:

getValues in class RegularStatement

Returns:

the values to use for this statement or null if there is no such values.

See Also:

SimpleStatement.SimpleStatement(String, Object...)