#include <serialization/BinarySerializer.h>

Inheritance diagram for BinarySerializer< Derived >:

[legend]

Public Types
typedef BinarySerializerTag	Tag

typedef serialization::VersionType	VersionType

typedef serialization::AcceptDesiredVersion	AcceptDesiredVersion

typedef boost::mpl::bool_< true >	isReadOnly

typedef boost::mpl::bool_< true >	isObjectTrackingSupported

typedef Base::ClassVersionMap	ClassVersionMap

typedef boost::mpl::bool_< true >	useHumanReadableIDs
	Specifies, if the Reflector supports human readable IDs. More...

typedef boost::mpl::bool_< false >	requireReflectBarriers
	Specifies whether the Reflector uses so-called 'reflect barriers' to allow maintaining separate states for individual blocks of reflected data. More...

Public Member Functions
template<typename T >
VersionType	version (VersionType version, const T *caller=NULL)

	MIRA_DEPRECATED ("Please call as version<MyType>(v) or version(v, this)", VersionType version(VersionType version))

template<typename T >
VersionType	version (VersionType version, AcceptDesiredVersion, const T *caller=NULL)

template<typename T >
void	write (const T *data, std::size_t count)

template<typename T >
bool	hasCodec () const
	Returns true, of there is a codec for the specified type T. More...

template<typename T >
bool	codec (const T &obj)
	Encodes the specified object containing the data using a matching codec. More...

void	desireClassVersions (const ClassVersionMap &versions)
	implements ReflectorInterface (for documentation see ReflectorInterface) More...

template<typename T >
void	serialize (const std::string &name, const T &value, const std::string &comment="")
	Serializes the specified object value under the given name. More...

template<typename T >
void	trackObject (T &member)

template<typename T >
void	pointer (T *&pointer)

template<typename T >
void	pointerNormal (T *&pointer, int typeId)

template<typename T >
void	pointerPolymorphic (T *&pointer, int typeId)

template<typename T >
void	pointerAbstract (T *&pointer, int typeId)

void	pushObjectTrackingStore ()

void	popObjectTrackingStore ()

