开源日志库<log4cplus+VS2008使用>整理

由于用eigen库解最小二乘法时间太久了,需要记录下执行时间,于是便使用了现成的log4cplus这个库,下面的教程是我从别人那里转载过来的,稍微有点改动,留个mark,以防来日遗忘!

一.简介

    log4cplus是C++编写的开源的日志系统，功能非常全面.本文介绍如何在Windows+VS2008中使用该日志库。

二.下载

可从网站http://log4cplus.sourceforge.net上去下载 log4cplus 1.0.3 rc9,具体地址
http://downloads.sourceforge.net/log4cplus/log4cplus-1.0.3-rc9.tar.bz2?use_mirror=nchc，同时附件也带有这个库。

三.配置环境
    1. 将库解压到某目录下,我这里的目录为E:\Work_Files\log4cplus-1.0.3-rc9，使用VS2005(没有2005用2008也可以)打开.\msvc8\log4cplus.sln,编译log4cplus_static(Debug_Unicode+Release_Unicode),并将生成的Lib(log4cplusUS.lib+log4cplusUSD.lib)复制到.\Lib目录下。
    2. 将.\Include和.\Lib分别添加到VS2008的搜索路径下。

    3. 在我们的工程中，添加预定义 LOG4CPLUS_STATIC。

    4. 只需要包含相应的头文件和链接相应的库就可以正常的使用log4cplus进行日志的管理了。

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif 

    5.注意编译的库和使用的程序，使用的CRT方式的一致，如下所示：

这里编译库时使用的是MTd方式,那么在使用库的程序中编译时也需要指定该方式,如下图所示:

6.另外还可以使用动态链接的方式去使用log4cplus,这里不介绍了。

四.log4cplus框架

1.log4cplus基本元素

Layouts:控制输出消息的格式。
Appenders:输出位置。
Logger:日志对象。    
Priorities:优先权，包括TRACE, DEBUG,INFO, WARNING, ERROR, FATAL。

2.log4cplus基本结构

3. 使用步骤：
    a.) 生成Appender对象。
    b.) 生成Layout对象，并绑定到Appender。(可选)
    c.) 生成Logger对象。
    d.) 设置Logger优先级。(可选)
    e.) 将需要关联Logger的Appender添加到Logger上。
    f.) 使用Logger输出信息，所有大于设定的优先级的信息，并在所有挂接在该Logger对象上的


Appender上以相应的Layout设定的格式显示出来。

五.log4cplus内容介绍

1. Logger对象
    Logger对象具有层次结构，按名称区分，如下代码：

Logger test = Logger::getInstance("test");Logger subtest = Logger::getInstance("test.subtest");

对象subtest是test的子对象。

2. 优先级


log4cplus优先级有低到高：
NOT_SET_LOG_LEVEL ：接受缺省的LogLevel，如果有父logger则继承它的LogLevel
ALL_LOG_LEVEL     ：开放所有log信息输出    
TRACE_LOG_LEVEL   ：开放trace信息输出(即ALL_LOG_LEVEL)
DEBUG_LOG_LEVEL   ：开放debug信息输出
INFO_LOG_LEVEL    ：开放info信息输出
WARN_LOG_LEVEL    ：开放warning信息输出
ERROR_LOG_LEVEL   ：开放error信息输出
FATAL_LOG_LEVEL   ：开放fatal信息输出
OFF_LOG_LEVEL     ：关闭所有log信息输出
 
    各个logger可以通过setLogLevel设置自己的优先级，当某个logger的LogLevel设置成NOT_SET_LOG_LEVEL时，该logger会继承父logger的优先级，另外，如果定义了重名的多个logger, 对其中任何一个的修改都会同时改变其它logger。

3.Layout格式输出
1.) SimpleLayout 是一种简单格式的布局器，在输出的原始信息之前加上LogLevel和一个"-"。
 
2.) TTCCLayout 其格式由时间，线程ID，Logger和NDC 组成。
 
