简介
本篇文章源码的地址为:https://github.com/freshman94/NetLib
多线程日志库的设计参照了陈硕先生的muduo库。与日志库相关的类有:
- FileUtil
- LogFile
- LogStream
- Logger
- AsyncLogging
详解
FileUtil
FileUtil实现了作为最底层的文件封装类AppendFile,构造时会打开日志文件(不存在时创建),并调用setbuffer设置文件缓冲区。构造函数会关闭日志文件。其关键的成员函数为
void append(const char* logline, size_t len);
void flush();
append将日志消息写入缓冲区中,flush则将缓冲区中的日志消息冲洗到日志文件中
LogFile
进一步封装FileUtil,并提供了日志文件滚动(rolling)的功能。其构造函数的声明为:
LogFile(const string& basename,
off_t rollSize,
bool threadSafe = true,
int flushInterval = 3,
int checkEveryN = 1024);
basename表示日志文件名。
rollSize表示日志文件的maxsize,如果超过了该值,日志就会滚动,也就是会另建一个日志文件,这样可以简化日志归档的实现。
日志库默认是线程安全的,因为会保证只有一个线程可以访问该线程库,后面会解释。
flushInterval表示flush日志文件的时间间隔,默认3秒。checkEveryN表示往日志文件写了多少条日志消息后,就flush日志文件。两个条件同时满足才会生效。
构造函数会调用函数rollFile()
新建一个日志文件。
核心成员函数为:
public:
void append(const char* logline, int len);
void flush();
bool rollFile();
private:
void append_unlocked(const char* logline, int len);
static string getLogFileName(const string& basename, time_t* now);
append函数基于append_unlocked函数、rollFile函数实现日志文件滚动的功能。
getLogFileName则生成日志文件名,日志文件名的格式为&