log4cplus使用

一、简介

log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统.受Apache Software License

保护。作者是Tad E. Smith。log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将信息划分

优先级使其可以面向程序调试、运行、测试、和维护等全生命周期； 你可以选择将信息输出到屏幕、文件、

NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。

二、构成要素

Layouts      ：布局器，控制输出消息的格式.

Appenders    ：挂接器，与布局器紧密配合，将特定格式的消息输出到所挂接的设备终端

               （如屏幕，文件等等)。

Logger       ：记录器，保存并跟踪对象日志信息变更的实体，当你需要对一个对象进行

               记录时，就需要生成一个logger。

Categories   ：分类器，层次化（hierarchy）的结构，用于对被记录信息的分类，层次中

               每一个节点维护一个logger的所有信息。

Priorities   ：优先权，包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。

三、基本步骤

1. 实例化一个appender对象

2. 实例化一个layout对象

3. 将layout对象绑定(attach)到appender对象

4. 实例化一个logger对象,调用静态函数：log4cplus::Logger::getInstance("logger_name")

5. 将appender对象绑定(attach)到logger对象，如省略此步骤，标准输出（屏幕）appender对象会绑定到logger

6. 设置logger的优先级，如省略此步骤，各种有限级的消息都将被记录

四、实例

/*
    严格实现步骤1-6，appender输出到屏幕, 其中的布局格式和LogLevel后面会详细解释。
*/
#include <log4cplus/logger.h>
#include <log4cplus/consoleappender.h>
#include <log4cplus/layout.h>

using namespace log4cplus;
using namespace log4cplus::helpers;

int main()
{
    /* step 1: Instantiate an appender object */
    SharedObjectPtr _append (new ConsoleAppender());
    _append->setName("append for test");

    /* step 2: Instantiate a layout object */
    std::string pattern = "%d{%m/%d/%y %H:%M:%S}  - %m [%l]%n";
    std::auto_ptr _layout(new PatternLayout(pattern));

    /* step 3: Attach the layout object to the appender */
    _append->setLayout( _layout );

    /* step 4: Instantiate a logger object */
    Logger _logger = Logger::getInstance("test");

    /* step 5: Attach the appender object to the logger  */
    _logger.addAppender(_append);

    /* step 6: Set a priority for the logger  */
    _logger.setLogLevel(ALL_LOG_LEVEL);

     /* log activity */
    LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message...")
    sleep(1);
    LOG4CPLUS_WARN(_logger, "This is the SECOND log message...")

    return 0;
}