3.) PatternLayout
    是一种有词法分析功能的模式布局器,类似正则表达式。以“%”作为开头的特殊预定义标识符，将产生特殊的格式信息。
 
（1）"%%"，转义为% 。
（2）"%c"，输出logger名称，如test.subtest。也可以控制logger名称的显示层次，比如"%c{1}"时输出"test"，其中数字表示层次。
（3）"%D"，显示本地时间，比如："2004-10-16 18:55:45"，%d显示标准时间。
可以通过%d{...}定义更详细的显示格式，比如%d{%H:%M:%s}表示要显示小时:分钟:秒。大括号中可显示的预定义标识符如下：   
     
    %a -- 表示礼拜几，英文缩写形式，比如"Fri" 
    %A -- 表示礼拜几，比如"Friday"   
    %b -- 表示几月份，英文缩写形式，比如"Oct"   
    %B -- 表示几月份，"October"  
    %c -- 标准的日期＋时间格式，如 "Sat Oct 16 18:56:19 2004"
    %d -- 表示今天是这个月的几号(1-31)"16"  
    %H -- 表示当前时刻是几时(0-23)，如 "18"  
    %I -- 表示当前时刻是几时(1-12)，如 "6"  
    %j -- 表示今天是哪一天(1-366)，如 "290" 
    %m -- 表示本月是哪一月(1-12)，如 "10" 
    %M -- 表示当前时刻是哪一分钟(0-59)，如 "59"  
    %p -- 表示现在是上午还是下午， AM or PM  
    %q -- 表示当前时刻中毫秒部分(0-999)，如 "237" 
    %Q -- 表示当前时刻中带小数的毫秒部分(0-999.999)，如 "430.732"
    %S -- 表示当前时刻的多少秒(0-59)，如 "32"
    %U -- 表示本周是今年的第几个礼拜，以周日为第一天开始计算(0-53)，如 "41"
    %w -- 表示礼拜几，(0-6, 礼拜天为0)，如 "6"  
    %W -- 表示本周是今年的第几个礼拜，以周一为第一天开始计算(0-53)，如 "41"  
    %x -- 标准的日期格式，如 "10/16/04" 
    %X -- 标准的时间格式，如 "19:02:34"  
    %y -- 两位数的年份(0-99)，如 "04"  
    %Y -- 四位数的年份，如 "2004"  
    %Z -- 时区名，比如 "GMT"
 
（4）"%F"，输出当前记录器所在的文件名称，比如"main.cpp"
（5）"%L"，输出当前记录器所在的文件行号，比如"51"
（6）"%l"，输出当前记录器所在的文件名称和行号，比如"main.cpp:51"
（7）"%m"，输出原始信息。
（8）"%n"，换行符。
（9）"%p"，输出LogLevel，比如"DEBUG"
（10）"%t"，输出记录器所在的线程ID，比如 "1075298944"
（11）"%x"，嵌套诊断上下文NDC (nested diagnostic context) 输出，从堆栈中弹出上下文信息，NDC可以用对不同源的log信息（同时地）交叉输出进行区分。
（12）格式对齐，比如"%-10m"时表示左对齐，宽度是10，当然其它的控制字符也可以相同的方式来使用，比如"%-12d"，"%-5p"等等。

4.) Appender输出位置

（1）控制台输出

ConsoleAppender

（2）文件输出

FileAppender / RollingFileAppender / DailyRollingFileAppender .

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－

FileAppender(filename,mode,immediateFlush);
filename:文件名
mode:文件类型，可选择的文件类型包括app,ate,binary,in,out,trunc。缺省是trunc，表示将先前文件删除。
immediateFlush:缓冲刷新标志.

FileAppender类实现了基本的文件操作功能。

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－       

RollingFileAppender(filename,maxFileSize,maxBackupIndex,immediateFlush)
filename    : 文件名
maxFileSize  : 文件的最大尺寸
maxBackupIndex : 最大记录文件数
immediateFlush : 缓冲刷新标志


