Serializer which encapsulates serialization of data entities and their members via channels. More...

#include <mdsBinarySerializer.h>

Inheritance diagram for mds::mod::CBinarySerializer:

[legend]

Public Types
enum	{ CLASS_OBJECT }
	Templates that require members of the CObject class can use this enum to check the existence. More...
enum	{ HEAP_OBJECT = 0x70616568 }
	Signature used to recognize objects on the heap. More...
typedef CChannelSerializer < CBinarySerializer >	tBase
	Base class.
typedef mds::base::CFunctor < bool, int, int >	tProgressFunc
	Progress observer (= functor).
typedef CProgressInitializer	tProgressInitializer
	Helper class which can be used to call methods beginProgress() and endProgress() automatically.
typedef CBinarySerializer	tSerializer
	Serializer type.
Public Member Functions
CHasOptions &	addOption (int Flag)
	Adds a given flag using bitwise OR operation.
void	beginProgress ()
	This function must be called by the class realizing an operation before it starts.
template<typename T >
void	beginRead (T &Object)
	Reads information on logical group of class members from the serialized data.
template<typename T >
void	beginRead (T &Object)
	Reads information on logical group of class members from the serialized data.
template<typename T >
void	beginWrite (T &Object)
	Creates a new logical group of class members in the serialized data.
template<typename T >
void	beginWrite (T &Object)
	Creates a new logical group of class members in the serialized data.
	CBinarySerializer (CChannel *pChannel, int iFlags=0)
	Default constructor.
bool	checkAllOptions (int Flags) const
	Checks if all specified flags are set.
bool	checkAnyOption (int Flags) const
	Checks if any of specified flags is set.
int	checkOption (int Flag) const
	Checks if a single flag is set.
CHasOptions &	clearOption (int Flag)
	Removes a given flag.
void	deregisterProgressFunc ()
	Sets the default empty observer.
void	endProgress ()
	The function must be called by the class realizing an operation every time the operation finishes.
template<typename T >
void	endRead (T &Object)
	Reads end of the logical group.
template<typename T >
void	endRead (T &Object)
	Reads end of the logical group.
template<typename T >
void	endWrite (T &Object)
	End of the logical group.
template<typename T >
void	endWrite (T &Object)
	End of the logical group.
CChannel *	getChannelPtr ()
	Returns pointer to the I/O channel.
tSerializer &	getImpl ()
	Returns reference to the serializer implementation.
const tSerializer &	getImpl () const
int	getOptions () const
	Returns all flags.
int	getProgressCount () const
	Returns current value of the internal progress value.
int	getProgressMax () const
	Returns the maximum allowed value of the internal progress counter.
int	getReferencesCount () const
	Returns the number of references.
bool	isOnHeap () const
	Returns true if the object is allocated on the heap.
	MDS_SHAREDPTR (CBinarySerializer)
	Smart pointer type.
bool	progress (int iIncrement=1)
	Calls the registered observer.
template<typename T >
void	read (T &Value)
	Deserializes a given fundamental value.
template<typename T >
void	read (T *pData, tSize Length)
	Deserializes a given block of data.
template<typename T >
void	read (T &Value)
	Deserializes a given fundamental value.
template<typename T >
void	read (T *pData, tSize Length)
	Deserializes a given block of data.
template<typename T >
void	readRoot (T &Object)
	Deserializes a given data entity.
template<typename T >
void	readRoot (T &Object)
	Deserializes a given data entity.
void	registerProgressFunc (const tProgressFunc &Func)
	Sets observer/functor called to inform a calling process about the current state of the running operation.
void	setChannel (CChannel *pChannel)
	Sets the I/O channel.
CHasOptions &	setOption (int Flag)
	Adds a given flag using bitwise OR operation.
CHasOptions &	setOptions (int Flags)
	Sets complete flags.
void	setProgressMax (int iValue)
	Sets the maximal counter value.
template<typename T >
void	write (const T &Value)
	Serializes a given fundamental value.
template<typename T >
void	write (const T *pData, tSize Length)
	Serializes a given block of data.
template<typename T >
void	write (const T &Value)
	Serializes a given fundamental value.
template<typename T >
void	write (const T *pData, tSize Length)
	Serializes a given block of data.
template<typename T >
void	writeRoot (T &Object)
	Serializes a given data entity.
