log4cplus中自定义的使用配置文件输出日志的类

        log4cplus是C++中的一个日志系统，之前有一篇文章介绍了它的配置，今天把它的使用方法列出来。

        下面是包装过的类，在项目中使用这个类会很简单，只需要包含它的头文件就可以使用了，当然前提是搭建好log4cplus的环境。

        自己定义的类名是Log

        Log.h文件如下：

#pragma once

#include "log4cplus/loglevel.h"
#include "log4cplus/ndc.h" 
#include "log4cplus/logger.h"
#include "log4cplus/configurator.h"
#include "iomanip"
#include "log4cplus/fileappender.h"
#include "log4cplus/layout.h"

using namespace log4cplus;
using namespace log4cplus::helpers;

//日志封装
#define TRACELOG(p) LOG4CPLUS_TRACE(Log::_logger, p)
#define DEBUGLOG(p) LOG4CPLUS_DEBUG(Log::_logger, p)
#define INFOLOG(p) LOG4CPLUS_INFO(Log::_logger, p)
#define WARNLOG(p) LOG4CPLUS_WARN(Log::_logger, p)
#define ERRORLOG(p) LOG4CPLUS_ERROR(Log::_logger, p)

// 日志控制类，全局共用一个日志
class Log
{
public:
	//打开日志
	bool open_log();

	//获得日志实例
	static Log & instance();

	//全局日志对象
	static Logger _logger;

private:
	Log();

	virtual ~Log();


};

        Log.cpp文件如下：

#include "Log.h"


CString str("DigitalImageProcess_log");
std::wstring wstr=str.GetString();
Logger  Log::_logger = log4cplus::Logger::getInstance(wstr); 

Log::Log()
{
	
}

Log::~Log()
{
}

Log& Log::instance()
{
	static Log log;
	return log;
}

bool Log::open_log()
{
	log4cplus::PropertyConfigurator::doConfigure(_T("d:\\log\\log4cplus.cfg"));//将要读取的配置文件的路径
	return true;
}

/************************************************************************/
/* log的使用方法：
if (!Log::instance().open_log())  
{  
std::cout << "Log::open_log() failed" << std::endl;    
}  
INFOLOG("Server init succ");  
ERRORLOG("Server run failed"); */
/************************************************************************/

        配置文件log4cplus.cfg如下：

log4cplus.rootLogger=INFO, STDOUT
log4cplus.logger.DigitalImageProcess_log=INFO, R3

log4cplus.appender.STDOUT=log4cplus::ConsoleAppender
log4cplus.appender.STDOUT.layout=log4cplus::PatternLayout
log4cplus.appender.STDOUT.layout.ConversionPattern=%d{%m/%d/%y %H:%M:%S} [%t] %-5p %c{2} %%%x%% - %m [%l]%n


log4cplus.appender.R3=log4cplus::RollingFileAppender
log4cplus.appender.R3.File=d:\\log\\DigitalImageProcess_Log.log
log4cplus.appender.R3.MaxFileSize=500KB
log4cplus.appender.R3.MaxBackupIndex=5
log4cplus.appender.R3.layout=log4cplus::PatternLayout
log4cplus.appender.R3.layout.ConversionPattern=%D{%y-%m-%d %H:%M:%S} [%l] %-5p -- %m%n

        主要是这3个文件，这样就可以在需要输入日志的地方使用下面的语句输出日志了：

if (!Log::instance().open_log())  
{  
std::cout << "Log::open_log() failed" << std::endl;    
}  
INFOLOG("Server init succ");  
ERRORLOG("Server run failed");

         在日志文件DigitalImageProcess_Log.log中会输出：

13-10-11 11:12:10 [.\TestEventHandler.cpp:15] INFO  -- Server init succ
13-10-11 11:12:10 [.\TestEventHandler.cpp:15] ERROR  -- Server run failed

        配置文件中的格式如下：

（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"

 

（4）"%F"，输出当前记录器所在的文件名称，比如"main.cpp"
（5）"%L"，输出当前记录器所在的文件行号，比如"51"
（6）"%l"，输出当前记录器所在的文件名称和行号，比如"main.cpp:51"
（7）"%m"，输出原始信息。
（8）"%n"，换行符。

（9）"%p"，输出LogLevel，比如"DEBUG"
（10）"%t"，输出记录器所在的线程ID，比如 "1075298944"
（11）"%x"，嵌套诊断上下文NDC (nested diagnostic context) 输出，从堆栈中弹出上下文信息，NDC可以用对不同源的log信息（同时地）交叉输出进行区分。
（12）格式对齐，比如"%-10m"时表示左对齐，宽度是10，当然其它的控制字符也可以相同的方式来使用，比如"%-12d"，"%-5p"等等。