com.datastax.oss.driver.api.core.data

Interface TupleValue

All Superinterfaces:

AccessibleByIndex, Data, GettableByIndex, SettableByIndex<TupleValue>

public interface TupleValue
extends GettableByIndex, SettableByIndex<TupleValue>

Driver-side representation of a CQL tuple value.

It is an ordered set of anonymous, typed fields.

A tuple value is attached if and only if its type is attached (see Detachable).

The default implementation returned by the driver is mutable and serializable. If you write your own implementation, serializability is not mandatory, but recommended for use with some 3rd-party tools like Apache Spark ™.

Method Summary

Modifier and Type	Method and Description
default String	getFormattedContents() Returns a string representation of the contents of this tuple.
TupleType	getType()
String	toString() Returns an abstract representation of this object, that may not include the tuple's contents.

Methods inherited from interface com.datastax.oss.driver.api.core.data.GettableByIndex

get, get, get, getBigDecimal, getBigInteger, getBoolean, getByte, getByteBuffer, getBytesUnsafe, getCqlDuration, getDouble, getFloat, getInetAddress, getInstant, getInt, getList, getLocalDate, getLocalTime, getLong, getMap, getObject, getSet, getShort, getString, getToken, getTupleValue, getUdtValue, getUuid, isNull

Methods inherited from interface com.datastax.oss.driver.api.core.data.SettableByIndex

set, set, set, setBigDecimal, setBigInteger, setBoolean, setByte, setByteBuffer, setBytesUnsafe, setCqlDuration, setDouble, setFloat, setInetAddress, setInstant, setInt, setList, setLocalDate, setLocalTime, setLong, setMap, setSet, setShort, setString, setToken, setToNull, setTupleValue, setUdtValue, setUuid

Methods inherited from interface com.datastax.oss.driver.api.core.data.AccessibleByIndex

getType, size

Methods inherited from interface com.datastax.oss.driver.api.core.data.Data

codecRegistry, protocolVersion

Method Detail

getType

@NonNull
TupleType getType()

getFormattedContents

@NonNull
default String getFormattedContents()

Returns a string representation of the contents of this tuple.

This produces a CQL literal, for example:

 (1,'test')
 

Notes:

• This method does not sanitize its output in any way. In particular, no effort is made to limit output size: all fields are included, and large strings or blobs will be appended as-is.
• Be mindful of how you expose the result. For example, in high-security environments, it might be undesirable to leak data in application logs.

toString

String toString()

Returns an abstract representation of this object, that may not include the tuple's contents.

The driver's built-in TupleValue implementation returns the default format of Object.toString(): the class name, followed by the at-sign and the hash code of the object.

Omitting the contents was a deliberate choice, because we feel it would make it too easy to accidentally leak data (e.g. in application logs). If you want the contents, use getFormattedContents().

Overrides:

toString in class Object