TransactionalFileSystem Class Reference

Special FileSystem implementation for libraries and projects. More...

#include <transactionalfilesystem.h>

Inheritance diagram for TransactionalFileSystem:

Collaboration diagram for TransactionalFileSystem:

Public Types
enum	RestoreMode

Public Member Functions
	TransactionalFileSystem ()=delete
	TransactionalFileSystem (const FilePath &filepath, bool writable=false, RestoreMode restoreMode=RestoreMode::NO, QObject *parent=nullptr)
	TransactionalFileSystem (const TransactionalFileSystem &other)=delete
virtual	~TransactionalFileSystem () noexcept
const FilePath &	getPath () const noexcept
bool	isWritable () const noexcept
bool	isRestoredFromAutosave () const noexcept
virtual FilePath	getAbsPath (const QString &path="") const noexcept override
virtual QStringList	getDirs (const QString &path="") const noexcept override
virtual QStringList	getFiles (const QString &path="") const noexcept override
virtual bool	fileExists (const QString &path) const noexcept override
virtual QByteArray	read (const QString &path) const override
virtual void	write (const QString &path, const QByteArray &content) override
virtual void	removeFile (const QString &path) override
virtual void	removeDirRecursively (const QString &path="") override
void	loadFromZip (const FilePath &fp)
void	exportToZip (const FilePath &fp) const
void	discardChanges () noexcept
QStringList	checkForModifications () const
void	autosave ()
void	save ()
Public Member Functions inherited from FileSystem
	FileSystem (QObject *parent=nullptr) noexcept
virtual	~FileSystem () noexcept

Static Public Member Functions
static std::shared_ptr< TransactionalFileSystem >	open (const FilePath &filepath, bool writable, RestoreMode restoreMode=RestoreMode::NO, QObject *parent=nullptr)
static std::shared_ptr< TransactionalFileSystem >	openRO (const FilePath &filepath, RestoreMode restoreMode=RestoreMode::NO, QObject *parent=nullptr)
static std::shared_ptr< TransactionalFileSystem >	openRW (const FilePath &filepath, RestoreMode restoreMode=RestoreMode::NO, QObject *parent=nullptr)
static QString	cleanPath (QString path) noexcept

Private Member Functions
bool	isRemoved (const QString &path) const noexcept
void	exportDirToZip (QuaZipFile &file, const FilePath &zipFp, const QString &dir) const
void	saveDiff (const QString &type) const
void	loadDiff (const FilePath &fp)
void	removeDiff (const QString &type)

Private Attributes
FilePath	mFilePath
bool	mIsWritable
DirectoryLock	mLock
bool	mRestoredFromAutosave
QHash< QString, QByteArray >	mModifiedFiles
QSet< QString >	mRemovedFiles
QSet< QString >	mRemovedDirs

Detailed Description

Special FileSystem implementation for libraries and projects.

This is an implementation of the librepcb::FileSystem interface with many features needed to create, open and save LibrePCB library elements and projects in a very safe way to always guarantee consistency of all files.

It handles following things:

• Supports read-only access to the file system to guarantee absolutely nothing is written to the disk.
• In R/W mode, it locks the accessed directory to avoid parallel usage (see Avoid opening a project multiple times (Directory Lock))
• Supports periodic saving to allow restoring the last autosave backup after an application crash (see Automatic Periodic Saving (autosave)).
• Holds all file modifications in memory and allows to write those in an atomic way to the disk (see Atomic Saving Procedure).
• Allows to export the whole file system to a ZIP file.

Member Enumeration Documentation

RestoreMode

enum RestoreMode

strong

Enumerator
NO	Do not restore the backup.
YES	Restore backup if available.
ASK	Ask (with QMessageBox) whether to restore or not.
ABORT	Throw a RuntimeError if a backup exists.

Constructor & Destructor Documentation

TransactionalFileSystem() [1/3]

TransactionalFileSystem ( )

delete

TransactionalFileSystem() [2/3]

TransactionalFileSystem	(	const FilePath &	filepath,
		bool	writable = false,
		RestoreMode	restoreMode = RestoreMode::NO,
		QObject *	parent = nullptr
	)

Here is the call graph for this function:

TransactionalFileSystem() [3/3]

