crawlservpp::Wrapper::DatabaseLock< DB > Class Template Reference

Template class for safe in-scope database locks. More...

#include <DatabaseLock.hpp>

Construction and Destruction
	DatabaseLock (DB &db, const std::string &lockName, IsRunningCallback isRunningCallback)
	Constructor locking the database after waiting for another lock if necessary. More...
virtual	~DatabaseLock ()
	Destructor unlocking the database. More...

Getter
bool	isActive () const noexcept
	Checks the status of the database lock. More...

Copy and Move
The class is not copyable, only moveable.
	DatabaseLock (DatabaseLock &)=delete
	Deleted copy constructor. More...
DatabaseLock &	operator= (DatabaseLock &)=delete
	Deleted copy assignment operator. More...
	DatabaseLock (DatabaseLock &&other) noexcept
	Move constructor. More...
DatabaseLock &	operator= (DatabaseLock &&other) noexcept
	Move assignment operator. More...

Detailed Description

template<class DB>
class crawlservpp::Wrapper::DatabaseLock< DB >

Template class for safe in-scope database locks.

Locks the database for specific actions on construction, unlocks it on destruction.

Template Parameters

DB	Database connection to be used for the lock. Must implement the member functions addDatabaseLock() and removeDatabaseLock(), i.e. inherit from Main::Database.

Constructor & Destructor Documentation

DatabaseLock() [1/3]

template<class DB >

crawlservpp::Wrapper::DatabaseLock< DB >::DatabaseLock ( DB &  db, const std::string &  lockName, IsRunningCallback  isRunningCallback  )

inline

Constructor locking the database after waiting for another lock if necessary.

If no other lock with the same name is active, the database will be locked by calling an implementation of Main::Database::addDatabaseLock.

Otherwise, the constructor will wait for the other lock to be released.

Parameters

db	The database connection to use.
lockName	The name of the lock. If there is another DatabaseLock active with the same name, the constructor will wait until it is destructed.
isRunningCallback	A function that returns whether both the current thread and program are still running.

Referenced by crawlservpp::Wrapper::DatabaseLock< DB >::isActive().

~DatabaseLock()

template<class DB >

virtual crawlservpp::Wrapper::DatabaseLock< DB >::~DatabaseLock ( )

inlinevirtual

Destructor unlocking the database.

If the constructor was successful in locking the database, the lock will be removed by calling an implementation of Main::Database::removeDatabaseLock.

DatabaseLock() [2/3]

template<class DB >

crawlservpp::Wrapper::DatabaseLock< DB >::DatabaseLock ( DatabaseLock< DB > &  )

delete

Deleted copy constructor.

DatabaseLock() [3/3]

template<class DB >

crawlservpp::Wrapper::DatabaseLock< DB >::DatabaseLock ( DatabaseLock< DB > &&  other )

inlinenoexcept

Move constructor.

Moves the database lock from the specified location into this instance of the class.

Note

The other lock will be invalidated by this move.

Parameters

other

The database lock to move from.

Member Function Documentation

isActive()

template<class DB >

bool crawlservpp::Wrapper::DatabaseLock< DB >::isActive ( ) const

inlinenoexcept

Checks the status of the database lock.

Returns

True if the lock is active. False otherwise.

References crawlservpp::Wrapper::DatabaseLock< DB >::DatabaseLock(), and crawlservpp::Wrapper::DatabaseLock< DB >::operator=().

operator=() [1/2]

template<class DB >

DatabaseLock& crawlservpp::Wrapper::DatabaseLock< DB >::operator= ( DatabaseLock< DB > &  )

delete

Deleted copy assignment operator.

Referenced by crawlservpp::Wrapper::DatabaseLock< DB >::isActive().

operator=() [2/2]

template<class DB >

DatabaseLock& crawlservpp::Wrapper::DatabaseLock< DB >::operator= ( DatabaseLock< DB > &&  other )

inlinenoexcept

Move assignment operator.

Moves the database lock from the specified location into this instance of the class.

If the current instance already holds a database lock, it will be released before moving in the other lock.

Note

The other lock will be invalidated by this move.

Nothing will be done if used on itself.

Parameters

other

The database lock to move from.

Returns

A reference to the instance containing the database lock after moving (i.e. *this).

---

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

• Wrapper/DatabaseLock.hpp