com.datastax.oss.protocol.internal

Interface PrimitiveCodec<B>

Type Parameters:

B - the binary representation we're manipulating. This API is designed with a mutable implementation in mind (because that is what the core driver is using). If you want to use an immutable type, write a mutable wrapper for it.

public interface PrimitiveCodec<B>

Reads and writes the protocol's primitive types (as defined in section 3 of the protocol specification) to a binary representation B.

Method Summary

Modifier and Type	Method and Description
B	allocate(int size)
B	concat(B left, B right)
void	markReaderIndex(B source)
byte	readByte(B source)
ByteBuffer	readBytes(B source)
default Map<String,ByteBuffer>	readBytesMap(B source)
default InetSocketAddress	readInet(B source)
InetAddress	readInetAddr(B source)
int	readInt(B source)
int	readInt(B source, int offset) Reads an int at the given offset (relative to the current read index).
long	readLong(B source)
String	readLongString(B source)
B	readRetainedSlice(B source, int sliceLength) Returns a view of the next sliceLength bytes.
byte[]	readShortBytes(B source)
String	readString(B source)
default List<String>	readStringList(B source)
default Map<String,String>	readStringMap(B source)
default Map<String,List<String>>	readStringMultimap(B source)
int	readUnsignedShort(B source)
default UUID	readUuid(B source)
void	release(B toRelease) "Releases" an element if the underlying implementation uses reference counting to manage memory allocation.
void	resetReaderIndex(B source)
int	sizeOf(B toMeasure) The number of readable bytes in the given element.
void	updateCrc(B source, CRC32 crc) Feeds all available bytes into the given CRC.
void	writeByte(byte b, B dest)
void	writeBytes(byte[] bytes, B dest)
void	writeBytes(ByteBuffer bytes, B dest)
default void	writeBytesMap(Map<String,ByteBuffer> m, B dest)
default void	writeInet(InetSocketAddress address, B dest)
void	writeInetAddr(InetAddress address, B dest)
void	writeInt(int i, B dest)
void	writeLong(long l, B dest)
void	writeLongString(String s, B dest)
void	writeShortBytes(byte[] bytes, B dest)
void	writeString(String s, B dest)
default void	writeStringList(List<String> l, B dest)
default void	writeStringMap(Map<String,String> m, B dest)
default void	writeStringMultimap(Map<String,List<String>> m, B dest)
void	writeUnsignedShort(int i, B dest)
default void	writeUuid(UUID uuid, B dest)

Method Detail

allocate

B allocate(int size)

release

void release(B toRelease)

"Releases" an element if the underlying implementation uses reference counting to manage memory allocation. Otherwise, this can simply be a no-op.

sizeOf

int sizeOf(B toMeasure)

The number of readable bytes in the given element.

concat

B concat(B left,
         B right)

markReaderIndex

void markReaderIndex(B source)

resetReaderIndex

void resetReaderIndex(B source)

readByte

byte readByte(B source)

readInt

int readInt(B source)

readInt

int readInt(B source,
            int offset)

Reads an int at the given offset (relative to the current read index). This method does not consume any data.

readInetAddr

InetAddress readInetAddr(B source)

readLong

long readLong(B source)

readUnsignedShort

int readUnsignedShort(B source)

readBytes

ByteBuffer readBytes(B source)

readShortBytes

byte[] readShortBytes(B source)

readString

String readString(B source)

readLongString

String readLongString(B source)

readRetainedSlice

B readRetainedSlice(B source,
                    int sliceLength)

Returns a view of the next sliceLength bytes. This consumes the bytes (the next reads must return the data after the slice). If the underlying implementation uses reference counting to manage memory allocation, this must also "retain" the slice, so that it doesn't get recycled if source is released.

updateCrc

void updateCrc(B source,
               CRC32 crc)

Feeds all available bytes into the given CRC. This should not "consume" the bytes.

readUuid

default UUID readUuid(B source)

readStringList

default List<String> readStringList(B source)

readStringMap

default Map<String,String> readStringMap(B source)

readStringMultimap

default Map<String,List<String>> readStringMultimap(B source)

readBytesMap

default Map<String,ByteBuffer> readBytesMap(B source)

readInet

default InetSocketAddress readInet(B source)

writeByte

void writeByte(byte b,
               B dest)

writeInt

void writeInt(int i,
              B dest)

writeInetAddr

void writeInetAddr(InetAddress address,
                   B dest)

writeLong

void writeLong(long l,
               B dest)

writeUnsignedShort

void writeUnsignedShort(int i,
                        B dest)

writeString

void writeString(String s,
                 B dest)

writeLongString

void writeLongString(String s,
                     B dest)

writeUuid

default void writeUuid(UUID uuid,
                       B dest)

writeBytes

void writeBytes(ByteBuffer bytes,
                B dest)

writeBytes

void writeBytes(byte[] bytes,
                B dest)

writeShortBytes

void writeShortBytes(byte[] bytes,
                     B dest)

writeStringList

default void writeStringList(List<String> l,
                             B dest)

writeStringMap

default void writeStringMap(Map<String,String> m,
                            B dest)

writeStringMultimap

default void writeStringMultimap(Map<String,List<String>> m,
                                 B dest)

writeBytesMap

default void writeBytesMap(Map<String,ByteBuffer> m,
                           B dest)

writeInet

default void writeInet(InetSocketAddress address,
                       B dest)