TransactionalFileSystem ( const TransactionalFileSystem &  other )

delete

~TransactionalFileSystem()

~TransactionalFileSystem ( )

virtualnoexcept

Here is the call graph for this function:

Member Function Documentation

getPath()

const FilePath& getPath ( ) const

inlinenoexcept

Here is the caller graph for this function:

isWritable()

bool isWritable ( ) const

inlinenoexcept

isRestoredFromAutosave()

bool isRestoredFromAutosave ( ) const

inlinenoexcept

Here is the call graph for this function:

getAbsPath()

FilePath getAbsPath ( const QString &  path = "" ) const

overridevirtualnoexcept

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

getDirs()

QStringList getDirs ( const QString &  path = "" ) const

overridevirtualnoexcept

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

getFiles()

QStringList getFiles ( const QString &  path = "" ) const

overridevirtualnoexcept

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

fileExists()

bool fileExists ( const QString &  path ) const

overridevirtualnoexcept

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

read()

QByteArray read ( const QString &  path ) const

overridevirtual

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

write()

void write ( const QString &  path, const QByteArray &  content  )

overridevirtual

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

removeFile()

void removeFile ( const QString &  path )

overridevirtual

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

removeDirRecursively()

void removeDirRecursively ( const QString &  path = "" )

overridevirtual

Implements FileSystem.

Here is the call graph for this function:

Here is the caller graph for this function:

loadFromZip()

void loadFromZip

(

const FilePath &

fp

)

Here is the call graph for this function:

Here is the caller graph for this function:

exportToZip()

void exportToZip

(

const FilePath &

fp

)

const

Here is the call graph for this function:

Here is the caller graph for this function:

discardChanges()

void discardChanges ( )

noexcept

Here is the caller graph for this function:

checkForModifications()

QStringList checkForModifications

(

)

const

Here is the call graph for this function:

Here is the caller graph for this function:

autosave()

void autosave

(

)

Here is the call graph for this function:

Here is the caller graph for this function:

save()

void save

(

)

Here is the call graph for this function:

Here is the caller graph for this function:

open()

static std::shared_ptr<TransactionalFileSystem> open ( const FilePath &  filepath, bool  writable, RestoreMode  restoreMode = RestoreMode::NO, QObject *  parent = nullptr  )

inlinestatic

Here is the caller graph for this function:

openRO()

static std::shared_ptr<TransactionalFileSystem> openRO ( const FilePath &  filepath, RestoreMode  restoreMode = RestoreMode::NO, QObject *  parent = nullptr  )

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

openRW()

static std::shared_ptr<TransactionalFileSystem> openRW ( const FilePath &  filepath, RestoreMode  restoreMode = RestoreMode::NO, QObject *  parent = nullptr  )

inlinestatic

Here is the call graph for this function:

Here is the caller graph for this function:

cleanPath()

QString cleanPath ( QString  path )

staticnoexcept

Here is the caller graph for this function:

isRemoved()

bool isRemoved ( const QString &  path ) const

privatenoexcept

Here is the caller graph for this function:

exportDirToZip()

void exportDirToZip ( QuaZipFile &  file, const FilePath &  zipFp, const QString &  dir  ) const

private

Here is the call graph for this function:

Here is the caller graph for this function:

saveDiff()

void saveDiff ( const QString &  type ) const

private

Here is the call graph for this function:

Here is the caller graph for this function:

loadDiff()

void loadDiff ( const FilePath &  fp )

private

Here is the call graph for this function:

Here is the caller graph for this function:

removeDiff()

void removeDiff ( const QString &  type )

private

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

mFilePath

FilePath mFilePath

private

mIsWritable

bool mIsWritable

private

mLock

DirectoryLock mLock

private

mRestoredFromAutosave

bool mRestoredFromAutosave

private

mModifiedFiles

QHash<QString, QByteArray> mModifiedFiles

private

mRemovedFiles

QSet<QString> mRemovedFiles

private

mRemovedDirs

QSet<QString> mRemovedDirs

private

---

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

• /__w/1/s/libs/librepcb/common/fileio/transactionalfilesystem.h
• /__w/1/s/libs/librepcb/common/fileio/transactionalfilesystem.cpp