Windows c++应用程序通用日志组件(组件及测试程序下载)

引言

  众所周知,在调试、跟踪和执行应用程序的过程中,程序的日志能为这些工作提供大量有价值的运行信息。因此,程序的日志对应用程序的运行、维护至关重要。

  在如何记录程序日志方面,通常有三种选择:

  1、采用Log4CXX等公共开源日志组件:这类日志组件的特点是跨平台且功能比较强大,例如可以把日志发往另一台服务器或记录到数据库中等; 另外,可配置性较高,可以通过配置文件或程序代码对日志进行很多个性化设置。但从另外一个角度看,由于这些优点往往也导致了在使用方面的缺点。首先,对于 一般应用程序来说,它们并不需要太多的功能,通常只需要把日志记录到文件或反馈到应用程序,功能太多反正让用户使用起来觉得繁琐还得背负很多从来都用不到 的代码。其次,这类日志组件通常是跨平台的,并不只是针对 Windows 或 VC 的应用程序,因此使用起来总会觉得有点别扭,例如他们的字符都是用 char 类型的,对于一个 Unicode 程序来说每次写日志都要做字符转换是很不爽的事情,本座在多年前曾经使用过 Log4Cpp ,程序执行时总是报告日志组件有内存泄露,虽然有可能是误报,但是使用起来总觉得很不舒服。

  2、自己写几个简单的类或函数记录日志:这种方法的确很简单,通常都不用一两百行的代码。但这种方法通常缺乏规范性和通用性,其他程序需要记录 类似的但有点差异的日志时,通常的作法是:Copy-Paste-Modify;另外,这类方法很可能也没有考虑性能或并发方面的问题,通常是直接在工作 线程中写日志,对于那些性能要求较高的应用程序是绝对不允许的。

  3、干脆不记录任何日志:的确,现在很多程序由于各种原因并没有记录任何日志。但本座以为,如果一个程序是有用的,具备一定功能,并且需要连续运行较长一段时间,那么记录日志是必须的;否则,得认真考虑该程序是否有存在的必要了。

 


设计

  综上所述,编写一个通用的日志组件应该着重考虑三个方面:功能、可用性和性能。下面,本座详细说明在设计日志组件时对这些方面问题的考虑:

  1、功能:本日志组件的目的是满足大多数应用程序记录日志的需求 —— 把日志输出到文件或发送到应用程序中,并不提供一些复杂但不常用的功能。本日志组件的功能包括:

  • 把日志信息输出到指定文件
  • 每日生成一个日志文件
  • 对于 GUI 程序,可以把日志信息发送到指定窗口
  • 对于Console应用程序,可以把日志信息发往标准输出 (std::cout)
  • 支持 MBCS / UNICODE,Console / GUI 程序
  • 支持动态加载和静态加载日志组件 DLL
  • 支持 DEBUG/TRACE/INFO/WARN/ERROR/FATAL 等多个日志级别

  2、可用性:本日志组件着重考虑了可用性,尽量让使用者用起来觉得简便、舒心:

  • 简单纯净:不依赖任何程序库或框架
  • 使用接口简单,不需复杂的配置或设置工作
  • 提供 CStaticLogger 和 CDynamicLogger 包装类用于静态或动态加载以及操作日志组件,用户无需关注加载细节
  • 程序如果要记录多个日志文件只需为每个日志文件创建相应的 CStaticLogger 或 CDynamicLogger 对象
  • 只需调用 Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法记录日志
  • 日志记录方法支持可变参数
  • 日志输出格式:<时间> <线程ID> <日志级别> <日志内容>

  3、性能:性能是组件是否值得使用的硬指标,本组件从设计到编码的过程都尽量考虑到性能优化:

  • 支持多线程同时发送写日志请求
  • 使用单独线程在后台写日志,不影响工作线程的正常执行
  • 采用批处理方式批量记录日志

 


接口

  1、ILogger:日志组件对象接口

