Reflection for RapidJSON  0.0.15
Reflection for serializing/deserializing with RapidJSON
Namespaces | Typedefs | Functions
ReflectiveRapidJSON::JsonReflector Namespace Reference

The JsonReflector namespace contains helper functions to ease the use of RapidJSON for automatic (de)serialization. More...

Namespaces

 Detail
 

Typedefs

template<typename Type >
using IsBuiltInType = Traits::Any< std::is_integral< Type >, std::is_floating_point< Type >, std::is_pointer< Type >, std::is_enum< Type >, Traits::IsSpecializationOf< Type, std::tuple >, Traits::IsSpecializationOf< Type, std::pair >, Traits::IsIteratable< Type >, Traits::IsSpecializationOf< Type, std::unique_ptr >, Traits::IsSpecializationOf< Type, std::shared_ptr >, Traits::IsSpecializationOf< Type, std::weak_ptr >, IsVariant< Type > >
 
template<typename Type >
using IsCustomType = Traits::Not< IsBuiltInType< Type > >
 
template<typename Type >
using IsJsonSerializable = Traits::Any< Traits::Not< Traits::IsComplete< Type > >, std::is_base_of< JsonSerializable< Type >, Type >, AdaptedJsonSerializable< Type > >
 

Functions

constexpr RAPIDJSON_NAMESPACE::SizeType rapidJsonSize (std::size_t size)
 Casts the specified size to the size type used by RapidJSON ensuring no overflow happens. More...
 
RAPIDJSON_NAMESPACE::StringBuffer serializeJsonDocToString (RAPIDJSON_NAMESPACE::Document &document)
 Serializes the specified JSON document. More...
 
RAPIDJSON_NAMESPACE::Document parseJsonDocFromString (const char *json, std::size_t jsonSize)
 Parses the specified JSON string. More...
 
