X-Git-Url: https://git.quassel-irc.org/?p=quassel.git;a=blobdiff_plain;f=src%2Fcommon%2Flogger.h;h=751fa05f8813d07762d19ddfd87eaae11cd1a300;hp=2caa5d39d5abe9287f95d2f354eb57de2f7bdbc8;hb=95848fd9232d92f388e0e533adb15f6ba9d2d492;hpb=372d56eee63dc08b85bd4877226582bef76fc1e4 diff --git a/src/common/logger.h b/src/common/logger.h index 2caa5d39..751fa05f 100644 --- a/src/common/logger.h +++ b/src/common/logger.h @@ -1,5 +1,5 @@ /*************************************************************************** - * Copyright (C) 2005-2014 by the Quassel Project * + * Copyright (C) 2005-2018 by the Quassel Project * * devel@quassel-irc.org * * * * This program is free software; you can redistribute it and/or modify * @@ -18,59 +18,99 @@ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. * ***************************************************************************/ -#ifndef LOGGER_H -#define LOGGER_H +#pragma once -#include -#include +#include "common-export.h" -#include "quassel.h" -#include "types.h" +#include -class Logger +#include +#include +#include +#include +#include + +/** + * The Logger class encapsulates the various configured logging backends. + */ +class COMMON_EXPORT Logger : public QObject { + Q_OBJECT + public: - inline Logger(Quassel::LogLevel level) : _stream(&_buffer, QIODevice::WriteOnly), _logLevel(level) {} - ~Logger(); + Logger(QObject* parent = nullptr); + ~Logger() override; -#if QT_VERSION < 0x050000 - static void logMessage(QtMsgType type, const char *msg); -#else - static void logMessage(QtMsgType, const QMessageLogContext&, const QString&); -#endif + enum class LogLevel + { + Debug, + Info, + Warning, + Error, + Fatal + }; - template - inline Logger &operator<<(const T &value) { _stream << value << " "; return *this; } - inline Logger &operator<<(const QStringList &t) { _stream << t.join(" ") << " "; return *this; } - inline Logger &operator<<(bool t) { _stream << (t ? "true" : "false") << " "; return *this; } + struct LogEntry + { + QDateTime timeStamp; + LogLevel logLevel; + QString message; + }; -private: - void log(); - QTextStream _stream; - QString _buffer; - Quassel::LogLevel _logLevel; -}; + /** + * Initial setup, to be called ones command line options are available. + * + * Sets up the log file if appropriate. Outputs the log messages already accumulated since + * construction. If @c keepMessages is false, deletes the accumulated messages afterwards, + * and won't store further ones. + * + * @param keepMessages Whether messages should be kept + * @throws ExitException, if command line options are invalid + */ + void setup(bool keepMessages); + /** + * Accesses the stores log messages, e.g. for consumption by DebugLogWidget. + * + * @returns The accumuates log messages + */ + std::vector messages() const; -class quInfo : public Logger -{ -public: - inline quInfo() : Logger(Quassel::InfoLevel) {} -}; + static void messageHandler(QtMsgType type, const QMessageLogContext& context, const QString& message); + /** + * Takes the given message with the given log level, formats it and emits the @a messageLogged() signal. + * + * @note This method is thread-safe. + * + * @param logLevel The log leve of the message + * @param message The message + */ + void handleMessage(LogLevel logLevel, const QString& message); -class quWarning : public Logger -{ -public: - inline quWarning() : Logger(Quassel::WarningLevel) {} -}; +signals: + /** + * Emitted whenever a message was logged. + * + * @param message The message that was logged + */ + void messageLogged(const Logger::LogEntry& message); +private slots: + void onMessageLogged(const Logger::LogEntry& message); -class quError : public Logger -{ -public: - inline quError() : Logger(Quassel::ErrorLevel) {} -}; +private: + void handleMessage(QtMsgType type, const QString& message); + void outputMessage(const LogEntry& message); + +private: + LogLevel _outputLevel{LogLevel::Info}; + QFile _logFile; + bool _syslogEnabled{false}; + std::vector _messages; + bool _keepMessages{true}; + bool _initialized{false}; +}; -#endif +Q_DECLARE_METATYPE(Logger::LogEntry)