fpmas::io::json::light_serializer< fpmas::api::utils::PtrWrapper< AgentType >, typename std::enable_if< std::is_base_of< fpmas::api::model::Agent, AgentType >::value &&!std::is_default_constructible< AgentType >::value &&std::is_same< AgentType, typename AgentType::FinalAgentType >::value >::type > Struct Template Reference

#include <json_serializer.h>

Static Public Member Functions
static void	to_json (light_json &j, const fpmas::api::utils::PtrWrapper< AgentType > &agent)
static fpmas::api::utils::PtrWrapper< AgentType >	from_json (const light_json &j)

Detailed Description

template<typename AgentType>
struct fpmas::io::json::light_serializer< fpmas::api::utils::PtrWrapper< AgentType >, typename std::enable_if< std::is_base_of< fpmas::api::model::Agent, AgentType >::value &&!std::is_default_constructible< AgentType >::value &&std::is_same< AgentType, typename AgentType::FinalAgentType >::value >::type >

A default light_serializer specialization for Agent types, when no default constructor is available. In this case, to_json() and from_json() methods falls back to the classic nlohmann::json serialization rules, what might be inefficient. A warning is also printed at runtime.

To avoid this inefficient behaviors, two things can be performed:

• Defining a default constructor for AgentType. Notice that the default constructed AgentType will never be used by FPMAS (since AgentType transmitted in a light_json are completely passive, a complete DistributedNode transfer is always performed when the Agent data is required).
• Specializing the light_serializer with AgentType:

  namespace fpmas { namespace io { namespace json {
    template<>
        struct light_serializer<fpmas::api::utils::PtrWrapper<CustomAgentType>> {
            static void to_json(light_json& j, const fpmas::api::utils::PtrWrapper<CustomAgentType>& ptr) {
                // light_json serialization rules
                ...
            }
   
            static fpmas::api::utils::PtrWrapper<CustomAgentType> from_json(light_json& j) {
                // light_json unserialization rules
                ...
   
                return new CustomAgentType(...);
            }
        };
  }}}

Template Parameters

AgentType

concrete type of Agent to serialize

Member Function Documentation

to_json()

template<typename AgentType >

static void fpmas::io::json::light_serializer< fpmas::api::utils::PtrWrapper< AgentType >, typename std::enable_if< std::is_base_of< fpmas::api::model::Agent, AgentType >::value &&!std::is_default_constructible< AgentType >::value &&std::is_same< AgentType, typename AgentType::FinalAgentType >::value >::type >::to_json ( light_json &  j, const fpmas::api::utils::PtrWrapper< AgentType > &  agent  )

inlinestatic

Calls nlohmann::adl_serializer<fpmas::api::utils::PtrWrapper<AgentType>>::to_json().

Parameters

j	json output
agent	agent to serialize

from_json()

template<typename AgentType >

static fpmas::api::utils::PtrWrapper< AgentType > fpmas::io::json::light_serializer< fpmas::api::utils::PtrWrapper< AgentType >, typename std::enable_if< std::is_base_of< fpmas::api::model::Agent, AgentType >::value &&!std::is_default_constructible< AgentType >::value &&std::is_same< AgentType, typename AgentType::FinalAgentType >::value >::type >::from_json ( const light_json &  j )

inlinestatic

Calls nlohmann::adl_serializer<fpmas::api::utils::PtrWrapper<AgentType>>::from_json().

Parameters

j	json input

Returns

dynamically allocated AgentType

---

The documentation for this struct was generated from the following file:

• src/fpmas/model/json_serializer.h