template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void push (const Type &reflectable, RAPIDJSON_NAMESPACE::Value &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 Pushes the specified reflectable to the specified value. More...
 
template<typename Type , Traits::DisableIf< IsJsonSerializable< Type >> * = nullptr>
void push (const Type &reflectable, RAPIDJSON_NAMESPACE::Value::Array &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 Pushes the reflectable to the specified array. More...
 
template<typename Type , Traits::EnableIf< IsJsonSerializable< Type >> * = nullptr>
void push (const Type &reflectable, const char *name, RAPIDJSON_NAMESPACE::Value::Object &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 Pushes the specified reflectable which has custom type as a member to the specified object. More...
 
template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void push (const Type &reflectable, RAPIDJSON_NAMESPACE::Value::Object &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 Pushes the reflectable which has a custom type to the specified object. More...
 
template<typename Type , Traits::EnableIfAny< std::is_integral< Type >, std::is_floating_point< Type >> * = nullptr>
void push (Type reflectable, RAPIDJSON_NAMESPACE::Value &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 Pushes the specified integer/float/boolean to the specified value. More...
 
template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void pull (Type &reflectable, const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ConstObject &value, JsonDeserializationErrors *errors)
 Pulls the reflectable which has a custom type from the specified object. More...
 
template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void pull (Type &reflectable, const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &value, JsonDeserializationErrors *errors)
 Pulls the reflectable which has a custom type from the specified value which is supposed and checked to contain an object. More...
 
template<typename Type , Traits::EnableIf< IsArrayOrSet< Type >, Traits::Not< Traits::IsReservable< Type >>> * = nullptr>
void pull (Type &reflectable, const rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &value, JsonDeserializationErrors *errors)
 Pulls the specified reflectable which is an iteratable without reserve() method from the specified value which is checked to contain an array. More...
 
template<typename Type , Traits::EnableIf< IsArray< Type >> * = nullptr>
void pull (Type &reflectable, rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ConstArray array, JsonDeserializationErrors *errors)
 Pulls the specified reflectable which is an array/vector/list from the specified array. More...
 
template<typename Type >
void pull (Type &reflectable, rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ValueIterator &value, JsonDeserializationErrors *errors)
 Pulls the specified reflectable from the specified value iterator which is checked to contain the right type. More...
 
template<typename Type >
void pull (Type &reflectable, const char *name, const rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ConstObject &value, JsonDeserializationErrors *errors)
 Pulls the specified member of reflectable which has a custom type from the specified object. More...
 
template<typename Type , Traits::EnableIfAny< IsJsonSerializable< Type >, IsMapOrHash< Type >, IsMultiMapOrHash< Type >> * = nullptr>
RAPIDJSON_NAMESPACE::Document toJsonDocument (const Type &reflectable)
 Serializes the specified reflectable which has a custom type or can be mapped to and object. More...
 
template<typename Type , Traits::EnableIfAny< std::is_integral< Type >, std::is_floating_point< Type >> * = nullptr>
RAPIDJSON_NAMESPACE::Document toJsonDocument (Type reflectable)
 Serializes the specified reflectable which is an integer, float or boolean. More...
 
template<typename Type , Traits::EnableIf< std::is_same< Type, std::string >> * = nullptr>
RAPIDJSON_NAMESPACE::Document toJsonDocument (const std::string &reflectable)
 Serializes the specified reflectable which is an std::string. More...
 
template<typename Type , Traits::EnableIf< std::is_same< Type, const char * >> * = nullptr>
RAPIDJSON_NAMESPACE::Document toJsonDocument (const char *reflectable)
 Serializes the specified reflectable which is a C-string. More...
 
template<typename Type , Traits::EnableIf< std::is_same< Type, std::string_view >> * = nullptr>
RAPIDJSON_NAMESPACE::Document toJsonDocument (std::string_view reflectable)
 Serializes the specified reflectable which is a C-string. More...
 
template<typename Type , Traits::EnableIfAny< IsJsonSerializable< Type >, IsMapOrHash< Type >, IsMultiMapOrHash< Type >, std::is_integral< Type >, std::is_floating_point< Type >, Traits::IsString< Type >, IsArray< Type >> * = nullptr>
RAPIDJSON_NAMESPACE::StringBuffer toJson (const Type &reflectable)
 Serializes the specified reflectable. More...
 
template<typename Type , Traits::EnableIfAny< IsJsonSerializable< Type >, IsMapOrHash< Type >, IsMultiMapOrHash< Type >> * = nullptr>
Type fromJson (const char *json, std::size_t jsonSize, JsonDeserializationErrors *errors=nullptr)
 Deserializes the specified JSON to. More...
 
template<typename Type >
Type fromJson (const char *json, JsonDeserializationErrors *errors=nullptr)
 Deserializes the specified JSON from an null-terminated C-string to. More...
 
template<typename Type >
Type fromJson (const std::string &json, JsonDeserializationErrors *errors=nullptr)
 Deserializes the specified JSON from an std::string to. More...
 
template<>
void push< CppUtilities::DateTime > (const CppUtilities::DateTime &reflectable, RAPIDJSON_NAMESPACE::Value &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 
template<>
void push< CppUtilities::TimeSpan > (const CppUtilities::TimeSpan &reflectable, RAPIDJSON_NAMESPACE::Value &value, RAPIDJSON_NAMESPACE::Document::AllocatorType &allocator)
 
template<>
void pull< CppUtilities::DateTime > (CppUtilities::DateTime &reflectable, const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &value, JsonDeserializationErrors *errors)
 
template<>
void pull< CppUtilities::TimeSpan > (CppUtilities::TimeSpan &reflectable, const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &value, JsonDeserializationErrors *errors)
 

Detailed Description

The JsonReflector namespace contains helper functions to ease the use of RapidJSON for automatic (de)serialization.

Typedef Documentation

◆ IsBuiltInType

template<typename Type >
using ReflectiveRapidJSON::JsonReflector::IsBuiltInType = typedef Traits::Any<std::is_integral<Type>, std::is_floating_point<Type>, std::is_pointer<Type>, std::is_enum<Type>, Traits::IsSpecializationOf<Type, std::tuple>, Traits::IsSpecializationOf<Type, std::pair>, Traits::IsIteratable<Type>, Traits::IsSpecializationOf<Type, std::unique_ptr>, Traits::IsSpecializationOf<Type, std::shared_ptr>, Traits::IsSpecializationOf<Type, std::weak_ptr>, IsVariant<Type> >

Definition at line 83 of file reflector.h.

◆ IsCustomType

template<typename Type >
using ReflectiveRapidJSON::JsonReflector::IsCustomType = typedef Traits::Not<IsBuiltInType<Type> >

Definition at line 87 of file reflector.h.

◆ IsJsonSerializable

template<typename Type >
using ReflectiveRapidJSON::JsonReflector::IsJsonSerializable = typedef Traits::Any<Traits::Not<Traits::IsComplete<Type> >, std::is_base_of<JsonSerializable<Type>, Type>, AdaptedJsonSerializable<Type> >

Definition at line 92 of file reflector.h.

Function Documentation

◆ fromJson() [1/3]

template<typename Type >
Type ReflectiveRapidJSON::JsonReflector::fromJson ( const char *  json,
JsonDeserializationErrors errors = nullptr 
)

Deserializes the specified JSON from an null-terminated C-string to.

Template Parameters
Type.

Definition at line 1130 of file reflector.h.

◆ fromJson() [2/3]

template<typename Type , Traits::EnableIfAny< IsJsonSerializable< Type >, IsMapOrHash< Type >, IsMultiMapOrHash< Type >> * = nullptr>
Type ReflectiveRapidJSON::JsonReflector::fromJson ( const char *  json,
std::size_t  jsonSize,
JsonDeserializationErrors errors = nullptr 
)

Deserializes the specified JSON to.

Template Parameters
Typewhich is a custom type or can be mapped to an object.
Typewhich is an integer, float or boolean.
Typewhich is a std::string.
Typewhich can be mapped to an array.

Definition at line 1059 of file reflector.h.

◆ fromJson() [3/3]

template<typename Type >
Type ReflectiveRapidJSON::JsonReflector::fromJson ( const std::string &  json,
JsonDeserializationErrors errors = nullptr 
)

Deserializes the specified JSON from an std::string to.

Template Parameters
Type.

Definition at line 1138 of file reflector.h.

◆ parseJsonDocFromString()

RAPIDJSON_NAMESPACE::Document ReflectiveRapidJSON::JsonReflector::parseJsonDocFromString ( const char *  json,
std::size_t  jsonSize 
)
inline

Parses the specified JSON string.

Definition at line 71 of file reflector.h.

◆ pull() [1/6]

template<typename Type >
void ReflectiveRapidJSON::JsonReflector::pull ( Type &  reflectable,
const char *  name,
const rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ConstObject &  value,
JsonDeserializationErrors errors 
)
inline

Pulls the specified member of reflectable which has a custom type from the specified object.

Remarks
It is checked whether the object actually contains the member. If not, the missing member is ignored. So currently all members are optional.

Definition at line 934 of file reflector.h.

◆ pull() [2/6]

template<typename Type , Traits::EnableIf< IsArrayOrSet< Type >, Traits::Not< Traits::IsReservable< Type >>> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::pull ( Type &  reflectable,
const rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &  value,
JsonDeserializationErrors errors 
)

Pulls the specified reflectable which is an iteratable without reserve() method from the specified value which is checked to contain an array.

Pulls the specified reflectable which is a variant from the specified value which might be null.

Pulls the specified reflectable which is a shared_ptr from the specified value which might be null.

Pulls the specified reflectable which is a unique_ptr from the specified value which might be null.

Pulls the specified reflectable which is a pair from the specified value which is checked to contain an array.

Pulls the specified reflectable which is a tuple from the specified value which is checked to contain an array.

Pulls the specified reflectable which is a multimap from the specified value which is checked to contain an object.

Pulls the specified reflectable which is a map from the specified value which is checked to contain an object.

Pulls the specified reflectable which is an iteratable with reserve() method from the specified value which is checked to contain an array.

Definition at line 597 of file reflector.h.

◆ pull() [3/6]

template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::pull ( Type &  reflectable,
const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &  value,
JsonDeserializationErrors errors 
)
inline

Pulls the reflectable which has a custom type from the specified value which is supposed and checked to contain an object.

Checks whether the specified value contains a string.

Pulls the std::string from the specified value which is supposed and checked to contain a string.

Pulls the specified enumeration item from the specified value which is supposed and checked to be compatible with the underlying type.

Pulls the boolean from the specified value which is supposed and checked to contain the right type.

Pulls the integer or float from the specified value which is supposed and checked to contain the right type.

Remarks
It is not checked, whether value is actually a valid enum item.
Does not actually store the value since the ownership would not be clear (see README.md).

Definition at line 515 of file reflector.h.

◆ pull() [4/6]

template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::pull ( Type &  reflectable,
const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ConstObject &  value,
JsonDeserializationErrors errors 
)

Pulls the reflectable which has a custom type from the specified object.

Remarks
The definition of this function must be provided by the code generator or Boost.Hana.

Definition at line 40 of file reflector-boosthana.h.

◆ pull() [5/6]

template<typename Type , Traits::EnableIf< IsArray< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::pull ( Type &  reflectable,
rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ConstArray  array,
JsonDeserializationErrors errors 
)

Pulls the specified reflectable which is an array/vector/list from the specified array.

Pulls the specified reflectable which is a multiset from the specified array.

Pulls the specified reflectable which is a set from the specified array.

The reflectable is cleared before.

Definition at line 629 of file reflector.h.

◆ pull() [6/6]

template<typename Type >
void ReflectiveRapidJSON::JsonReflector::pull ( Type &  reflectable,
rapidjson::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >>::ValueIterator &  value,
JsonDeserializationErrors errors 
)
inline

Pulls the specified reflectable from the specified value iterator which is checked to contain the right type.

Definition at line 922 of file reflector.h.

◆ pull< CppUtilities::DateTime >()

template<>
void ReflectiveRapidJSON::JsonReflector::pull< CppUtilities::DateTime > ( CppUtilities::DateTime &  reflectable,
const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &  value,
JsonDeserializationErrors errors 
)
inline

Definition at line 41 of file reflector-chronoutilities.h.

◆ pull< CppUtilities::TimeSpan >()

template<>
void ReflectiveRapidJSON::JsonReflector::pull< CppUtilities::TimeSpan > ( CppUtilities::TimeSpan &  reflectable,
const RAPIDJSON_NAMESPACE::GenericValue< RAPIDJSON_NAMESPACE::UTF8< char >> &  value,
JsonDeserializationErrors errors 
)
inline

Definition at line 56 of file reflector-chronoutilities.h.

◆ push() [1/5]

template<typename Type , Traits::EnableIf< IsJsonSerializable< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::push ( const Type &  reflectable,
const char *  name,
RAPIDJSON_NAMESPACE::Value::Object &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)

Pushes the specified reflectable which has custom type as a member to the specified object.

Pushes the specified reflectable as a member to the specified object.

Definition at line 379 of file reflector.h.

◆ push() [2/5]

template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::push ( const Type &  reflectable,
RAPIDJSON_NAMESPACE::Value &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)
inline

Pushes the specified reflectable to the specified value.

Pushes the specified variant to the specified value.

Pushes the specified unique_ptr, shared_ptr or weak_ptr to the specified value.

Pushes the specified pair to the specified value.

Pushes the specified tuple to the specified value.

Pushes the specified multimap (std::multimap, std::unordered_multimap) to the specified value.

Pushes the specified map (std::map, std::unordered_map) to the specified value.

Pushes the specified iteratable list (eg.

Pushes the specified iteratable (eg.

Pushes the specified std::string to the specified value.

Pushes the specified reflectable which has a custom type to the specified value.

std::vector, std::list) to the specified value.

Definition at line 140 of file reflector.h.

◆ push() [3/5]

template<typename Type , Traits::DisableIf< IsJsonSerializable< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::push ( const Type &  reflectable,
RAPIDJSON_NAMESPACE::Value::Array &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)

Pushes the reflectable to the specified array.

Pushes the specified reflectable to the specified array.

Pushes the specified reflectable which has a custom type to the specified array.

Pushes the reflectable which has a custom type to the specified array.

Definition at line 356 of file reflector.h.

◆ push() [4/5]

template<typename Type , Traits::DisableIf< IsBuiltInType< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::push ( const Type &  reflectable,
RAPIDJSON_NAMESPACE::Value::Object &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)

Pushes the reflectable which has a custom type to the specified object.

Remarks
The definition of this function must be provided by the code generator or Boost.Hana.

Definition at line 30 of file reflector-boosthana.h.

◆ push() [5/5]

template<typename Type , Traits::EnableIfAny< std::is_integral< Type >, std::is_floating_point< Type >> * = nullptr>
void ReflectiveRapidJSON::JsonReflector::push ( Type  reflectable,
RAPIDJSON_NAMESPACE::Value &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)
inline

Pushes the specified integer/float/boolean to the specified value.

Pushes the specified C-string to the specified value.

Pushes the specified enumeration item to the specified value.

Definition at line 151 of file reflector.h.

◆ push< CppUtilities::DateTime >()

template<>
void ReflectiveRapidJSON::JsonReflector::push< CppUtilities::DateTime > ( const CppUtilities::DateTime &  reflectable,
RAPIDJSON_NAMESPACE::Value &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)
inline

Definition at line 23 of file reflector-chronoutilities.h.

◆ push< CppUtilities::TimeSpan >()

template<>
void ReflectiveRapidJSON::JsonReflector::push< CppUtilities::TimeSpan > ( const CppUtilities::TimeSpan &  reflectable,
RAPIDJSON_NAMESPACE::Value &  value,
RAPIDJSON_NAMESPACE::Document::AllocatorType &  allocator 
)
inline

Definition at line 31 of file reflector-chronoutilities.h.

◆ rapidJsonSize()

constexpr RAPIDJSON_NAMESPACE::SizeType ReflectiveRapidJSON::JsonReflector::rapidJsonSize ( std::size_t  size)
constexpr

Casts the specified size to the size type used by RapidJSON ensuring no overflow happens.

Definition at line 51 of file reflector.h.

◆ serializeJsonDocToString()

RAPIDJSON_NAMESPACE::StringBuffer ReflectiveRapidJSON::JsonReflector::serializeJsonDocToString ( RAPIDJSON_NAMESPACE::Document &  document)
inline

Serializes the specified JSON document.

Definition at line 60 of file reflector.h.

◆ toJson()

template<typename Type , Traits::EnableIfAny< IsJsonSerializable< Type >, IsMapOrHash< Type >, IsMultiMapOrHash< Type >, std::is_integral< Type >, std::is_floating_point< Type >, Traits::IsString< Type >, IsArray< Type >> * = nullptr>
RAPIDJSON_NAMESPACE::StringBuffer ReflectiveRapidJSON::JsonReflector::toJson ( const Type &  reflectable)

Serializes the specified reflectable.

Definition at line 1047 of file reflector.h.

◆ toJsonDocument() [1/5]

template<typename Type , Traits::EnableIf< std::is_same< Type, const char * >> * = nullptr>
RAPIDJSON_NAMESPACE::Document ReflectiveRapidJSON::JsonReflector::toJsonDocument ( const char *  reflectable)

Serializes the specified reflectable which is a C-string.

Definition at line 1013 of file reflector.h.

◆ toJsonDocument() [2/5]

template<typename Type , Traits::EnableIf< std::is_same< Type, std::string >> * = nullptr>
RAPIDJSON_NAMESPACE::Document ReflectiveRapidJSON::JsonReflector::toJsonDocument ( const std::string &  reflectable)

Serializes the specified reflectable which is an std::string.

Definition at line 1002 of file reflector.h.

◆ toJsonDocument() [3/5]

template<typename Type , Traits::EnableIfAny< IsJsonSerializable< Type >, IsMapOrHash< Type >, IsMultiMapOrHash< Type >> * = nullptr>
RAPIDJSON_NAMESPACE::Document ReflectiveRapidJSON::JsonReflector::toJsonDocument ( const Type &  reflectable)

Serializes the specified reflectable which has a custom type or can be mapped to and object.

Serializes the specified reflectable which can be mapped to an array.

Definition at line 980 of file reflector.h.

◆ toJsonDocument() [4/5]

template<typename Type , Traits::EnableIf< std::is_same< Type, std::string_view >> * = nullptr>
RAPIDJSON_NAMESPACE::Document ReflectiveRapidJSON::JsonReflector::toJsonDocument ( std::string_view  reflectable)

Serializes the specified reflectable which is a C-string.

Definition at line 1024 of file reflector.h.

◆ toJsonDocument() [5/5]

template<typename Type , Traits::EnableIfAny< std::is_integral< Type >, std::is_floating_point< Type >> * = nullptr>
RAPIDJSON_NAMESPACE::Document ReflectiveRapidJSON::JsonReflector::toJsonDocument ( Type  reflectable)

Serializes the specified reflectable which is an integer, float or boolean.

Definition at line 991 of file reflector.h.