log4cxx的使用

log4cxx是业界通用的日志系统，建议我们在写程序的时候可以直接拿来使用，关于工程包及相关的lib及dll文件，网上有很多说明，略过。以下只讲怎样使用。

一、建测试工程：testlog4cxx,直接选控制台应用程序,    在配置属性页中，选C/C++，常规，在附加包含目录中加入“./”；选链接器，常规，在附加库目录中加入"./",点选中常规下面的输入，在附加依赖项中加入“log4cxx/log4cxx.lib”

二、在测试工程目录下加入log4cxx文件包

三、加入include头文件：

#include <log4cxx/logger.h>

#include <log4cxx/propertyconfigurator.h>

四、定义配置文件log4cxx.properties的位置

log4cxx::PropertyConfigurator::configure("log4cxx.properties");

此处的作用为定义配置文件的位置，如果想让程序在D盘根目录下加载配置文件，可以如下定义：

log4cxx::PropertyConfigurator::configure("D:\log4cxx.properties");

五、定义不同的打印级别

此在配置文件中log4cxx.properties将会有所定义。假设有这样的场景，你必须使用别人提供一个DLL用来获取接口，此DLL中使用了log4cxx日志，然后你又想在自己的工程中同样引入log4cxx日志,为了区分你的日志和别人的日志，你该如何做呢，假设别人使用的为log4j.rootLogger顶级接口。（默认情况下，所有的日志都会在顶级接口对应的日志文件中进行记录）

这样一个设置可使得顶级接口与子接口分离：

# 屏蔽gather的Appender继承 
log4j.additivity.gather = false

以下配置假设引用的DLL库使用了log4cxx的根接口，并且输出两种级别的文件，一种为error，一种为debug

# 设置root logger为DEBUG级别，使用了两个Appender log4j.rootLogger=DEBUG, COM, ERR

# 设置sample logger为DEBUG级别 log4j.logger.sample = DEBUG, sample # 屏蔽sample的Appender继承 log4j.additivity.sample = false

log4j.logger.sample.error = WARN, sample.error #log4j.additivity.sample.error = false

log4j.appender.COM=org.apache.log4j.RollingFileAppender log4j.appender.COM.File=../log/dll_output.log log4j.appender.COM.Append=false log4j.appender.COM.MaxFileSize=3MB log4j.appender.COM.MaxBackupIndex=10 log4j.appender.COM.ImmediateFlush=true log4j.appender.COM.layout=org.apache.log4j.PatternLayout log4j.appender.COM.layout.ConversionPattern=%d %-5p %m%n

log4j.appender.ERR=org.apache.log4j.RollingFileAppender log4j.appender.ERR.File=../log/dll_error.log log4j.appender.ERR.Append=false log4j.appender.ERR.Threshold=ERROR log4j.appender.ERR.MaxFileSize=3MB log4j.appender.ERR.MaxBackupIndex=10 log4j.appender.ERR.layout=org.apache.log4j.PatternLayout log4j.appender.ERR.layout.ConversionPattern=%d %-5p %m%n

log4j.appender.sample=org.apache.log4j.RollingFileAppender log4j.appender.sample.File=../log/sample_output.log log4j.appender.sample.Append=false log4j.appender.sample.MaxFileSize=10MB log4j.appender.sample.MaxBackupIndex=10 log4j.appender.sample.ImmediateFlush=true log4j.appender.sample.layout=org.apache.log4j.PatternLayout log4j.appender.sample.layout.ConversionPattern=%d %-5p %m%n

log4j.appender.sample.error=org.apache.log4j.RollingFileAppender log4j.appender.sample.error.File=../log/sample_error.log log4j.appender.sample.error.Append=false log4j.appender.sample.error.MaxFileSize=3MB log4j.appender.sample.error.MaxBackupIndex=10 log4j.appender.sample.error.ImmediateFlush=true log4j.appender.sample.error.layout=org.apache.log4j.PatternLayout log4j.appender.sample.error.layout.ConversionPattern=%d %-5p %m%n

六、后台打印的日志与控制台显示的级别不同（一般控制台打印比较慢，显示的尽可能少，后台则尽可能详尽）

