便利的开发工具-log4cpp快速使用指南

log4cpp::BasicLayout 	   // 以“时间戳 优先级（priority，下文介绍）
// 类别（category，下文介绍）
// NDC标签（nested diagnostic contexts 下文介绍）: 日志信息”。
// 如：1056638652 INFO main : This is some info
log4cpp::PatternLayout 	// 让用户根据类似于 C 语言 printf 函数的转换模式
//来指定输出格式。格式定义见代码附带文档。
log4cpp::SimpleLayout 	// 以“优先级（priority） - 日志信息”格式显示。

log4cpp::IdsaAppender
// 发送到IDS或者logger, 详细见 http://jade.cs.uct.ac.za/idsa/ log4cpp::FileAppender       // 输出到文件
log4cpp::RollingFileAppender
// 输出到回卷文件，即当文件到达某个大小后回卷
log4cpp::OstreamAppender     // 输出到一个ostream类
log4cpp::RemoteSyslogAppender   // 输出到远程syslog服务器
log4cpp::StringQueueAppender   // 内存队列
log4cpp::SyslogAppender     // 本地syslog
log4cpp::Win32DebugAppender   // 发送到缺省系统调试器
log4cpp::NTEventLogAppender   // 发送到win 事件日志

// FileName: test_log4cpp1.cpp
// Test log4cpp by manual operation.
// Announce: use as your own risk.
// Compile : g++ -otest1 -llog4cpp test_log4cpp1.cpp
// Run     : ./test1
// Tested  : RedHat 7.2 log4cpp0.3.4b
// Author  : liqun (liqun@nsfocus.com)
// Data    : 2003-6-27
#include	"log4cpp/Category.hh"
#include	"log4cpp/FileAppender.hh"
#include	"log4cpp/BasicLayout.hh"
int main(int argc, char* argv[])
{
// 1实例化一个layout 对象
log4cpp::Layout* layout =
new log4cpp::BasicLayout();
// 2. 初始化一个appender 对象
log4cpp::Appender* appender = new
log4cpp::FileAppender("FileAppender",
"./test_log4cpp1.log");
// 3. 把layout对象附着在appender对象上
appender->setLayout(layout);
// 4. 实例化一个category对象
log4cpp::Category& warn_log =
log4cpp::Category::getInstance("mywarn");
// 5. 设置additivity为false，替换已有的appender
warn_log.setAdditivity(false);
// 5. 把appender对象附到category上
warn_log.setAppender(appender);
// 6. 设置category的优先级，低于此优先级的日志不被记录
warn_log.setPriority(log4cpp::Priority::WARN);
// 记录一些日志
warn_log.info("Program info which cannot be wirten");
warn_log.debug("This debug message will fail to write");
warn_log.alert("Alert info");
// 其他记录日志方式
warn_log.log(log4cpp::Priority::WARN, "This will be a logged warning");
log4cpp::Priority::PriorityLevel priority;
bool this_is_critical = true;
if(this_is_critical)
priority = log4cpp::Priority::CRIT;
else
priority = log4cpp::Priority::DEBUG;
warn_log.log(priority,"Importance depends on context");

warn_log.critStream() << "This will show up << as "
<< 1 << " critical message"
<< log4cpp::CategoryStream::ENDLINE;
// clean up and flush all appenders
log4cpp::Category::shutdown();
return 0;
}

# a simple test config
#定义了3个category sub1, sub2, sub1.sub2
log4j.rootCategory=DEBUG, rootAppender
log4j.category.sub1=,A1
log4j.category.sub2=INFO
log4j.category.sub1.sub2=ERROR, A2
# 设置sub1.sub2 的additivity属性
log4j.additivity.sub1.sub2=false
#定义rootAppender类型和layout属性
log4j.appender.rootAppender=org.apache.log4j.ConsoleAppender
log4j.appender.rootAppender.layout=org.apache.log4j.BasicLayout
#定义A1的属性
log4j.appender.A1=org.apache.log4j.FileAppender
log4j.appender.A1.fileName=A1.log
log4j.appender.A1.layout=org.apache.log4j.SimpleLayout
#定义A2的属性
log4j.appender.A2=org.apache.log4j.ConsoleAppender
log4j.appender.A2.layout=org.apache.log4j.PatternLayout
log4j.appender.A2.layout.ConversionPattern=The message '%m' at time %d%n

