log4cplus2.0基本使用方法

使用log4cplus有六个基本步骤:

用Initializer类进行初始化
log4cplus::Initializer initializer;

创建Appender对象。
appender(new log4cplus::ConsoleAppender()) 创建 console 的appender对象

设置Appender的名称和输出格式(Layout)
setName函数设置appender名称;setLayout函数设置layout对象,可以直接new一个新的

获得一个Logger实例,并设置其日志输出等级阈值
getInstance函数获取实例; setLogLevel函数设置日志输出等级阈值

给Logger实例添加Appender
logger.addAppender(appender);

使用宏输出日志(宏的等级有6个,分别为:FATAL, ERROR, WARN, INFO, DEBUG, TRACE。FATAL宏的名为LOG4CPLUS_FATAL( ),ERROR的宏的名为LOG4CPLUS_ERROR( ),以此类推。具体使用方法见示例。)

功能
Logger 记录日志的句柄。
Appender 用于指定内容输出位置(如:控制台,文件、远程服务器等)。一个Logger可添加多个Appender,从而向多个位置输出日志。
Layout 用于指定日志输出的格式。每一个Appender须要设置一个Layout。

三者关系

log4cplus2.0基本使用方法

Log4cplus支持的Layout的类型

log4cplus2.0基本使用方法

SimpleLayout
/* step 1:  Instantiate an appender object */
SharedObjectPtr  _append (new ConsoleAppender());
_append->setName("append for  test");
/* step 2:  Instantiate a layout object */
std::auto_ptr<Layout>  _layout(new  log4cplus::SimpleLayout());
/* 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);
/* log activity */
LOG4CPLUS_DEBUG(_logger,  "This  is the simple formatted log message...")
PatternLayout
/* 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>  _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_logger.subtest");        
/* step 5: Attach  the appender object to the logger  */
_logger.addAppender(_append);
/* log activity */
LOG4CPLUS_DEBUG(_logger,  "teststr")
PatterLayout支持的转换标识符主要包括:

(1)"%%",转义为%, 即,std::string pattern = "%%" 时输出"%"。

(2)"%c",输出logger名称,比如std::string pattern ="%c" 时输出: "test_logger.subtest",     也可以控制logger名称的显示层次,比如"%c{1}"时输出"test_logger",其中数字表示层次。

(3)"%D",显示本地时间,当std::string pattern ="%D" 时输出:"2004-10-16 18:55:45",%d显示标准时间,所以当std::string pattern ="%d" 时输出"2004-10-16 10:55:45" (因为北京时间位于东8区,差8个小时)。

可以通过%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",输出当前记录器所在的文件名称,比如std::string pattern ="%F" 时输出: "main.cpp"。

(5)"%L",输出当前记录器所在的文件行号,比如std::string pattern ="%L" 时输出: "51"

(6)"%l",输出当前记录器所在的文件名称和行号,比如std::string pattern ="%l" 时输出"main.cpp:51"。

(7)"%m",输出原始信息,比如std::string pattern ="%m" 时输出: "teststr",即上述代码中LOG4CPLUS_DEBUG的第二个参数,这种实现机制可以确保原始信息被嵌入到带格式的信息中。

(8)"%n",换行符,没什么好解释的。

(9)"%p",输出LogLevel,比如std::string pattern ="%p" 时输出: "DEBUG"。

(10)"%t",输出记录器所在的线程ID,比如std::string pattern ="%t" 时输出: "1075298944"。

(11)"%x",嵌套诊断上下文NDC (nested diagnostic context) 输出,从堆栈中弹出上下文信息,NDC可以用对不同源的log信息(同时地)交叉输出进行区分,关于NDC方面的详细介绍会在下文中提到。

(12)格式对齐,比如std::string pattern ="%-10m"时表示左对齐,宽度是10,此时会输出"teststr   ",当然其它的控制字符也可以相同的方式来使用,比如"%-12d","%-5p"等等。
TTCCLayout
/*step1:Instantiateanappenderobject*/
SharedObjectPtr_append(new  ConsoleAppender());
_append->setName("appendfortest");
/*step2:Instantiatealayoutobject*/
std::auto_ptr_layout(new  TTCCLayout());
/*step3:Attachthelayoutobjecttotheappender*/
_append->setLayout(_layout);
/*step4:Instantiatealoggerobject*/
Logger_logger=Logger::getInstance("test_logger");
/*step5:Attachtheappenderobjecttothelogger*/
_logger.addAppender(_append);
/*logactivity*/
LOG4CPLUS_DEBUG(_logger,"teststr")

