com.singlestore.jdbc.plugin

Interface Codec<T>

Type Parameters:

T - java type supported

All Known Implementing Classes:

BigDecimalCodec, BigIntegerCodec, BitSetCodec, BlobCodec, BooleanCodec, ByteArrayCodec, ByteCodec, ClobCodec, DateCodec, DoubleCodec, DurationCodec, FloatArrayCodec, FloatCodec, FloatObjectArrayCodec, InstantCodec, IntCodec, LineStringCodec, LocalDateCodec, LocalDateTimeCodec, LocalTimeCodec, LongCodec, OffsetDateTimeCodec, PointCodec, PolygonCodec, ReaderCodec, ShortCodec, StreamCodec, StringCodec, TimeCodec, TimestampCodec, UuidCodec, VectorCodec, ZonedDateTimeCodec

public interface Codec<T>

Codec interface, to describe how a certain type of data must be encoded / decoded

Method Summary

Modifier and Type	Method and Description
boolean	canDecode(com.singlestore.jdbc.client.ColumnDecoder column, Class<?> type) If codec can decode this a server datatype to a java class type
boolean	canEncode(Object value) Can Codec encode the java object type
default boolean	canEncodeLongData() Indicate if can encode long data
String	className() Codec native type
T	decodeBinary(com.singlestore.jdbc.client.ReadableByteBuf buffer, MutableInt fieldLength, com.singlestore.jdbc.client.ColumnDecoder column, Calendar cal) Decode from a mysql packet binary encoded a value to codec java type
T	decodeText(com.singlestore.jdbc.client.ReadableByteBuf buffer, MutableInt fieldLength, com.singlestore.jdbc.client.ColumnDecoder column, Calendar cal) Decode from a mysql packet text encoded a value to codec java type
void	encodeBinary(Writer encoder, Object value, Calendar cal, Long length) Binary encode value to writer
default void	encodeBinaryAsString(Writer encoder, Object value, Long length)
default byte[]	encodeData(T value, Long length) binary encoding value to a byte[]
default void	encodeLongData(Writer encoder, T value, Long length) binary encoding value to a long data packet
void	encodeText(Writer encoder, com.singlestore.jdbc.client.Context context, Object value, Calendar cal, Long length) Text encode value to writer
int	getApproximateTextProtocolLength(Object value) Approximate length in bytes.
int	getBinaryEncodeType() Return server encoding data type

Method Detail

className

String className()

Codec native type

Returns:

code native return type

canDecode

boolean canDecode(com.singlestore.jdbc.client.ColumnDecoder column,
                  Class<?> type)

If codec can decode this a server datatype to a java class type

Parameters:

column - server datatype

type - java return class

Returns:

true if codec can decode it

canEncode

boolean canEncode(Object value)

Can Codec encode the java object type

Parameters:

value - java object type

Returns:

true if codec can encode java type

getApproximateTextProtocolLength

int getApproximateTextProtocolLength(Object value)
                              throws SQLException

Approximate length in bytes.

Parameters:

value - to calculate

Returns:

value length in bytes

Throws:

SQLException

decodeText

T decodeText(com.singlestore.jdbc.client.ReadableByteBuf buffer,
             MutableInt fieldLength,
             com.singlestore.jdbc.client.ColumnDecoder column,
             Calendar cal)
      throws SQLDataException

Decode from a mysql packet text encoded a value to codec java type

Parameters:

buffer - mysql packet buffer

fieldLength - encoded value length

column - server column metadata

cal - calendar

Returns:

decoded value

Throws:

SQLDataException - if unexpected error occurs during decoding

decodeBinary

T decodeBinary(com.singlestore.jdbc.client.ReadableByteBuf buffer,
               MutableInt fieldLength,
               com.singlestore.jdbc.client.ColumnDecoder column,
               Calendar cal)
        throws SQLDataException

Decode from a mysql packet binary encoded a value to codec java type

Parameters:

buffer - mysql packet buffer

fieldLength - encoded value length

column - server column metadata

cal - calendar

Returns:

decoded value

Throws:

SQLDataException - if unexpected error occurs during decoding

encodeText

void encodeText(Writer encoder,
                com.singlestore.jdbc.client.Context context,
                Object value,
                Calendar cal,
                Long length)
         throws IOException,
                SQLException

Text encode value to writer

Parameters:

encoder - writer

context - connection context

value - value to encode

cal - calendar

length - maximum value length

Throws:

IOException - if any socket error occurs

SQLException - if encoding error occurs

encodeBinary

void encodeBinary(Writer encoder,
                  Object value,
                  Calendar cal,
                  Long length)
           throws IOException,
                  SQLException

Binary encode value to writer

Parameters:

encoder - writer

value - value to encode

cal - calendar

length - maximum value length

Throws:

IOException - if any socket error occurs

SQLException - if encoding error occurs

canEncodeLongData

default boolean canEncodeLongData()

Indicate if can encode long data

Returns:

true if possible

encodeLongData

default void encodeLongData(Writer encoder,
                            T value,
                            Long length)
                     throws IOException,
                            SQLException

binary encoding value to a long data packet

Parameters:

encoder - writer

value - value to encode

length - maximum length value

Throws:

IOException - if any socket error occurs

SQLException - if encoding error occurs

encodeData

default byte[] encodeData(T value,
                          Long length)
                   throws IOException,
                          SQLException

binary encoding value to a byte[]

Parameters:

value - value to encode

length - maximum length value

Returns:

encoded value

Throws:

IOException - if any socket error occurs

SQLException - if encoding error occurs

getBinaryEncodeType

int getBinaryEncodeType()

Return server encoding data type

Returns:

server encoding data type

encodeBinaryAsString

default void encodeBinaryAsString(Writer encoder,
                                  Object value,
                                  Long length)
                           throws IOException

Throws:

IOException