ZLToolKit模块(一)logger-创新互联

文章目录

• 功能描述
• 使用示例
• 源码分析
• • 类图
  • 源码分析
• C++11
• • 禁止拷贝和移动的基类
  • enable_shared_from_this
  • List及const成员函数

凤泉网站制作公司哪家好，找创新互联！从网页设计、网站建设、微信开发、APP开发、响应式网站建设等网站项目制作，到程序开发，运营维护。创新互联公司2013年成立到现在10年的时间，我们拥有了丰富的建站经验和运维经验，来保证我们的工作的顺利进行。专注于网站建设就选创新互联。

---

功能描述

ZLToolkit的日志模块。

1. 支持console,文件，广播三种输出通道，支持异步输出。
2. 支持按时间、文件数量，文件大小进行清理和切片。
3. 支持三种输出风格(cout, printf, 可变长模板)。
4. 支持重载<<的类。
5. 参考test_logger测试代码。

---

使用示例

#include "Util/logger.h"
int main()
{
    Logger::Instance().add(std::make_shared());
    Logger::Instance().setWriter(std::make_shared());
    TraceL<< "int"<< (int)1<< endl;
    PrintT("this is a %s test:%d", "printf trace", 124);
    LogT(1, "+", "2", '=', 3);
    return 0;
}

源码分析 类图

源码分析

1. LogContext
   存储日志的打印信息，继承了ostringstream用<<存储内容和str()输出日志内容的字符串。
   _repeat成员变量用来记录重复日志的次数，避免短时间重复打印同样的日志。

使用如下:

void Logger::writeChannels(const LogContextPtr &ctx) {
     if (ctx->_line == _last_log->_line && ctx->_file == _last_log->_file && ctx->str() == _last_log->str()) {
        //重复的日志每隔500ms打印一次，过滤频繁的重复日志
        ++_last_log->_repeat;
        if (timevalDiff(_last_log->_tv, ctx->_tv) >500) {  //超过500ms，打印一条
            ctx->_repeat = _last_log->_repeat;  //ctx->_repeat要继承过来
            writeChannels_l(ctx); 
        }
        return;
    }
    if (_last_log->_repeat) {    //上一条日志短时间内一直重复，没有打印出来，最后打印一下
        writeChannels_l(_last_log);
    }
    writeChannels_l(ctx);
}

1. Logger
   单例，核心类，所有的重要操作几乎都是由这个类完成。

   • add() 添加输出通道
   • setWriter() 设置异步写日志线程
   • setLevel() 设置所有日志通道的log等级
   • write() 写日志,如果调用过setWriter，则异步写，否则直接同步写

2. LogChannel
   日志通道，负责格式化日志并打印到输出流
   void format(const Logger &logger, std::ostream &ost, const LogContextPtr &ctx, bool enable_color, bool enable_detail)函数负责将LogContex的内容进行格式化并输出ost中。

   • ConsoleChannel: format函数的输出参数设置位std::cout。
   • FileChannelBase: 文件输出通道的基类。
   • FileChannel: 文件输出实际使用的类，自动清理的日志文件通道。主要是在write前检测文件夹和文件大小，并创建新文件、更新index信息、删除过期的日志文件。最后调用FileChannelBase的write函数写文件。
   • EventChannel: 事件通道。向注册在“kBroadcastLogEvent”的listener emit日志上下文信。

3. LogWriter/AsyncLogWriter
   LogWriter只是作为一个基类，几乎没有实现。AsyncLogWriter是一个使用率很高的类，这个类开启了一个线程用于写日志。
   write函数用于将日志暂存进_pending对象，并唤醒阻塞的信号量刷新日志。
   ** flushAll**函数用于刷新日志。

   void AsyncLogWriter::flushAll() {
       decltype(_pending) tmp;
       {
           lock_guardlock(_mutex);
           tmp.swap(_pending);
       }
   
       tmp.for_each([&](std::pair&pr) {
           pr.second->writeChannels(pr.first);
       });
   }

   这个函数将_pending的日志先交换到tmp对象再进行打印。可以优先减少锁的时间，提高效率。

4. LogContextCapture
   每次打印的时候会生成该类的临时对象，在构造时生成LogContext对象并与logger对象进行关联，结束后主要是生成LogContext对象并将logger对象于其进行关联。比较有意思的是LogContextCapture &operator<<(std::ostream &(*f)(std::ostream &))这个函数，会在参数为std::endl(回车符)的时候是调用，这个函数会调用_logger.write(_ctx)将日志立即输出。

