Poco logger 日志使用小析
日志
在软件开发过程中，为了定位软件运行过程中可能出现的错误，一种常用的做法是在潜在的错误位置，设置防御代码，并且将错误代码执行后的错误信息记录下来，以供后续改进代码提供支持。
在日志记录的内容，为了定位错误，最基本的信息要求一下几点：
- 日期
- 时间
- 文件位置
- 触发错误代码行号
- 详细的错误信息
日志记录上述信息之后，基本确定错误的地点，从而有的放矢的实现对代码的重构和优化
logger 库选择
基于C++ 的logger 库有很多， glog ， log4cplus ， log4cpp， Poco::logger ， 这些库都是不错的，都有着不错的背景和强劲的技术开发团队。glog背后站着的谷歌这样的巨头。而log4cplus 的干爹则是Java库，其设计思路基本沿袭的java 一贯的OOP 风格 。 鉴于笔者长期使用Poco 作为C++ 的基础库作为STL库 的拓展库使用，为了保持代码的一致性风格，我优先选择了Poco::logger 作为开发库
Poco::logger 架构简析
这里笔者不想过多的介绍Poco::logger 设计思路，这方面的内容官方比我讲的要好的多。 理解logger 库的最核心一点就是看懂logger库的层次结构，这种设计方式很好的实现解耦，并且层次结构分明，非常值得学习
步骤一 生成消息
步骤二 写入logger
步骤三 导入channel
步骤四 写文件
使用
如何使用poco::logger ， 我想最好的方式就是贴代码了。 通过代码的方式一目了然的理解如何poco::logger 。 依葫芦画瓢是作为一名软件开发者最基本的素质
.h file
#pragma once
#include "Poco/Logger.h"
using Poco::Logger; // for global decorator
namespace Logger
{
#define logger_handle (Logger::get("logger"))
void Logger_initiation(); // initiation
void Setup_logger(); // init only once
}.cpp file
#include "StdAfx.h"
#include "dante_logger.h"
#include "Poco/PatternFormatter.h"
#include "Poco/FormattingChannel.h"
#include "Poco/FileChannel.h"
#include "Poco/AutoPtr.h"
using namespace Poco;
namespace Logger
{
void Logger_initiation()
{
AutoPtr<FileChannel> file_channel(new FileChannel());
file_channel->setProperty("rotation" ,"10M");
file_channel->setProperty("archive" ,"timestamp");
file_channel->setProperty("path" ,"dante_route_log.log");
AutoPtr<PatternFormatter> pattern_formatter (new PatternFormatter("%L%H:%M:%S-code line :%u-%U : %t"));
AutoPtr<FormattingChannel> formatter_channle(new FormattingChannel(pattern_formatter , file_channel));
Logger::root().setChannel(formatter_channle);
///- finish logger initiation
}
void Setup_logger()
{
static bool b_setup =false; // only allow run once time
if (! b_setup)
{
b_setup =true;
Logger_initiation();
}
}
}main 入口函数
using Logger;
void Test_logger()
{
poco_information(logger_handle , "hello world，this is a 苍原狮啸's blog");
}
int main()
{
Setup_logger();
Test_logger();
}备注
经过笔者测试，发现Poco::logger 不支持在类中完成 Logger 的初始化过程， 一旦在类中初始化logger ，软件就会自动抛出异常。因为logger 作为一个在整个过程中都是视为全局变量。
拓展
作为开发者，个人觉得最好的方式，就是连初始化的过程都能直接自动完成，最好是在加载文件的时候就直接完成，而不是需要使用者使用调用一次Setup_logger() 来完成相关的操作。 有更好的解决方案的读者欢迎分享您的理解和方案
总结
通过对Poco::logger简单的封装之后，就可以做到一处初始化后，到处使用了.
在需要使用的地点，只需添加头文件和using namespace. 调用过程则全程使用宏，将所需要记录的消息记录下来即可。是不是觉很方便呢？