Sct::Archive::IOManagerStreamerVersioned Class Reference

Abstract IOManager to be used in archival, makes use of streamer versioning. More...

#include <IOManagerStreamerVersioned.h>

Inheritance diagram for Sct::Archive::IOManagerStreamerVersioned:

[legend]Collaboration diagram for Sct::Archive::IOManagerStreamerVersioned:

[legend]


Public Member Functions
virtual Streamer &	getStreamer (const string &className) const
	Over-ride of getStreamer returns appropriate version of streamer if in read mode, otherwise default IOManager::getStreamer.
virtual void	readImpl (IStream &in, Streamable &ob, bool bReadClassName) const
	over-ride readImpl to read classnames and versions
virtual shared_ptr< Streamable >	readImpl (IStream &in) const
	over-ride readImpl to read classnames and versions
virtual shared_ptr< Streamable >	readImpl (IStream &in, const std::string &className) const
	over-ride readImpl to read classnames and versions
virtual void	writeImpl (OStream &out, const Streamable &ob, bool bWriteClassName) const
	over-ride writeImpl to write classname and version
virtual void	readImpl (IStream &in, Streamable &ob, const std::string &className) const
	over-ride readImpl to read classnames and versions
virtual void	writeImpl (OStream &out, const Streamable &ob, const std::string &className) const
	over-ride writeImpl to write classname and version
Protected Types
typedef std::map< std::string, unsigned >	VersionMap
Protected Member Functions
	IOManagerStreamerVersioned ()
	Public access is through instance().
virtual void	writeClassName (OStream &, const string &classname) const
	override to write class and version to OStream uses writeClassName
virtual std::string	readClassName (IStream &) const
	override to read version from IStream and put in map.
boost::recursive_mutex &	getMutex () const
	concrete implimentations must lock this mutex when doing read or write, so that read or write mode cannot be changed by other threads.
void	setReadMode (bool mode) const
	set read mode to true when reading, false when writing.
bool	readMode () const
	get read mode - true if reading, false if writing.
Static Protected Member Functions
VersionMap &	getReadVersionMap ()
	Map of streamer versions to use for each classname.
Private Attributes
boost::recursive_mutex	m_access
	access must be locked for thread-safeness.
bool	m_read_mode
	if true will use its own verion map to get appropriate streamers.

Detailed Description

Abstract IOManager to be used in archival, makes use of streamer versioning.

When writing, the appropriate (i.e. current) streamer versions are written out. When reading the file, the streamer versions are first read, and then the getStreamer() method overriden to return the historic streamers. In write mode the most recent (default) streamers are always returned. Concrete versions must get a lock on the mutex, and setReadMode(true) at start of read. Similarly they must get a lock on the mutex and setReadMode(false) at the start of a write.

Definition at line 22 of file IOManagerStreamerVersioned.h.

Constructor & Destructor Documentation

Sct::Archive::IOManagerStreamerVersioned::IOManagerStreamerVersioned ( ) [protected]

Public access is through instance().

Definition at line 12 of file IOManagerStreamerVersioned.cpp.

Member Function Documentation

boost::recursive_mutex & Sct::Archive::IOManagerStreamerVersioned::getMutex ( ) const [protected]

concrete implimentations must lock this mutex when doing read or write, so that read or write mode cannot be changed by other threads.

Definition at line 135 of file IOManagerStreamerVersioned.cpp.
References m_access.
Referenced by SctArchiving::IOManagerDB::read(), readMode(), Sct::Archive::IOManagerArchive::setCompressionLevel(), setReadMode(), SctArchiving::IOManagerDB::write(), and Sct::Archive::IOManagerArchiveFile::write().

IOManagerStreamerVersioned::VersionMap & Sct::Archive::IOManagerStreamerVersioned::getReadVersionMap ( ) [static, protected]

Map of streamer versions to use for each classname.

Definition at line 15 of file IOManagerStreamerVersioned.cpp.
Referenced by getStreamer(), SctArchiving::IOManagerDB::read(), Sct::Archive::IOManagerArchiveFile::read(), and readClassName().

Streamer & Sct::Archive::IOManagerStreamerVersioned::getStreamer ( const string & className ) const [virtual]

Over-ride of getStreamer returns appropriate version of streamer if in read mode, otherwise default IOManager::getStreamer.

Reimplemented from Sct::IOManager.
Definition at line 101 of file IOManagerStreamerVersioned.cpp.
References getReadVersionMap(), and readMode().
Referenced by readImpl(), and writeImpl().