日志
在软件开发过程中,为了定位软件运行过程中可能出现的错误,一种常用的做法是在潜在的错误位置,设置防御代码,并且将错误代码执行后的错误信息记录下来,以供后续改进代码提供支持。
在日志记录的内容,为了定位错误,最基本的信息要求一下几点:
- 日期
- 时间
- 文件位置
- 触发错误代码行号
- 详细的错误信息
日志记录上述信息之后,基本确定错误的地点,从而有的放矢的实现对代码的重构和优化
logger 库选择Poco::logger 架构简析基于C++ 的logger 库有很多, glog , log4cplus , log4cpp, Poco::logger , 这些库都是不错的,都有着不错的背景和强劲的技术开发团队。glog背后站着的谷歌这样的巨头。而log4cplus 的干爹则是Java库,其设计思路基本沿袭的java 一贯的OOP 风格 。 鉴于笔者长期使用Poco 作为C++ 的基础库作为STL库 的拓展库使用,为了保持代码的一致性风格,我优先选择了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. 调用过程则全程使用宏,将所需要记录的消息记录下来即可。是不是觉很方便呢?