使用log4j.appender.ca.Threshold=WARN可达到控制台显示与后台打印不相同，如下一个配置文件设置：

# 设置root logger为DEBUG级别，使用了两个Appender log4j.rootLogger=DEBUG, server, ca

# 设置kline logger为DEBUG级别 log4j.logger.kline = DEBUG, kline, ca # 屏蔽kline的Appender继承 log4j.additivity.kline = false

log4j.logger.kline.error = WARN, kline.error, ca #log4j.additivity.kline.error = false

log4j.appender.server=org.apache.log4j.RollingFileAppender log4j.appender.server.File=../log/server_output.log log4j.appender.server.Append=false log4j.appender.server.MaxFileSize=3MB log4j.appender.server.MaxBackupIndex=10 log4j.appender.server.ImmediateFlush=true log4j.appender.server.layout=org.apache.log4j.PatternLayout log4j.appender.server.layout.ConversionPattern=%d %-5p %m%n

log4j.appender.server.error=org.apache.log4j.RollingFileAppender log4j.appender.server.error.File=../log/server_error.log log4j.appender.server.error.Append=false log4j.appender.server.error.Threshold=ERROR log4j.appender.server.error.MaxFileSize=3MB log4j.appender.server.error.MaxBackupIndex=10 log4j.appender.server.error.layout=org.apache.log4j.PatternLayout log4j.appender.server.error.layout.ConversionPattern=%d %-5p %m%n

log4j.appender.kline=org.apache.log4j.RollingFileAppender log4j.appender.kline.File=../log/kline_output.log log4j.appender.kline.Append=false log4j.appender.kline.MaxFileSize=10MB log4j.appender.kline.MaxBackupIndex=10 log4j.appender.kline.ImmediateFlush=true log4j.appender.kline.layout=org.apache.log4j.PatternLayout log4j.appender.kline.layout.ConversionPattern=%d %-5p %m%n

log4j.appender.kline.error=org.apache.log4j.RollingFileAppender log4j.appender.kline.error.File=../log/kline_error.log log4j.appender.kline.error.Append=false log4j.appender.kline.error.MaxFileSize=3MB log4j.appender.kline.error.MaxBackupIndex=10 log4j.appender.kline.error.ImmediateFlush=true log4j.appender.kline.error.layout=org.apache.log4j.PatternLayout log4j.appender.kline.error.layout.ConversionPattern=%d %-5p %m%n

#对Appender ca进行设置： # 这是一个控制台类型的Appender #  输出格式（layout）为PatternLayout log4j.appender.ca=org.apache.log4j.ConsoleAppender log4j.appender.ca.Threshold=WARN log4j.appender.ca.layout=org.apache.log4j.PatternLayout log4j.appender.ca.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %.16c - %m%n

七、打印日志的方法

LOG4CXX_INFO(log4cxx::Logger::getLogger("hello"), "你好，log4cxx!");

以上打印方法可行，不过写起来比较麻烦，建议进行一番包装。

如下代码所示：

/******************************************************************************
  author  : luhx
  purpose : 日志系统，以宏log_XXX开头，封装log4cxx日志。
*******************************************************************************/
#pragma once


#include "log4cxx/logger.h"
#include "log4cxx/propertyconfigurator.h"
/*
日志类
*/

#include<string>
using namespace std;

class CServerlog;
extern CServerlog* g_serverlog;

#define log_debug(pszFormat, ...)    g_serverlog->WriteFormatDebugLog( pszFormat, __VA_ARGS__)
#define log_info(pszFormat, ...)    g_serverlog->WriteFormatInfoLog( pszFormat, __VA_ARGS__)
#define log_warn(pszFormat, ...)    g_serverlog->WriteFormatWarnLog( pszFormat, __VA_ARGS__)
#define log_error(pszFormat, ...)    g_serverlog->WriteFormatErrorLog( pszFormat, __VA_ARGS__)

class CServerlog
{
public:
    CServerlog();
    ~CServerlog();

