booster log 库介绍

用什么在C++程序里面写日志？一直在等待boost发布真正的日志库，就是不见踪影。以前用的log4cxx也太老了。在使用CppCMS的时候，发现了Artyom开发的booster::log，用法简单，值得推荐。

编译CppCMS的方法请看我以前的博客。

然后在你的C++代码中这样写：

#include <booster/log.h>#include <booster/shared_ptr.h>/* *  */int main(int argc, char** argv) {    booster::shared_ptr<booster::log::sinks::file> f(new booster::log::sinks::file());    f->append();    f->max_files(10);    f->open("/opt/test.log");    booster::log::logger::instance().add_sink(f);    booster::log::logger::instance().set_default_level(booster::log::notice);        return 0;}

运行看一下，/opt/test.log日志产生了。

max_files是什么意思？指的是最多生成10个日志文件，每次调用f->open的时候，就会产生一个新的test.log文件，而把旧的文件重命名，比如叫做test.log.1

注意max_files调用需要在open之前，否则无效，因为实现代码如下：cppcms1.0.2/booster/log/src/log.cpp

void file::max_files(unsigned m){if(!opened_) max_files_=m;}

目前旋转日志不支持按照文件大小自动切分，不过看了里面的代码，有max_size和current_size变量，Artyom日后应该会增加这个功能。

所有的日志处理类都继承自booster::sink类，你可以实现自己的处理类，然后调用add_sink就可以接手日志消息。

参考文档见：http://cppcms.com/cppcms_ref/latest/namespacebooster_1_1log.html#details

看看如何写日志吧。

BOOSTER_ERROR("main") << "The configuration file path specified by paramerter doens't exit,file path:" << xml_path;

宏BOOSTER_ERROR可以输出日志。_ERROR代表日志级别，低于默认级别的不会出现在日志文件中。

enum  level_type {   emergency = 0, alert = 10, critical = 20, error = 30,   warning = 40, notice = 50, info = 60, debug = 70,   all = 100 }

在前面的日志级别高，越往后越低。

宏的定义都在log.h文件中:

#define BOOSTER_LOG(level,module) \::booster::log::logger::instance().should_be_logged(::booster::log::level,module)\&& ::booster::log::message(::booster::log::level,module,__FILE__,__LINE__).out()/// Same as BOOSTER_LOG(emergency,m)#define BOOSTER_EMERG(m)BOOSTER_LOG(emergency,m)/// Same as BOOSTER_LOG(alert,m)#define BOOSTER_ALERT(m)BOOSTER_LOG(alert,m)/// Same as BOOSTER_LOG(critical,m)#define BOOSTER_CRITICAL(m)BOOSTER_LOG(critical,m)/// Same as BOOSTER_LOG(error,m)#define BOOSTER_ERROR(m)BOOSTER_LOG(error,m)/// Same as BOOSTER_LOG(warning,m)#define BOOSTER_WARNING(m)BOOSTER_LOG(warning,m)/// Same as BOOSTER_LOG(notice,m)#define BOOSTER_NOTICE(m)BOOSTER_LOG(notice,m)/// Same as BOOSTER_LOG(info,m)#define BOOSTER_INFO(m)BOOSTER_LOG(info,m)/// Same as BOOSTER_LOG(debug,m)#define BOOSTER_DEBUG(m)BOOSTER_LOG(debug,m)

关于时区，最早默认为GMT+0，后来我在mailing list中提了意见，现在是更友好的本地时区为默认值，不过可以通过函数set_timezone设置你想要的时区。