复制代码
  1 /******************************************************************************
  2 Module:  Logger.h
  3 Notices: Copyright (c) 2012 Bruce Liang - http://www.cnblogs.com/ldcsaa/
  4 
  5 Purpose: 记录程序日志。
  6         1. 把日志信息输出到指定文件
  7         2. 对于 GUI 程序,可以把日志信息发送到指定窗口
  8         3. 对于Console应用程序,可以把日志信息发往标准输出 (std::cout)
  9 
 10 Desc:
 11         1、功能:
 12         --------------------------------------------------------------------------------------
 13         a) 把日志信息输出到指定文件
 14         b) 每日生成一个日志文件
 15         c) 对于 GUI 程序,可以把日志信息发送到指定窗口
 16         d) 对于Console应用程序,可以把日志信息发往标准输出 (std::cout)
 17         e) 支持 MBCS / UNICODE,Console / GUI 程序
 18         f) 支持动态加载和静态加载日志组件 DLL
 19         g) 支持 DEBUG/TRACE/INFO/WARN/ERROR/FATAL 等多个日志级别
 20         
 21         2、可用性:
 22         --------------------------------------------------------------------------------------
 23         a) 简单纯净:不依赖任何程序库或框架
 24         b) 使用接口简单,不需复杂的配置或设置工作
 25         c) 提供 CStaticLogger 和 CDynamicLogger 包装类用于静态或动态加载以及操作日志组件,用户无需关注加载细节
 26         d) 程序如果要记录多个日志文件只需为每个日志文件创建相应的 CStaticLogger 或 CDynamicLogger 对象
 27         e) 只需调用 Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法记录日志
 28         f) 日志记录方法支持可变参数
 29         g) 日志输出格式:<时间> <线程ID> <日志级别> <日志内容>
 30         
 31         3、性能:
 32         --------------------------------------------------------------------------------------
 33         a) 支持多线程同时发送写日志请求
 34         b) 使用单独线程在后台写日志,不影响工作线程的正常执行
 35         c) 采用批处理方式批量记录日志
 36 
 37 Usage:
 38         方法一:(静态加载 Logger DLL)
 39         --------------------------------------------------------------------------------------
 40         0. 应用程序包含 StaticLogger.h 头文件
 41         1. 创建 CStaticLogger 对象(通常为全局对象)
 42         2. 调用 CStaticLogger->Init(...) 初始化日志组件
 43         3. 使用 CStaticLogger->Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法写日志
 44         4. 调用 CStaticLogger->UnInit(...) 清理日志组件(CStaticLogger 对象析构时也会自动清理日志组件)
 45 
 46         方法二:(动态加载 Logger DLL)
 47         --------------------------------------------------------------------------------------
 48         0. 应用程序包含 DynamicLogger.h 头文件
 49         1. 创建 CDynamicLogger 对象(通常为全局对象)
 50         2. 调用 CDynamicLogger->Init(...) 初始化日志组件
 51         3. 使用 CDynamicLogger->Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法写日志
 52         4. 调用 CDynamicLogger->UnInit(...) 清理日志组件(CDynamicLogger 对象析构时也会自动清理日志组件)
 53 
 54         方法三:(直接用导出函数加载 Logger DLL)
 55         --------------------------------------------------------------------------------------
 56         0. 应用程序包含 Logger.h 头文件
 57         1. 手工调用 ILoger_Create() 和 ILoger_Create() 导出函数创建和销毁 ILogger 对象 
 58         (注:如果是动态加载,需手工调用 ::LoadLibrary()/::FreeLibrary() 系列 API 函数加载和卸载 Logger DLL)
 59         
 60         [
 61             ***** 对于希望通过窗口接收日志信息的 GUI 程序 *****
 62 
 63             A. 日志组件初始化成功后调用 SetGUIWindow(HWND) 设置收日志的窗口
 64             B. 窗口须响应处理 LOG_MESSAGE 消息
 65             C. 处理完 LOG_MESSAGE 消息后,调用 ILogger::FreeLogMsg() 销毁接收到的 TLogMsg 
 66         ]
 67 
 68 Environment:
 69         1. Windows 2000 or later (_WIN32_WINNT >= 0x0500)
 70         2. VC++ 2010 or later
 71 
 72 Release:
 73         1. Logger_C.dll     - Console/MBCS/Release
 74         2. Logger_CD.dll    - Console/MBCS/Debug
 75         3. Logger_CU.dll    - Console/Unicode/Release
 76         4. Logger_CUD.dll   - Console/Unicode/Debug
 77         5. Logger.dll       - GUI/MBCS/Release
 78         6. Logger_D.dll     - GUI/MBCS/Debug
 79         7. Logger_U.dll     - GUI/Unicode/Release
 80         8. Logger_UD.dll    - GUI/Unicode/Debug
 81 
 82 Examples:
 83         1. TestGUILogger        - GUI 版测试程序       (静态加载)
 84         2. TestDynamicLogger    - GUI 版测试程序       (动态加载)
 85         3. TestConsoleLogger    - Console 版测试程序  (静态加载)
 86 
 87 ******************************************************************************/
 88 
 89 #pragma once
 90 
 91 /**************************************************/
 92 /********** imports / exports Logger.dll **********/
 93 
 94 #ifdef LOGGER_EXPORTS
 95     #define LOGGER_API __declspec(dllexport)
 96     //#define TRY_INLINE    inline
 97 #else
 98     #define LOGGER_API __declspec(dllimport)
 99     //#define TRY_INLINE