    void WriteFormatDebugLog(char* lpszFormat, ...);
    void WriteFormatInfoLog(char* lpszFormat, ...);

    void WriteFormatWarnLog(char* lpszFormat, ...);
    void WriteFormatErrorLog(char* lpszFormat, ...);

protected:

    log4cxx::LoggerPtr infologger;
    log4cxx::LoggerPtr errorlogger;
};

#include <Windows.h>
#include <tchar.h>
#include <stdio.h>
#include "serverlog.h"


CServerlog* g_serverlog = new CServerlog();

CServerlog::CServerlog()
{
    log4cxx::PropertyConfigurator::configure("log4cxx.properties");
    infologger = (log4cxx::Logger::getLogger("server"));
    errorlogger = (log4cxx::Logger::getLogger("server.error"));
}

CServerlog::~CServerlog()
{
}


void CServerlog::WriteFormatDebugLog(char* lpszFormat, ...)
{
    va_list args;
    va_start(args, lpszFormat);
    CHAR szBuffer[1024];
    vsprintf(szBuffer, lpszFormat, args);
    va_end(args);
    infologger->debug(szBuffer);
}


void CServerlog::WriteFormatInfoLog(char* lpszFormat, ...)
{
    va_list args;
    va_start(args, lpszFormat);
    CHAR szBuffer[1024];
    vsprintf(szBuffer, lpszFormat, args);
    va_end(args);
    infologger->info(szBuffer);
}

void CServerlog::WriteFormatWarnLog(char* lpszFormat, ...)
{
    va_list args;
    va_start(args, lpszFormat);
    CHAR szBuffer[1024];
    vsprintf(szBuffer, lpszFormat, args);
    va_end(args);

    errorlogger->warn(szBuffer);
}

void CServerlog::WriteFormatErrorLog(char* lpszFormat, ...)
{
    va_list args;
    va_start(args, lpszFormat);
    CHAR szBuffer[1024];
    vsprintf(szBuffer, lpszFormat, args);
    va_end(args);
    errorlogger->error(szBuffer);
}

另外,发现打印出的日志在某些机器上不支持中文, 中文显示为乱码,通过在配置文件中增加如下配置项即可解决:

log4j.appender.sample.encoding=UTF-8,这里,sample即为你的日志类.

前面已经说完了怎样使用log4cxx进行日志记录，今天发现问题稍有点复杂。原因是系统中用到的一个dll已经使用了log4cxx。我们在开发的过程中也想使用log4cxx,但不想与DLL中的日志写到同一个文件中，问题就来了，怎样区别打印到不同的文件中呢，DLL中采用的为应该为getRootLogger的方式。

这个网址中的文章很好，解决方案主要参考此文：http://www.open-open.com/doc/view/4bf2bd4f517c4044b1f7d4e2d22eccaf

log4cxx主要是由三部分组成：loggers, appenders和layouts.这三个主要组成部分，协同协作能够使我们根据实际的需要进行日志的输出，它们规定了日志信息的类型和级别，控制应用程序运行时的日志信息组成方式以及日志记录的输出方式。

Logger是Log4cxx的核心，Logger具有继承关系的层次结构，最顶层为RootLogger,每个Logger都有一个级别(Level),每个Logger可以附加多个Appender.Appender代表了日志输出的目标，对于每一个Appender可以通过Layout进行格式配置。

Logger命名：保持Logger与其所在的类的名称一致的方法是目前所知的最好的命名策略。

一个关于Logger继承的例子：

#设置root logger 为DEBUG级别，使用了ca, fa两个Appender

log4j.rootLogger = DEBUG, ca, fa

#设置list logger

log4j.logger.list = DEBUG, listApp

#设置list.voice logger

log4j.logger.list.voice= INFO, listVoice, listVoiceBak

list是list.voice的父亲Logger, list.voice是list的儿子Logger. rootLogger是根Logger, 在此例中list和list.voice两个Logger又都继承了rootLogger，不过只是继承了Appenders,Level并没有继。（此解有待验证）

还是看配置文件：log4cxx.properties

