DCCL v4
|
A class that goes between FieldCodecBase and TypedFieldCodec to determine if the pre_encode() and post_decode() methods must be implemented or not. The specialization is selected if WireType == FieldType and implements these functions as a pass-through. More...
#include <dccl/field_codec_typed.h>
Public Member Functions | |
virtual WireType | pre_encode (const FieldType &field_value) |
No-op version of pre_encode (since FieldType == WireType) | |
virtual FieldType | post_decode (const WireType &wire_value) |
No-op version of post_encode (since FieldType == WireType) | |
![]() | |
FieldCodecBase () | |
virtual | ~FieldCodecBase ()=default |
void | base_encode (Bitset *bits, const google::protobuf::Message &msg, MessagePart part, bool strict) |
Encode this part (body or head) of the base message. More... | |
void | base_size (unsigned *bit_size, const google::protobuf::Message &msg, MessagePart part) |
Calculate the size (in bits) of a part of the base message when it is encoded. More... | |
void | base_decode (Bitset *bits, google::protobuf::Message *msg, MessagePart part) |
Decode part of a message. More... | |
void | base_max_size (unsigned *bit_size, const google::protobuf::Descriptor *desc, MessagePart part) |
Calculate the maximum size of a message given its Descriptor alone (no data) More... | |
void | base_min_size (unsigned *bit_size, const google::protobuf::Descriptor *desc, MessagePart part) |
Calculate the minimum size of a message given its Descriptor alone (no data) More... | |
void | base_validate (const google::protobuf::Descriptor *desc, MessagePart part) |
Validate this part of the message to make sure all required extensions are set. More... | |
void | base_info (std::ostream *os, const google::protobuf::Descriptor *desc, MessagePart part) |
Get human readable information (size of fields, etc.) about this part of the DCCL message. More... | |
std::string | name () const |
the name of the codec used to identifier it in the .proto custom option extension | |
google::protobuf::FieldDescriptor::Type | field_type () const |
the type exposed to the user in the original and decoded Protobuf messages More... | |
google::protobuf::FieldDescriptor::CppType | wire_type () const |
the C++ type used "on the wire". This is the type visible after pre_encode and before post_decode functions are called. More... | |
const google::protobuf::FieldDescriptor * | this_field () const |
Returns the FieldDescriptor (field schema meta-data) for this field. More... | |
const google::protobuf::Descriptor * | this_descriptor () const |
Returns the Descriptor (message schema meta-data) for the immediate parent Message. More... | |
const google::protobuf::Message * | this_message () |
const google::protobuf::Message * | root_message () |
const google::protobuf::Descriptor * | root_descriptor () const |
internal::MessageStackData & | message_data () |
const internal::MessageStackData & | message_data () const |
bool | has_codec_group () |
std::string | codec_group () |
int | codec_version () |
MessagePart | part () |
the part of the message currently being encoded (head or body) | |
bool | strict () |
void | set_force_use_required (bool force_required=true) |
Force the codec to always use the "required" field encoding, regardless of the FieldDescriptor setting. Useful when wrapping this codec in another that handles optional and repeated fields. | |
void | field_pre_encode (dccl::any *wire_value, const dccl::any &field_value) |
Pre-encodes a non-repeated (i.e. optional or required) field by converting the FieldType representation (the Google Protobuf representation) into the WireType representation (the type used in the encoded DCCL message). This allows for type-converting codecs. More... | |
void | field_pre_encode_repeated (std::vector< dccl::any > *wire_values, const std::vector< dccl::any > &field_values) |
Pre-encodes a repeated field. More... | |
void | field_encode (Bitset *bits, const dccl::any &field_value, const google::protobuf::FieldDescriptor *field) |
Encode a non-repeated field. More... | |
void | field_encode_repeated (Bitset *bits, const std::vector< dccl::any > &field_values, const google::protobuf::FieldDescriptor *field) |
Encode a repeated field. More... | |
void | field_size (unsigned *bit_size, const dccl::any &field_value, const google::protobuf::FieldDescriptor *field) |
Calculate the size of a field. More... | |
void | field_size_repeated (unsigned *bit_size, const std::vector< dccl::any > &field_values, const google::protobuf::FieldDescriptor *field) |
Calculate the size of a repeated field. More... | |
void | field_decode (Bitset *bits, dccl::any *field_value, const google::protobuf::FieldDescriptor *field) |
Decode a non-repeated field. More... | |
void | field_decode_repeated (Bitset *bits, std::vector< dccl::any > *field_values, const google::protobuf::FieldDescriptor *field) |
Decode a repeated field. More... | |
void | field_post_decode (const dccl::any &wire_value, dccl::any *field_value) |
Post-decodes a non-repeated (i.e. optional or required) field by converting the WireType (the type used in the encoded DCCL message) representation into the FieldType representation (the Google Protobuf representation). This allows for type-converting codecs. More... | |
void | field_post_decode_repeated (const std::vector< dccl::any > &wire_values, std::vector< dccl::any > *field_values) |
Post-decodes a repeated field. More... | |
void | field_max_size (unsigned *bit_size, const google::protobuf::FieldDescriptor *field) |
Calculate the upper bound on this field's size (in bits) More... | |
void | field_min_size (unsigned *bit_size, const google::protobuf::FieldDescriptor *field) |
Calculate the lower bound on this field's size (in bits) More... | |
void | field_validate (bool *b, const google::protobuf::FieldDescriptor *field) |
Validate this field, checking that all required option extensions are set (e.g. (dccl.field).max and (dccl.field).min for arithmetic codecs) More... | |
void | field_info (std::ostream *os, const google::protobuf::FieldDescriptor *field) |
Write human readable information about the field and its bounds to the provided stream. More... | |
dccl::DCCLFieldOptions | dccl_field_options () const |
Get the DCCL field option extension value for the current field. More... | |
void | require (bool b, const std::string &description) |
Essentially an assertion to be used in the validate() virtual method. More... | |
DynamicConditions & | dynamic_conditions (const google::protobuf::FieldDescriptor *field) |
FieldCodecManagerLocal & | manager () |
const FieldCodecManagerLocal & | manager () const |
virtual void | set_manager (FieldCodecManagerLocal *manager) |
Additional Inherited Members | |
![]() | |
static std::string | codec_group (const google::protobuf::Descriptor *desc) |
![]() | |
bool | use_required () |
Whether to use the required or optional encoding. | |
virtual void | any_encode (Bitset *bits, const dccl::any &wire_value)=0 |
Virtual method used to encode. More... | |
virtual void | any_decode (Bitset *bits, dccl::any *wire_value)=0 |
Virtual method used to decode. More... | |
virtual void | any_pre_encode (dccl::any *wire_value, const dccl::any &field_value) |
Virtual method used to pre-encode (convert from FieldType to WireType). The default implementation of this method is for when WireType == FieldType and simply copies the field_value to the wire_value. More... | |
virtual void | any_post_decode (const dccl::any &wire_value, dccl::any *field_value) |
Virtual method used to post-decode (convert from WireType to FieldType). The default implementation of this method is for when WireType == FieldType and simply copies the wire_value to the field_value. More... | |
virtual unsigned | any_size (const dccl::any &wire_value)=0 |
Virtual method for calculating the size of a field (in bits). More... | |
virtual void | validate () |
Validate a field. Use require() inside your overloaded validate() to assert requirements or throw Exceptions directly as needed. | |
virtual std::string | info () |
Write field specific information (in addition to general information such as sizes that are automatically written by this class for all fields. More... | |
virtual unsigned | max_size ()=0 |
Calculate maximum size of the field in bits. More... | |
virtual unsigned | min_size ()=0 |
Calculate minimum size of the field in bits. More... | |
virtual void | any_encode_repeated (Bitset *bits, const std::vector< dccl::any > &wire_values) |
virtual void | any_decode_repeated (Bitset *repeated_bits, std::vector< dccl::any > *field_values) |
virtual void | any_pre_encode_repeated (std::vector< dccl::any > *wire_values, const std::vector< dccl::any > &field_values) |
virtual void | any_post_decode_repeated (const std::vector< dccl::any > &wire_values, std::vector< dccl::any > *field_values) |
virtual unsigned | any_size_repeated (const std::vector< dccl::any > &wire_values) |
virtual unsigned | max_size_repeated () |
virtual unsigned | min_size_repeated () |
void | check_repeat_settings () const |
A class that goes between FieldCodecBase and TypedFieldCodec to determine if the pre_encode() and post_decode() methods must be implemented or not. The specialization is selected if WireType == FieldType and implements these functions as a pass-through.
Definition at line 56 of file field_codec_typed.h.