log4cplus是什么?
详情见网页:log4cplus
log4cplus如何应用到MXCity2.0
- 为方便使用,作了简单的抽象,定义在根目录的common_files的log.h和log.cpp中,方便主程序和插件包含
- log.h作了简单的变量申明、函数申明以及使用了更加简单的宏,具体实现见log.cpp
#pragma once
#include <log4cplus\logger.h>
#include <log4cplus\loggingmacros.h>
// global object
extern log4cplus::Logger logger;
// define some macros for simplicity
#define LOG_TRACE(logEvent) LOG4CPLUS_TRACE(logger, logEvent)
#define LOG_DEBUG(logEvent) LOG4CPLUS_DEBUG(logger, logEvent)
#define LOG_INFO(logEvent) LOG4CPLUS_INFO(logger, logEvent)
#define LOG_WARN(logEvent) LOG4CPLUS_WARN(logger, logEvent)
#define LOG_ERROR(logEvent) LOG4CPLUS_ERROR(logger, logEvent)
#define LOG_FATAL(logEvent) LOG4CPLUS_FATAL(logger, logEvent)
extern void initLogger(std::string configFilePath);
- 日志的输出频率、文件名称、输出样式可以通过程序控制,也可以通过配置文件。我们选择的是配置文件的方式:
log4cplus.rootLogger=TRACE, R
log4cplus.appender.R=log4cplus::DailyRollingFileAppender
log4cplus.appender.R.File=logs/client.log
log4cplus.appender.R.Schedule=MONTHLY
log4cplus.appender.R.Append=true
log4cplus.appender.R.MaxFileSize=10MB
log4cplus.appender.R.MaxBackupIndex=5
log4cplus.appender.R.layout=log4cplus::PatternLayout
log4cplus.appender.R.layout.ConversionPattern=[%D{%Y-%m-%d %H:%M:%S:%Q}] [%-5p] - %m [%l] [%t]%n
上述配置表示,以月为单位的频度输出日志,文件最大10M,超出部分会转存到新文件,最多文件个数为5+1=6个,超过将只保留最新的6个文件。输出样式为:
[2017-12-08 14:53:25:176.384] [TRACE] - Test [E:\mxcity2.0\Desktop-Platform\platform\main.cpp:16] [6628]
[2017-12-08 14:53:25:176.580] [DEBUG] - This is a test [E:\mxcity2.0\Desktop-Platform\platform\main.cpp:17] [6628]
[2017-12-08 14:53:25:176.673] [INFO ] - shenzhen [E:\mxcity2.0\Desktop-Platform\platform\main.cpp:18] [6628]
[2017-12-08 14:53:25:176.745] [ERROR] - Hello world [E:\mxcity2.0\Desktop-Platform\platform\main.cpp:19] [6628]
[2017-12-08 14:53:25:176.813] [FATAL] - What is happening [E:\mxcity2.0\Desktop-Platform\platform\main.cpp:20] [6628]
依次为日期,时间(精确到毫秒),日志级别,真正的输出信息,logger实例所在的文件及行号,线程实例号
- 实际使用:log4cplus库的初始化操作会放在platform中,插件不需要再作初始化,
std::string runtimePath = QDir::toNativeSeparators(QCoreApplication::applicationDirPath() + QDir::separator()).toStdString();
std::string configFilePath = runtimePath + std::string("log4cplus.cfg");
initLogger(configFilePath);
插件需要做的是:在对应的CMakeLists.txt文件中添加log.h、log.cpp以及log4cplus依赖,
set(${target}_HEADERS
../../common_files/log.h
)
set(${target}_SOURCES
../../common_files/log.cpp
)
import_custom_library(${target} Log4cplus)
然后在需要打日志的地方,包含log.h文件,使用LOG_TRACE,LOG_DEBUG,LOG_INFO,LOG_ERROR,LOG_FATAL宏即可
- Good luck, guys