ACE_Log_Meg 怎么样打印日志？

ACE_Log_Msg日志  


2008-09-20 17:33:28|  分类： C/VC/C++ |字号 订阅
日志级别:


LM_DEBUG：调试信息;


LM_TRACE：指示函数调用次序的跟踪消息;


LM_INFO：消息汗有通常只在程序调试时使用的信息;


LM_NOTICE：不是出错的情况，而是可能需要特别处理的情况;


LM_WARNING：警告信息;


LM_ERROR：错误信息;


LM_CRITICAL：紧急情况，比如：硬件设备出错;


LM_ALERT：应该立即纠正的情况，比如系统数据库损坏;


LM_EMERGENCY：万分紧急的情况，通常会广播给所有用户;


部分日志格式化指令：


%l：日志宏所处的行号，与C里面的宏__LINE__对应;


%N：日志宏所在的文件名称，与C里面的宏__FILE__对应;


%D：当前时间戳格式，与C里面的宏__DATE__、__TIME__对应;


%T：当前时间格式，与C里面的宏__TIME__对应;


%t: 调用线程的线程ID;


%M：消息级别的文本形式；如：LM_DEBUG、LM_INFO、LM_ERROR等等;


%c：格式化单个字符，与printf()的%c对应;


%C：格式化char*类型的C字符串;


%s：格式化ACE_TCHAR*类型的ACE字符串;


%w：格式化wchar_t类型的宽字符;


%W：格式化wchar_t*类型的宽字符串;


%i、%d、%R：格式化成十进制格式;


%x、%X：格式化成十六进制格式;


输出日志的宏：


ACE_DEBUG((log_level,format_string,va_list));


ACE_ERROR((log_level,format_string,va_list));


ACE_TRACE((string))；在该宏出现的地方打印行号、文件名以及string;


ACE_RETURN(value)：不打印消息，直接返回，返回值为value;


ACE_ERROR_RETURN((level,format_string, va_list), value)：打印信息，然后返回，返回值为value;


ACE_ERROR_INIT(value, flags)；把op_status设置为value，把日志记录器的选项标记设置为falgs;


ACE_ERROR_BREAK((level, format_string, va_list))；打印信息，并退出while、for、do...while等循环;


日志宏是否产生日志方法调用,由三个配置选项在编译时的值决定:ACE_NDEBUG、ACE_NTRACE、ACE_NOLOGGING；它们都被编译成“不”，所以:


#define ACE_NDEBUG  0  //调试


#define ACE_NDEBUG  1  //不调试


#define ACE_NTRACE  0  //跟踪


#define ACE_NTRACE  1  //不跟踪


#define ACE_NOLOGGING  0   //记录日志


#define ACE_NOLOGGING  1   //不记录日志


日志级别掩码的范围:


ACE_Log_Msg::PROCESS: 指定PROCESS,获取或设置进程范围内的掩码,会影响所有ACE_Log_Msg实例的日志严重性;


ACE_Log_Msg::THREAD: 每个ACE_Log_Msg实例都可以有自己的严重性掩码,指定THREAD可以获取或设置该掩码;ACE_Log_Msg类实现了日志消息格式化功能;ACE为每个新派生的线程自动维护一个ACE_Log_Msg类的单体实例,其中也包括主线程;要获取ACE_Log_Msg类的单体实例的指针,可以使用快捷方式ACE_LOG_MSG.为了能在正确的ACE_Log_Msg单体实例上发出调用,所有的ACE日志都使用了宏ACE_LOG_MSG;你几乎没有理由直接初始化ACE_Log_Msg;


ACE自动为每个新派生的线程创建一个新的ACE_Log_Msg实例,从而让每个线程都有各自的日志输出;所以,通常把ACE_Log_Msg视为线程专有的对象;


禁用和启用日志级别:


在评估日志消息的严重性级别时,既评估进程范围内的严重性掩码,也评估线程级的每个实例的严重性掩码;这两个范围中的任何一个范围启用了该消息的严重级别,那么这条日志消息就会被记录到日志中;默认情况下,在进程范围内,所有的位都为1,表示启用每一个严重级别;而在实例范围内,所有的位都是0,表示禁用每一个严重级别;因为进程范围内的所有位默认都是1,所以无论该日志消息是何种严重性,它都会被记录到日志中;要让每个线程自己决定把哪些严重级别记录到日志中,可以先把进程范围内的所有位都置0,并允许每个线程设置自己的每个严重性掩码;例如:下面的代码在进程级禁用所有严重级别的日志记录,而在当前线程中只启用LM_DEBUG和LM_NOTICE严重性:


使用ACE_LOG_MSG->priority_mask()方法来启用和禁用日志严重级别;


ACE_LOG_MSH->priority_mask(0, ACE_Log_Msg::PROCESS);


ACE_LOG_MSH->priority_mask(LM_DEBUG | LM_NOTICE, ACE_Log_Msg::THREAD);