#include <glib-object.h>
#include <gmodule.h>
#include "fl_value.h"

Macros
#define	FL_MESSAGE_CODEC_ERROR fl_message_codec_error_quark()

Enumerations
enum	FlMessageCodecError { FL_MESSAGE_CODEC_ERROR_FAILED , FL_MESSAGE_CODEC_ERROR_OUT_OF_DATA , FL_MESSAGE_CODEC_ERROR_ADDITIONAL_DATA , FL_MESSAGE_CODEC_ERROR_UNSUPPORTED_TYPE }

Functions
G_MODULE_EXPORT GQuark	fl_message_codec_error_quark (void) G_GNUC_CONST

G_MODULE_EXPORT	G_DECLARE_DERIVABLE_TYPE (FlMessageCodec, fl_message_codec, FL, MESSAGE_CODEC, GObject) struct _FlMessageCodecClass

GBytes *	fl_message_codec_encode_message (FlMessageCodec codec, FlValue message, GError **error)

FlValue *	fl_message_codec_decode_message (FlMessageCodec codec, GBytes message, GError **error)

Macro Definition Documentation

◆ FL_MESSAGE_CODEC_ERROR

#define FL_MESSAGE_CODEC_ERROR fl_message_codec_error_quark()

FlMessageCodecError: @FL_MESSAGE_CODEC_ERROR_FAILED: Codec failed due to an unspecified error. @FL_MESSAGE_CODEC_ERROR_OUT_OF_DATA: Codec ran out of data reading a value. @FL_MESSAGE_CODEC_ERROR_ADDITIONAL_DATA: Additional data encountered in message. @FL_MESSAGE_CODEC_ERROR_UNSUPPORTED_TYPE: Codec encountered an unsupported FlValue.

Errors for #FlMessageCodec objects to set on failures.

Definition at line 30 of file fl_message_codec.h.

Enumeration Type Documentation

◆ FlMessageCodecError

enum FlMessageCodecError

Enumerator
FL_MESSAGE_CODEC_ERROR_FAILED
FL_MESSAGE_CODEC_ERROR_OUT_OF_DATA
FL_MESSAGE_CODEC_ERROR_ADDITIONAL_DATA
FL_MESSAGE_CODEC_ERROR_UNSUPPORTED_TYPE

Definition at line 32 of file fl_message_codec.h.

             {
  // NOLINTBEGIN(readability-identifier-naming)
  FL_MESSAGE_CODEC_ERROR_FAILED,
  FL_MESSAGE_CODEC_ERROR_OUT_OF_DATA,
  FL_MESSAGE_CODEC_ERROR_ADDITIONAL_DATA,
  FL_MESSAGE_CODEC_ERROR_UNSUPPORTED_TYPE,
  // NOLINTEND(readability-identifier-naming)
} FlMessageCodecError;

Function Documentation

◆ fl_message_codec_decode_message()

FlValue * fl_message_codec_decode_message	(	FlMessageCodec *	codec,
		GBytes *	message,
		GError **	error
	)

fl_message_codec_decode_message: @codec: an #FlMessageCodec. @message: binary message to decode. @error: (allow-none): #GError location to store the error occurring, or NULL.

Decodes a message from a binary encoding.

Returns: an FlValue or NULL on error.

Definition at line 33 of file fl_message_codec.cc.

                                                                         {
  g_return_val_if_fail(FL_IS_MESSAGE_CODEC(self), nullptr);
  g_return_val_if_fail(message != nullptr, nullptr);
 
  return FL_MESSAGE_CODEC_GET_CLASS(self)->decode_message(self, message, error);
}

◆ fl_message_codec_encode_message()

GBytes * fl_message_codec_encode_message	(	FlMessageCodec *	codec,
		FlValue *	message,
		GError **	error
	)

fl_message_codec_encode_message: @codec: an #FlMessageCodec. @buffer: buffer to write to. @message: message to encode or NULL to encode the null value. @error: (allow-none): #GError location to store the error occurring, or NULL.

Encodes a message into a binary representation.

Returns: a binary encoded message or NULL on error.

Definition at line 17 of file fl_message_codec.cc.

                                                                        {
  g_return_val_if_fail(FL_IS_MESSAGE_CODEC(self), nullptr);
 
  // If the user provided NULL, then make a temporary FlValue object for this to
  // make it simpler for the subclasses.
  g_autoptr(FlValue) null_value = nullptr;
  if (message == nullptr) {
    null_value = fl_value_new_null();
    message = null_value;
  }
 
  return FL_MESSAGE_CODEC_GET_CLASS(self)->encode_message(self, message, error);
}

◆ fl_message_codec_error_quark()

G_MODULE_EXPORT GQuark fl_message_codec_error_quark ( void )

◆ G_DECLARE_DERIVABLE_TYPE()

G_MODULE_EXPORT G_DECLARE_DERIVABLE_TYPE	(	FlMessageCodec	,
		fl_message_codec	,
		FL	,
		MESSAGE_CODEC	,
		GObject
	)

FlMessageCodec:

#FlMessageCodec is a message encoding/decoding mechanism that operates on FlValue objects. Both operations returns errors if the conversion fails. Such situations should be treated as programming errors.

#FlMessageCodec matches the MethodCodec class in the Flutter services library.

FlMessageCodec::encode_message: @codec: an #FlMessageCodec. @message: message to encode or NULL to encode the null value. @error: (allow-none): #GError location to store the error occurring, or NULL.

Virtual method to encode a message. A subclass must implement this method. If the subclass cannot handle the type of @message then it must generate a FL_MESSAGE_CODEC_ERROR_UNSUPPORTED_TYPE error.

Returns: a binary message or NULL on error.

FlMessageCodec::decode_message: @codec: an #FlMessageCodec. @message: binary message to decode. @error: (allow-none): #GError location to store the error occurring, or NULL.

Virtual method to decode a message. A subclass must implement this method. If @message is too small then a FL_MESSAGE_CODEC_ERROR_OUT_OF_DATA error must be generated. If @message is too large then a FL_MESSAGE_CODEC_ERROR_ADDITIONAL_DATA error must be generated.