Apache log4cxx用法

一个好的系统通常需要日志输出帮助定位问题 。Apache基金会的log4cxx提供的完善的Log分级和输出功能。所以准备把该Log模块加入的系统中。

使用log4cxx需要满足一下功能：

1.提供日志分级输出功能

2.能将日志导出到文件

3.每个Log占一行，在每行的前面输出时间，因为很多时候定位问题需要时间值

4. 每天更换日志文件

5.支持线程安全

6.支持用代码配置Log属性

在网上google了很久，都是零散的信息，对于中文网页，千篇一律都是一样的文章。下面介绍log4cxx的用法。

使用log4cxx 需要引入头文件

#include <log4cxx/logger.h> 
#include <log4cxx/helpers/object.h> 
#include <log4cxx/helpers/pool.h> 
#include <log4cxx/basicconfigurator.h> 
#include <log4cxx/PatternLayout.h> 
#include <log4cxx/DailyRollingFileAppender.h>

如果使用到其他log4cxx的类，也需要include对应的头文件。

同时需要将log4cxx.lib添加到工程中，并且将log4cxx.dll拷贝到exe所在目录。

网上很多例子都是用配置文件来设置Log系统，但是使用外部Log文件可能会暴露过多的信息，导致系统风险。所以改用代码中配置。

log4cxx::PatternLayout提供通过字符串格式化日志；

%r [%t] %-5p - %m\n  用来格式化日志

%r  显示从程序启动到记录本日志经历的毫秒数。

%t 输出该日志的线程ID

%-5p 5个字符宽显示日志的优先级

%m 日志消息

\n  换行输出日志

FileAppender是log4cxx中用于配置日志输出到文件的类，FileAppender只能配置固定的文件作为Log输出，但是DailyRollingFileAppender可以用DatePattern来设置Log系统每日更换Log文件。由于软件需要24×7小时运行，所以必须定时更换Log文件，否则单个日志文件会过于庞大。

DatePattern为  '.'yyyy-MM-dd  将会在进入下一天时将前一天的Log文件，如 jianyu.me 更名为 jianyu.me.2013-07-10  这样就避免在同一个Log文件中输出太多Log信息。

"./Log/jianyu.me" 为当前操作的日志文件名，在Log目录下的 jianyu.me文件

使用前需要创建一个LoggerPtr 对象，

例如：

LoggerPtr  m_logger;

使用以下宏来输出Log，这几个宏代表不同的Log等级

LOG4CXX_DEBUG(logger, message) 
LOG4CXX_TRACE(logger, message) 
LOG4CXX_INFO(logger, message) 
LOG4CXX_WARN(logger, message) 
LOG4CXX_ERROR(logger, message)

关于log4cxx编译可以参考另一篇i帖子

代码如下：

#include <log4cxx/logger.h> 
#include <log4cxx/helpers/object.h> 
#include <log4cxx/helpers/pool.h> 
#include <log4cxx/basicconfigurator.h> 
#include <log4cxx/PatternLayout.h> 
#include <log4cxx/DailyRollingFileAppender.h>

using namespace log4cxx; 
using namespace log4cxx::helpers;

#pragma comment(lib, "log4cxx.lib")

LoggerPtr  m_logger;

log4cxx::LogString    logFile(L"./Log/jianyu.me"); 
log4cxx::LogString    patternStr(L"\%r [\%t] \%-5p - \%m\n"); 
log4cxx::LogString    strDatePattern(L"\'.\'yyyy-MM-dd");

log4cxx::FileAppender* fileAppender = new log4cxx::DailyRollingFileAppender( 
    log4cxx::LayoutPtr(new log4cxx::PatternLayout(patternStr)), 
    logFile, strDatePattern); 
log4cxx::helpers::Pool p; 
fileAppender->activateOptions(p);

log4cxx::BasicConfigurator::configure(log4cxx::AppenderPtr(fileAppender)); 
log4cxx::Logger::getRootLogger()->setLevel(log4cxx::Level::getDebug()); 
m_logger = log4cxx::Logger::getLogger("logger");

LOG4CXX_DEBUG(m_logger, strLog);