com.datastax.driver.core

Interface SettableByIndexData<T extends SettableByIndexData<T>>

All Known Subinterfaces:

SettableData<T>

All Known Implementing Classes:

BoundStatement, TupleValue, UDTValue

public interface SettableByIndexData<T extends SettableByIndexData<T>>

Collection of (typed) CQL values that can set by index (starting a 0).

Method Summary

Modifier and Type	Method and Description
T	setBool(int i, boolean v) Sets the ith value to the provided boolean.
T	setBytes(int i, ByteBuffer v) Sets the ith value to the provided byte buffer.
T	setBytesUnsafe(int i, ByteBuffer v) Sets the ith value to the provided byte buffer.
T	setDate(int i, Date v) Set the ith value to the provided date.
T	setDecimal(int i, BigDecimal v) Sets the ith value to the provided big decimal.
T	setDouble(int i, double v) Sets the ith value to the provided double.
T	setFloat(int i, float v) Sets the ith value to the provided float.
T	setInet(int i, InetAddress v) Sets the ith value to the provided inet address.
T	setInt(int i, int v) Set the ith value to the provided integer.
<E> T	setList(int i, List<E> v) Sets the ith value to the provided list.
T	setLong(int i, long v) Sets the ith value to the provided long.
<K,V> T	setMap(int i, Map<K,V> v) Sets the ith value to the provided map.
<E> T	setSet(int i, Set<E> v) Sets the ith value to the provided set.
T	setString(int i, String v) Sets the ith value to the provided string.
T	setToNull(int i) Sets the ith value to null.
T	setTupleValue(int i, TupleValue v) Sets the ith value to the provided tuple value.
T	setUDTValue(int i, UDTValue v) Sets the ith value to the provided UDT value.
T	setUUID(int i, UUID v) Sets the ith value to the provided UUID.
T	setVarint(int i, BigInteger v) Sets the ith value to the provided big integer.

Method Detail

setBool

T setBool(int i,
          boolean v)

Sets the ith value to the provided boolean.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type BOOLEAN.

setInt

T setInt(int i,
         int v)

Set the ith value to the provided integer.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type INT.

setLong

T setLong(int i,
          long v)

Sets the ith value to the provided long.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type BIGINT or COUNTER.

setDate

T setDate(int i,
          Date v)

Set the ith value to the provided date.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type TIMESTAMP.

setFloat

T setFloat(int i,
           float v)

Sets the ith value to the provided float.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type FLOAT.

setDouble

T setDouble(int i,
            double v)

Sets the ith value to the provided double.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type DOUBLE.

setString

T setString(int i,
            String v)

Sets the ith value to the provided string.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is of neither of the following types: VARCHAR, TEXT or ASCII.

setBytes

T setBytes(int i,
           ByteBuffer v)

Sets the ith value to the provided byte buffer.

This method validate that the type of the column set is BLOB. If you want to insert manually serialized data into columns of another type, use setBytesUnsafe(int, java.nio.ByteBuffer) instead.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type BLOB.

setBytesUnsafe

T setBytesUnsafe(int i,
                 ByteBuffer v)

Sets the ith value to the provided byte buffer.

Contrary to setBytes(int, java.nio.ByteBuffer), this method does not check the type of the column set. If you insert data that is not compatible with the type of the column, you will get an InvalidQueryException at execute time.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

setVarint

T setVarint(int i,
            BigInteger v)

Sets the ith value to the provided big integer.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type VARINT.

setDecimal

T setDecimal(int i,
             BigDecimal v)

Sets the ith value to the provided big decimal.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type DECIMAL.

setUUID

T setUUID(int i,
          UUID v)

Sets the ith value to the provided UUID.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type UUID or TIMEUUID, or if value i is of type TIMEUUID but v is not a type 1 UUID.

setInet

T setInet(int i,
          InetAddress v)

Sets the ith value to the provided inet address.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not of type INET.

setList

<E> T setList(int i,
              List<E> v)

Sets the ith value to the provided list.

Please note that null values are not supported inside collection by CQL.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not a list type or if the elements of v are not of the type of the elements of column i.

NullPointerException - if v contains null values. Nulls are not supported in collections by CQL.

setMap

<K,V> T setMap(int i,
               Map<K,V> v)

Sets the ith value to the provided map.

Please note that null values are not supported inside collection by CQL.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not a map type or if the elements (keys or values) of v are not of the type of the elements of column i.

NullPointerException - if v contains null values. Nulls are not supported in collections by CQL.

setSet

<E> T setSet(int i,
             Set<E> v)

Sets the ith value to the provided set.

Please note that null values are not supported inside collection by CQL.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not a set type or if the elements of v are not of the type of the elements of column i.

NullPointerException - if v contains null values. Nulls are not supported in collections by CQL.

setUDTValue

T setUDTValue(int i,
              UDTValue v)

Sets the ith value to the provided UDT value.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not a UDT value or if its definition does not correspond to the one of v.

setTupleValue

T setTupleValue(int i,
                TupleValue v)

Sets the ith value to the provided tuple value.

Parameters:

i - the index of the value to set.

v - the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.

InvalidTypeException - if value i is not a tuple value or if its types do not correspond to the ones of v.

setToNull

T setToNull(int i)

Sets the ith value to null.

This is mainly intended for CQL types which map to native Java types.

Parameters:

i - the index of the value to set.

Returns:

this object.

Throws:

IndexOutOfBoundsException - if i is not a valid index for this object.