log4cplus使用
框架说明:
C++日志库log4cplus:SocketAppender记录日志到log Server
配置文件:
最近项目涉及到日志记录功能,因此学习了写log4cplus框架,下载下来源码后研究了几天,上面几篇文章都是学习过程中觉着对我有帮助的。
下面记录下我最近学习log4cplus的一些知识和自己的想法
日志输出原则:
1、在程序开始运行应该以INFO记录程序开始运行的消息;
2、在程序初始化过程中,如果影响程序主体正常运行错误出现,应该以FATAL记录出现错误的函数名、事件和错误号;如果只是一个不影响程序正常功能的模块出现错误,则应该以ERROR记录出现错误的函数名、模块名、事件和错误号;
3、在程序初始化完成后,应该以INFO记录程序初始化完成的消息;
4、在函数的入口,如果需要验证参数,则可以DEBUG的形式输出参数的信息。如果重要参数不正确,则应该以ERROR输出;
5、程序的输入和输出要以Debug记录下来,包括:从文件、数据库、网络、用户等输入的信息,向文件、数据库、网络输出的信息;
6、对重要结构体的修改,要以Info记录修改前、后的状态;
7、在调用比较成熟的API时,如果失败,则以ERROR记录,并且有错误号记下错误号;
8、在调用没有经过严格测试的库时,即使返回成功,也要以DEBUG的形式记录下返回的结果;
9、以捕获异常时,以ERROR记录下错误;
10、在进行数据库操作时,以DEBUG的级别输出执行的SQL词句,对于取回的结果,最好是能打印出所有构造完成的对象的信息;
11、在与其它程序进行通信时,以DEBUG记录下通信过程中的重要信息;
12、对程序中的每个线程,它们的初始化完成和开始运行也要以INFO记录下来;
13、对程序中需要检查运行性能的地方,以DEBUG记录下运行耗时;
14、程序正常结束时,和初始化的记录方式相同,对各个模块的卸载采用和加载是一样的处理方式。当程序都卸载完成后以INFO记录程序退出的消息。
下面给我出我学习log4cplus源码时画出的系统重要类结构,志在理解,画的图有时候不规范,大家将就理解下。
图1主要给出了框架中日志输出位置类继承关系图,从图中可以看出,框架提供了很多日志输出的设备,比如:控制台、文件、网络等等。
图2是配置文件类,通过该类可以完成对logger、appender和layout的配置,很方便,推荐使用
图3也比较复杂,主要实现了多种工厂,理解一般
图4是过滤器类结构,过滤器总有4中模式,按图中顺序依次为:拒绝所有过滤器、串匹配、等级匹配和区间匹配
图5是分类器
图6 格式输出类,从左到右格式依次复杂,简单格式输出只添加日志等级和‘-’作为输出日志信息,TTCCLayout输出类添加了线程ID、文件行数等信息,PatternLayout是格式化输出类,用户可以自由拼接
图7是日志记录者
图8是日志等级管理者
图9是socket类关系
图10是线程同步类,主要包括:5中线程同步类,SyncGuardFunc和SyncGuard是一个方便类,在构造对象时传入不同的线程同步类,他会自动加锁,并在对象析构时自动解锁
图11线程类
图12是时间类,可以用来测试程序效率
上面贴出了12张图,都是log4cplus中的类,也比较好理解,具体的分析读者可以看文章开头的链接,讲的都比较详细。