io.micronaut.serde

Interface Serializer<T>

Type Parameters:

T - The type to be serialized

All Known Subinterfaces:

NullableSerde<T>, NumberSerde<N>, Serde<T>, TemporalSerde<T>

All Known Implementing Classes:

AbstractBsonSerde, BsonRepresentationSerde, CodecBsonDecoder, DefaultFormattedTemporalSerde, HealthStatusSerde, InstantSerde, LocalDateSerde, LocalDateTimeSerde, LocalTimeSerde, ObjectArraySerde, ObjectSerializer, OffsetDateTimeSerde, YearSerde, ZonedDateTimeSerde

@Indexed(value=Serializer.class)
public interface Serializer<T>

Models a build time serializer. That is a class computed at build-time that can be used to serialize an instance of T.

Author:

Jonas Konrad, graemerocher

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Serializer.EncoderContext Context object passes to the serialize(Encoder, io.micronaut.serde.Serializer.EncoderContext, Object, io.micronaut.core.type.Argument) method.

Method Summary

Modifier and Type	Method and Description
default Serializer<T>	createSpecific(io.micronaut.core.type.Argument<? extends T> type, Serializer.EncoderContext encoderContext) Create a more specific serializer for the given definition.
default boolean	isAbsent(T value) Used for JsonInclude.Include#NON_ABSENT checking.
default boolean	isEmpty(T value) Used for JsonInclude.Include#NON_EMPTY checking.
void	serialize(Encoder encoder, Serializer.EncoderContext context, T value, io.micronaut.core.type.Argument<? extends T> type) Serializes the given value using the passed Encoder.

Method Detail

createSpecific

@NonNull
default Serializer<T> createSpecific(@NonNull
                                              io.micronaut.core.type.Argument<? extends T> type,
                                              @NonNull
                                              Serializer.EncoderContext encoderContext)
                                       throws SerdeException

Create a more specific serializer for the given definition.

Parameters:

encoderContext - The encoder context

type - The type definition including any annotation metadata

Returns:

The more specific serializer

Throws:

SerdeException

serialize

void serialize(@NonNull
               Encoder encoder,
               @NonNull
               Serializer.EncoderContext context,
               @NonNull
               T value,
               @NonNull
               io.micronaut.core.type.Argument<? extends T> type)
        throws java.io.IOException

Serializes the given value using the passed Encoder.

Parameters:

encoder - The encoder to use

context - The encoder context, never null

value - The value, can be null

type - Models the generic type of the value

Throws:

java.io.IOException - If an error occurs during serialization

isEmpty

default boolean isEmpty(@Nullable
                        T value)

Used for JsonInclude.Include#NON_EMPTY checking.

Parameters:

value - The check to check

Returns:

Return true if the value is empty

isAbsent

default boolean isAbsent(T value)

Used for JsonInclude.Include#NON_ABSENT checking.

Parameters:

value - The value to check

Returns:

Return true if the value is absent