log4cplus 使用方法配置

最新推荐文章于 2024-03-26 21:56:30 发布

mzhifa

最新推荐文章于 2024-03-26 21:56:30 发布

阅读量975

点赞数

文章标签： log4cplus

Log4cplus使用指南

1. Log4cplus简介

log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统，受Apache Software License保护，作者是Tad E. Smith。

log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将日志划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期。你可以选择将日志输出到屏幕、文件、NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。

2. 安装方法

2.1. linux

1- 解压: gzip -cd log4cplus-x.x.x.tar.gz | tar -xf -

2- 进入log4cplus根目录: cd log4cplus-x.x.x

3- 产生Makefile: ./configure --prefix=/where/to/install -enable-threads=no

如果需要指定安装路径可使用--prefix参数, 否则将缺省安装到/usr/local目录下。另外，如果需要单线程版本可通过参数-enable-threads=no指定, 否则默认将安装多线程版本。

对于HP-UNIX平台用户, 由于aCC编译器选项兼容性问题，请另外加入参数CXXFLAGS=”-AA -w”(单线程版本)或CXXFLAGS=”-AA –mt -w”(多线程版本)。

4- 创建: make

对于HP-UNIX用户，由于aCC编译器不包含-Wall选项来显示所有警告，创建时将导致无效的-W参数错误，请修改/log4cplus-x.x.x/src目录下的Makefile，将AM_CPPFLAGS = -Wall 行的-Wall选项删除或注释掉。

此外，某些HP-UNIX平台的套接字连接接受函数accept()第三个参数要求为int*，而在socket-unix.cxx源文件153行实现中实际传入的是socklen_t*类型，平台并不支持，也将导致编译错误。解决方法是将源代码该行中的传入参数强制转换为int*类型即可。

注意AIX和Linux平台目前并没有上述两处创建错误。

对于AIX平台用户请保证创建时使用的编译器是xlC而不是g++，否则将导致log4cplus脚本配置功能运行时产生段异常，生成core文件。有鉴于此，也请保证HP-UNIX用户尽量使用aCC编译器进行创建。

5- 创建/log4cplus/tests目录下的测试用例: make check

6- 安装: make install

安装成功后将在/usr/local目录或指定的目录下创建include和lib两个子目录及相应文件。其中include目录包含头文件，lib目录包含最终打包生成的静态和动态库。在动态连接log4cplus库时请使用-llog4cplus选项。

2.2. win

3. 主要类说明

类名	说明
Filter	过滤器，过滤输出消息。过滤器，解决哪些信息需要输出的问题，比如DEBUG，WARR,INFO等的输出控制
Layout	布局器，控制输出消息的格式。格式化输出信息,解决了如何输出的问题。
Appender	挂接器，与布局器和过滤器紧密配合，将特定格式的消息过滤后输出到所挂接的设备终端如屏幕，文件等等)。接收日志的各个设备,如控制台、文件、网络等。解决了输出到哪里去的问题
Logger	记录器，保存并跟踪对象日志信息变更的实体，当你需要对一个对象进行记录时，就需要生成一个logger。日志模块,程序中唯一一个必须得使用的模块，解决了在哪里使用日志的问题。
Hierarchy	分类器，层次化的树型结构，用于对被记录信息的分类，层次中每一个节点维护一个logger的所有信息。
LogLevel	优先权，包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。

4. 基本使用

4.1. 基本步骤

使用log4cplus有六个基本步骤：

l 实例化一个封装了输出介质的appender对象；

l 实例化一个封装了输出格式的layout对象；

l 将layout对象绑定(attach)到appender对象；如省略此步骤，简单布局器SimpleLayout(参见5.1小节)对象会绑定到logger。

l 实例化一个封装了日志输出logger对象,并调用其静态函数getInstance()获得实例，log4cplus::Logger::getInstance("logger_name")；

l 将appender对象绑定(attach)到logger对象；

l 设置logger的优先级，如省略此步骤，各种有限级的日志都将被输出。

4.2. 使用示例

下面通过一些例子来了解log4cplus的基本使用。

4.2.1. 例1-标准使用

*标准使用，严格实现步骤1-6。

#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<Appender> _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");

/* 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;

}

输出结果：

10/14/04 09:06:24 - This is the FIRST log message... [main.cpp:31]

10/14/04 09:06:25 - This is the SECOND log message... [main.cpp:33]

4.2.2. 例2-简洁使用

　*简洁使用，仅实现步骤1、4、5。