template<typename T >
void	writeRoot (T &Object)
	Serializes a given data entity.
	~CBinarySerializer ()
	Destructor.
Static Public Member Functions
static void *	operator new (std::size_t Size)
	Allocates a new object on the heap.
Protected Member Functions
void	addReference () const
	Increase the reference counter.
bool	delReference () const
	Decrease the reference counter.
Protected Attributes
int	m_iHeapObject
	Flag initialized if the object is on the heap.
int	m_iReferences
	The number of references to the object.
int	m_Options
	Optional flags.
CChannelPtr	m_spActiveChannel
	Smart pointer to actively used channel.
CChannelPtr	m_spChannel
	Pointer to the I/O channel.

Detailed Description

Serializer which encapsulates serialization of data entities and their members via channels.

Member Typedef Documentation

typedef CChannelSerializer<CBinarySerializer> mds::mod::CBinarySerializer::tBase

Base class.

typedef mds::base::CFunctor<bool, int, int> mds::mod::CProgress::tProgressFunc [inherited]

Progress observer (= functor).

You may return false from the observer if you want to terminate the running operation.
Parameters describe current and final state of the pending operation (counter and maximal value).
If the second parameter is equal to -1, termination time cannot be determined, the current state is unknown.

typedef CProgressInitializer mds::mod::CProgress::tProgressInitializer [inherited]

Helper class which can be used to call methods beginProgress() and endProgress() automatically.

Create static object of this type at the begining of a method that realizes an operation.

typedef CBinarySerializer mds::mod::CChannelSerializer< CBinarySerializer >::tSerializer [inherited]

Serializer type.

Member Enumeration Documentation

anonymous enum [inherited]

Templates that require members of the CObject class can use this enum to check the existence.

Enumerator:

CLASS_OBJECT

anonymous enum [inherited]

Signature used to recognize objects on the heap.

Enumerator:

HEAP_OBJECT

Constructor & Destructor Documentation

mds::mod::CBinarySerializer::CBinarySerializer	(	CChannel *	pChannel,
		int	iFlags = `0`
	)

Default constructor.

mds::mod::CBinarySerializer::~CBinarySerializer ( )

Destructor.

Member Function Documentation

CHasOptions& mds::base::CHasOptions::addOption ( int Flag ) [inherited]

Adds a given flag using bitwise OR operation.

void mds::base::CObject::addReference ( ) const [protected, inherited]

Increase the reference counter.

void mds::mod::CProgress::beginProgress ( ) [inherited]

This function must be called by the class realizing an operation before it starts.

template<typename T >

void mds::mod::CBinarySerializer::beginRead ( T & Object )

Reads information on logical group of class members from the serialized data.

Must be called before any read() method.
Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::beginRead ( T & Object )

Reads information on logical group of class members from the serialized data.

Must be called before any read() method.
Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::beginWrite ( T & Object )

Creates a new logical group of class members in the serialized data.

Properties of the group, such as compression method, are chosen according to the serialization traits.
Must be called before any write() method.
Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::beginWrite ( T & Object )

Creates a new logical group of class members in the serialized data.

Properties of the group, such as compression method, are chosen according to the serialization traits.
Must be called before any write() method.
Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

bool mds::base::CHasOptions::checkAllOptions ( int Flags ) const [inherited]

Checks if all specified flags are set.

bool mds::base::CHasOptions::checkAnyOption ( int Flags ) const [inherited]

Checks if any of specified flags is set.

int mds::base::CHasOptions::checkOption ( int Flag ) const [inherited]

Checks if a single flag is set.

Returns zero on false.

CHasOptions& mds::base::CHasOptions::clearOption ( int Flag ) [inherited]

Removes a given flag.

bool mds::base::CObject::delReference ( ) const [protected, inherited]

Decrease the reference counter.

Returns true if the decremented number of references is lower or equal to zero and object must be deleted.

void mds::mod::CProgress::deregisterProgressFunc ( ) [inherited]

Sets the default empty observer.

void mds::mod::CProgress::endProgress ( ) [inherited]

The function must be called by the class realizing an operation every time the operation finishes.

Sets the default observer.

template<typename T >

void mds::mod::CBinarySerializer::endRead ( T & Object )

Reads end of the logical group.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::endRead ( T & Object )

Reads end of the logical group.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::endWrite ( T & Object )

End of the logical group.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::endWrite ( T & Object )

