Log4cpp概念

最新推荐文章于 2022-05-18 19:28:40 发布

基斯卡人

最新推荐文章于 2022-05-18 19:28:40 发布

阅读量486

点赞数

分类专栏： C++ 文章标签： log4j log4cpp

本文链接：https://blog.csdn.net/Eric_lmy/article/details/53221877

版权

　　Log4cpp中的概念继承自log4j，最重要的是Category(种类)、Appender(附加目的地)和Layout(布局)三个概念，此外还有Priority(优先级)和NDC(嵌套的诊断上下文)等。
　　简言之，Category负责向日志中写入信息，Appender负责指定日志的目的地，Layout负责设定日志的格式，Priority被用来指定Category的优先级和日志的优先级， NDC则是一种用来区分不同场景中交替出现的日志的手段。
　　Log4cpp记录日志的原理如下：每个Category都有一个优先级，该优先级可以由setPriority方法设置，或者从其父Category中继承而来。每条日志也有一个优先级，当Category记录该条日志时，若日志优先级高于Category的优先级时，该日志被记录，否则被忽略。系统中默认的优先级等级如下：

typedef enum {
EMERG  = 0,
FATAL  = 0,
ALERT  = 100,
CRIT   = 200,
ERROR  = 300,
WARN   = 400,
NOTICE = 500,
INFO   = 600,
DEBUG  = 700,
NOTSET = 800
} PriorityLevel;

注意：取值越小，优先级越高。例如一个Category的优先级为101，则所有EMERG、FATAL、ALERT日志都可以记录下来，而其他则不能。

　Category、Appender和Layout三者的关系如下：系统中可以有多个Category，它们都是继承自同一个根，每个Category负责记录自己的日志;每个Category可以添加多个Appender，每个Appender指定了一个日志的目的地，例如文件、字符流或者Windows日志，当Category记录一条日志时，该日志被写入所有附加到此Category的Appender;每个Append都包含一个Layout，该Layout定义了这个Appender上日志的格式。
其流程如下：
1. 创建一个Appender，并指定其包含的Layout；
2. 从系统中得到Category的根，将Appender添加到该Category中；
3. 设置Category的优先级；
4. 记录日志；
5. 关闭Category。

Layout(布局)
layout类控制输出日志消息的显示样式（看起来像什么）。log4cpp当前提供以下layout格式：
log4cpp::BasicLayout // 以“时间戳优先级（priority，下文介绍）
// 类别（category，下文介绍）
// NDC标签（nested diagnostic contexts 下文介绍）: 日志信息”。
// 如：1056638652 INFO main : This is some info
log4cpp::PatternLayout // 让用户根据类似于 C 语言 printf 函数的转换模式
//来指定输出格式。格式定义见代码附带文档。
log4cpp::SimpleLayout // 以“优先级（priority） - 日志信息”格式显示。

PatternLayout
　　在介绍PatternLayout以前，首先来看看log4cpp中所有的Layout子类(Layout本身是个虚类)，一共三个：BasicLayout、PatternLayout和SimpleLayout，其中SimapleLayout并不建议使用，而BaiscLayout过于简单，因此如果程序员不自己扩展Layout的话，就只能使用PatternLayout了，值得庆幸的是，PatternLayout还是比较好用的。
　　PatternLayout使用setConversionPattern函数来设置日志的输出格式。该函数的声明如下：
void log4cpp::PatternLayout::setConversionPattern (const std::string & conversionPattern) throw (ConfigureFailure) [virtual]
　　其中参数类型为std::string，类似于C语言中的printf，使用格式化字符串来描述输出格式，其具体含义如下：
u %c category；
u %d 日期；日期可以进一步的设置格式，用花括号包围，例如%d{%H:%M:%S,%l} 或者 %d{%d %m %Y %H:%M:%S,%l}。如果不设置具体日期格式，则如下默认格式被使用“W