将日志输出到控制台

#include <log4cplus/log4cplus.h>

int main()
{
    //用Initializer类进行初始化
    log4cplus::Initializer initializer;

    //第1步:建立ConsoleAppender
    log4cplus::SharedAppenderPtr appender(new log4cplus::ConsoleAppender());

    //第2步:设置Appender的名称和输出格式(SimpleLayout)
    appender->setName(LOG4CPLUS_TEXT("console"));
    appender->setLayout(std::unique_ptr<log4cplus::Layout>(new log4cplus::SimpleLayout));

    //第3步:得到一个Logger实例,并设置其日志输出等级阈值
    log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT ("test"));
    logger.setLogLevel(log4cplus::INFO_LOG_LEVEL);

    //第4步:为Logger实例添加ConsoleAppender
    logger.addAppender(appender);

    //第5步:使用宏将日志输出
    LOG4CPLUS_INFO(logger, LOG4CPLUS_TEXT("Hello world"));

    return 0;
}

将日志输出到控制台并写入文件

#include <log4cplus/log4cplus.h>

int main()
{
    //用Initializer类进行初始化
    log4cplus::Initializer initializer;

    //第1步:建立ConsoleAppender和FileAppender(参数app表示内容追加到文件)
    log4cplus::SharedAppenderPtr consoleAppender(new log4cplus::ConsoleAppender);
    log4cplus::SharedAppenderPtr fileAppender(new log4cplus::FileAppender(
                                                  LOG4CPLUS_TEXT("log.txt"),
                                                  std::ios_base::app
                                                  )
                                              );

    //第2步:设置Appender的名称和输出格式
    //ConsoleAppender使用SimpleLayout
    //FileAppender使用PatternLayout
    consoleAppender->setName(LOG4CPLUS_TEXT("console"));
    consoleAppender->setLayout(std::unique_ptr<log4cplus::Layout>(new log4cplus::SimpleLayout()));
    fileAppender->setName(LOG4CPLUS_TEXT("file"));
    log4cplus::tstring pattern = LOG4CPLUS_TEXT("%D{%m/%d/%y %H:%M:%S,%Q} [%t] %-5p %c - %m [%l]%n");
    fileAppender->setLayout(std::unique_ptr<log4cplus::Layout>(new log4cplus::PatternLayout(pattern)));

    //第3步:得到一个Logger实例,并设置其日志输出等级阈值
    log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT ("test"));
    logger.setLogLevel(log4cplus::INFO_LOG_LEVEL);

    //第4步:为Logger实例添加ConsoleAppender和FileAppender
    logger.addAppender(consoleAppender);
    logger.addAppender(fileAppender);

    //第5步:使用宏将日志输出
    LOG4CPLUS_INFO(logger, LOG4CPLUS_TEXT("Hello world"));

    return 0;
}

将日志发送到日志服务器

#include <log4cplus/log4cplus.h>

int main()
{
    //用Initializer类进行初始化
    log4cplus::Initializer initializer;

    //第1步:建立SocketAppender
    log4cplus::SharedAppenderPtr appender(new log4cplus::SocketAppender(
                                                    LOG4CPLUS_TEXT("localhost"),
                                                    32015, LOG4CPLUS_TEXT("test")));

    //第2步:设置Appender的名称,SocketAppender不须要设置输出格式
    appender->setName(LOG4CPLUS_TEXT("logserver"));

    //第3步:得到一个Logger实例,并设置其日志输出等级阈值
    log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT ("test"));
    logger.setLogLevel(log4cplus::INFO_LOG_LEVEL);

    //第4步:为Logger实例添加Appender
    logger.addAppender(appender);

    //第5步:使用宏将日志输出
    LOG4CPLUS_INFO(logger, LOG4CPLUS_TEXT("Hello world"));
    return 0;
}

log4cplus2.0基本使用方法

上一篇:yum软件包管理


下一篇:word通配符特殊字符处理