public abstract static class TypeCodec.CollectionCodec<E,C extends Collection<E>> extends TypeCodec<C>
DataType.list(DataType)
or DataType.set(DataType)
.
Note that for practical reasons, TypeCodec.MapCodec
does not inherit from this class.TypeCodec.AbstractUUIDCodec, TypeCodec.AsciiCodec, TypeCodec.BigintCodec, TypeCodec.BlobCodec, TypeCodec.BooleanCodec, TypeCodec.CollectionCodec<E,C extends Collection<E>>, TypeCodec.CounterCodec, TypeCodec.CustomCodec, TypeCodec.DateCodec, TypeCodec.DecimalCodec, TypeCodec.DoubleCodec, TypeCodec.EnumIntCodec<E extends Enum<E>>, TypeCodec.EnumStringCodec<E extends Enum<E>>, TypeCodec.FloatCodec, TypeCodec.InetCodec, TypeCodec.IntCodec, TypeCodec.ListCodec<T>, TypeCodec.LongCodec, TypeCodec.MapCodec<K,V>, TypeCodec.MappingCodec<T,U>, TypeCodec.PrimitiveBooleanCodec, TypeCodec.PrimitiveByteCodec, TypeCodec.PrimitiveDoubleCodec, TypeCodec.PrimitiveFloatCodec, TypeCodec.PrimitiveIntCodec, TypeCodec.PrimitiveLongCodec, TypeCodec.PrimitiveShortCodec, TypeCodec.SetCodec<T>, TypeCodec.SmallIntCodec, TypeCodec.StringCodec, TypeCodec.StringParsingCodec<T>, TypeCodec.TimeCodec, TypeCodec.TimestampCodec, TypeCodec.TimeUUIDCodec, TypeCodec.TinyIntCodec, TypeCodec.TupleCodec, TypeCodec.UDTCodec, TypeCodec.UUIDCodec, TypeCodec.VarcharCodec, TypeCodec.VarintCodec
Constructor and Description |
---|
CollectionCodec(DataType.CollectionType cqlType,
com.google.common.reflect.TypeToken<C> javaType,
TypeCodec<E> eltCodec) |
Modifier and Type | Method and Description |
---|---|
boolean |
accepts(Object value)
Return
true if this codec is capable of serializing
the given object. |
C |
deserialize(ByteBuffer bytes,
ProtocolVersion protocolVersion)
Deserialize the given
ByteBuffer instance according to the CQL type
handled by this codec. |
String |
format(C value)
Format the given value as a valid CQL literal according
to the CQL type handled by this codec.
|
protected abstract char |
getClosingChar() |
protected abstract char |
getOpeningChar() |
protected abstract C |
newInstance(int capacity) |
C |
parse(String value)
Parse the given CQL literal into an instance of the Java type
handled by this codec.
|
ByteBuffer |
serialize(C value,
ProtocolVersion protocolVersion)
Serialize the given value according to the CQL type
handled by this codec.
|
protected abstract C |
unmodifiable(C coll) |
accepts, accepts, equals, getCqlType, getJavaType, hashCode, toString
public CollectionCodec(DataType.CollectionType cqlType, com.google.common.reflect.TypeToken<C> javaType, TypeCodec<E> eltCodec)
public ByteBuffer serialize(C value, ProtocolVersion protocolVersion)
TypeCodec
Implementation notes:
null
input as
the equivalent of an empty collection.serialize
in class TypeCodec<C extends Collection<E>>
value
- An instance of T; may be null
.protocolVersion
- the protocol version to use when serializing
bytes
. In most cases, the proper value to provide for this argument
is the value returned by ProtocolOptions.getProtocolVersion()
(which
is the protocol version in use by the driver).ByteBuffer
instance containing the serialized form of Tpublic C deserialize(ByteBuffer bytes, ProtocolVersion protocolVersion)
TypeCodec
ByteBuffer
instance according to the CQL type
handled by this codec.
Implementation notes:
null
or a default value for the corresponding Java type, if applicable;null
;
they should return empty collections instead.deserialize
in class TypeCodec<C extends Collection<E>>
bytes
- A ByteBuffer
instance containing the serialized form of T;
may be null
or empty.protocolVersion
- the protocol version to use when serializing
bytes
. In most cases, the proper value to provide for this argument
is the value returned by ProtocolOptions.getProtocolVersion()
(which
is the protocol version in use by the driver).public String format(C value)
TypeCodec
"NULL"
for null
inputs.format
in class TypeCodec<C extends Collection<E>>
value
- An instance of T; may be null
.public C parse(String value)
TypeCodec
"NULL"
;
in most cases, implementations should interpret these inputs has equivalent to a null
reference.parse
in class TypeCodec<C extends Collection<E>>
value
- The CQL string to parse, may be null
or empty.null
on a null input
.public boolean accepts(Object value)
TypeCodec
true
if this codec is capable of serializing
the given object. Note that the object's Java type is inferred
from the object' runtime (raw) type, contrary
to TypeCodec.accepts(TypeToken)
which is capable of
handling generic types.
This method is intended mostly to be used by the QueryBuilder when no type information is available when the codec is used.
Implementation notes:
TypeCodec.TimeUUIDCodec
or TypeCodec.AsciiCodec
, must override
this method and manually inspect the object to check if it
complies or not with the codec's limitations.accepts
in class TypeCodec<C extends Collection<E>>
value
- The Java type this codec should serialize from and deserialize to; cannot be null
.true
if the codec is capable of serializing
the given javaType
, and false
otherwise.protected abstract C newInstance(int capacity)
protected abstract char getOpeningChar()
protected abstract char getClosingChar()
Copyright © 2012–2015. All rights reserved.