5. LoggerWrapper包装类
   这个类用于支持printf和可变参数格式。实现比较简单，但是对模板的使用很巧妙。

   templatestatic inline void printLogArray(Logger &logger, LogLevel level, const char *file, const char *function, int line, First &&first, ARGS &&...args) {
       LogContextCapture log(logger, level, file, function, line);
       log<< std::forward(first);
       appendLog(log, std::forward(args)...);
   }
   
    templatestatic inline void appendLog(Log &out, First &&first, ARGS &&...args) {
       out<< std::forward(first);
       appendLog(out, std::forward(args)...);
   }
   
    templatestatic inline void appendLog(Log &out) {}

   将第一个参数用First &&first和其余参数区分开。First &&first和std::forward(first)是完美转发，不改变first的左值或者右值属性。printLogArray创建了一个LogContextCapture对象，交给appendLog进行<<处理，直到最后一次空调用。

C++11 禁止拷贝和移动的基类

//禁止拷贝基类
class noncopyable {
protected:
    noncopyable() {}
    ~noncopyable() {}
private:
    //禁止拷贝
    noncopyable(const noncopyable &that) = delete;
    noncopyable(noncopyable &&that) = delete;
    noncopyable &operator=(const noncopyable &that) = delete;
    noncopyable &operator=(noncopyable &&that) = delete;
};

将拷贝函数声明为delete，当你尝试调用这些函数时，编译器会抛出一个错误, 而且派生类不能重写这个函数。
default也是可以简化开发。

class MyClass {
 public:
  MyClass() = default;  // 提供缺省的构造函数
  MyClass(const MyClass& other) = default;  // 提供缺省的拷贝构造函数
  MyClass& operator=(const MyClass& other) = default;  // 提供缺省的拷贝赋值运算符
  // 其他成员函数
 private:
  int x;
};

enable_shared_from_this

说明：
若一个类T继承了std::enable_shared_from_this,则会为该类T提供成员函数:shared_from_this.当T类型对象t被一个为名为 pt的std::shared_ptr 类对象管理时,调用 T::shared_from_this 成员函数，将会返回一个新的std::shared_ptr 对象,它与pt共享t的所有权。

示例：

class A : public std::enable_shared_from_this 
{
public:
	std::shared_ptr getptr() {
		return shared_from_this();
	}
	~A() { std::cout<< "A::~A() called"<< std::endl; }
};
 
int main()
{
	{
		std::shared_ptr a1(new A());
		std::shared_ptr a2 = a1->getptr();
		std::cout<< "a1.use_count() = "<< a1.use_count()<< std::endl;  //2 
		std::cout<< "a2.use_count() = "<< a2.use_count()<< std::endl;  //2 
	}
}

使用场景：
在异步调用中，存在一个保活机制，异步函数执行的时间点我们是无法确定的，然而异步函数可能会使用到异步调用之前就存在的变量。为了保证该变量在异步函数执期间一直有效，我们可以传递一个指向自身的share_ptr给异步函数，这样在异步函数执行期间share_ptr所管理的对象就不会析构，所使用的变量也会一直有效了（保活）。

List及const成员函数

templateclass List : public std::list{
public:
    templateList(ARGS &&...args) : std::list(std::forward(args)...) {};

    ~List() = default;

    void append(List&other) {
        if (other.empty()) {
            return;
        }
        this->insert(this->end(), other.begin(), other.end());
        other.clear();
    }

    templatevoid for_each(FUNC &&func) {
        for (auto &t : *this) {
            func(t);
        }
    }

    templatevoid for_each(FUNC &&func) const {  //const List& listRef = list; const List* listPtr = &list调用的版本
        for (auto &t : *this) {
            func(t);
        }
    }
};

你是否还在寻找稳定的海外服务器提供商？创新互联www.cdcxhl.cn海外机房具备T级流量清洗系统配攻击溯源，准确流量调度确保服务器高可用性，企业级服务器适合批量采购，新人活动首月15元起，快前往官网查看详情吧

当前题目：ZLToolKit模块(一)logger-创新互联
路径分享：http://dzwzjz.com/article/desdgi.html