VR-Forces Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
List of all members | Public Types | Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes
makVrv::DtSettingsBackup Class Referenceabstract
vrvCore

Provides a method of doign settings backup.

Inheritance diagram for makVrv::DtSettingsBackup:
Inheritance graph
[legend]

Public Types

enum  RestoreFlags { RestoreFromFactory = 0x00000001, RestoreFromLocal = 0x00000002, KeepRestoreFromLocal = 0x80000000, RestoreAll = RestoreFromFactory | RestoreFromLocal }
 
typedef std::map
< DtSettingsBackup *, int > 		RestoreWhenRestored
 
- Public Types inherited from makVrv::DtBackupInterface
typedef std::vector< std::string > NameList
 

Public Member Functions

 DtSettingsBackup ()
 
virtual ~DtSettingsBackup ()
 
virtual bool createAndWriteToBackupFile (const std::ostringstream &str, const std::string &path)
 
virtual bool createAndWriteToBackupFiles (const std::vector< std::ostringstream * > &str, const std::string &path, const std::vector< std::string > &fileNames)
 
const std::string & backupFile () const
 
virtual bool backupFileExists () const
 
virtual bool backupDirExists () const
 
virtual bool factoryFileExists () const
 
virtual bool factoryDirExists () const
 
virtual void backup ()
 
virtual void backupByDir ()
 
virtual void deleteBackup ()
 
virtual void restore (bool fromFactory=false)
 
virtual void getRestorableNames (NameList &names)
 
virtual void restore (bool fromFactory, bool selectedOnly)
 
virtual void restore (const DtSettingsBackup *from)=0
 
virtual void restoreSelected (const DtSettingsBackup *)
 
virtual std::string backupClassType () const =0
 
virtual DtSettingsBackup * create () const =0
 
virtual void write (boost::archive::xml_oarchive &ar)=0
 
virtual void read (boost::archive::xml_iarchive &ar)=0
 
virtual void writeDir (std::vector< std::ostringstream * > &outStreamVec, std::vector< std::string > &fileNames)
 
virtual void readIncremental (boost::archive::xml_iarchive &ar)
 
void setManagerDestroyed (bool b)
 
virtual void addRestoreWhenRestored (DtSettingsBackup *, const RestoreFlags &f=RestoreAll)
 
const RestoreWhenRestored & restoreWhenRestored () const
 
virtual void cancelRestoreWhenRestored (DtSettingsBackup *, const RestoreFlags &f=RestoreAll)
 
virtual std::string backupName () const
 
void setBackupsPath (const std::string &s)
 
const std::string & backupsPath () const
 
void setFactoryFile (const std::string &s)
 
const std::string & factoryFile () const
 
void setFactoryDir (const std::string &dir)
 
const std::string & factoryDir () const
 
void setBackupDir (const std::string &dir)
 
const std::string & backupDir () const
 
- Public Member Functions inherited from makVrv::DtBackupInterface
 DtBackupInterface ()
 
virtual ~DtBackupInterface ()
 

Public Attributes

boost::signalslib::signal
< void(const DtSettingsBackup *)> 		signal_destructing
 
boost::signalslib::signal
< void(const DtSettingsBackup *)> 		signal_backupCleared
 
boost::signalslib::signal
< void(const DtSettingsBackup *)> 		signal_backedUp
 
boost::signalslib::signal
< void(const DtSettingsBackup *)> 		signal_restored
 
- Public Attributes inherited from makVrv::DtBackupInterface
boost::signalslib::signal
< void(DtBackupInterface *)> 		signal_backupFileChanged
 

Protected Member Functions

virtual bool restore (bool fromFactory, std::vector< DtSettingsBackup * > &hasBeenRestored, bool selectedOnly)
 

Protected Attributes

bool myManagerDestroyed
 
RestoreWhenRestored myRestoreWhenRestored
 
std::string myBackupFile
 
std::string myFactoryFile
 
std::string myBackupsPath
 
std::string myBackupDir
 
std::string myFactoryDir
 

Member Typedef Documentation