RollingFileAppender类可以根据你预先设定的大小来决定是否转储，当超过该大小，后续log信息会另存到新文件中，除了定义每个记录文件的大小之外，你还要确定在RollingFileAppender类对象构造时最多需要多少个这样的记录文件(maxBackupIndex+1)，当存储的文件数目超过maxBackupIndex+1时，会删除最早生成的文件，保证整个文件数目等于maxBackupIndex+1 。

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－
 

DailyRollingFileAppender(filename, schedule,immediateFlush,  maxBackupIndex)
filename       : 文件名
schedule       : 存储频度
immediateFlush : 缓冲刷新标志
maxBackupIndex : 最大记录文件数

DailyRollingFileAppender类可以根据你预先设定的频度来决定是否转储，当超过该频度，后续log信息会另存到新文件中，这里的频度包括：MONTHLY,WEEKLY,DAILY,TWICE_DAILY,HOURLY,MINUTELY。

－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－

六.测试代码
1. 一个基本框架的例子

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif int _tmain(int argc, _TCHAR* argv[]){//定义一个控制台的AppenderSharedAppenderPtr pConsoleAppender(new ConsoleAppender());//定义一个简单的Layout，并绑定到Appenderauto_ptr<Layout> pSimpleLayout(new SimpleLayout());pConsoleAppender->setLayout(pSimpleLayout);//定义Logger,并设置优先级Logger pTestLogger = Logger::getInstance(_T("LoggerName"));pTestLogger.setLogLevel(WARN_LOG_LEVEL); //将需要关联Logger的Appender添加到Logger上pTestLogger.addAppender(pConsoleAppender);//输出日志信息LOG4CPLUS_WARN(pTestLogger, "This is a <Warn> log message...");return 0;}

运行结果如下：

2.一个精简模式的例子

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif int _tmain(int argc, _TCHAR* argv[]){//定义一个控制台的AppenderSharedAppenderPtr pConsoleAppender(new ConsoleAppender());//定义LoggerLogger pTestLogger = Logger::getInstance(_T("LoggerName"));//将需要关联Logger的Appender添加到Logger上pTestLogger.addAppender(pConsoleAppender);//输出日志信息LOG4CPLUS_WARN(pTestLogger, "This is a <Warn> log message...");return 0;}

运行结果如下：

3.输出更多的信息内容

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif int _tmain(int argc, _TCHAR* argv[]){//定义一个控制台的AppenderSharedAppenderPtr pConsoleAppender(new ConsoleAppender());//定义LoggerLogger pTestLogger = Logger::getInstance(_T("LoggerName"));//将需要关联Logger的Appender添加到Logger上pTestLogger.addAppender(pConsoleAppender);int n = 6;TCHAR *p = _T("TestString");//输出日志信息LOG4CPLUS_WARN(pTestLogger, "This is a <Warn> log message..." << n << " " << p);return 0;}

运行结果如下：

4.输出到日志文件

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif int _tmain(int argc, _TCHAR* argv[]){//定义一个文件AppenderSharedAppenderPtr pFileAppender(new FileAppender(_T("TestLog.log")));//该文件将在当前目录下生成//定义LoggerLogger pTestLogger = Logger::getInstance(_T("LoggerName"));//将需要关联Logger的Appender添加到Logger上pTestLogger.addAppender(pFileAppender);//输出日志信息LOG4CPLUS_WARN(pTestLogger, "This is a <Warn> log message...");return 0;}

5.使用更多的格式控制

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif int _tmain(int argc, _TCHAR* argv[]){//定义一个控制台的Appender，三个文件的AppenderSharedAppenderPtr pConsoleAppender(new ConsoleAppender());SharedAppenderPtr pFileAppender1(new FileAppender(_T("D:\\TestLog1.log")));SharedAppenderPtr pFileAppender2(new FileAppender(_T("D:\\TestLog2.log")));SharedAppenderPtr pFileAppender3(new FileAppender(_T("D:\\TestLog3.log")));//定义一个简单的Layout，并绑定到pFileAppender1auto_ptr<Layout> pSimpleLayout(new SimpleLayout());pFileAppender1->setLayout(pSimpleLayout);//定义一个TTCLayout,并绑定到pFileAppender2auto_ptr<Layout> pTTCLayout(new TTCCLayout());pFileAppender2->setLayout(pTTCLayout);//定义一个PatternLayout,并绑定到pFileAppender3auto_ptr<Layout> pPatternLayout(new PatternLayout(_T("%d{%m/%d/%y %H:%M:%S} - %m [%l]%n")));pFileAppender3->setLayout(pPatternLayout);//定义LoggerLogger pTestLogger = Logger::getInstance(_T("LoggerName"));//将需要关联Logger的Appender添加到Logger上pTestLogger.addAppender(pConsoleAppender);pTestLogger.addAppender(pFileAppender1);pTestLogger.addAppender(pFileAppender2);pTestLogger.addAppender(pFileAppender3);//输出日志信息LOG4CPLUS_WARN(pTestLogger, "This is a <Warn> log message...");return 0;}

运行结果如下：

七.把设置移到配置文件中

log4cplus通过PropertyConfigurator类实现了基于脚本配置的功能，通过脚本可以完成对logger、appender和layout的配置。

 配置步骤：
1.配置Appender名称
枚举：

log4cplus.appender.AppenderName1=log4cplus::ConsoleAppender    
log4cplus.appender.AppenderName2=log4cplus::FileAppender    
log4cplus.appender.AppenderName3=log4cplus::RollingFileAppender    
log4cplus.appender.AppenderName4=log4cplus::DailyRollingFileAppender    
log4cplus.appender.AppenderName5=log4cplus::SocketAppender

2.配置Layout


可以选择不设置、TTCCLayout、或PatternLayout

设置TTCCLayout如下所示：
log4cplus.appender.AppenderName.layout=log4cplus::TTCCLayout
设置PatternLayout如下所示：        
log4cplus.appender.AppenderName.layout=log4cplus::PatternLayout        
log4cplus.appender.AppenderName.layout.ConversionPattern=%d{%m/%d/%y %H:%M:%S,%Q} [%t] %-5p -%m%n

3.配置Filter

可选择的Filter: LogLevelMatchFilter,LogLevelRangeFilter和StringMatchFilter.

对LogLevelMatchFilter来说,过滤条件包括LogLevelToMatch和AcceptOnMatch,只有当log信息的LogLevel值与LogLevelToMatch相同，且AcceptOnMatch为true时才会匹配。
对LogLevelRangeFilter来说，过滤条件包括LogLevelMin、LogLevelMax和AcceptOnMatch，只有当log信息的LogLevel在LogLevelMin、LogLevelMax之间同时AcceptOnMatch为true时才会匹配。
对StringMatchFilter来说，过滤条件包括StringToMatch和AcceptOnMatch，只有当log信息的LogLevel值与StringToMatch对应的LogLevel值与相同，且AcceptOnMatch为true时会匹配。

4.配置Logger

对于RootLogger来说：
log4cplus.rootLogger=[LogLevel], appenderName, appenderName, ... 
对于non-root logger来说：
log4cplus.logger.logger_name=[LogLevel|INHERITED], appenderName, ...

5.加载配置

PropertyConfigurator::doConfigure("cfg_filename");

6.举例：
a.) 对Appender,Layout和Filter进行配置。


设置Appender名称及参数，如：
log4cplus.appender.AppenderName=log4cplus::FileAppender
log4cplus.appender.AppenderName.File=d:\testlog.log
 
设置Layout及参数，如：
log4cplus.appender.AppenderName.layout=log4cplus::PatternLayout    
log4cplus.appender.AppenderName.layout.ConversionPattern=%d{%m/%d/%y %H:%M:%S,%Q} [%t] %-5p - %m%n
 
设置Filter及参数，如：
log4cplus.appender.AppenderName.filters.1=log4cplus::spi::LogLevelRangeFilter    
log4cplus.appender.AppenderName.filters.1.LogLevelMin=DEBUG    
log4cplus.appender.AppenderName.filters.1.LogLevelMax=INFO    
log4cplus.appender.AppenderName.filters.1.AcceptOnMatch=true    
log4cplus.appender.AppenderName.filters.2=log4cplus::spi::DenyAllFilter

b.) 设置Logger对象
    log4cplus.rootLogger=TRACE,AppenderName

c.) 将以上配置保存到文件中，比如：d:\log4cplus.cfg 中,以供程序使用

log4cplus.cfg文件内容如下：

log4cplus.appender.AppenderName=log4cplus::FileAppenderlog4cplus.appender.AppenderName.File=d:\TestLog.log log4cplus.appender.AppenderName.layout=log4cplus::PatternLayout    log4cplus.appender.AppenderName.layout.ConversionPattern=%d{%m/%d/%y %H:%M:%S,%Q} [%t] %-5p - %m%n log4cplus.appender.AppenderName.filters.1=log4cplus::spi::LogLevelRangeFilter    log4cplus.appender.AppenderName.filters.1.LogLevelMin=DEBUG    log4cplus.appender.AppenderName.filters.1.LogLevelMax=INFO    log4cplus.appender.AppenderName.filters.1.AcceptOnMatch=true    log4cplus.appender.AppenderName.filters.2=log4cplus::spi::DenyAllFilterlog4cplus.rootLogger=TRACE,AppenderName

源程序如下：

#include <memory>#include <tchar.h>#include <log4cplus/logger.h>#include <log4cplus/fileappender.h>#include <log4cplus/consoleappender.h>#include <log4cplus/layout.h>#include <log4cplus/configurator.h>//注意添加该头文件using std::auto_ptr;using namespace log4cplus;using namespace log4cplus::helpers; // Link Lib #ifndef _DEBUG #pragma comment(lib,"log4cplusUS.lib") #else #pragma comment(lib,"log4cplusUSD.lib") #endif int _tmain(int argc, _TCHAR* argv[]){PropertyConfigurator::doConfigure(_T("d:\\log4cplus.cfg"));Logger logger = Logger::getRoot();LOG4CPLUS_DEBUG(logger, "This is a DEBUG message");LOG4CPLUS_INFO(logger, "This is a INFO message");LOG4CPLUS_WARN(logger, "This is a WARN message");LOG4CPLUS_ERROR(logger, "This is a ERROR message");LOG4CPLUS_FATAL(logger, "This is a FATAL message");return 0;}

运行结果如下：

搞了一下午终于整理完了，呵呵 ，最后看下它在我的一个项目中的应用吧！~

2015-01-07 13:28:02  -  模型加载开始... 
2015-01-07 13:28:03  -  模型加载完毕,共有482个点!
 
2015-01-07 13:28:03  -  轮廓加载开始... 
2015-01-07 13:28:03  -  轮廓加载完毕,共有101个点!
 
2015-01-07 13:28:03  -  轮廓采样开始... 
2015-01-07 13:28:03  -  轮廓采样完毕,采样后有85个点!
 
2015-01-07 13:28:03  -  过滤模型点开始... 
2015-01-07 13:28:03  -  过滤模型点完毕,共有358个点!
 
2015-01-07 13:28:03  -  计算发射概率开始... 
2015-01-07 13:28:03  -  计算发射概率完毕!
 
2015-01-07 13:28:03  -  计算转移概率开始... 
2015-01-07 13:28:22  -  计算转移概率完毕!
 
2015-01-07 13:28:22  -  维特比算法开始... 
2015-01-07 13:28:28  -  维特比算法完毕!
 
2015-01-07 13:28:28  -  配对开始... 
2015-01-07 13:28:28  -  配对完毕!
 
2015-01-07 13:28:28  -  去掉重复匹配的模型点开始... 
2015-01-07 13:28:28  -  去掉重复匹配的模型点完毕!
 
2015-01-07 13:28:33  -  变形开始... 
2015-01-07 14:56:11  -  变形完成!