100 #endif
101 
102 /**************************************************/
103 /****************** 日志组件接口 *******************/
104 
105 class LOGGER_API ILogger
106 {
107 public:
108     /***** 日志级别 *****/
109     enum LogLevel
110     {
111         LL_NONE     = 0XFF,
112         LL_DEBUG    = 1,
113         LL_TRACE    = 2,
114         LL_INFO     = 3,
115         LL_WARN     = 4,
116         LL_ERROR    = 5,
117         LL_FATAL    = 6
118     };
119 
120     /***** 操作错误码 *****/
121     enum ErrorCode
122     {
123         // 无错误
124         EC_OK    = NO_ERROR,
125         // 文件操作相关的错误
126         EC_FILE_GENERIC,
127         EC_FILE_FILENOTFOUND,
128         EC_FILE_BADPATH,
129         EC_FILE_TOMANYOPERFILES,
130         EC_FILE_ACCESSDENIED,
131         EC_FILE_INVALIDFILE,
132         EC_FILE_REMOVECURRENTDIR,
133         EC_FILE_DIRECTORYFULL,
134         EC_FILE_BADSEEK,
135         EC_FILE_HARDIO,
136         EC_FILE_SHARINGVIOLATION,
137         EC_FILE_LOCKVIOLATION,
138         EC_FILE_DISKFULL,
139         EC_FILE_ENDOFFILE,
140         // 其他错误
141         EC_INVALID_STATE,
142         EC_INIT_LOGLEVEL,
143         EC_INIT_PRINTFLAG,
144         EC_INIT_CREATE_LOG_THREAD_FAIL
145     };
146 
147     /******************************************
148                     日志信息结构
149     *******************************************/
150     struct TLogMsg
151     {
152         DWORD       m_dwSize;       // 结构大小 - 跟据消息长度动态变化
153         LogLevel    m_logLevel;     // 日志级别
154         UINT        m_uiThreadID;   // 线程ID
155         SYSTEMTIME  m_stMsgTime;    // 记录时间
156         TCHAR       m_psMsg[1];     // 消息内容
157     };
158 
159 public:
160     ILogger(void);
161     virtual ~ILogger(void);
162 private:
163     ILogger(const ILogger&);
164     ILogger& operator = (const ILogger&);
165 
166 public:
167     // 日志组件初始化方法
168     virtual BOOL Init(
169                         LPCTSTR logFile  = NULL                  // 日志文件. 默认: {AppPath}/logs/{AppName}-YYYYMMDD.log
170                       , LogLevel ll      = DEFAULT_LOG_LEVEL     // 日志级别. 默认: [Debug -> LL_DEBUG] / [Release -> LL_INFO]
171                       , int printFlag    = DEFAULT_PRINT_FLAG    // 输出掩码. 是否输出到文件和(或)屏幕. 默认: 只输出到文件
172                      )       = 0;
173     // 日志组件清理方法
174     virtual BOOL UnInit()    = 0;
175 
176 public:
177     // 写日志方法:传入日志内容字符串(对于不需要格式化的日志文本,用本方法效率最高)
178     virtual void Log_0  (LogLevel ll, LPCTSTR msg) = 0;
179     virtual void Debug_0(LPCTSTR msg);
180     virtual void Trace_0(LPCTSTR msg);
181     virtual void Info_0 (LPCTSTR msg);
182     virtual void Warn_0 (LPCTSTR msg);
183     virtual void Error_0(LPCTSTR msg);
184     virtual void Fatal_0(LPCTSTR msg);
185 
186     // 写日志方法:传入格式化字符串和参数栈指针(通常只在组件内部使用)
187     virtual void LogV   (LogLevel ll, LPCTSTR format, va_list arg_ptr);
188 
189     // 写日志方法:传入格式化字符串和可变参数(非常灵活简便)
190     virtual void Log     (LogLevel ll, LPCTSTR format, ...);
191     virtual void Debug   (LPCTSTR format, ...);
192     virtual void Trace   (LPCTSTR format, ...);
193     virtual void Info    (LPCTSTR format, ...);
194     virtual void Warn    (LPCTSTR format, ...);
195     virtual void Error   (LPCTSTR format, ...);
196     virtual void Fatal   (LPCTSTR format, ...);
197 
198     // 写日志方法:传入格式化字符串和可变参数(与上一组方法类似,但在进行任何操作前会检查日志级别)
199     virtual void TryLog     (LogLevel ll, LPCTSTR format, ...);
200     virtual void TryDebug   (LPCTSTR format, ...);
201     virtual void TryTrace   (LPCTSTR format, ...);
202     virtual void TryInfo    (LPCTSTR format, ...);
203     virtual void TryWarn    (LPCTSTR format, ...);
204     virtual void TryError   (LPCTSTR format, ...);
205     virtual void TryFatal   (LPCTSTR format, ...);
206 
207     // 通用辅助方法
208     virtual BOOL HasInited           ()        const    = 0;        // 是否已经初始化                            
209     virtual BOOL IsPrint2File        ()        const    = 0;        // 是否把日志输出到文件    
210     virtual BOOL IsPrint2Screen      ()        const    = 0;        // 是否把日志输出到屏幕窗口    
211     virtual int    GetPrintFlag      ()        const    = 0;        // 打印标志                    
212     virtual LogLevel    GetLogLevel  ()        const    = 0;        // 日志级别        
213     virtual LPCTSTR        GetLogFile()        const    = 0;        // 日志文件
214     virtual ErrorCode    GetLastError()        const    = 0;        // 当前操作错误码
215 
216 /****************************** GUI ******************************/
217 #ifdef _WINDOWS
218     public:
219         // 设置接收日志信息的窗口, hWndGUI == NULL 则取消接收
220         virtual void SetGUIWindow(HWND hWndGUI)    = 0;
221         // 获取接收日志信息的窗口
222         virtual HWND GetGUIWindow()                = 0;
223 
224         // 销毁在发送 LOG_MESSAGE 消息时动态创建的 TLogMsg 对象
225         virtual void FreeLogMsg(const TLogMsg* pLogMsg);
226 
227         // 虚拟窗口句柄标掩码:用于向 GUI 窗口发送 LOG_MESSAGE 消息时作为发送源标识
228         static const int LOGGER_FAKE_WINDOW_BASE = 0X80001111;
229         // 自定义日志消息:通过本消息向 GUI 窗口发送日志
230         // 其中:WPARAM -> ILogger 对象指针,LPARAM -> TLogMsg 结构体指针
231         static const int LOG_MESSAGE = WM_USER | (0x7FFF & LOGGER_FAKE_WINDOW_BASE);
232 #endif
233 
234 public:
235     static const int PRINT_FLAG_FILE            = 0x00000001;            // 打印到文件
236     static const int PRINT_FLAG_SCREEN          = 0x00000002;            // 打印到屏幕
237     static const int DEFAULT_PRINT_FLAG         = PRINT_FLAG_FILE;        // 默认日志掩码
238     static const LogLevel DEFAULT_LOG_LEVEL     = 
239 #ifdef _DEBUG
240                 LL_DEBUG
241 #else
242                 LL_INFO
243 #endif
244                 ;
245 };
246 
247 /**************************************************/
248 /************** Logger DLL 导出函数 ***************/
249 
250 // 创建 ILogger 对象
251 EXTERN_C LOGGER_API ILogger* ILogger_Create();
252 // 销毁 ILogger 对象
253 EXTERN_C LOGGER_API void ILogger_Destroy(ILogger* p);
254 
255 // 获取各日志级别的文字描述
256 EXTERN_C LOGGER_API LPCTSTR    ILogger_GetLogLevelDesc (ILogger::LogLevel ll);
257 // 获取各操作错误码的文字描述
258 EXTERN_C LOGGER_API LPCTSTR    ILogger_GetErrorDesc    (ILogger::ErrorCode ec);
复制代码

 

   代码中的注释基本已经能够说明日志组件的使用方法,这里只做一些简单的概括:

  版本:日志组件以 DLL 的形式提供,已编译成 Debug/Release、MBCS/Unicode、GUI/Console 8个版本

  测试:三个测试程序 TestGUILogger、TestDynamicLogger 和 TestConsoleLogger 用于测试所有版本。其中 TestDynamicLogger 采用动态加载方式加载 Logger DLL

  使用方法:

    0. 应用程序包含 Logger.h 头文件
    1. 调用 ILogger_Create() 导出函数创建 ILogger 对象
    2. 调用 ILogger->Init(...) 初始化日志组件
    3. 使用 ILogger->Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法写日志
    4. 调用 ILogger->UnInit(...) 清理日志组件
    5. 调用 ILogger_Destroy() 导出函数销毁 ILogger 对象
 

  2、CStaticLogger:ILogger 包装器(智能指针)—— 用于静态加载 Logger DLL 