typedef std::map<DtSettingsBackup*, int> makVrv::DtSettingsBackup::RestoreWhenRestored

Member Enumeration Documentation

enum makVrv::DtSettingsBackup::RestoreFlags
Enumerator
RestoreFromFactory 
RestoreFromLocal 
KeepRestoreFromLocal 

Normally, when restoring locally, the object will be removed from the next local restore, figuring that, when the associated object is restored, there is no need to continue to restore this object. To prevent that, set this flag when registering to restore an object when another is restored.

RestoreAll 

Constructor & Destructor Documentation

makVrv::DtSettingsBackup::DtSettingsBackup ( )

CTOR.

virtual makVrv::DtSettingsBackup::~DtSettingsBackup ( )
virtual

DTOR.

Member Function Documentation

virtual bool makVrv::DtSettingsBackup::createAndWriteToBackupFile ( const std::ostringstream &  str,
const std::string &  path 
)
virtual

Creates a backup file on the specified path and writes to that backup file given the string stream which contains the stored buffer. Will delete the backup file when this object is deleted.

virtual bool makVrv::DtSettingsBackup::createAndWriteToBackupFiles ( const std::vector< std::ostringstream * > &  str,
const std::string &  path,
const std::vector< std::string > &  fileNames 
)
virtual
const std::string& makVrv::DtSettingsBackup::backupFile ( ) const

Get the name of the backup file.

virtual bool makVrv::DtSettingsBackup::backupFileExists ( ) const
virtual

Returns true if the file can be restored from a local backup.

Implements makVrv::DtBackupInterface.

virtual bool makVrv::DtSettingsBackup::backupDirExists ( ) const
virtual

Returns true if the file can be restored from a local backup directory.

Implements makVrv::DtBackupInterface.

virtual bool makVrv::DtSettingsBackup::factoryFileExists ( ) const
virtual

Returns true if can be restored from factory.

Implements makVrv::DtBackupInterface.

virtual bool makVrv::DtSettingsBackup::factoryDirExists ( ) const
virtual

Returns true if can be restored from factory directory.

Implements makVrv::DtBackupInterface.

virtual void makVrv::DtSettingsBackup::backup ( )
virtual

Backs up settings to backup file. If file does not exist, will create. Emits signal_backedUp when this object is backed up.

Implements makVrv::DtBackupInterface.

Reimplemented in makVrv::DtRecordSettingsBackupInterface.

Referenced by makVrv::DtRecordSettingsBackupInterface::backup(), makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >::backup(), and makVrv::DtBaseSettingsManager< makArchives::DtOculusSettingsRecord >::initializeBackup().

virtual void makVrv::DtSettingsBackup::backupByDir ( )
virtual

Backs up settings to backup directory. If directory does not exist, will create. Emits signal_backedUp when this object is backed up.

Reimplemented in makVrv::DtRecordSettingsBackupInterface.

Referenced by makVrv::DtRecordSettingsBackupInterface::backupByDir().

virtual void makVrv::DtSettingsBackup::deleteBackup ( )
virtual

If backup file exists, deletes it. Returns true if successful. Emits signal_backupCleared when backup is cleared.

Implements makVrv::DtBackupInterface.

virtual void makVrv::DtSettingsBackup::restore ( bool  fromFactory = false)
virtual

Restore all.

Implements makVrv::DtBackupInterface.

virtual void makVrv::DtSettingsBackup::getRestorableNames ( NameList &  names)
virtual

Get the names of states restore will affect.

Implements makVrv::DtBackupInterface.

virtual void makVrv::DtSettingsBackup::restore ( bool  fromFactory,
bool  selectedOnly 
)
virtual

Restore the state, either from the backup (default) or from the factory.

virtual void makVrv::DtSettingsBackup::restore ( const DtSettingsBackup *  from)
pure virtual

Called with the object that needs to be restored from. The object passed in should be considered temporary. Any member that holds onto this will become invalid after the restore method is complete.