log4j / log4cpp . [category / appender].[category or appender 's name].
[category or appender 's property]
= [Appender / Layout / property's value / Priority, appender name1 [appender name2 ...]]
[appender]
{ConsoleAppender}
{FileAppender}  // 当appender的类型是FileAppender时，可以定义它下面的属性。
[fileName]  string  foobar  // 格式是：属性名 值的类型 缺省值
[append]  bool  true
{RollingFileAppender}
[fileName]   string  foobar
[maxFileSize]  num  10*1024*1024
[maxBackupIndex]  num  1
[append]  bool  true
{SyslogAppender}
[syslogName]  string  syslog
[syslogHost]  string  localhost
[facility]  num  -1  // * 8 to get LOG_KERN, etc. compatible values.
[portNumber]  num  -1
{IdsaAppender}
[idsaName]  string  foobar
{Win32DebugAppender}
{NTEventLogAppender}
[source]  string  foobar

[threshold]  string ""  // 全部
// 如果此类型appender需要layout，必须定义此appender的下面属性
[layout]
{BasicLayout}
{SimpleLayout}
{PatternLayout}
// 当layout的值是BasicLayout时，需要定义下面的属性。
[ConversionPattern]

[rootCategory]
[additivity]
[category name]  bool  true

// FileName: test_log4cpp2.cpp
// Test log4cpp by config file.
// Announce: use as your own risk.
// Compile : g++ -llog4cpp test_log4cpp2.cpp
// Run     : ./a.out
// Tested  : RedHat 7.2 log4cpp0.3.4b
// Author  : liqun (liqun@nsfocus.com)
// Data    : 2003-6-27
#include "log4cpp/Category.hh"
#include "log4cpp/PropertyConfigurator.hh"
int main(int argc, char* argv[])
{
// 1 读取解析配置文件
// 读取出错, 完全可以忽略，可以定义一个缺省策略或者使用系统缺省策略
// BasicLayout输出所有优先级日志到ConsoleAppender
try {
log4cpp::PropertyConfigurator::configure("./log4cpp.conf");
} catch(log4cpp::ConfigureFailure& f) {
std::cout << "Configure Problem " << f.what() << std::endl;
return -1;
}

// 2 实例化category对象
// 这些对象即使配置文件没有定义也可以使用，不过其属性继承其父category
// 通常使用引用可能不太方便，可以使用指针，以后做指针使用
// log4cpp::Category* root = &log4cpp::Category::getRoot();
log4cpp::Category& root = log4cpp::Category::getRoot();

log4cpp::Category& sub1 =
log4cpp::Category::getInstance(std::string("sub1"));
log4cpp::Category& sub3 =
log4cpp::Category::getInstance(std::string("sub1.sub2"));
// 3 正常使用这些category对象进行日志处理。
// sub1 has appender A1 and rootappender.
sub1.info("This is some info");
sub1.alert("A warning");

// sub3 only have A2 appender.
sub3.debug("This debug message will fail to write");
sub3.alert("All hands abandon ship");
sub3.critStream() << "This will show up << as " << 1 << " critical message"
<< log4cpp::CategoryStream::ENDLINE;
sub3 << log4cpp::Priority::ERROR
<< "And this will be an error"
<< log4cpp::CategoryStream::ENDLINE;
sub3.log(log4cpp::Priority::WARN, "This will be a logged warning");

return 0;
}

if(sub1.isDebugEnabled())
{
sub1.debug(string("Current num is") + i + GetCurStat());
}