复制代码
 1 #pragma once
 2 
 3 #include "Logger.h"
 4 
 5 /**************************************************/
 6 /********* http://www.cnblogs.com/ldcsaa/ *********/
 7 /********** ILogger 包装器(智能指针) ***********/
 8 /*********** 用于静态加载 Logger DLL ************/
 9 
10 class LOGGER_API CStaticLogger
11 {
12 public:
13     // 构造函数:如果 bCreate 为 TRUE,则在构建 CStaticLogger 实例的同时创建 ILogger 对象
14     CStaticLogger(BOOL bCreate = TRUE);
15     // 析构函数
16     ~CStaticLogger();
17 private:
18     CStaticLogger(const CStaticLogger&);
19     CStaticLogger& operator = (const CStaticLogger&);
20 
21 public:
22     inline void Reset           (ILogger* pLogger);     // 重设其封装的 ILogger 指针
23     inline BOOL IsValid         ()    const;            // 判断其封装的 ILogger 指针是否非空
24     inline ILogger* Get         ()    const;            // 获取 ILogger 指针
25     inline ILogger& operator *  ()    const;            // 获取 ILogger 引用
26     inline ILogger* operator -> ()    const;            // 获取 ILogger 指针
27     inline operator ILogger*    ()    const;            // 转换为 ILogger 指针
28 
29 private:
30     ILogger* m_pLogger;
31 };
复制代码

 

  CStaticLogger 为简化日志组件使用而设计,用于静态加载 Logger DLL 的场合。使用方法:

    0. 应用程序包含 StaticLogger.h 头文件
    1. 创建 CStaticLogger 对象(通常为全局对象)
    2. 调用 CStaticLogger->Init(...) 初始化日志组件
    3. 使用 CStaticLogger->Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法写日志
    4. 调用 CStaticLogger->UnInit(...) 清理日志组件(CStaticLogger 对象析构时也会自动清理日志组件)

 

  3、CDynamicLogger:ILogger 包装器(智能指针)—— 用于动态加载 Logger DLL 