Implemented in makVrv::DtEntityTypeMapperBackup, makVrv::DtCigiSettingsBackup, makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtKeyMapSettingsBackup, makVrv::DtRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtObserverModesRecord >, makArchives::DtObserverModesRecord >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtShadowSettingsCollectionRecord >, makArchives::DtShadowSettingsCollectionRecord >, makVrv::DtSchemaSettingsBackup, and makVrv::DtModelDefinitionManagerBackup.

virtual void makVrv::DtSettingsBackup::restoreSelected ( const DtSettingsBackup *  )
inlinevirtual

Called with the object that needs to be restored from. The object passed in should be considered temporary. Any member that holds onto this will become invalid after the restore method is complete.

Reimplemented in makVrv::DtShadowSettingsCollectionBackup, and makVrv::DtObserverModesSettingsBackup.

virtual std::string makVrv::DtSettingsBackup::backupClassType ( ) const
pure virtual

Override to return the class name of this object. Will be used as a key to look itself up in the backup manager.

Implemented in makVrv::DtEntityTypeMapperBackup, makVrv::DtCigiSettingsBackup, makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtKeyMapSettingsBackup, makVrv::DtRecordSettingsBackupInterface, makVrv::DtSchemaSettingsBackup, and makVrv::DtModelDefinitionManagerBackup.

virtual DtSettingsBackup* makVrv::DtSettingsBackup::create ( ) const
pure virtual

Returns a new empty class of type. Will be called from restore() method to restore data into.

Implemented in makVrv::DtEntityTypeMapperBackup, makVrv::DtCigiSettingsBackup, makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtKeyMapSettingsBackup, makVrv::DtRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtObserverModesRecord >, makArchives::DtObserverModesRecord >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtShadowSettingsCollectionRecord >, makArchives::DtShadowSettingsCollectionRecord >, makVrv::DtSchemaSettingsBackup, and makVrv::DtModelDefinitionManagerBackup.

virtual void makVrv::DtSettingsBackup::write ( boost::archive::xml_oarchive &  ar)
pure virtual

Override to write to given stream. Implementation need not be more than oa << *this.

Implemented in makVrv::DtEntityTypeMapperBackup, makVrv::DtCigiSettingsBackup, makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtKeyMapSettingsBackup, makVrv::DtRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtObserverModesRecord >, makArchives::DtObserverModesRecord >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtShadowSettingsCollectionRecord >, makArchives::DtShadowSettingsCollectionRecord >, makVrv::DtSchemaSettingsBackup, and makVrv::DtModelDefinitionManagerBackup.

virtual void makVrv::DtSettingsBackup::read ( boost::archive::xml_iarchive &  ar)
pure virtual

Override to read from given stream. Implementation need not be more than ia >> *this.

Implemented in makVrv::DtEntityTypeMapperBackup, makVrv::DtCigiSettingsBackup, makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtKeyMapSettingsBackup, makVrv::DtRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtObserverModesRecord >, makArchives::DtObserverModesRecord >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtShadowSettingsCollectionRecord >, makArchives::DtShadowSettingsCollectionRecord >, makVrv::DtSchemaSettingsBackup, and makVrv::DtModelDefinitionManagerBackup.

virtual void makVrv::DtSettingsBackup::writeDir ( std::vector< std::ostringstream * > &  outStreamVec,
std::vector< std::string > &  fileNames 
)
inlinevirtual

Support for writing settings to files in a directory.

Reimplemented in makVrv::DtRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtObserverModesRecord >, makArchives::DtObserverModesRecord >, and makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtShadowSettingsCollectionRecord >, makArchives::DtShadowSettingsCollectionRecord >.

virtual void makVrv::DtSettingsBackup::readIncremental ( boost::archive::xml_iarchive &  ar)
inlinevirtual

Support for reading files from a directory by looping over files and incrementally adding their contents.

Reimplemented in makVrv::DtEntityTypeMapperBackup, makVrv::DtRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtObserverModesRecord >, makArchives::DtObserverModesRecord >, makVrv::DtRecordSettingsBackup< DtBaseSettingsManager< makArchives::DtShadowSettingsCollectionRecord >, makArchives::DtShadowSettingsCollectionRecord >, and makVrv::DtModelDefinitionManagerBackup.