End of the logical group.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

CChannel* mds::mod::CChannelSerializer< CBinarySerializer >::getChannelPtr ( ) [inherited]

Returns pointer to the I/O channel.

tSerializer& mds::mod::CChannelSerializer< CBinarySerializer >::getImpl ( ) [inherited]

Returns reference to the serializer implementation.

const tSerializer& mds::mod::CChannelSerializer< CBinarySerializer >::getImpl ( ) const [inherited]

int mds::base::CHasOptions::getOptions ( ) const [inherited]

Returns all flags.

int mds::mod::CProgress::getProgressCount ( ) const [inherited]

Returns current value of the internal progress value.

int mds::mod::CProgress::getProgressMax ( ) const [inherited]

Returns the maximum allowed value of the internal progress counter.

int mds::base::CObject::getReferencesCount ( ) const [inherited]

Returns the number of references.

bool mds::base::CObject::isOnHeap ( ) const [inherited]

Returns true if the object is allocated on the heap.

mds::mod::CBinarySerializer::MDS_SHAREDPTR ( CBinarySerializer )

Smart pointer type.

Declares type tSmartPtr.

static void* mds::base::CObject::operator new ( std::size_t Size ) [static, inherited]

Allocates a new object on the heap.

bool mds::mod::CProgress::progress ( int iIncrement = 1 ) [inherited]

Calls the registered observer.

Returns false if the running operation should be terminated as soon as possible.
It must be called periodically by the class realizing the operation.

template<typename T >

void mds::mod::CBinarySerializer::read ( T & Value )

Deserializes a given fundamental value.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::read	(	T *	pData,
		tSize	Length
	)

Deserializes a given block of data.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::read ( T & Value )

Deserializes a given fundamental value.

Throws exception on failure.
Derived classes have to implement this method!

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::read	(	T *	pData,
		tSize	Length
	)

Deserializes a given block of data.

Throws exception on failure.
Derived classes have to implement this method!

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::readRoot ( T & Object )

Deserializes a given data entity.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::readRoot ( T & Object )

Deserializes a given data entity.

Throws exception on failure.
Derived classes have to implement this method!

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

void mds::mod::CProgress::registerProgressFunc ( const tProgressFunc & Func ) [inherited]

Sets observer/functor called to inform a calling process about the current state of the running operation.

This function should be called before any operation starts.

void mds::mod::CChannelSerializer< CBinarySerializer >::setChannel ( CChannel * pChannel ) [inherited]

Sets the I/O channel.

CHasOptions& mds::base::CHasOptions::setOption ( int Flag ) [inherited]

Adds a given flag using bitwise OR operation.

CHasOptions& mds::base::CHasOptions::setOptions ( int Flags ) [inherited]

Sets complete flags.

void mds::mod::CProgress::setProgressMax ( int iValue ) [inherited]

Sets the maximal counter value.

template<typename T >

void mds::mod::CBinarySerializer::write ( const T & Value )

Serializes a given fundamental value.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::write	(	const T *	pData,
		tSize	Length
	)

Serializes a given block of data.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::write ( const T & Value )

Serializes a given fundamental value.

Throws exception on failure.
Derived classes have to implement this method!

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::write	(	const T *	pData,
		tSize	Length
	)

Serializes a given block of data.

Throws exception on failure.
Derived classes have to implement this method!

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::writeRoot ( T & Object )

Serializes a given data entity.

Throws exception on failure.
Derived classes have to implement this method!

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

template<typename T >

void mds::mod::CBinarySerializer::writeRoot ( T & Object )

Serializes a given data entity.

Throws exception on failure.

Reimplemented from mds::mod::CChannelSerializer< CBinarySerializer >.

Member Data Documentation

int mds::base::CObject::m_iHeapObject [mutable, protected, inherited]

Flag initialized if the object is on the heap.

int mds::base::CObject::m_iReferences [mutable, protected, inherited]

The number of references to the object.

Zero if there is no reference.

int mds::base::CHasOptions::m_Options [protected, inherited]

Optional flags.

CChannelPtr mds::mod::CBinarySerializer::m_spActiveChannel [protected]

Smart pointer to actively used channel.

CChannelPtr mds::mod::CChannelSerializer< CBinarySerializer >::m_spChannel [protected, inherited]

Pointer to the I/O channel.

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

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Typedef Documentation

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation