io.r2dbc.postgresql.codec

Interface Codec<T>

Type Parameters:

T - the type that is handled by this codec.

All Known Implementing Classes:

BigIntegerCodec, EnumCodec

public interface Codec<T>

Codec to encode and decode values based on Postgres OIDs and Format.

Codecs can decode one or more server-specific data types and represent them as a specific Java type. The type parameter of Codec indicates the interchange type that is handled by this codec.

See Also:

PostgresqlObjectId

Method Summary

Modifier and Type	Method and Description
boolean	canDecode(int dataType, io.r2dbc.postgresql.message.Format format, Class<?> type) Determine whether this Codec is capable of decoding a value for the given dataType and Format and whether it can represent the decoded value as the desired type.
boolean	canEncode(Object value) Determine whether this Codec is capable of encoding the value.
boolean	canEncodeNull(Class<?> type) Determine whether this Codec is capable of encoding a null value for the given Class type.
T	decode(io.netty.buffer.ByteBuf buffer, int dataType, io.r2dbc.postgresql.message.Format format, Class<? extends T> type) Decode the buffer and return it as the requested type.
io.r2dbc.postgresql.client.Parameter	encode(Object value) Encode the value to be used as RPC parameter.
io.r2dbc.postgresql.client.Parameter	encodeNull() Encode a null value.
Class<?>	type() Returns the Java type of this codec.

Method Detail

canDecode

boolean canDecode(int dataType,
                  io.r2dbc.postgresql.message.Format format,
                  Class<?> type)

Determine whether this Codec is capable of decoding a value for the given dataType and Format and whether it can represent the decoded value as the desired type.

Parameters:

dataType - the dataType to decode

format - the data type Format, text or binary

type - the desired value type

Returns:

true if this codec is able to decode values for tge given dataType and Format

canEncode

boolean canEncode(Object value)

Determine whether this Codec is capable of encoding the value.

Parameters:

value - the parameter value

Returns:

true if this Codec is able to encode the value.

See Also:

encodeNull()

canEncodeNull

boolean canEncodeNull(Class<?> type)

Determine whether this Codec is capable of encoding a null value for the given Class type.

Parameters:

type - the desired value type

Returns:

true if this Codec is able to encode null values for the given Class type.

See Also:

encodeNull()

decode

@Nullable
T decode(@Nullable
                   io.netty.buffer.ByteBuf buffer,
                   int dataType,
                   io.r2dbc.postgresql.message.Format format,
                   Class<? extends T> type)

Decode the buffer and return it as the requested type.

Parameters:

buffer - the data buffer

dataType - the dataType to decode

format - the data type Format, text or binary

type - the desired value type

Returns:

the decoded value. Can be null if the value is null.

encode

io.r2dbc.postgresql.client.Parameter encode(Object value)

Encode the value to be used as RPC parameter.

Parameters:

value - the null value

Returns:

the encoded value

encodeNull

io.r2dbc.postgresql.client.Parameter encodeNull()

Encode a null value.

Returns:

the encoded null value

type

Class<?> type()

Returns the Java type of this codec.

Returns:

the Java type