ACE_Log_Msg日志

日志级别:

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);