log4cplus是C++编写的开源的日志系统,功能非常全面,用到自己开发的工程中会比较专业的,:),本文介绍了log4cplus基本概念,以及如何安装,配置。
### 简介 ###
log4cplus是C++编写的开源的日志系统,前身是java编写的log4j系统.受Apache Software License保护。作者是Tad E. Smith。log4cplus具有线程安全、灵活、以及多粒度控制的特点,通过将信息划分优先级使其可以面向程序调试、运行、测试、和维护等全生命周期; 你可以选择将信息输出到屏幕、文件、NT event log、甚至是远程服务器;通过指定策略对日志进行定期备份等等。
### 下载 ###
最新的log4cplus可以从以下网址下载 http://log4cplus.sourceforge.net本文使用的版本为:1.0.4
### 安装 ###
1. linux下安装
tar xvzf log4cplus-x.x.x.tar.gzcd log4cplus-x.x.x./configure --prefix=/where/to/install
make
make install
这里我采用缺省安装路径:/usr/local,下文如无特别说明,均以此路径为准。
查看安装后的目录信息:
2.运行log4cplus实例:
官方实例运行成功。
3。与IDE集成测试。
这里,我使用的IDE为netbeans7.0采用samba实现linux与windows文件共享。
netbeans环境配置如下:
采用动态链接库
编写一个简单的main.c
#include <log4cplus/logger.h>
#include <log4cplus/configurator.h>
#include <iomanip>
using namespace log4cplus;
int main(void) {
BasicConfigurator config;
config.configure();
Logger logger = Logger::getInstance("main");
LOG4CPLUS_WARN(logger, "Hello, World!");
return 0;
} 运行:
WARN - Hello, World!
运行成功(总计时间: 62毫秒)
常用的封装后的使用:
vlog.h
/**//*
* File: vlog.h
* Author: Vicky
*
* 1.安装log4cplus。
* 2.C++ 编译器 : 其他选项 -lpthread -llog4cplus
* 3.C++ 连接器 : 运行时搜索目录 /usr/local/lib
* Created on 2011年12月8日, 下午1:53
*/
#ifndef VLOG_H
#define VLOG_H
#include <log4cplus/logger.h>
#include <log4cplus/layout.h>
#include <log4cplus/loglevel.h>
#include <log4cplus/fileappender.h>
#include <log4cplus/consoleappender.h>
#include <log4cplus/helpers/loglog.h>
using namespace log4cplus;
using namespace helpers;
/**//**
* 使用log4cplus
* @param logfile 记录的文件路径,如“main.log”
* @param format 格式化前缀,默认%d [%l] %-5p : %m %n
* @param bebug 是否打印bebug信息,默认true
* @param lv 设置日记级别
* @return
*/
void initLog4cplus(
const char* logfile,
const bool console = true,
const bool bebug = true,
LogLevel lv = DEBUG_LOG_LEVEL,
const char* format = "%d %-5p [%c < %l] : %m %n"
);
/**//**
* 获得根日志
* @return
*/
Logger getRootLogger(void);
/**//**
* 获得子日志
* @param child 子日志名,如,sub;sub.sub1
* @return
*/
Logger getSubLogger(const char* sub);
/**//**
* 关闭日志系统
*/
void shutdownLogger(void);
#endif /* VLOG_H */
vlog.cpp
#include "vlog.h"
void initLog4cplus(const char* logfile, const bool console, const bool bebug,
LogLevel lv, const char* format)
/**//*
NOT_SET_LOG_LEVEL ( -1) :接受缺省的LogLevel,如果有父logger则继承它的
LogLevelALL_LOG_LEVEL ( 0) :开放所有log信息输出
TRACE_LOG_LEVEL ( 0) :开放trace信息输出(即ALL_LOG_LEVEL)
DEBUG_LOG_LEVEL (10000) :开放debug信息输出
INFO_LOG_LEVEL (20000) :开放info信息输出
WARN_LOG_LEVEL (30000) :开放warning信息输出
ERROR_LOG_LEVEL (40000) :开放error信息输出
FATAL_LOG_LEVEL (50000) :开放fatal信息输出
OFF_LOG_LEVEL (60000) :关闭所有log信息输出
*/ {
// 0.日志系统配置:设置显示debug信息
LogLog::getLogLog()->setInternalDebugging(bebug);
// 创建屏幕输出Appender,不采用stderror流,不采用立刻写入模式
SharedAppenderPtr pappender1(new RollingFileAppender(LOG4CPLUS_TEXT(logfile), 1024 * 1024, 10, false));
// 生成的日志文件名称,文件最大值(最小1M),扩展文件个数,不采用立刻写入模式
// 2.实例化一个layout对象
// 2.1创建layout布局格式
tstring pattern = LOG4CPLUS_TEXT(format);
std::auto_ptr<Layout> playout1(new PatternLayout(pattern));
// 3.将layout对象绑定(attach)到appender对象
// pappender.setLayout(std::auto_ptr<Layout> layout);
pappender1->setLayout(playout1);
// 4.Logger :记录器,保存并跟踪对象日志信息变更的实体,当你需要对一个对象进行记录时,就需要生成一个logger。
Logger rootLogger = Logger::getRoot();
// 5.将appender对象绑定(attach)到logger对象,如省略此步骤,标准输出(屏幕)appender对象会绑定到logger
rootLogger.addAppender(pappender1);
if (console) {
// 1.Appenders :挂接器,与布局器紧密配合,将特定格式的消息输出到所挂接的设备终端 (如屏幕,文件等等)。
SharedAppenderPtr pappender2(new ConsoleAppender(false, false));
std::auto_ptr<Layout> playout2(new PatternLayout(pattern));
pappender2->setLayout(playout2);
rootLogger.addAppender(pappender2);
}
// 6.设置logger的优先级,如省略此步骤,各种有限级的消息都将被记录
rootLogger.setLogLevel(lv);
}
Logger getRootLogger(void) {
return Logger::getRoot();
}
Logger getSubLogger(const char* sub) {
return Logger::getInstance(LOG4CPLUS_TEXT(sub));
}
void shutdownLogger(void) {
Logger::getRoot().shutdown();
}
main.cpp
/**//*
* File: main.cpp
* Author: Vicky
*
*/
#include "vlog.h"
/**//*
*
*/
int main(void) {
// 初始化log4cplus
initLog4cplus("main.log");
// 日志对象:测试一
log4cplus::Logger test1 = getSubLogger("test1");
// 日志对象:测试一 第一次测试
log4cplus::Logger test1_01 = getSubLogger("test1.01");
// 类型日志记录
LOG4CPLUS_DEBUG(test1_01, "you can log like this :" << "hello " << 100 << '!');
// 关闭日志
shutdownLogger();
return 0;
}
OK。unix下log4cplus的安装,集成,测试!随后我将讲述Microsoft Visual Studio 2010下的安装,集成,与测试。
运行时动态链接库设置