开源日志log4cplus-1.2.0使用1

网上的方法不能照搬，这里总结下，实测有效。

1 Log4cplus简介
　　　log4cplus是C++编写的开源的日志系统，前身是java编写的log4j系统，受Apache Software License保护，作者是Tad E. Smith。
　　　log4cplus具有线程安全、灵活、以及多粒度控制的特点，通过将日志划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期。你可以选择将日志输出到屏幕、文件、NT event log、甚至是远程服务器；通过指定策略对日志进行定期备份等等。
2 安装方法
只讲windows下的：linux下的没有实际测试，就不写了。

                下载压缩包：log4cplus-1.2.0.7z

解压缩，进入log4cplus-1.2.0\msvc10\

用vs2010编译log4cplus.sln，生成lib及dll,目录在log4cplus-1.2.0\msvc10\Win32\bin.Debug

3，测试：

用vs2010写测试程序，把include文件夹及库文件都放到你测试程序的工程下，设置好包含目录，库目录。

编写测试程序：实测可运行

#include <log4cplus/logger.h>
#include <log4cplus/consoleappender.h>
#include <log4cplus/layout.h>
#include <log4cplus/helpers/sleep.h>
#include <log4cplus/loggingmacros.h>


#pragma comment(lib,"../lib/log4cplusD.lib")

using namespace log4cplus;
using namespace log4cplus::helpers;

int main()
{
	/* step 1: 设置一个输出对象，就是在哪里输出日志，屏幕就是console */
	SharedObjectPtr<Appender> _append (new ConsoleAppender());
	_append->setName(LOG4CPLUS_TEXT("append for test"));
	/* step 2: 设置一个日志输出格式的对象 ，这里格式为时间 工作目录文件，行以及换行 */
	   //std::string pattern = "%d{%m/%d/%y %H:%M:%S}  - %m [%l]%n";
	   log4cplus::tstring pattern = LOG4CPLUS_TEXT("%d{%m/%d/%y %H:%M:%S}  - %m [%l]%n");
	   std::auto_ptr<Layout> _layout(new PatternLayout(pattern));
	   /* step 3: 绑定屏幕和格式对象 */
	   _append->setLayout( _layout );
	   /* step 4: 设置一个日志对象，还有名字 */
	   Logger _logger = Logger::getInstance(LOG4CPLUS_TEXT("test"));
       /* step 5: 绑定日志对象和屏幕  */
	   _logger.addAppender(_append);
	   /* step 6: Se设置日志优先级，应该是打印那些级别的日志  */
	   _logger.setLogLevel(ALL_LOG_LEVEL);
	   /* log activity */
	   LOG4CPLUS_DEBUG(_logger, "This is the FIRST log message...");
	   log4cplus::helpers::sleep(1);
	   LOG4CPLUS_WARN(_logger, "This is the SECOND log message...");
	   return 0;
}

也就是使用这个日志一般有6个步骤，但是也不是必须的。

4，书面解释：

类名    说明
Filter            过滤器，过滤输出消息。
Layout          布局器，控制输出消息的格式。
Appender       挂接器，与布局器和过滤器紧密配合，将特定格式的消息过滤后输出到所挂接的设备终端如屏幕，文件等等)。
Logger           记录器，保存并跟踪对象日志信息变更的实体，当你需要对一个对象进行记录时，就需要生成一个logger。
Hierarchy         分类器，层次化的树型结构，用于对被记录信息的分类，层次中每一个节点维护一个logger的所有信息。
LogLevel         优先权，包括TRACE, DEBUG, INFO, WARNING, ERROR, FATAL。
基本步骤
　　　使用log4cplus有六个基本步骤：
 实例化一个封装了输出介质的appender对象；
 实例化一个封装了输出格式的layout对象；
 将layout对象绑定(attach)到appender对象；
　　　如省略此步骤，简单布局器SimpleLayout(参见5.1小节)对象会绑定到logger。
 实例化一个封装了日志输出logger对象,并调用其静态函数getInstance()获得实  
　　例，log4cplus::Logger::getInstance("logger_name")；
 将appender对象绑定(attach)到logger对象；
设置logger的优先级，如省略此步骤，各种有限级的日志都将被输出。