/* * CLogger.h, part of VCMI engine * * Authors: listed in file AUTHORS in main folder * * License: GNU General Public License v2.0 or later * Full text of license available in license.txt file, in main folder * */ #pragma once #include "../CConsoleHandler.h" VCMI_LIB_NAMESPACE_BEGIN class CLogger; struct LogRecord; class ILogTarget; namespace ELogLevel { #ifdef VCMI_ANDROID int toAndroid(ELogLevel logLevel); #endif } /// The class CLoggerDomain provides convenient access to super domains from a sub domain. class DLL_LINKAGE CLoggerDomain { public: /// Constructs a CLoggerDomain with the domain designated by name. /// Sub-domains can be specified by separating domains by a dot, e.g. "ai.battle". The global domain is named "global". explicit CLoggerDomain(std::string name); const std::string& getName() const; CLoggerDomain getParent() const; bool isGlobalDomain() const; static const std::string DOMAIN_GLOBAL; private: std::string name; }; /// The logger is used to log messages to certain targets of a specific domain/name. /// It is thread-safe and can be used concurrently by several threads. class DLL_LINKAGE CLogger: public vstd::CLoggerBase { public: ELogLevel::ELogLevel getLevel() const; void setLevel(ELogLevel::ELogLevel level); const CLoggerDomain & getDomain() const; /// Logger access methods static CLogger * getLogger(const CLoggerDomain & domain); static CLogger * getGlobalLogger(); void log(ELogLevel::ELogLevel level, const std::string & message) const override; void log(ELogLevel::ELogLevel level, const boost::format & fmt) const override; void addTarget(std::unique_ptr && target); void clearTargets(); /// Returns true if a debug/trace log message will be logged, false if not. /// Useful if performance is important and concatenating the log message is a expensive task. bool isDebugEnabled() const override; bool isTraceEnabled() const override; private: explicit CLogger(const CLoggerDomain & domain); inline ELogLevel::ELogLevel getEffectiveLevel() const; /// Returns the log level applied on this logger whether directly or indirectly. inline void callTargets(const LogRecord & record) const; CLoggerDomain domain; CLogger * parent; ELogLevel::ELogLevel level; std::vector > targets; mutable std::mutex mx; static std::recursive_mutex smx; }; /* ---------------------------------------------------------------------------- */ /* Implementation/Detail classes, Private API */ /* ---------------------------------------------------------------------------- */ /// The class CLogManager is a global storage for logger objects. class DLL_LINKAGE CLogManager : public boost::noncopyable { public: static CLogManager & get(); void addLogger(CLogger * logger); CLogger * getLogger(const CLoggerDomain & domain); /// Returns a logger or nullptr if no one is registered for the given domain. std::vector getRegisteredDomains() const; private: CLogManager(); virtual ~CLogManager(); std::map loggers; mutable std::mutex mx; static std::recursive_mutex smx; }; /// The struct LogRecord holds the log message and additional logging information. struct DLL_LINKAGE LogRecord { LogRecord(const CLoggerDomain & domain, ELogLevel::ELogLevel level, const std::string & message) : domain(domain), level(level), message(message), timeStamp(boost::posix_time::microsec_clock::local_time()), threadId(boost::lexical_cast(boost::this_thread::get_id())) { } CLoggerDomain domain; ELogLevel::ELogLevel level; std::string message; boost::posix_time::ptime timeStamp; std::string threadId; }; /// The class CLogFormatter formats log records. /// /// There are several pattern characters which can be used to format a log record: /// %d = Date/Time /// %l = Log level /// %n = Logger name /// %t = Thread ID /// %m = Message class DLL_LINKAGE CLogFormatter { public: CLogFormatter(); CLogFormatter(std::string pattern); void setPattern(const std::string & pattern); void setPattern(std::string && pattern); const std::string & getPattern() const; std::string format(const LogRecord & record) const; private: std::string pattern; }; /// The interface ILogTarget is used by all log target implementations. It holds /// the abstract method write which sub-classes should implement. class DLL_LINKAGE ILogTarget : public boost::noncopyable { public: virtual ~ILogTarget() { }; virtual void write(const LogRecord & record) = 0; }; /// The class CColorMapping maps a logger name and a level to a specific color. Supports domain inheritance. class DLL_LINKAGE CColorMapping { public: CColorMapping(); void setColorFor(const CLoggerDomain & domain, ELogLevel::ELogLevel level, EConsoleTextColor::EConsoleTextColor color); EConsoleTextColor::EConsoleTextColor getColorFor(const CLoggerDomain & domain, ELogLevel::ELogLevel level) const; private: std::map > map; }; /// This target is a logging target which writes message to the console. /// The target may be shared among multiple loggers. All methods except write aren't thread-safe. /// The console target is intended to be configured once and then added to a logger. class DLL_LINKAGE CLogConsoleTarget : public ILogTarget { public: explicit CLogConsoleTarget(CConsoleHandler * console); bool isColoredOutputEnabled() const; void setColoredOutputEnabled(bool coloredOutputEnabled); ELogLevel::ELogLevel getThreshold() const; void setThreshold(ELogLevel::ELogLevel threshold); const CLogFormatter & getFormatter() const; void setFormatter(const CLogFormatter & formatter); const CColorMapping & getColorMapping() const; void setColorMapping(const CColorMapping & colorMapping); void write(const LogRecord & record) override; private: #if !defined(VCMI_MOBILE) CConsoleHandler * console; #endif ELogLevel::ELogLevel threshold; bool coloredOutputEnabled; CLogFormatter formatter; CColorMapping colorMapping; mutable std::mutex mx; }; /// This target is a logging target which writes messages to a log file. /// The target may be shared among multiple loggers. All methods except write aren't thread-safe. /// The file target is intended to be configured once and then added to a logger. class DLL_LINKAGE CLogFileTarget : public ILogTarget { public: /// Constructs a CLogFileTarget and opens the file designated by filePath. If the append parameter is true, the file /// will be appended to. Otherwise the file designated by filePath will be truncated before being opened. explicit CLogFileTarget(const boost::filesystem::path & filePath, bool append = true); ~CLogFileTarget(); const CLogFormatter & getFormatter() const; void setFormatter(const CLogFormatter & formatter); void write(const LogRecord & record) override; private: boost::filesystem::fstream file; CLogFormatter formatter; mutable std::mutex mx; }; VCMI_LIB_NAMESPACE_END