void makVrv::DtSettingsBackup::setManagerDestroyed ( bool  b)
inline

If true, will not signal destroyed.

virtual void makVrv::DtSettingsBackup::addRestoreWhenRestored ( DtSettingsBackup *  ,
const RestoreFlags &  f = RestoreAll 
)
virtual

Sets to restore the specified object when this object is restored. Will hold the information only – the actual restore will be handled by the backup manager.

const RestoreWhenRestored& makVrv::DtSettingsBackup::restoreWhenRestored ( ) const
inline
virtual void makVrv::DtSettingsBackup::cancelRestoreWhenRestored ( DtSettingsBackup *  ,
const RestoreFlags &  f = RestoreAll 
)
virtual

Cancels that the specified object should be restored when this one is restored.

virtual std::string makVrv::DtSettingsBackup::backupName ( ) const
virtual

Returns a more readable backup name (for dialogs). Will return backupClassType by default.

Reimplemented in makVrv::DtCigiSettingsBackup, makVrv::DtSharedRecordSettingsBackup< SettingsClass, ArchiveClass >, makVrv::DtKeyMapSettingsBackup, makVrv::DtRecordSettingsBackupInterface, and makVrv::DtModelDefinitionManagerBackup.

void makVrv::DtSettingsBackup::setBackupsPath ( const std::string &  s)
inline
const std::string& makVrv::DtSettingsBackup::backupsPath ( ) const
inline
void makVrv::DtSettingsBackup::setFactoryFile ( const std::string &  s)
inline

Referenced by makVrv::DtBaseSettingsManager< makArchives::DtOculusSettingsRecord >::initializeBackup(), and makVrv::DtBaseSharedSettingsManager< makArchives::DtSymbolDecorationSettingsRecord, DtSymbolDecorationSettings >::initializeBackup().

const std::string& makVrv::DtSettingsBackup::factoryFile ( ) const
inline
void makVrv::DtSettingsBackup::setFactoryDir ( const std::string &  dir)
inline
const std::string& makVrv::DtSettingsBackup::factoryDir ( ) const
inline
void makVrv::DtSettingsBackup::setBackupDir ( const std::string &  dir)
inline
const std::string& makVrv::DtSettingsBackup::backupDir ( ) const
inline
virtual bool makVrv::DtSettingsBackup::restore ( bool  fromFactory,
std::vector< DtSettingsBackup * > &  hasBeenRestored,
bool  selectedOnly 
)
protectedvirtual

Restores from startup (false) or factory (true) file.

Member Data Documentation

boost::signalslib::signal<void (const DtSettingsBackup*)> makVrv::DtSettingsBackup::signal_destructing

Called when destructing. If registered with shared manager will remove item.

boost::signalslib::signal<void (const DtSettingsBackup*)> makVrv::DtSettingsBackup::signal_backupCleared
boost::signalslib::signal<void (const DtSettingsBackup*)> makVrv::DtSettingsBackup::signal_backedUp
boost::signalslib::signal<void (const DtSettingsBackup*)> makVrv::DtSettingsBackup::signal_restored
bool makVrv::DtSettingsBackup::myManagerDestroyed
protected
RestoreWhenRestored makVrv::DtSettingsBackup::myRestoreWhenRestored
protected
std::string makVrv::DtSettingsBackup::myBackupFile
protected
std::string makVrv::DtSettingsBackup::myFactoryFile
protected
std::string makVrv::DtSettingsBackup::myBackupsPath
protected
std::string makVrv::DtSettingsBackup::myBackupDir
protected
std::string makVrv::DtSettingsBackup::myFactoryDir
protected
The documentation for this class was generated from the following file:
Document ID: Generated on Thu Oct 23 22:29:17 EDT 2025 from SVN revision 280951
Copyright © 2005-2024 MAK Technologies. All Rights Reserved (www.mak.com)