(C++)跨平台日志库——yaolog v1.6

       

        写代码总免不了要看日志。就C++而言，不少程序员只是简单地用printf来输出日志，或者临时写个日志类，log4cpp等比较“重型”的日志库的使用率反而并不怎么高（至少从我经历的项目而言）。也许是不想为不需要的功能付出额外的学习成本，但无论如何，对于通用类别的工具采取临时手写的方式来应付，从长远考虑，在功能性和健壮性方面是得不偿失的。写这个日志类(yaolog)的最初的想法只是为了实现“输出到文件的带有时间信息的printf”，后来历经不同项目需求的“拷问”，借鉴和引用了很多开源代码（在此对那些作者表示感谢），就成了现在这个样子。yaolog的主要特点如下：

        # printf风格的接口，包括LOGA__, LOGW__, LOG__, LOGBIN__, LOGBIN_F__
        # 日志附加信息包括时间，源代码文件，函数，行号
        # 每个日志对象都有单独的行为
        # 在程序运行时通过配置ini文件动态改变日志行为
        # 可以输出到控制台窗口，文件，http服务器
        # 线程安全
        # 跨平台(windows, linux)

        

v1.6新加功能：
1 可以输出格式化的二进制日志（见上图），非常方便对socket通信之类进行debug
2 可以设置每天自动生成新的日志文件

        这里有一个重点就是尽可能的简单，我对接口修改过多次，为了尽量做到简单易用和自解释。而上述功能都是从实际项目的需求中提炼出来的，比如为什么每个日志对象需要有单独的行为？看日志文件最大的烦恼就是内容太多太杂不容易找到需要的，那么yaolog给出一种解决方法是设置不同的日志对象，如果想专门查看socket日志，可以只启用socket日志对象，或者将socket日志专门输出到一个文件，而这些都是可以在程序运行时动态配置的。又比如发送日志到http服务器，起因于某次有个用户在QQ上报了一个bug，这个bug如果在有日志的debug版本下应该能很快确定原因，但是release版本是没有日志的。当然，也可以给用户一个带日志的dll去替换，但是这种方法至少存在两个问题：版本控制（新的dll和用户原来的dll一致吗）和日志查看（用户怎样将日志提交给开发人员，不要高估了小白）。于是就想到要在服务器端控制日志的启用，以及将日志内容发送到服务器进行分析。

         yaolog v1.6的代码和demo在这里

        另外我在codeproject上发了一篇详细说明，地址在这里

        如果你觉得这个工具好用请回帖支持一下。有什么问题或建议可以留言讨论。

        下面贴一段简单的测试代码：

#include <iostream>#include "yaolog.h"// 日志对象的ID，可以自定义，不能雷同#define LOGID_I "info"#define LOGID_B "bin"#define LOGID_FB "formatted_bin"int main(){    // 初始化，在程序入口点调用    YAOLOG_INIT;    // 创建日志对象    YAOLOG_CREATE(LOGID_I, true, YaoUtil::LOG_TYPE_TEXT);    YAOLOG_CREATE(LOGID_B, true, YaoUtil::LOG_TYPE_BIN);    YAOLOG_CREATE(LOGID_FB, true, YaoUtil::LOG_TYPE_FORMATTED_BIN);    LOGA__(LOGID_I, "My name is %s! I'm %d!", "neil", 29);    // 设置日志对象的属性：输出日志到控制台窗口和文件    YAOLOG_SET_LOG_ATTR(LOGID_I, true, YaoUtil::LOGOUT_FLAG_STDOUT | YaoUtil::LOGOUT_FLAG_FILE, true, false, true, true, NULL);    LOGW__(LOGID_I, L"My name is %s! I'm %d!", L"neil", 29);    // 设置日志对象的属性：输出日志到文件和http服务器    YAOLOG_SET_LOG_ATTR(LOGID_I, true, YaoUtil::OUT_FLAG_FILE | YaoUtil::OUT_FLAG_REMOTE, true, true, true, true, "http://192.168.1.195/default.aspx");     YAOLOG_SET_LOGFILE_ATTR(LOGID_I, false, false, false, "c:\\logfile", "tt.log");     LOG__(LOGID_I, _T("My name is %s! I'm %d!"), _T("neil"), 29);    // 设置日志对象的属性：使用ini文件    YAOLOG_SET_ATTR_FROM_CONFIG_FILE(LOGID_I, "logconfig.ini");    for (int i = 0; i < 100; i++)    {        LOGA__(LOGID_I, "You can modify the ini file and view effect(%d)!", i);        Sleep(500);    }    // 二进制日志     YAOLOG_CREATE(LOGID_B, true, YaoUtil::LOG_TYPE_BIN);    YAOLOG_SET_ATTR_FROM_CONFIG_FILE(LOGID_B, "logconfig.ini");    char buf[10] = { 0,1,2,3,4,5,6,7,8,9 };    LOGBIN__(LOGID_B, buf, 10);    // 格式化的二进制日志    YAOLOG_CREATE(LOGID_FB, true, YaoUtil::LOG_TYPE_FORMATTED_BIN);    YAOLOG_SET_ATTR_FROM_CONFIG_FILE(LOGID_FB, "logconfig.ini");     char data1[4] = { 0,1,2,3 };    char data2[4] = { 4,5,6,7 };    LOGBIN_F__(LOGID_FB, "send", data1, 4);    LOGBIN_F__(LOGID_FB, "recv", data2, 4);    std::cin.get();    // 清理，在程序退出前调用    YAOLOG_EXIT;    return 0;}