com.datastax.driver.core.querybuilder
Class Insert

java.lang.Object
  com.datastax.driver.core.Query
      com.datastax.driver.core.Statement
          com.datastax.driver.core.querybuilder.Insert

public class Insert
extends Statement

A built INSERT statement.

Nested Class Summary

static class

Insert.Options The options of an INSERT statement.

Method Summary

protected String	buildQueryString()
String	getQueryString() The query string for this statement.
ByteBuffer	getRoutingKey() The routing key (in binary raw form) to use for token aware routing of this query.
protected void	setDirty()
Insert.Options	using(Using using) Adds a new options for this INSERT statement.
Insert	value(String name, Object value) Adds a column/value pair to the values inserted by this INSERT statement.
Insert	values(String[] names, Object[] values) Adds multiple column/value pairs to the values inserted by this INSERT statement.

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

toString

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

disableTracing, enableTracing, getConsistencyLevel, getRetryPolicy, isTracing, setConsistencyLevel, setRetryPolicy

Methods inherited from class java.lang.Object

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

Method Detail

buildQueryString

protected String buildQueryString()

value

public Insert value(String name,
                    Object value)

Adds a column/value pair to the values inserted by this INSERT statement.

Parameters:

name - the name of the column to insert/update.

value - the value to insert/update for name.

Returns:

this INSERT statement.

values

public Insert values(String[] names,
                     Object[] values)

Adds multiple column/value pairs to the values inserted by this INSERT statement.

Parameters:

names - a list of column names to insert/update.

values - a list of values to insert/update. The ith value in values will be inserted for the ith column in names.

Returns:

this INSERT statement.

Throws:

IllegalArgumentException - if names.length != values.length.

using

public Insert.Options using(Using using)

Adds a new options for this INSERT statement.

Parameters:

using - the option to add.

Returns:

the options of this INSERT statement.

getQueryString

public String getQueryString()

Description copied from class: Statement

The query string for this statement.

Specified by:

getQueryString in class Statement

Returns:

a valid CQL query string.

setDirty

protected void setDirty()

getRoutingKey

public ByteBuffer getRoutingKey()

Description copied from class: Query

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

The routing key is optional in the sense 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 Query

Returns:

the routing key for this query or null.