Database logger - logs to the MythTV database. More...

#include <loggingserver.h>

Inheritance diagram for DatabaseLogger:

Collaboration diagram for DatabaseLogger:

[legend]

Public Member Functions
	DatabaseLogger (const char *table)
	DatabaseLogger constructor. More...

	~DatabaseLogger () override
	DatabaseLogger deconstructor. More...

bool	logmsg (LoggingItem *item) override
	Process a log message, queuing it for logging to the database. More...

void	reopen (void) override
	Reopen the log file to facilitate log rolling. More...

void	stopDatabaseAccess (void) override
	Stop logging to the database and wait for the thread to stop. More...

Public Member Functions inherited from LoggerBase
	LoggerBase (const char *string)
	LoggerBase Constructor. More...

	~LoggerBase () override
	LoggerBase Deconstructor. More...

Static Public Member Functions
static DatabaseLogger *	create (const QString &table, QMutex *mutex)

Protected Member Functions
bool	logqmsg (MSqlQuery &query, LoggingItem *item)
	Actually insert a log message from the queue into the database. More...

void	prepare (MSqlQuery &query)
	Prepare the database query for use, and bind constant values to it. More...

Private Member Functions
bool	isDatabaseReady (void)
	Check if the database is ready for use. More...

Static Private Member Functions
static bool	tableExists (const QString &table)
	Checks whether table exists and is ready for writing. More...

Private Attributes
DBLoggerThread *	m_thread
	The database queue handling thread. More...

QString	m_query
	The database query to insert log messages. More...

bool	m_opened {true}
	The database is opened. More...

bool	m_loggingTableExists {false}
	The desired logging table exists. More...

QElapsedTimer	m_disabledTime
	Elapsed time since the DB logging was disabled. More...

QElapsedTimer	m_errorLoggingTime
	Elapsed time since DB error logging was last done. More...

Static Private Attributes
static constexpr std::chrono::milliseconds	kMinDisabledTime {1s}
	Minimum time to disable DB logging. More...

Friends
class	DBLoggerThread

Additional Inherited Members
Protected Attributes inherited from LoggerBase
QString	m_handle {}
	semi-opaque handle for identifying instance More...

Detailed Description

Database logger - logs to the MythTV database.

Definition at line 99 of file loggingserver.h.

Constructor & Destructor Documentation

◆ DatabaseLogger()

DatabaseLogger::DatabaseLogger ( const char * table )

explicit

DatabaseLogger constructor.

Parameters

table C-string of the database table to log to

Definition at line 317 of file loggingserver.cpp.

Referenced by create().

◆ ~DatabaseLogger()

DatabaseLogger::~DatabaseLogger ( )

override

DatabaseLogger deconstructor.

Definition at line 336 of file loggingserver.cpp.

Member Function Documentation

◆ logmsg()

bool DatabaseLogger::logmsg ( LoggingItem * item )

overridevirtual

Process a log message, queuing it for logging to the database.

Parameters

item	LoggingItem containing the log message to process

Implements LoggerBase.

Definition at line 378 of file loggingserver.cpp.

◆ reopen()

void DatabaseLogger::reopen ( void )

inlineoverridevirtual

Reopen the log file to facilitate log rolling.

Implements LoggerBase.

Definition at line 108 of file loggingserver.h.

◆ stopDatabaseAccess()

void DatabaseLogger::stopDatabaseAccess ( void )

overridevirtual

Stop logging to the database and wait for the thread to stop.

Reimplemented from LoggerBase.

Definition at line 365 of file loggingserver.cpp.

Referenced by ~DatabaseLogger().

◆ create()

DatabaseLogger * DatabaseLogger::create	(	const QString &	table,
		QMutex *	mutex
	)

static

Definition at line 343 of file loggingserver.cpp.

Referenced by LogForwardThread::forwardMessage().

◆ logqmsg()

bool DatabaseLogger::logqmsg	(	MSqlQuery &	query,
		LoggingItem *	item
	)

protected

Actually insert a log message from the queue into the database.

Parameters

query	The database insert query to use
item	LoggingItem containing the log message to insert

Definition at line 416 of file loggingserver.cpp.

Referenced by DBLoggerThread::run().

◆ prepare()

void DatabaseLogger::prepare ( MSqlQuery & query )

protected

Prepare the database query for use, and bind constant values to it.

Parameters

query The database query to prepare

Definition at line 454 of file loggingserver.cpp.

Referenced by DBLoggerThread::run().

◆ isDatabaseReady()

bool DatabaseLogger::isDatabaseReady ( void )

private

Check if the database is ready for use.

Returns: true when database is ready, false otherwise

Definition at line 462 of file loggingserver.cpp.

Referenced by logmsg(), and DBLoggerThread::run().

◆ tableExists()

bool DatabaseLogger::tableExists ( const QString & table )

staticprivate

Checks whether table exists and is ready for writing.

Parameters

table The name of the table to check (without schema name)

Returns: true if table exists in schema or false if not

Definition at line 482 of file loggingserver.cpp.

Referenced by isDatabaseReady().

Friends And Related Function Documentation

◆ DBLoggerThread

friend class DBLoggerThread

friend

Definition at line 103 of file loggingserver.h.

Referenced by DatabaseLogger().

Member Data Documentation

◆ m_thread

DBLoggerThread* DatabaseLogger::m_thread

private

The database queue handling thread.

Definition at line 118 of file loggingserver.h.

Referenced by DatabaseLogger(), logmsg(), and stopDatabaseAccess().

◆ m_query

QString DatabaseLogger::m_query

private

The database query to insert log messages.

Definition at line 119 of file loggingserver.h.

Referenced by DatabaseLogger(), and prepare().

◆ m_opened

bool DatabaseLogger::m_opened {true}

private

The database is opened.

Definition at line 120 of file loggingserver.h.

◆ m_loggingTableExists

bool DatabaseLogger::m_loggingTableExists {false}

private

The desired logging table exists.

Definition at line 121 of file loggingserver.h.

Referenced by isDatabaseReady().

◆ m_disabledTime

QElapsedTimer DatabaseLogger::m_disabledTime

private

Elapsed time since the DB logging was disabled.

Definition at line 122 of file loggingserver.h.

Referenced by logmsg().

◆ m_errorLoggingTime

QElapsedTimer DatabaseLogger::m_errorLoggingTime

private

Elapsed time since DB error logging was last done.

Definition at line 123 of file loggingserver.h.

Referenced by logqmsg().

◆ kMinDisabledTime

constexpr std::chrono::milliseconds DatabaseLogger::kMinDisabledTime {1s}

staticconstexprprivate

Minimum time to disable DB logging.

Definition at line 124 of file loggingserver.h.

Referenced by logmsg().

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

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Friends

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ DatabaseLogger()

◆ ~DatabaseLogger()

Member Function Documentation

◆ logmsg()

◆ reopen()

◆ stopDatabaseAccess()

◆ create()

◆ logqmsg()

◆ prepare()

◆ isDatabaseReady()

◆ tableExists()

Friends And Related Function Documentation

◆ DBLoggerThread

Member Data Documentation

◆ m_thread

◆ m_query

◆ m_opened

◆ m_loggingTableExists

◆ m_disabledTime

◆ m_errorLoggingTime

◆ kMinDisabledTime