log4cpp应用手册

转自：http://blog.csdn.net/jq0123/article/details/1042617

（部分是自己修改的）

log4cpp应用手册）

1、 下载log4cpp并解压。
       我下载的版本是log4cpp-0.3.5。
2、 打开/log4cpp-0.3.5rc3/msvc6/msvc6.dsw
        //编译log4cpp工程Release版。

       其中log4cpp工程是静态库版本，log4cppDLL工程是动态库版本，可以分别编译它们的Debug版和Release版。

3、在编译log4cppDLL时遇到的编译问题

      d:/log4cpp-0.3.5rc1/include/log4cpp/priority.hh(65) : error C2258: illegal pure syntax, must be '= 0'
      d:/log4cpp-0.3.5rc1/include/log4cpp/priority.hh(65) : error C2252: 'MESSAGE_SIZE' : pure specifier can only be specified for functions
      d:/log4cpp-0.3.5rc1/include/log4cpp/threading/msthreads.hh(160) : fatal error C1506: unrecoverable block scoping error

      解决办法：

      在priority.hh文件中，出错位置是：（如下红色位置，类的成员在定义时不能初始化）

      class LOG4CPP_EXPORT Priority {
        public:
        static const int MESSAGE_SIZE=8;

      }

      所以：将上述红色语句修改为：static const int MESSAGE_SIZE;

                在priority.cpp文件中加上  const int log4cpp::Priority::MESSAGE_SIZE = 8;

                保存，重新编译即可。
 
4、将编译后的log4cpp.lib复制到VC的Lib目录中。
      将编译生成的lib.dll放在lib文件夹下，并复制到VC的Lib目录中。
5、将头文件的目录log4cpp-0.3.4b/include/复制到VC的Include目录.
      (或者添加log4cpp-0.3.4b/include到VC的Include环境变量)

6、并在系统中注册dll

测试项目：

    

#include<iostream>
#include<log4cpp\Category.hh>
#include<log4cpp\OstreamAppender.hh>
#include<log4cpp\BasicLayout.hh>
#include<log4cpp\Priority.hh>

using namespace std;

#pragma comment(lib, "log4cppD.lib")
int main(int argc,char* argv[])
{
   log4cpp::OstreamAppender* osAppender =new log4cpp::OstreamAppender("osAppender",&cout);
   osAppender->setLayout(new log4cpp::BasicLayout());
   log4cpp::Category& root =log4cpp::Category::getRoot();
   root.addAppender(osAppender);
   root.setPriority(log4cpp::Priority::DEBUG);
   root.error("Hello log4cpp in aError Message!");
   root.warn("Hello log4cpp in aWarning Message!");
   log4cpp::Category::shutdown();   
   return 0;
}

结果：

     

//以下部分尚未验证   
6 目标工程包含库
log4cpp.lib ws2_32.lib
（要选择库连接方式相同的库）

5 包含头文件
日志记录
#include <log4cpp/Category.hh>
日志配置读取
#include <log4cpp/PropertyConfigurator.hh>
NDC
#include <log4cpp/NDC.hh>

9 日志代码
每个类可以有自己的类别(log4cpp::Category)，
可以在配置文件中添加该类别并设置日志级别。
所有的log4cpp::Category都使用同一个Appender
不同的Category配置为不同的日志级别，就可以控制日志输出的范围。
一般只使用四个记录日志级：DEBUG，INFO，WARN，ERROR
如：
log4cpp::Category::getRoot().info("Now run line %d", __LINE__);
或使用非根类别
log4cpp::Category::getInstance("MyCat").info("Now run line %d", __LINE__);

使用流：
log4cpp::Category::getInstance("main_cat").infoStream()
<< "This will show up as "
<< 1 << " emergency message"
<< log4cpp::CategoryStream::ENDLINE;

具体的函数说明见api文档.

7 读取配置代码
读取log配置文件，应在log4cpp静态成员初始化之后。
如在CXXXApp::InitInstance()中

try
{
log4cpp::PropertyConfigurator::configure("log.ini");
}
catch (log4cpp::ConfigureFailure e)
{
log4cpp::Category::getRoot().warn(e.what());
}


8 配置文件

[log4cpp]
# Set root category priority to DEBUG and its only appender to A1.
# priority enum: "FATAL", "ALERT", "CRIT", "ERROR", "WARN",
# "NOTICE", "INFO", "DEBUG", "NOTSET", "UNKNOWN"
rootCategory=DEBUG,A1
additivity.rootCategory=false

# define appender
appender.A1=RollingFileAppender
#appender.A1.threshold=NOTSET
appender.A1.fileName=XXXX.log
#appender.A1.maxFileSize=10485760
#appender.A1.maxBackupIndex=1
appender.A1.layout=PatternLayout
appender.A1.layout.ConversionPattern=[%d{%Y-%m-%d %H:%M:%S}](%p)%c %x: %m%n

appender.Info_Cons=ConsoleAppender
appender.Info_Cons.threshold=INFO
appender.Info_Cons.layout=PatternLayout
appender.Info_Cons.layout.ConversionPattern=[%d{%Y-%m-%d %H:%M:%S}](%p)%c %x: %m%n

# category for sub1
category.sub1=DEBUG,A1,Info_Cons
additivity.sub1=false
category.sub2=INFO,A1
additivity.sub1=false

# other categories

[others]
djkf=dksajf