public interface SettableByIndexData<T extends SettableByIndexData<T>>
Modifier and Type | Method and Description |
---|---|
<V> T |
set(int i,
V v,
Class<V> targetClass)
Sets the
i th value to the provided value of the provided Java class. |
<V> T |
set(int i,
V v,
TypeCodec<V> codec)
Sets the
i th value to the provided value, converted using the given TypeCodec . |
<V> T |
set(int i,
V v,
TypeToken<V> targetType)
Sets the
i th value to the provided value of the provided Java type. |
T |
setBool(int i,
boolean v)
Sets the
i th value to the provided boolean. |
T |
setByte(int i,
byte v)
Set the
i th value to the provided byte. |
T |
setBytes(int i,
ByteBuffer v)
Sets the
i th value to the provided byte buffer. |
T |
setBytesUnsafe(int i,
ByteBuffer v)
Sets the
i th value to the provided byte buffer. |
T |
setDate(int i,
LocalDate v)
Set the
i th value to the provided date (without time). |
T |
setDecimal(int i,
BigDecimal v)
Sets the
i th value to the provided big decimal. |
T |
setDouble(int i,
double v)
Sets the
i th value to the provided double. |
T |
setFloat(int i,
float v)
Sets the
i th value to the provided float. |
T |
setInet(int i,
InetAddress v)
Sets the
i th value to the provided inet address. |
T |
setInt(int i,
int v)
Set the
i th value to the provided integer. |
<E> T |
setList(int i,
List<E> v)
Sets the
i th value to the provided list. |
<E> T |
setList(int i,
List<E> v,
Class<E> elementsClass)
Sets the
i th value to the provided list, which elements are of the provided Java class. |
<E> T |
setList(int i,
List<E> v,
TypeToken<E> elementsType)
Sets the
i th value to the provided list, which elements are of the provided Java type. |
T |
setLong(int i,
long v)
Sets the
i th value to the provided long. |
<K,V> T |
setMap(int i,
Map<K,V> v)
Sets the
i th value to the provided map. |
<K,V> T |
setMap(int i,
Map<K,V> v,
Class<K> keysClass,
Class<V> valuesClass)
Sets the
i th value to the provided map, which keys and values are of the provided Java
classes. |
<K,V> T |
setMap(int i,
Map<K,V> v,
TypeToken<K> keysType,
TypeToken<V> valuesType)
Sets the
i th value to the provided map, which keys and values are of the provided Java
types. |
<E> T |
setSet(int i,
Set<E> v)
Sets the
i th value to the provided set. |
<E> T |
setSet(int i,
Set<E> v,
Class<E> elementsClass)
Sets the
i th value to the provided set, which elements are of the provided Java class. |
<E> T |
setSet(int i,
Set<E> v,
TypeToken<E> elementsType)
Sets the
i th value to the provided set, which elements are of the provided Java type. |
T |
setShort(int i,
short v)
Set the
i th value to the provided short. |
T |
setString(int i,
String v)
Sets the
i th value to the provided string. |
T |
setTime(int i,
long v)
Set the
i th value to the provided time as a long in nanoseconds since midnight. |
T |
setTimestamp(int i,
Date v)
Set the
i th value to the provided date. |
T |
setToNull(int i)
Sets the
i th value to null . |
T |
setTupleValue(int i,
TupleValue v)
Sets the
i th value to the provided tuple value. |
T |
setUDTValue(int i,
UDTValue v)
Sets the
i th value to the provided UDT value. |
T |
setUUID(int i,
UUID v)
Sets the
i th value to the provided UUID. |
T |
setVarint(int i,
BigInteger v)
Sets the
i th value to the provided big integer. |
T setBool(int i, boolean v)
i
th value to the provided boolean.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type boolean
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Boolean.class)
IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setByte(int i, byte v)
i
th value to the provided byte.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type tinyint
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Byte.class)
IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setShort(int i, short v)
i
th value to the provided short.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type smallint
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Short.class)
IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setInt(int i, int v)
i
th value to the provided integer.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type int
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Integer.class)
IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setLong(int i, long v)
i
th value to the provided long.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type bigint
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Long.class)
IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setTimestamp(int i, Date v)
i
th value to the provided date.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type timestamp
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setDate(int i, LocalDate v)
i
th value to the provided date (without time).
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type date
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setTime(int i, long v)
i
th value to the provided time as a long in nanoseconds since midnight.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type time
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setFloat(int i, float v)
i
th value to the provided float.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type float
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Float.class)
IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setDouble(int i, double v)
i
th value to the provided double.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type double
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set. To set the value to NULL, use setToNull(int)
or set(i, v, Double.class)
.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setString(int i, String v)
i
th value to the provided string.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL types text
, varchar
and ascii
, this will
be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setBytes(int i, ByteBuffer v)
i
th value to the provided byte buffer.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type blob
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setBytesUnsafe(int i, ByteBuffer v)
i
th value to the provided byte buffer.
This method does not use any codec; it sets the value in its binary form directly. If you
insert data that is not compatible with the underlying CQL type, you will get an InvalidQueryException
at execute time.
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.T setVarint(int i, BigInteger v)
i
th value to the provided big integer.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type varint
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setDecimal(int i, BigDecimal v)
i
th value to the provided big decimal.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type decimal
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setUUID(int i, UUID v)
i
th value to the provided UUID.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL types uuid
and timeuuid
, this will be the built-in
codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setInet(int i, InetAddress v)
i
th value to the provided inet address.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (for CQL type inet
, this will be the built-in codec).
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<E> T setList(int i, List<E> v)
i
th value to the provided list.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (the type of the elements in the Java list is not considered). If two or
more codecs target that CQL type, the one that was first registered will be used. For this
reason, it is generally preferable to use the more deterministic methods setList(int,
List, Class)
or setList(int, List, TypeToken)
.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<E> T setList(int i, List<E> v, Class<E> elementsClass)
i
th value to the provided list, which elements are of the provided Java class.
This method uses the CodecRegistry
to find a codec to handle the conversion of lists
of the given Java type to the underlying CQL type.
If the type of the elements is generic, use setList(int, List, TypeToken)
.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.elementsClass
- the class for the elements of the list.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<E> T setList(int i, List<E> v, TypeToken<E> elementsType)
i
th value to the provided list, which elements are of the provided Java type.
This method uses the CodecRegistry
to find a codec to handle the conversion of lists
of the given Java type to the underlying CQL type.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.elementsType
- the type for the elements of the list.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<K,V> T setMap(int i, Map<K,V> v)
i
th value to the provided map.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (the type of the elements in the Java map is not considered). If two or
more codecs target that CQL type, the one that was first registered will be used. For this
reason, it is generally preferable to use the more deterministic methods setMap(int,
Map, Class, Class)
or setMap(int, Map, TypeToken, TypeToken)
.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<K,V> T setMap(int i, Map<K,V> v, Class<K> keysClass, Class<V> valuesClass)
i
th value to the provided map, which keys and values are of the provided Java
classes.
This method uses the CodecRegistry
to find a codec to handle the conversion of lists
of the given Java types to the underlying CQL type.
If the type of the keys or values is generic, use setMap(int, Map, TypeToken,
TypeToken)
.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.keysClass
- the class for the keys of the map.valuesClass
- the class for the values of the map.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<K,V> T setMap(int i, Map<K,V> v, TypeToken<K> keysType, TypeToken<V> valuesType)
i
th value to the provided map, which keys and values are of the provided Java
types.
This method uses the CodecRegistry
to find a codec to handle the conversion of lists
of the given Java types to the underlying CQL type.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.keysType
- the type for the keys of the map.valuesType
- the type for the values of the map.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<E> T setSet(int i, Set<E> v)
i
th value to the provided set.
This method uses the CodecRegistry
to find a codec to handle the conversion to the
underlying CQL type (the type of the elements in the Java set is not considered). If two or
more codecs target that CQL type, the one that was first registered will be used. For this
reason, it is generally preferable to use the more deterministic methods setSet(int,
Set, Class)
or setSet(int, Set, TypeToken)
.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<E> T setSet(int i, Set<E> v, Class<E> elementsClass)
i
th value to the provided set, which elements are of the provided Java class.
This method uses the CodecRegistry
to find a codec to handle the conversion of sets
of the given Java type to the underlying CQL type.
If the type of the elements is generic, use setSet(int, Set, TypeToken)
.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.elementsClass
- the class for the elements of the set.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<E> T setSet(int i, Set<E> v, TypeToken<E> elementsType)
i
th value to the provided set, which elements are of the provided Java type.
This method uses the CodecRegistry
to find a codec to handle the conversion of sets
of the given Java type to the underlying CQL type.
i
- the index of the value to set.v
- the value to set. Note that null
values inside collections are not supported
by CQL.elementsType
- the type for the elements of the set.IndexOutOfBoundsException
- if i
is not a valid index for this object.NullPointerException
- if v
contains null values. Nulls are not supported in
collections by CQL.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setUDTValue(int i, UDTValue v)
i
th value to the provided UDT value.
This method uses the CodecRegistry
to find a codec to handle the conversion of
UDTValue
to the underlying CQL type.
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setTupleValue(int i, TupleValue v)
i
th value to the provided tuple value.
This method uses the CodecRegistry
to find a codec to handle the conversion of
TupleValue
to the underlying CQL type.
i
- the index of the value to set.v
- the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.T setToNull(int i)
i
th value to null
.
This is mainly intended for CQL types which map to native Java types.
i
- the index of the value to set.IndexOutOfBoundsException
- if i
is not a valid index for this object.<V> T set(int i, V v, Class<V> targetClass)
i
th value to the provided value of the provided Java class.
This method uses the CodecRegistry
to find a codec to handle the conversion of the
provided Java class to the underlying CQL type.
If the Java type is generic, use set(int, Object, TypeToken)
instead.
i
- the index of the value to set.v
- the value to set; may be null
.targetClass
- The Java class to convert to; must not be null
;IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<V> T set(int i, V v, TypeToken<V> targetType)
i
th value to the provided value of the provided Java type.
This method uses the CodecRegistry
to find a codec to handle the conversion of the
provided Java type to the underlying CQL type.
i
- the index of the value to set.v
- the value to set; may be null
.targetType
- The Java type to convert to; must not be null
;IndexOutOfBoundsException
- if i
is not a valid index for this object.CodecNotFoundException
- if there is no registered codec to convert the value to the
underlying CQL type.<V> T set(int i, V v, TypeCodec<V> codec)
i
th value to the provided value, converted using the given TypeCodec
.
This method entirely bypasses the CodecRegistry
and forces the driver to use the
given codec instead. This can be useful if the codec would collide with a previously registered
one, or if you want to use the codec just once without registering it.
It is the caller's responsibility to ensure that the given codec accepts
the underlying CQL type; failing to do so may result in
InvalidTypeException
s being thrown.
i
- the index of the value to set.v
- the value to set; may be null
.codec
- The TypeCodec
to use to serialize the value; may not be null
.InvalidTypeException
- if the given codec does not accept
the underlying CQL type.IndexOutOfBoundsException
- if i
is not a valid index for this object.Copyright © 2012–2023. All rights reserved.