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  #include  #include    using namespace log4cplus; using namespace log4cplus::helpers;   int main() {     /* 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(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。  　*/ #include  #include    using namespace log4cplus; using namespace log4cplus::helpers;   int main() {     /* step 1: Instantiate an appender object */     SharedAppenderPtr _append(new ConsoleAppender());     _append->setName("append  test");     　　　     /* 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  FIRST log message...")     sleep(1);     LOG4CPLUS_WARN(_logger, "This is the  SECOND log message...")     　　　     return 0; }

输出结果：

DEBUG - This is  the FIRST log message... WARN - This is the  SECOND log message...

转载： https://my.oschina.net/lovecxx/blog/185951#OSC_h1_1