wish  
日历
<2008年8月>
272829303112
3456789
10111213141516
17181920212223
24252627282930
31123456
统计
  • 随笔 - 4
  • 文章 - 1
  • 评论 - 34
  • 引用 - 0

导航

常用链接

留言簿(8)

随笔档案

文章档案

搜索

  •  

最新评论

阅读排行榜

评论排行榜

 

一个简单的异步日志模块,基本达到了灵活、高效、易用的目标。

此日志模块为文本日志,异步记录方式,即有单独的线程负责写日志文件。
具备以下特征:

1、可同时操作N个日志文件,N可配置;
2、可动态添加、删除和替换日志文件;
3、良好的多线程支持;
4、C++流风格的日志消息生成方式;

发布形式为ZLog.dll,使用时只需包含ZLog.h并连接ZLog.lib即可。

日志文件操作函数:

// 启动日志模块,logfile为日志文件名,level为输出到文件的最低日志等级,nQueueLength为内部缓冲队列的最大长度,一般使用默认值即可
// 日志等级由高至低分别为:LL_NONE、LL_FATAL、LL_ERROR、LL_WARNING、LL_INFO
// 例如,若level为LL_WARNING,则仅记录LL_WARNING、LL_ERROR和LL_FATAL等级的日志消息,而不记录LL_INFO等级的日志消息
// 成功启动后logfile的序号为0
// 返回0表明成功,其它值表明失败
int  __cdecl startup(LPCTSTR logfile, LONG level, unsigned int nQueueLength = 256);

// 关闭日志模块
void __cdecl cleanup();

// 删除一个日志文件,fileindex指定该文件的序号(>= 0),仅有一个日志文件时,不允许删除
BOOL __cdecl removefile(unsigned int fileindex);

// 得到日志文件的大小,fileindex为该文件的序号(>= 0)
BOOL __cdecl getfilesize(unsigned int fileindex, ULARGE_INTEGER *lpuliFileSize);

// 将文件序号为fileindex的日志文件替换为newlogfile指定的文件,fileindex必需有效。
// 若当前有三个日志文件log1.txt,log2.txt和log3.txt,则序号分别为0,1,2。
// 若删除1代表的日志文件(即log2.txt),则log1.txt的序号不变,依然为0,log3.txt的序号变为1,同时序号2失效。
BOOL __cdecl replacefile(unsigned int fileindex, LPCTSTR newlogfile);

// 添加新的日志文件,newlogfile为文件名,若成功则返回新文件的序号(>= 0),若失败,返回-1。日志文件最大数量为16
int  __cdecl addfile(LPCTSTR newlogfile);

以上所有函数都是线程安全的。

使用方法:

    loginfo,logwarn,logerr,logfatal分别生成information,warning,error,fatal类型的日志消息;
    输入参数格式与cout(ostream)基本一致,不同之处在于:
    1、可接受Unicode字符串
    2、第一个输入参数可为choosefile(n),其中n为目标日志文件的序号

例子:

 1 #include "ZLog.h"
 2 
 3 using namespace ZLog;
 4 
 5 int _tmain(int argc, _TCHAR* argv[])
 6 {
 7     startup(TEXT("log1.txt"));
 8 
 9     addfile(TEXT("log2.txt"));
10     addfile(TEXT("log3.txt"));
11 
12     loginfo<<"log entry to log1.txt";                 // log1.txt, impliedly "choosefile(0)"
13     logwarn<<choosefile(1)<<L"log entry to log2.txt"// log2.txt
14     logerr<<choosefile(2)<<L"log entry to log3.txt";  // log3.txt
15 
16     removefile(2); // remove log3.txt
17 
18     logerr<<choosefile(2)<<"log entry to log3.txt"// log3.txt has been removed, so log entry will be redirected to log1.txt
19 
20     addfile(TEXT("newlog3.txt"));                   // add "newlog3.txt"
21     logerr<<choosefile(2)<<"log entry to newlog3.txt";
22 
23     replacefile(1, TEXT("newlog2.txt")); // replace log2.txt with newlog2.txt
24 
25     logfatal<<choosefile(1)<<"log entry to newlog2.txt";
26 
27     replacefile(1, TEXT("newnewlog2.txt")); // replace newlog2.txt with newnewlog2.txt
28     logfatal<<choosefile(1)<<"log entry to newnewlog2.txt";
29 
30     cleanup();
31     return 0;
32 }
33 

上例为单线程演示,在多线程环境下同样适用。
同一个程序中,若有多个模块同时引用了ZLog.dll,只需要调用一次startup和cleanup即可,但多次调用亦无副作用。

有兴趣的朋友可以测试一下,发现任何问题请告诉我。

DLL下载    源代码下载

 

posted on 2008-08-30 03:26 阅读(3868) 评论(2)  编辑 收藏 引用
评论:
  • # re: 简单的异步日志模块  true Posted @ 2008-08-31 13:31
    看见ZLog感觉眼熟,下载下来看看,果然是你,呵呵,最近怎么样?不辞而别不够哥们义气啊,^_^
    by tianqigui
      回复  更多评论   

  • # re: 简单的异步日志模块  wish Posted @ 2010-01-21 15:54
    @true
    是在不怎么样,去年年初来了大姨妈,到现在还没完,唉。。。。  回复  更多评论   


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理


 
Copyright © 淼 Powered by: 博客园 模板提供:沪江博客