复制代码
  1 #pragma once
  2 
  3 #include "Logger.h"
  4 
  5 /**************************************************/
  6 /********* http://www.cnblogs.com/ldcsaa/ *********/
  7 /************** Logger DLL 默认文件名 ***************/
  8 
  9 #ifdef _DEBUG
 10     #ifdef _UNICODE
 11         #ifdef _WINDOWS
 12             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger_UD.dll")
 13         #else
 14             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger_CUD.dll")
 15         #endif
 16     #else
 17         #ifdef _WINDOWS
 18             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger_D.dll")
 19         #else
 20             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger_CD.dll")
 21         #endif
 22     #endif
 23 #else
 24     #ifdef _UNICODE
 25         #ifdef _WINDOWS
 26         #define DEF_LOGGER_DLL_FILE_PATH        _T("Logger_U.dll")
 27         #else
 28             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger_CU.dll")
 29         #endif
 30     #else
 31         #ifdef _WINDOWS
 32             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger.dll")
 33         #else
 34             #define DEF_LOGGER_DLL_FILE_PATH    _T("Logger_C.dll")
 35         #endif
 36     #endif
 37 #endif
 38 
 39 /**************************************************/
 40 /*************** Logger DLL 导出函数 ***************/
 41 
 42 // 创建 ILogger 对象
 43 typedef ILogger*            (*FN_ILogger_Create)            ();
 44 // 销毁 ILogger 对象
 45 typedef void                (*FN_ILogger_Destroy)           (ILogger* p);
 46 // 获取各日志级别的文字描述
 47 typedef LPCTSTR             (*FN_ILogger_GetLogLevelDesc)   (ILogger::LogLevel ll);
 48 // 获取各操作错误码的文字描述
 49 typedef LPCTSTR             (*FN_ILogger_GetErrorDesc)      (ILogger::ErrorCode ec);
 50 
 51 /*************************************************/
 52 /********** ILogger 包装器(智能指针) ***********/
 53 /************ 用于动态加载 Logger DLL ************/
 54 
 55 class CDynamicLogger
 56 {
 57 public:
 58     // 构造函数:如果 bLoad 为 TRUE,则在构建 CDynamicLogger 示例的同时创建 ILogger 对象
 59     CDynamicLogger(BOOL bLoad = TRUE, LPCTSTR lpszFilePath = DEF_LOGGER_DLL_FILE_PATH)
 60     {
 61         Reset();
 62 
 63         if(bLoad)
 64             Load(lpszFilePath);
 65     }
 66 
 67     // 析构函数
 68     ~CDynamicLogger()
 69     {
 70         Free();
 71     }
 72 
 73 private:
 74     CDynamicLogger(const CDynamicLogger&);
 75     CDynamicLogger& operator = (const CDynamicLogger&);
 76 
 77 public:
 78     // 创建 ILogger 对象
 79     ILogger* ILogger_Create()
 80         {return m_fnILoggerCreate();}
 81     // 销毁 ILogger 对象
 82     void ILogger_Destroy(ILogger* p)
 83         {m_fnILoggerDestroy(p);}
 84     // 获取各日志级别的文字描述
 85     LPCTSTR    ILogger_GetLogLevelDesc(ILogger::LogLevel ll)
 86         {return m_fnILoggerGetLogLevelDesc(ll);}
 87     // 获取各操作错误码的文字描述
 88     LPCTSTR    ILogger_GetErrorDesc(ILogger::ErrorCode ec)
 89         {return m_fnILoggerGetErrorDesc(ec);}
 90 
 91     // 加载 Logger DLL
 92     BOOL Load(LPCTSTR lpszFilePath = DEF_LOGGER_DLL_FILE_PATH)
 93     {
 94         if(IsValid())
 95             return FALSE;
 96 
 97         BOOL isOK = FALSE;
 98         m_hLogger = ::LoadLibrary(lpszFilePath);
 99 
100         if(m_hLogger)
101         {
102             m_fnILoggerCreate            = (FN_ILogger_Create)            ::GetProcAddress(m_hLogger, "ILogger_Create");
103             m_fnILoggerDestroy           = (FN_ILogger_Destroy)           ::GetProcAddress(m_hLogger, "ILogger_Destroy");
104             m_fnILoggerGetLogLevelDesc   = (FN_ILogger_GetLogLevelDesc)   ::GetProcAddress(m_hLogger, "ILogger_GetLogLevelDesc");
105             m_fnILoggerGetErrorDesc      = (FN_ILogger_GetErrorDesc)      ::GetProcAddress(m_hLogger, "ILogger_GetErrorDesc");
106 
107             if(m_fnILoggerCreate && m_fnILoggerDestroy)
108             {
109                 m_pLogger   = ILogger_Create();
110                 isOK        = (m_pLogger != NULL);
111             }
112         }
113 
114         if(!isOK)
115             Free();
116 
117         return isOK;
118     }
119 
120     // 卸载 Logger DLL
121     BOOL Free()
122     {
123         if(!IsValid())
124             return TRUE;
125 
126         BOOL isOK = TRUE;
127 
128         if(m_pLogger)    ILogger_Destroy(m_pLogger);
129         if(m_hLogger)    isOK = ::FreeLibrary(m_hLogger);
130 
131         Reset();
132 
133         return isOK;
134     }
135 
136     BOOL IsValid            ()    const    {return m_pLogger != NULL;}  // 判断其封装的 ILogger 指针是否非空
137     ILogger* Get            ()    const    {return m_pLogger;}          // 获取 ILogger 指针
138     ILogger& operator *     ()    const    {return *m_pLogger;}         // 获取 ILogger 引用
139     ILogger* operator ->    ()    const    {return m_pLogger;}          // 获取 ILogger 指针
140     operator ILogger*       ()    const    {return m_pLogger;}          // 转换为 ILogger 指针
141 
142 private:
143     void Reset()
144     {
145         m_hLogger                    = NULL;
146         m_pLogger                    = NULL;
147         m_fnILoggerCreate            = NULL;
148         m_fnILoggerDestroy           = NULL;
149         m_fnILoggerGetLogLevelDesc   = NULL;
150         m_fnILoggerGetErrorDesc      = NULL;
151     }
152 
153 private:
154     HMODULE         m_hLogger;
155     ILogger*        m_pLogger;
156 
157     FN_ILogger_Create            m_fnILoggerCreate;
158     FN_ILogger_Destroy           m_fnILoggerDestroy;
159     FN_ILogger_GetLogLevelDesc   m_fnILoggerGetLogLevelDesc;
160     FN_ILogger_GetErrorDesc      m_fnILoggerGetErrorDesc;
161 };
复制代码

 

  CDynamicLogger 为简化日志组件使用而设计,用于动态加载 Logger DLL 的场合。使用方法:

    0. 应用程序包含 DynamicLogger.h 头文件
    1. 创建 CDynamicLogger 对象(通常为全局对象)
    2. 调用 CDynamicLogger->Init(...) 初始化日志组件
    3. 使用 CDynamicLogger->Log()/Debug()/Trace()/Info()/Warn()/Error()/Fatal() 等方法写日志
    4. 调用 CDynamicLogger->UnInit(...) 清理日志组件(CDynamicLogger 对象析构时也会自动清理日志组件) 

 

   (有需要的朋友请轻踩这里,你懂的^_*

 

转自:http://www.cnblogs.com/ldcsaa/archive/2012/06/28/2560619.html 

posted on 2012-12-25 08:57  猿人谷  阅读(536)  评论(0编辑  收藏  举报