log4cplus应用之日志文件输出(一)

log4cplus应用之日志文件输出(一)

简介

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

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”

%F – 输出当前记录器所在的文件名称，比如”main.cpp”
%L – 输出当前记录器所在的文件行号，比如”51”
%l – 输出当前记录器所在的文件名称和行号，比如”main.cpp:51”
%m – 输出原始信息。
%n – 换行符。
%p – 输出LogLevel，比如”DEBUG”
%t – 输出记录器所在的线程ID，比如 “1075298944”
%x – 嵌套诊断上下文NDC (nested diagnostic context) 输出，从堆栈中弹出上下文信息，NDC可以用对不同源的log信息（同时地）交叉输出进行区分。

格式对齐，比如”%-10m”时表示左对齐，宽度是10，当然其它的控制字符也可以相同的方式来使用，比如”%-12d”，”%-5p”等等。

4.) Appender输出位置
（1）控制台输出
ConsoleAppender
（2）文件输出
FileAppender / RollingFileAppender / DailyRollingFileAppender .

FileAppender :
实现了基本的文件操作功能，构造函数如下:
FileAppender(filename,mode,immediateFlush);

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

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

参考博客http://blog.csdn.net/augusdi/article/details/8989494