# 设置root logger为DEBUG级别，使用了ca和fa两个Appender 
log4j.rootLogger=DEBUG, fa, ca 
# 设置.listApp logger,屏蔽logger-list的LEVEL继承 
log4j.logger.listApp=DEBUG, listApp

# 设置.listApp2 logger,屏蔽logger-list的LEVEL继承 
log4j.logger.listApp2=DEBUG, listApp2

#屏蔽listApp的Appender继承 
log4j.additivity.listApp=false

#屏蔽listApp2的Appender继承 
log4j.additivity.listApp2=false

#对Appender fa进行设置：# 这是一个文件类型的Appender， 
log4j.appender.fa=org.apache.log4j.FileAppender 
log4j.appender.fa.ImmediateFlush=true

# 其输出文件（File）为 Runlog.log， 
log4j.appender.fa.File=Runlog.log 
log4j.appender.fa.layout=org.apache.log4j.PatternLayout

# 输出方式（Append）为覆盖方式， 
log4j.appender.fa.Append=false

# 输出格式（layout）为PatternLayout 
log4j.appender.fa.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %.16c - %m%n

#对Appender ca进行设置：

# 这是一个控制台类型的Appender 
log4j.appender.ca=org.apache.log4j.ConsoleAppender

# 输出格式（layout）为PatternLayout 
log4j.appender.ca.layout=org.apache.log4j.PatternLayout 
log4j.appender.ca.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %.16c - %m%n

#对Appender listApp进行设置# 这是一个文件类型的Appender， 
log4j.appender.listApp=org.apache.log4j.FileAppender

#立即写入日志文件 
log4j.appender.listApp.ImmediateFlush=true

# 其输出文件（File）为 listApp.log 
log4j.appender.listApp.File=listApp.log

# 输出方式（Append）为覆盖方式， 
log4j.appender.listApp.Append=false 
log4j.appender.listApp.layout=org.apache.log4j.PatternLayout 
log4j.appender.listApp.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %.16c - %m%n

#对Appender listApp2进行设置 
log4j.appender.listApp2=org.apache.log4j.FileAppender 
log4j.appender.listApp2.ImmediateFlush=true 
log4j.appender.listApp2.File=listApp2.log 
log4j.appender.listApp2.Append=false 
log4j.appender.listApp2.layout=org.apache.log4j.PatternLayout 
log4j.appender.listApp2.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %.16c - %m%n

以下为实现代码：

// testlog4cxx.cpp : 定义控制台应用程序的入口点。
//

#include "stdafx.h"
#include <iostream>
using namespace std;
#include <log4cxx/logger.h>
#include <log4cxx/propertyconfigurator.h>

using namespace log4cxx;
using namespace log4cxx::helpers;

int _tmain(int argc, _TCHAR* argv[])
{

    PropertyConfigurator::configure("log4cxx.properties");

    LOG4CXX_INFO(log4cxx::Logger::getLogger("list5"), "list，log4cxx!");
    LOG4CXX_INFO(log4cxx::Logger::getLogger("list5"), "list，mylog4cxx!");

    LOG4CXX_INFO(log4cxx::Logger::getLogger("listApp"), "listApp，log4cxx!");

    LOG4CXX_INFO(log4cxx::Logger::getLogger("listApp2"), "listApp2, hello world!");

    return 0;
}

将log4cxx.properties与生成后的testlog4cxx.exe放置同一目录，运行后发现目录下生成三个文件，分别为：他们的文件名及内容分别为

Runlog.log:

2012-04-06 21:13:56 INFO  list5 - list，log4cxx! 
2012-04-06 21:13:56 INFO  list5 - list，mylog4cxx!

listApp.log:

2012-04-06 21:13:56 INFO  listApp - listApp，log4cxx! 
2012-04-06 21:13:56 INFO  listApp - listApp TimeRsp.nErrno: 123

listApp2.log:

2012-04-06 21:13:56 INFO  listApp2 - listApp2, hello world!

由此可以看出，所有Logger默认继承于rootLogger的Appender,一般情况下（Level级别允许）总会在Runlog.log中打出，若想有所例外，需用配置log4j.additivity.AppenderName = false将默认继承去除。