template<typename T >
void	member (const char name, T &member, const char comment, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	member (const char name, const std::string &id, T &member, const char comment, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	member (const char name, const T &member, Setter< T > setter, const char comment, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	member (const char name, Getter< T > getter, Setter< T > setter, const char comment, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	member (const char name, T &member, const char comment, const T &defaultValue, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T , typename U >
void	member (const char name, T &member, const char comment, const U &defaultValue, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	member (const char name, const T &member, Setter< T > setter, const char comment, const T &defaultValue, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T , typename U >
void	member (const char name, const T &member, Setter< T > setter, const char comment, const U &defaultValue, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	member (const char name, Getter< T > getter, Setter< T > setter, const char comment, const T &defaultValue, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T , typename U >
void	member (const char name, Getter< T > getter, Setter< T > setter, const char comment, const U &defaultValue, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, T &member, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, const std::string &id, T &member, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, const T &member, Setter< T > setter, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, Getter< T > getter, Setter< T > setter, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, T &member, const char comment, const T &defaultValue, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T , typename U >
void	property (const char name, T &member, const char comment, const U &defaultValue, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, const T &member, Setter< T > setter, const char comment, const T &defaultValue, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T , typename U >
void	property (const char name, const T &member, Setter< T > setter, const char comment, const U &defaultValue, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	property (const char name, Getter< T > getter, Setter< T > setter, const char comment, const T &defaultValue, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T , typename U >
void	property (const char name, Getter< T > getter, Setter< T > setter, const char comment, const U &defaultValue, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)

template<typename T >
void	delegate (T &member, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)
	Delegates the serialization directly to the specified member, without creating a separate compound for the current object. More...

template<typename T >
void	delegate (const T &member, Setter< T > setter, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)
	Delegates the serialization directly to the specified member, without creating a separate compound for the current object. More...

template<typename T >
void	delegate (Getter< T > getter, Setter< T > setter, ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)
	Delegates the serialization directly to the specified member, without creating a separate compound for the current object. More...

const ReflectMemberMeta &	getCurrentMemberMeta () const
	Returns the meta-information of the current member that is reflected. More...

const std::string &	getCurrentMemberFullID () const
	Returns the full human readable object id / name of the current member being reflected. More...

template<typename T >
void	invokeMember (T &member, const ReflectMemberMeta &meta)
	Is called to invoke this Reflector on the member with the specified meta information. More...

template<typename T >
void	invokeMemberOverwrite (T &member, const ReflectMemberMeta &meta)
	The actual invokeMember implementation that is called from invokeMember(). More...

template<typename T >
void	invokePointerObject (T &member)
	Is called to reflect objects of pointers. More...

template<typename T >
void	invokeMemberWithoutDefault (T &member, const ReflectMemberMeta &meta)
	Delegates to invokeMember() and rethrows any occurring XMemberNotFound exception as XIO exception. More...

template<typename T , typename U >
void	invokeMemberWithDefault (T &member, const ReflectMemberMeta &meta, const U &defaultValue)
	Delegates to invokeMember() and handles any occurring XMemberNotFound exception by setting the member to the given default value. More...

template<typename T >
void	invokeMemberWithDefault (T &member, const ReflectMemberMeta &meta, const serialization::IgnoreMissing &defaultValue)
	Delegates to invokeMember() and handles any occurring XMemberNotFound exception by ignoring the exception and hence the missing member, as indicated by IgnoreMissing as default value. More...

template<typename T >
VersionType	requireVersion (VersionType version, VersionType minVersion, const T *caller=NULL)
	implements ReflectorInterface (for documentation see ReflectorInterface) More...

template<typename T >
void	requireVersion (VersionType requiredVersion, const T *caller=NULL)
	implements ReflectorInterface (for documentation see ReflectorInterface) More...

template<typename T >
VersionType	requireVersion (VersionType version, VersionType minVersion, AcceptDesiredVersion, const T *caller=NULL)
	implements ReflectorInterface (for documentation see ReflectorInterface) More...

template<typename T >
void	requireVersion (VersionType requiredVersion, AcceptDesiredVersion, const T *caller=NULL)
	implements ReflectorInterface (for documentation see ReflectorInterface) More...

	MIRA_DEPRECATED ("Please call as requireVersion<MyType>(v, minV) or requireVersion(v, minV, this)", VersionType requireVersion(VersionType version, VersionType minVersion))

	MIRA_DEPRECATED ("Please call as requireVersion<MyType>(v) or requireVersion(v, this)", void requireVersion(VersionType requiredVersion))

template<typename Base >
void	reflectBase (Base &base)
	implements ReflectorInterface (for documentation see ReflectorInterface) More...

ReflectState	preReflect (const char *context="")
	If a reflector requires reflection barriers, preReflect() and postReflect() should be called before/after calling an external method within reflect(), to declare these barriers (such a 'barrier' is just a declaration to the reflector, in fact). More...

void	postReflect (const ReflectState &)
	See preReflect for documentation. More...

Special Pointer Handlers For Overwriting
void	pointerReference (int referencedObjectID)
	Is called by the pointer() method if an object, a pointer references, was already serialized and a reference to that object must be stored instead of the whole object. More...

void	pointerNull ()
	Is called by the pointer() method to indicate that a pointer that is to be serialized is a NULL-pointer. More...

void	pointerWithoutClassType ()
	Is called if a pointer points to a non-polymorphic type and hence the object can be stored without specifying a class type. More...

void	pointerWithClassType (const std::string &type)
	Is called if a pointer points to a polymorphic type and hence the object must be stored with specifying a class type. More...

Visiting methods that are called by the RecursiveMemberReflector
while reflecting the members
template<typename T >
void	atomic (T &member)
	Is called if the member is an atomic type (int, float, etc). More...

template<typename T >
void	enumeration (T &member)
	Is called by the if the member is an enumeration. More...

template<typename T >
void	object (T &member)
	Is called for each complex object. More...

template<typename T >
void	collection (T &member)
	Is called for each complex object or array, where the IsCollection<T> trait is true_type. More...

Optional Class Versioning.
These visiting methods may be supported by different reflectors like the RecursiveMemberReflector and the RPCMethodReflector, etc. Note Specifying versions for serialized classes is optional. requireVersion() and version() currently are supported by serialization reflectors only.
	MIRA_DEPRECATED ("Please call as requireVersion<MyType>(v) or requireVersion(v, this)", VersionType requireVersion(VersionType version))
	Deprecated 'anonymous' (no type) requireVersion(). More...

Methods for reflecting members
These visiting methods are supported by the RecursiveMemberReflector.
template<typename T >
void	roproperty (const char name, const T &member, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)
	A property that just reflects a runtime state of the object and can be displayed but not altered. More...

template<typename T >
void	roproperty (const char name, const std::string &id, const T &member, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)
	Same as above, with an extra parameter for specifying the id explicitly if it differs from name. More...

template<typename T >
void	roproperty (const char name, Getter< T > getter, const char comment, PropertyHint &&hint=PropertyHint(), ReflectCtrlFlags flags=REFLECT_CTRLFLAG_NONE)
	Same as above, with a special getter method for reading the member. More...

void	itemName (const std::string &name)
	If the currently reflected object is an item within a collection, this allows to specify an explicit name for that item. More...

Methods for reflecting RPC (remote procedure call) methods
void	interface (const char *name)
	Indicates that the class implements the specified RPC interface. More...

void	method (const char name, Method method, const char comment, const char paramName, const char paramDescription, P paramSampleValue,...)
	Specifies that the class that is reflected provides a service through the specified static member function or free function. More...

void	method (const char name, Method method, Class object, const char comment, const char paramName, const char *paramDescription, P paramSampleValue,...)
	Specifies that the class that is reflected provides a service through the specified non-static member function. More...

void	method (const char name, Method method, const char comment, const char paramName, const char paramDescription, P paramSampleValue,...)
	Specifies that the class that is reflected provides a service through the specified function wrapper. More...

Static Public Member Functions
static int	forcedSerializeVersion ()
	Returns either the version number from value of environment variable 'MIRA_FORCE_SERIALIZE_VERSION', or -1 (= do not force a version). More...

template<typename T >
static void	registerClass ()
	Registers a new polymorphic class at the PolymorphPointerReflector. More...

template<typename T >
static void	unregisterClass ()
	Unregisters the class. More...

template<typename T >
static bool	isReflectedAsPointer ()
	For internal use only: Returns true, if the type T is ever reflected as pointer within the current translation unit (C file). More...

static bool	usesHumanReadableIDs ()
	Returns true, if the concrete derived Reflector supports human readable IDs. More...

Protected Types
typedef std::set< AObject >	ObjectSet

typedef std::map< int, std::string >	ObjectIDToNameMap

typedef std::pair< ObjectSet, ObjectIDToNameMap >	TrackingState

Protected Member Functions
VersionType	queryDesiredClassVersion (VersionType version, const std::string &type, bool acceptDesiredVersion=false)

template<typename T >
VersionType	queryDesiredClassVersion (VersionType version, bool acceptDesiredVersion=false)

template<typename T >
bool	isTrackingEnabled () const
	Returns true, if object tracking is enabled for the type T. More...

const std::string &	getHumanReadableFullID (int objectID) const
	Returns the full human readable object id / name for the given internal objectID. More...

template<typename T >
void	invokeTrackObject (T &member)
	tracks the given object (if pointer tracking is enabled for type T) More...

Derived *	This ()
	"Curiously recurring template pattern" (CRTP). More...

template<typename T >
void	invoke (T &object)
	Invokes this reflector on the specified object. More...

template<typename T >
void	invokeOverwrite (T &object)
	The actual invoke implementation, that may also be overwritten in derived classes to add additional functionality. More...

Static Protected Member Functions
static int	checkForcedVersion (const std::string &variable)

Protected Attributes
ClassVersionMap	mDesiredClassVersions

ObjectSet	mObjects

ObjectIDToNameMap	mObjectIDToName

std::stack< TrackingState >	mTrackingStack

Static Protected Attributes
static constexpr auto	MIRA_REFLECTOR_TOPLEVEL_NAME = "@value"
	Use this when a reflector needs to choose a name for serializing an object. More...

Member Typedef Documentation

◆ Tag

typedef BinarySerializerTag Tag

◆ VersionType

typedef serialization::VersionType VersionType

◆ AcceptDesiredVersion

typedef serialization::AcceptDesiredVersion AcceptDesiredVersion

◆ isReadOnly

typedef boost::mpl::bool_<true> isReadOnly

inherited

◆ isObjectTrackingSupported

typedef boost::mpl::bool_<true> isObjectTrackingSupported

inherited

◆ ClassVersionMap

typedef Base::ClassVersionMap ClassVersionMap

inherited

◆ ObjectSet

typedef std::set<AObject> ObjectSet

protectedinherited

◆ ObjectIDToNameMap

typedef std::map<int, std::string> ObjectIDToNameMap

protectedinherited

◆ TrackingState

typedef std::pair<ObjectSet, ObjectIDToNameMap> TrackingState

protectedinherited

◆ useHumanReadableIDs

typedef boost::mpl::bool_<true> useHumanReadableIDs

inherited

Specifies, if the Reflector supports human readable IDs.

This type must be set to the proper boost::mpl::bool type by the derived Reflector class. (Default is true)

◆ requireReflectBarriers

typedef boost::mpl::bool_<false> requireReflectBarriers

inherited

Specifies whether the Reflector uses so-called 'reflect barriers' to allow maintaining separate states for individual blocks of reflected data.

A reflect barrier is just a virtual separation line declared by a reflected object. It tells the reflector that certain parts of the reflected data should be considered as independent and can have separate states (if the reflector maintains any states for data). As an example, the BinarySerializer reserves space for a version number for each reflected object. If there is more than one individual block, it reserves space for a version for each of the blocks. If the reflector needs reflect barriers, it defines requireReflectBarriers::type to true in its class scope, and defines methods preReflect() and postReflect() that should be called by reflected objects for separation of independent reflection blocks (where the separation is not already implied by visitors like reflector.member()!) (The default is false). Also see ReflectState and MIRA_REFLECT_CALL.

Member Function Documentation

◆ version() [1/2]

VersionType version	(	VersionType	version,
		const T *	caller = `NULL`
	)

inline

◆ MIRA_DEPRECATED() [1/4]

MIRA_DEPRECATED	(	"Please call as version<MyType>(v) or version(v, this)"	,
		VersionType	versionVersionType version
	)

inline

◆ version() [2/2]

VersionType version	(	VersionType	version,
		AcceptDesiredVersion	,
		const T *	caller = `NULL`
	)

inline

◆ write()

void write	(	const T *	data,
		std::size_t	count
	)

inline

◆ hasCodec()

bool hasCodec ( ) const

inline

Returns true, of there is a codec for the specified type T.

In this case, the encode method can be used to encode the data using the codec.

◆ codec()

bool codec ( const T & obj )

inline

Encodes the specified object containing the data using a matching codec.

The encoded data will be written directly into the binary output. If no codec was found, false is returned, and the caller must serialize the data manually without codec (in this case "NULL" is written as codec fourcc into the binary stream).

◆ forcedSerializeVersion()

static int forcedSerializeVersion ( )

inlinestaticinherited

Returns either the version number from value of environment variable 'MIRA_FORCE_SERIALIZE_VERSION', or -1 (= do not force a version).

◆ desireClassVersions()

void desireClassVersions ( const ClassVersionMap & versions )

inlineinherited

implements ReflectorInterface (for documentation see ReflectorInterface)

◆ queryDesiredClassVersion() [1/2]

VersionType queryDesiredClassVersion	(	VersionType	version,
		const std::string &	type,
		bool	acceptDesiredVersion = `false`
	)

inlineprotectedinherited

◆ queryDesiredClassVersion() [2/2]

VersionType queryDesiredClassVersion	(	VersionType	version,
		bool	acceptDesiredVersion = `false`
	)

inlineprotectedinherited

◆ serialize()

void serialize	(	const std::string &	name,
		const T &	value,
		const std::string &	comment = `""`
	)

inlineinherited

Serializes the specified object value under the given name.

If you overwrite this method in a derived class you usually MUST call this method of the base class.

◆ trackObject()

void trackObject ( T & member )

inlineinherited

◆ pointer()

void pointer ( T *& pointer )

inlineinherited

◆ pointerNormal()

void pointerNormal	(	T *&	pointer,
		int	typeId
	)

inlineinherited

◆ pointerPolymorphic()

void pointerPolymorphic	(	T *&	pointer,
		int	typeId
	)

inlineinherited

◆ pointerAbstract()

void pointerAbstract	(	T *&	pointer,
		int	typeId
	)

inlineinherited

◆ pointerReference()

void pointerReference ( int referencedObjectID )

inlineinherited

Is called by the pointer() method if an object, a pointer references, was already serialized and a reference to that object must be stored instead of the whole object.

This method can be implemented by derived concrete serializers to store pointer references.

◆ pointerNull()

void pointerNull ( )

inlineinherited

Is called by the pointer() method to indicate that a pointer that is to be serialized is a NULL-pointer.

It can be implemented by derived concrete serializers to handle the special NULL-pointer case.

◆ pointerWithoutClassType()

void pointerWithoutClassType ( )

inlineinherited

Is called if a pointer points to a non-polymorphic type and hence the object can be stored without specifying a class type.

It can be implemented by derived concrete serializers to indicate that no pointer reference and no class type needs to be stored and the full object will follow afterwards. (this is used by the BinarySerializer)

◆ pointerWithClassType()

void pointerWithClassType ( const std::string & type )

inlineinherited

Is called if a pointer points to a polymorphic type and hence the object must be stored with specifying a class type.

It can be implemented by derived concrete serializers to indicate that no pointer reference is stored, but that the full object is serialized afterwards and to store the class type that is needed for proper deserialization.

◆ isTrackingEnabled()

bool isTrackingEnabled ( ) const

inlineprotectedinherited

Returns true, if object tracking is enabled for the type T.

◆ pushObjectTrackingStore()

void pushObjectTrackingStore ( )

inlineinherited

◆ popObjectTrackingStore()

void popObjectTrackingStore ( )

inlineinherited

◆ getHumanReadableFullID()

const std::string& getHumanReadableFullID ( int objectID ) const

inlineprotectedinherited

Returns the full human readable object id / name for the given internal objectID.

The human readable id only is available, if the Reflector has set useHumanReadableIDs to true.

◆ member() [1/10]

void member	(	const char *	name,
		T &	member,
		const char *	comment,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [2/10]

void member	(	const char *	name,
		const std::string &	id,
		T &	member,
		const char *	comment,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [3/10]

void member	(	const char *	name,
		const T &	member,
		Setter< T >	setter,
		const char *	comment,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [4/10]

void member	(	const char *	name,
		Getter< T >	getter,
		Setter< T >	setter,
		const char *	comment,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [5/10]

void member	(	const char *	name,
		T &	member,
		const char *	comment,
		const T &	defaultValue,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [6/10]

void member	(	const char *	name,
		T &	member,
		const char *	comment,
		const U &	defaultValue,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [7/10]

void member	(	const char *	name,
		const T &	member,
		Setter< T >	setter,
		const char *	comment,
		const T &	defaultValue,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [8/10]

void member	(	const char *	name,
		const T &	member,
		Setter< T >	setter,
		const char *	comment,
		const U &	defaultValue,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [9/10]

void member	(	const char *	name,
		Getter< T >	getter,
		Setter< T >	setter,
		const char *	comment,
		const T &	defaultValue,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ member() [10/10]

void member	(	const char *	name,
		Getter< T >	getter,
		Setter< T >	setter,
		const char *	comment,
		const U &	defaultValue,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [1/10]

void property	(	const char *	name,
		T &	member,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [2/10]

void property	(	const char *	name,
		const std::string &	id,
		T &	member,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [3/10]

void property	(	const char *	name,
		const T &	member,
		Setter< T >	setter,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [4/10]

void property	(	const char *	name,
		Getter< T >	getter,
		Setter< T >	setter,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [5/10]

void property	(	const char *	name,
		T &	member,
		const char *	comment,
		const T &	defaultValue,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [6/10]

void property	(	const char *	name,
		T &	member,
		const char *	comment,
		const U &	defaultValue,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [7/10]

void property	(	const char *	name,
		const T &	member,
		Setter< T >	setter,
		const char *	comment,
		const T &	defaultValue,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [8/10]

void property	(	const char *	name,
		const T &	member,
		Setter< T >	setter,
		const char *	comment,
		const U &	defaultValue,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [9/10]

void property	(	const char *	name,
		Getter< T >	getter,
		Setter< T >	setter,
		const char *	comment,
		const T &	defaultValue,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ property() [10/10]

void property	(	const char *	name,
		Getter< T >	getter,
		Setter< T >	setter,
		const char *	comment,
		const U &	defaultValue,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

◆ delegate() [1/3]

void delegate	(	T &	member,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

Delegates the serialization directly to the specified member, without creating a separate compound for the current object.

This method usually is used together with IsTransparentSerializable. Note: only one call of delegate is allowed within one reflect method.

◆ delegate() [2/3]

void delegate	(	const T &	member,
		Setter< T >	setter,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

Delegates the serialization directly to the specified member, without creating a separate compound for the current object.

This method usually is used together with IsTransparentSerializable. Note: only one call of delegate is allowed within one reflect method.

◆ delegate() [3/3]

void delegate	(	Getter< T >	getter,
		Setter< T >	setter,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

Delegates the serialization directly to the specified member, without creating a separate compound for the current object.

This method usually is used together with IsTransparentSerializable. Note: only one call of delegate is allowed within one reflect method.

◆ atomic()

void atomic ( T & member )

inlineinherited

Is called if the member is an atomic type (int, float, etc).

(Type A1)

As for all the other visit-methods the parameter is a reference to the actual visited/reflected member.

This method usually will be implemented in concrete derived classes.

◆ enumeration()

void enumeration ( T & member )

inlineinherited

Is called by the if the member is an enumeration.

(Type A2)

As for all the other visit-methods the parameter is a reference to the actual visited/reflected member.

The default implementation casts the enum to an uint32 and calls atomic().

◆ object()

void object ( T & member )

inlineinherited

Is called for each complex object.

See documentation of RecursiveMemberReflectorBase class for detailed calling sequences. If you overwrite this method in a derived class you should call the method of the Base class to allow recursive reflection of the complex object's members.

◆ collection()

void collection ( T & member )

inlineinherited

Is called for each complex object or array, where the IsCollection<T> trait is true_type.

The default implementation calls object().

◆ registerClass()

static void registerClass ( )

inlinestaticinherited

Registers a new polymorphic class at the PolymorphPointerReflector.

Each RecursiveMemberReflector only is able to process pointers to polymorphic classes that are registered using this method.

The MIRA_CLASS_SERIALIZATION macro provides a simple mechanism to register a class in all known MemberReflectors and calls their registerClass() method. If you implement a new MemberReflector you should modify the MIRA_CLASS_SERIALIZATION macro and add your reflector there.

See also: MIRA_CLASS_SERIALIZATION

◆ unregisterClass()

static void unregisterClass ( )

inlinestaticinherited

Unregisters the class.

The MIRA_CLASS_SERIALIZATION macro provides a simple mechanism to register a class in all known MemberReflectors and calls their registerClass() method. If you implement a new MemberReflector you should modify the MIRA_CLASS_SERIALIZATION macro and add your reflector there.

See also: MIRA_CLASS_SERIALIZATION

◆ getCurrentMemberMeta()

const ReflectMemberMeta& getCurrentMemberMeta ( ) const

inlineinherited

Returns the meta-information of the current member that is reflected.

◆ getCurrentMemberFullID()

const std::string& getCurrentMemberFullID ( ) const

inlineinherited

Returns the full human readable object id / name of the current member being reflected.

This method must not be called if the Reflector has set useHumanReadableIDs to false. If it is called anyway we will assert here.

◆ isReflectedAsPointer()

static bool isReflectedAsPointer ( )

inlinestaticinherited

For internal use only: Returns true, if the type T is ever reflected as pointer within the current translation unit (C file).

◆ invokeTrackObject()

void invokeTrackObject ( T & member )

inlineprotectedinherited

tracks the given object (if pointer tracking is enabled for type T)

◆ invokeMember()

void invokeMember	(	T &	member,
		const ReflectMemberMeta &	meta
	)

inlineinherited

Is called to invoke this Reflector on the member with the specified meta information.

This method delegates the call to the most derived invokeMemberOverwrite() method that may be overwritten in subclasses.

Note: Usually, the RecursiveMemberReflector should be invoked using this invokeMember() method instead of the invoke() method of the ReflectorInterface base class. The invoke() method is called internally by the RecursiveMemberReflector.

◆ invokeMemberOverwrite()

void invokeMemberOverwrite	(	T &	member,
		const ReflectMemberMeta &	meta
	)

inlineinherited

The actual invokeMember implementation that is called from invokeMember().

This method may be overwritten in derived classes to add additional functionality, however, you should always call this implementation of the base class.

◆ invokePointerObject()

void invokePointerObject ( T & member )

inlineinherited

Is called to reflect objects of pointers.

They will use the same meta as the pointer

◆ invokeMemberWithoutDefault()

void invokeMemberWithoutDefault	(	T &	member,
		const ReflectMemberMeta &	meta
	)

inlineinherited

Delegates to invokeMember() and rethrows any occurring XMemberNotFound exception as XIO exception.

◆ invokeMemberWithDefault() [1/2]

void invokeMemberWithDefault	(	T &	member,
		const ReflectMemberMeta &	meta,
		const U &	defaultValue
	)

inlineinherited

Delegates to invokeMember() and handles any occurring XMemberNotFound exception by setting the member to the given default value.

◆ invokeMemberWithDefault() [2/2]

void invokeMemberWithDefault	(	T &	member,
		const ReflectMemberMeta &	meta,
		const serialization::IgnoreMissing &	defaultValue
	)

inlineinherited

Delegates to invokeMember() and handles any occurring XMemberNotFound exception by ignoring the exception and hence the missing member, as indicated by IgnoreMissing as default value.

The value of the member remains unchanged.

◆ requireVersion() [1/4]

VersionType requireVersion	(	VersionType	version,
		VersionType	minVersion,
		const T *	caller = `NULL`
	)

inlineinherited

implements ReflectorInterface (for documentation see ReflectorInterface)

◆ requireVersion() [2/4]

void requireVersion	(	VersionType	requiredVersion,
		const T *	caller = `NULL`
	)

inlineinherited

implements ReflectorInterface (for documentation see ReflectorInterface)

◆ requireVersion() [3/4]

VersionType requireVersion	(	VersionType	version,
		VersionType	minVersion,
		AcceptDesiredVersion	,
		const T *	caller = `NULL`
	)

inlineinherited

implements ReflectorInterface (for documentation see ReflectorInterface)

◆ requireVersion() [4/4]

void requireVersion	(	VersionType	requiredVersion,
		AcceptDesiredVersion	,
		const T *	caller = `NULL`
	)

inlineinherited

implements ReflectorInterface (for documentation see ReflectorInterface)

◆ MIRA_DEPRECATED() [2/4]

MIRA_DEPRECATED	(	"Please call as requireVersion<MyType>(v, minV) or requireVersion(v, minV, this)"	,
		VersionType	requireVersionVersionType version, VersionType minVersion
	)

inlineinherited

◆ MIRA_DEPRECATED() [3/4]

MIRA_DEPRECATED	(	"Please call as requireVersion<MyType>(v) or requireVersion(v, this)"	,
		void	requireVersionVersionType requiredVersion
	)

inlineinherited

◆ MIRA_DEPRECATED() [4/4]

MIRA_DEPRECATED	(	"Please call as requireVersion<MyType>(v) or requireVersion(v, this)"	,
		VersionType	requireVersionVersionType version
	)

inlineinherited

Deprecated 'anonymous' (no type) requireVersion().

◆ reflectBase()

void reflectBase ( Base & base )

inlineinherited

implements ReflectorInterface (for documentation see ReflectorInterface)

◆ This()

Derived* This ( )

inlineprotectedinherited

"Curiously recurring template pattern" (CRTP).

Safely casts this into Derived. This is safe since when implementing derived class their type is passed as template parameter.

See Wikipedia for more details on CRTP if necessary!

◆ invoke()

void invoke ( T & object )

inlineprotectedinherited

Invokes this reflector on the specified object.

This is like calling object.reflect(*this). However, this automatically examines if the class T contains a reflect method. In this case it calls the intrusive reflect method, otherwise it uses the non-intrusive reflect method.

◆ invokeOverwrite()

void invokeOverwrite ( T & object )

inlineprotectedinherited

The actual invoke implementation, that may also be overwritten in derived classes to add additional functionality.

Note: If you overwrite this method you should call the implementation of the base class unless you perform your own invocation process.

◆ roproperty() [1/3]

void roproperty	(	const char *	name,
		const T &	member,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

A property that just reflects a runtime state of the object and can be displayed but not altered.

◆ roproperty() [2/3]

void roproperty	(	const char *	name,
		const std::string &	id,
		const T &	member,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

Same as above, with an extra parameter for specifying the id explicitly if it differs from name.

◆ roproperty() [3/3]

void roproperty	(	const char *	name,
		Getter< T >	getter,
		const char *	comment,
		PropertyHint &&	hint = `PropertyHint()`,
		ReflectCtrlFlags	flags = `REFLECT_CTRLFLAG_NONE`
	)

inlineinherited

Same as above, with a special getter method for reading the member.

See also: Getters and Setters

◆ itemName()

void itemName ( const std::string & name )

inlineinherited

If the currently reflected object is an item within a collection, this allows to specify an explicit name for that item.

This currently is interpreted by the PropertySerializer only.

◆ interface()

void interface ( const char * name )

inlineinherited

Indicates that the class implements the specified RPC interface.

If you indicate that your class implements the specified interface by calling this method in your reflect method, there is an implicit contract that your class provides all methods that are defined by that interface.

◆ method() [1/3]

void method	(	const char *	name,
		Method	method,
		const char *	comment,
		const char *	paramName,
		const char *	paramDescription,
		P	paramSampleValue,
			...
	)

inherited

Specifies that the class that is reflected provides a service through the specified static member function or free function.

The method will then be available for RPC calls. For each method its name (used to identify the method in RPC calls) and a comment that describes the method must be specified.

Parameters

name	The name of the method (used for calling it)
method	The static member function (or free function) that implements the method
comment	A comment that describes the method
paramName	Optional additional argument(s) for the names of the method's parameters
paramDescription	Optional additional argument(s) for the descriptions of the method's parameters.
paramSampleValue	Optional additional argument(s) providing a sample value for each parameter. These are not default values, they are only used for documentation purpose, and should mainly serve to illustrate notation.

The optional parameter documentation arguments must be either a sequence of pairs of const char* values or a sequence of triplets, where each third value is a value of the respective method parameter's type. (name and description must both be provided, for all parameters or for none, and if sample values are to be added, they also need to be added for all parameters).

Examples:

r.method("myMethod1", myStaticMethod1, "static method that does something");
r.method("myMethod2", myStaticMethod2, "static method that does something else",
         "x", "1st parameter", "y", "2nd parameter");
r.method("myMethod3", myStaticMethod3, "yet another static method"
         "a", "parameter 1", ParamType1(...), "b", "parameter b", ParamType2(...));

◆ method() [2/3]

void method	(	const char *	name,
		Method	method,
		Class *	object,
		const char *	comment,
		const char *	paramName,
		const char *	paramDescription,
		P	paramSampleValue,
			...
	)

inherited

Specifies that the class that is reflected provides a service through the specified non-static member function.

The method will then be available for RPC calls. For each method its name (used to identify the method in RPC calls) and a comment that describes the method must be specified.

Parameters

name	The name of the method (used for calling it)
method	The non-static member function (const or non-const) that implements the method
object	A pointer to the object on which the function is called (usually "this")
comment	A comment that describes the method
paramName	Optional additional argument(s) for the names of the method's parameters
paramDescription	Optional additional argument(s) for the descriptions of the method's parameters.
paramSampleValue	Optional additional argument(s) providing a sample value for each parameter.

See above for documentation of optional parameter documentation arguments.

Example:

r.method("myMethod2", &MyClass::myMethod, this, "a non-static method");

◆ method() [3/3]

void method	(	const char *	name,
		Method	method,
		const char *	comment,
		const char *	paramName,
		const char *	paramDescription,
		P	paramSampleValue,
			...
	)

inherited

Specifies that the class that is reflected provides a service through the specified function wrapper.

The method will then be available for RPC calls. For each method its name (used to identify the method in RPC calls) and a comment that describes the method must be specified.

Parameters

name	The name of the method (used for calling it)
method	The function wrapper object that implements the method, e.g. created using boost::bind
comment	A comment that describes the method
paramName	Optional additional argument(s) for the names of the method's parameters
paramDescription	Optional additional argument(s) for the descriptions of the method's parameters.
paramSampleValue	Optional additional argument(s) providing a sample value for each parameter.

See above for documentation of optional parameter documentation arguments.

Example:

r.method("myMethod3", boost::bind(&MyClass::myMethod, this, 1.23, 4, _1), "a function wrapper");

◆ usesHumanReadableIDs()

static bool usesHumanReadableIDs ( )

inlinestaticinherited

Returns true, if the concrete derived Reflector supports human readable IDs.

The return value of this method is known at compile time and hence the compiler is able to optimize the code depending on that value.

◆ preReflect()

ReflectState preReflect ( const char * context = "" )

inlineinherited

If a reflector requires reflection barriers, preReflect() and postReflect() should be called before/after calling an external method within reflect(), to declare these barriers (such a 'barrier' is just a declaration to the reflector, in fact).

The base implementation is empty and should not actually be called (if a reflector needs these methods, it must provide own definitions).

Parameters

context Can be used to provide context, e.g. name of the reflected class or function that is called. How this is used depends on the reflector implementation, e.g. MetaSerializer uses it to generate comments on data elements implicitly defined by preReflect.

The complete process of calling these methods is wrapped by MIRA_REFLECT_CALL. That macro should be used to simplify handling.

See requireReflectBarriers and ReflectState.

◆ postReflect()

void postReflect ( const ReflectState & )

inlineinherited

See preReflect for documentation.

◆ checkForcedVersion()

static int checkForcedVersion ( const std::string & variable )

inlinestaticprotectedinherited

Member Data Documentation

◆ mDesiredClassVersions

ClassVersionMap mDesiredClassVersions

protectedinherited

◆ mObjects

ObjectSet mObjects

protectedinherited

◆ mObjectIDToName

ObjectIDToNameMap mObjectIDToName

protectedinherited

◆ mTrackingStack

std::stack<TrackingState> mTrackingStack

protectedinherited

◆ MIRA_REFLECTOR_TOPLEVEL_NAME

constexpr auto MIRA_REFLECTOR_TOPLEVEL_NAME = "@value"

staticprotectedinherited

Use this when a reflector needs to choose a name for serializing an object.

Internally this is used to recognize it is not a name defined by the reflected object, but by the reflector.

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

base/include/serialization/BinarySerializer.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Static Protected Attributes

Member Typedef Documentation

◆ Tag

◆ VersionType

◆ AcceptDesiredVersion

◆ isReadOnly

◆ isObjectTrackingSupported

◆ ClassVersionMap

◆ ObjectSet

◆ ObjectIDToNameMap

◆ TrackingState

◆ useHumanReadableIDs

◆ requireReflectBarriers

Member Function Documentation

◆ version() [1/2]

◆ MIRA_DEPRECATED() [1/4]

◆ version() [2/2]

◆ write()

◆ hasCodec()

◆ codec()

◆ forcedSerializeVersion()

◆ desireClassVersions()

◆ queryDesiredClassVersion() [1/2]

◆ queryDesiredClassVersion() [2/2]

◆ serialize()

◆ trackObject()

◆ pointer()

◆ pointerNormal()

◆ pointerPolymorphic()

◆ pointerAbstract()

◆ pointerReference()

◆ pointerNull()

◆ pointerWithoutClassType()

◆ pointerWithClassType()

◆ isTrackingEnabled()

◆ pushObjectTrackingStore()

◆ popObjectTrackingStore()

◆ getHumanReadableFullID()

◆ member() [1/10]

◆ member() [2/10]

◆ member() [3/10]

◆ member() [4/10]

◆ member() [5/10]

◆ member() [6/10]

◆ member() [7/10]

◆ member() [8/10]

◆ member() [9/10]

◆ member() [10/10]

◆ property() [1/10]

◆ property() [2/10]

◆ property() [3/10]

◆ property() [4/10]

◆ property() [5/10]

◆ property() [6/10]

◆ property() [7/10]

◆ property() [8/10]

◆ property() [9/10]

◆ property() [10/10]

◆ delegate() [1/3]

◆ delegate() [2/3]

◆ delegate() [3/3]

◆ atomic()

◆ enumeration()

◆ object()

◆ collection()

◆ registerClass()

◆ unregisterClass()

◆ getCurrentMemberMeta()

◆ getCurrentMemberFullID()

◆ isReflectedAsPointer()

◆ invokeTrackObject()

◆ invokeMember()

◆ invokeMemberOverwrite()