com.datastax.oss.driver.api.core.detach

Interface Detachable

All Known Subinterfaces:

ColumnDefinition, ColumnDefinitions, CustomType, DataType, ListType, MapType, ReactiveRow, Row, SetType, TupleType, UserDefinedType

public interface Detachable

Defines the contract of an object that can be detached and reattached to a driver instance.

The driver's data structure types (such as rows, tuples and UDT values) store their data as byte buffers, and only decode it on demand, when the end user accesses a particular column or field.

Decoding requires a ProtocolVersion (because the encoded format might change across versions), and a CodecRegistry (because the user might ask us to decode to a custom type).

• When a data container was obtained from a driver instance (for example, reading a row from a result set, or reading a value from a UDT column), it is attached: its protocol version and registry are those of the driver.
• When it is created manually by the user (for example, creating an instance from a manually created TupleType), it is detached: it uses ProtocolVersion.DEFAULT and CodecRegistry.DEFAULT.

The only way an attached object can become detached is if it is serialized and deserialized (referring to Java serialization).

A detached object can be reattached to a driver instance. This is done automatically if you pass the object to one of the driver methods, for example if you use a manually created tuple as a query parameter.

Method Summary

Modifier and Type	Method and Description
void	attach(AttachmentPoint attachmentPoint)
boolean	isDetached()

Method Detail

isDetached

boolean isDetached()

attach

void attach(@NonNull
            AttachmentPoint attachmentPoint)