一. 優(yōu)先級(jí)控制
在研究LogLevelManager之前，首先介紹一下log4cplus中l(wèi)ogger的存儲(chǔ)機(jī)制，在log4cplus中，
所有l(wèi)ogger都通過一個(gè)層次化的結(jié)構(gòu)（其實(shí)內(nèi)部是hash表）來組織的，有一個(gè)Root級(jí)別的logger,
可以通過以下方法獲?。?br>Logger root = Logger::getRoot();
用戶定義的logger都有一個(gè)名字與之對(duì)應(yīng)，比如：
Logger test = Logger::getInstance("test");
可以定義該logger的子logger:
Logger subTest = Logger::getInstance("test.subtest");
注意：Root級(jí)別的logger只有通過getRoot方法獲取，Logger::getInstance("root")獲得的是它的子對(duì)象而已。
有了這些具有父子關(guān)系的logger之后可分別設(shè)置其LogLevel比如：
root.setLogLevel( ... );
test.setLogLevel( ... );
subTest.setLogLevel( ... );
logger的這種父子關(guān)聯(lián)性會(huì)體現(xiàn)在優(yōu)先級(jí)控制方面，log4cplus將輸出的log信息按照LogLevel（從低到高）分為：
NOT_SET_LOG_LEVEL ( -1) ：接受缺省的LogLevel，如果有父logger則繼承它的LogLevel
ALL_LOG_LEVEL ( 0) ：開放所有l(wèi)og信息輸出
TRACE_LOG_LEVEL ( 0) ：開放trace信息輸出(即ALL_LOG_LEVEL)
DEBUG_LOG_LEVEL (10000) ：開放debug信息輸出
INFO_LOG_LEVEL (20000) ：開放info信息輸出
WARN_LOG_LEVEL (30000) ：開放warning信息輸出
ERROR_LOG_LEVEL (40000) ：開放error信息輸出
FATAL_LOG_LEVEL (50000) ：開放fatal信息輸出
OFF_LOG_LEVEL (60000) ：關(guān)閉所有l(wèi)og信息輸出
LogLevelManager負(fù)責(zé)設(shè)置logger的優(yōu)先級(jí)，各個(gè)logger可以通過setLogLevel設(shè)置自己的優(yōu)先級(jí)，
當(dāng)某個(gè)logger的LogLevel設(shè)置成NOT_SET_LOG_LEVEL時(shí)，該logger會(huì)繼承父logger的優(yōu)先級(jí)，另外，
如果定義了重名的多個(gè)logger, 對(duì)其中任何一個(gè)的修改都會(huì)同時(shí)改變其它logger,我們舉例說明：
/**//*
設(shè)置日志等級(jí)
*/
#include "stdafx.h"
#pragma comment(lib,"../bin/log4cplusD.lib")
#include <log4cplus/logger.h>
#include <log4cplus/fileappender.h>
#include <log4cplus/consoleappender.h>
#include <conio.h>
#include <iostream>
using namespace std;
using namespace log4cplus;
int _tmain(int argc, _TCHAR* argv[])
{
SharedAppenderPtr _append(new ConsoleAppender());
_append->setName(LOG4CPLUS_TEXT("test"));
//新建test logger以及test的子subtest logger
Logger::getRoot().addAppender(_append);
Logger root = Logger::getRoot();
Logger test = Logger::getInstance(LOG4CPLUS_TEXT("test"));
Logger subTest = Logger::getInstance(LOG4CPLUS_TEXT("test.subtest"));
LogLevelManager& llm = getLogLevelManager();
//設(shè)置優(yōu)先級(jí)之前
//默認(rèn)都是debug級(jí)別
cout << endl << "Before Setting, Default LogLevel" << endl;
LOG4CPLUS_FATAL(root, "root: " << llm.toString(root.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test: " << llm.toString(test.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test.subtest: " << llm.toString(subTest.getChainedLogLevel()));
//subTest被設(shè)置警告優(yōu)先級(jí)
cout << endl << "Setting test.subtest to WARN" << endl;
subTest.setLogLevel(WARN_LOG_LEVEL);
LOG4CPLUS_FATAL(root, "root: " << llm.toString(root.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test: " << llm.toString(test.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test.subtest: " << llm.toString(subTest.getChainedLogLevel()));
//設(shè)置TRACE
cout << endl << "Setting test.subtest to TRACE" << endl;
test.setLogLevel(TRACE_LOG_LEVEL);
LOG4CPLUS_FATAL(root, "root: " << llm.toString(root.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test: " << llm.toString(test.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test.subtest: " << llm.toString(subTest.getChainedLogLevel()));
cout << endl << "Setting test.subtest to NO_LEVEL" << endl;
//NOT_SET_LOG_LEVEL
subTest.setLogLevel(NOT_SET_LOG_LEVEL);
LOG4CPLUS_FATAL(root, "root: " << llm.toString(root.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test: " << llm.toString(test.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test.subtest: " << llm.toString(subTest.getChainedLogLevel()) << '\n') ;
//重新獲取test實(shí)例
cout << "create a logger test_bak, named \"test_\", too. " << endl;
Logger test_bak = Logger::getInstance(LOG4CPLUS_TEXT("test"));
//設(shè)置等級(jí)INFO_LOG_LEVEL
cout << "Setting test to INFO, so test_bak also be set to INFO" << endl;
test.setLogLevel(INFO_LOG_LEVEL);
LOG4CPLUS_FATAL(root, "test: " << llm.toString(test.getChainedLogLevel()));
LOG4CPLUS_FATAL(root, "test_bak: " << llm.toString(test_bak.getChainedLogLevel()));
_getch();
return 0;
}
/**//*
設(shè)置日志等級(jí)，輸出對(duì)應(yīng)等級(jí)的日志
*/
#include "stdafx.h"
#pragma comment(lib,"../bin/log4cplusD.lib")
#include <log4cplus/logger.h>
#include <log4cplus/fileappender.h>
#include <log4cplus/consoleappender.h>
#include <conio.h>
#include <iostream>
using namespace std;
using namespace log4cplus;
void ShowMsg(void)
{
LOG4CPLUS_TRACE(Logger::getRoot(),"info");
LOG4CPLUS_DEBUG(Logger::getRoot(),"info");
LOG4CPLUS_INFO(Logger::getRoot(),"info");
LOG4CPLUS_WARN(Logger::getRoot(),"info");
LOG4CPLUS_ERROR(Logger::getRoot(),"info");
LOG4CPLUS_FATAL(Logger::getRoot(),"info");
}
int _tmain(int argc, _TCHAR* argv[]){
SharedAppenderPtr _append(new ConsoleAppender());
_append->setName(LOG4CPLUS_TEXT("test"));
//std::auto_ptr<Layout> _layout(new TTCCLayout());
//_append->setLayout(_layout);
_append->setLayout(std::auto_ptr<TTCCLayout>(new TTCCLayout()));
Logger root = Logger::getRoot();
root.addAppender(_append);
//無等級(jí)，顯示所有的日志
cout << endl << "all-log allowed" << endl;
root.setLogLevel(ALL_LOG_LEVEL);
ShowMsg();
//顯示>=TRACE等級(jí)日志
cout << endl << "trace-log and above allowed" << endl;
root.setLogLevel(TRACE_LOG_LEVEL);
ShowMsg();
//顯示>=DEBUG等級(jí)日志
cout << endl << "debug-log and above allowed" << endl;
root.setLogLevel(DEBUG_LOG_LEVEL);
ShowMsg();
//顯示>=INFO等級(jí)日志
cout << endl << "info-log and above allowed" << endl;
root.setLogLevel(INFO_LOG_LEVEL);
ShowMsg();
//顯示>=WARN等級(jí)日志
cout << endl << "warn-log and above allowed" << endl;
root.setLogLevel(WARN_LOG_LEVEL);
ShowMsg();
//顯示>=ERROR等級(jí)日志
cout << endl << "error-log and above allowed" << endl;
root.setLogLevel(ERROR_LOG_LEVEL);
ShowMsg();
//顯示>=FATAL等級(jí)日志
cout << endl << "fatal-log and above allowed" << endl;
root.setLogLevel(FATAL_LOG_LEVEL);
ShowMsg();
//關(guān)閉所有日志輸出
cout << endl << "log disabled" << endl;
root.setLogLevel(OFF_LOG_LEVEL);
ShowMsg();
_getch();
return 0;
}
用戶也可以自行定義LogLevel，操作比較簡(jiǎn)單，首先要定義LEVEL值，比如HELLO_LOG_LEVEL定義如下：
//DEBUG_LOG_LEVEL < HELLO_LOG_LEVEL < INFO_LOG_LEVEL
const LogLevel HELLO_LOG_LEVEL = 15000;
然后定義以下宏即可：
// define MACRO LOG4CPLUS_HELLO
#define LOG4CPLUS_HELLO(logger, logEvent) \
if(logger.isEnabledFor(HELLO_LOG_LEVEL)) { \
log4cplus::tostringstream _log4cplus_buf; \
_log4cplus_buf << logEvent; \
logger.forcedLog(HELLO_LOG_LEVEL, _log4cplus_buf.str(), __FILE__, __LINE__); \
}
不過log4cplus沒有提供給用戶一個(gè)接口來實(shí)現(xiàn)LEVEL值與字符串的轉(zhuǎn)換，所以當(dāng)帶格式
輸出LogLevel字符串時(shí)候會(huì)顯示"UNKNOWN"， 不夠理想。比如用TTCCLayout控制輸出的結(jié)果可能會(huì)如下所示：
10-17-04 11:17:51,124 [1075298944] UNKNOWN root <> - info
而不是期望的以下結(jié)果：
10-17-04 11:17:51,124 [1075298944] HELLO root <> - info
要想實(shí)現(xiàn)第二種結(jié)果，按照log4cplus現(xiàn)有的接口機(jī)制，只能改其源代碼后重新編譯，方法是在loglevel.cxx中加入：
#define _HELLO_STRING LOG4CPLUS_TEXT("HELLO")
然后修改log4cplus::tstring defaultLogLevelToStringMethod(LogLevel ll)函數(shù)，增加一個(gè)判斷：
case HELLO_LOG_LEVEL:
return _HELLO_STRING;
重新編譯log4cplus源代碼后生成庫文件，再使用時(shí)即可實(shí)現(xiàn)滿意效果。
二. 基于腳本配置來過濾log信息
除了通過程序?qū)崿F(xiàn)對(duì)log環(huán)境的配置之外，log4cplus通過PropertyConfigurator類實(shí)現(xiàn)了基于腳本配置的功能。
通過腳本可以完成對(duì)logger、appender和layout的配置，因此可以解決怎樣輸出，輸出到哪里的問題，我將在
全文的最后一部分中提到多線程環(huán)境中如何利用腳本配置來配合實(shí)現(xiàn)性能測(cè)試，本節(jié)將重點(diǎn)介紹基腳本實(shí)現(xiàn)過
濾log信息的功能。
首先簡(jiǎn)單介紹一下腳本的語法規(guī)則：
包括Appender的配置語法和logger的配置語法，其中：
1.Appender的配置語法:
（1）設(shè)置名稱：
//設(shè)置方法
log4cplus.appender.appenderName=fully.qualified.name.of.appender.class
例如（列舉了所有可能的Appender，其中SocketAppender后面會(huì)講到）：
log4cplus.appender.append_1=log4cplus::ConsoleAppender
log4cplus.appender.append_2=log4cplus::FileAppender
log4cplus.appender.append_3=log4cplus::RollingFileAppender
log4cplus.appender.append_4=log4cplus::DailyRollingFileAppender
log4cplus.appender.append_4=log4cplus::SocketAppender
（2）設(shè)置Filter：
包括選擇過濾器和設(shè)置過濾條件，可選擇的過濾器包括：LogLevelMatchFilter、LogLevelRangeFilter、和StringMatchFilter：
對(duì)LogLevelMatchFilter來說，過濾條件包括LogLevelToMatch和AcceptOnMatch（true|false），
只有當(dāng)log信息的LogLevel值與LogLevelToMatch相同，且AcceptOnMatch為true時(shí)才會(huì)匹配。
LogLevelRangeFilter來說，過濾條件包括LogLevelMin、LogLevelMax和AcceptOnMatch，
只有當(dāng)log信息的LogLevel在LogLevelMin、LogLevelMax之間同時(shí)AcceptOnMatch為true時(shí)才會(huì)匹配。
對(duì)StringMatchFilter來說，過濾條件包括StringToMatch和AcceptOnMatch，只有當(dāng)log信息的LogLevel值
與StringToMatch對(duì)應(yīng)的LogLevel值與相同， 且AcceptOnMatch為true時(shí)會(huì)匹配。
過濾條件處理機(jī)制類似于IPTABLE的Responsibility chain，（即先deny、再allow）不過執(zhí)行順序剛好相反，
后寫的條件會(huì)被先執(zhí)行,比如：
log4cplus.appender.append_1.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.append_1.filters.1.LogLevelToMatch=TRACE
log4cplus.appender.append_1.filters.1.AcceptOnMatch=true
#log4cplus.appender.append_1.filters.2=log4cplus::spi::DenyAllFilter
會(huì)首先執(zhí)行filters.2的過濾條件，關(guān)閉所有過濾器，然后執(zhí)行filters.1，僅匹配TRACE信息。
(3) 設(shè)置Layout可以選擇不設(shè)置、TTCCLayout、或PatternLayout如果不設(shè)置，
會(huì)輸出簡(jiǎn)單格式的log信息。設(shè)置TTCCLayout如下所示：
log4cplus.appender.ALL_MSGS.layout=log4cplus::TTCCLayout
設(shè)置PatternLayout如下所示：
log4cplus.appender.append_1.layout=log4cplus::PatternLayout
log4cplus.appender.append_1.layout.ConversionPattern=%d{%m/%d/%y %H:%M:%S,%Q} [%t] %-5p - %m%n
2.logger的配置語法
包括rootLogger和non-root logger。
對(duì)于rootLogger來說：log4cplus.rootLogger=[LogLevel], appenderName, appenderName, ...
對(duì)于non-root logger來說：log4cplus.logger.logger_name=[LogLevel|INHERITED], appenderName, appenderName, ...
腳本方式使用起來非常簡(jiǎn)單，只要首先加載配置即可（urconfig.properties是自行定義的配置文件）：
PropertyConfigurator::doConfigure("urconfig.properties");
補(bǔ)充說明：log4cplus.additivity.logger_name表示表示是否繼承父類的配置
3. 示例：
配置文件如下：
log4cplus.rootLogger=TRACE, ALL_MSGS, TRACE_MSGS, DEBUG_INFO_MSGS, FATAL_MSGS
#trace_msgs將可以通過Logger::getInstance(LOG4CPLUS_TEXT("trace_msgs"))獲取
log4cplus.logger.trace_msgs = TRACE,TRACE_MSGS
log4cplus.logger.debug_info_msgs = TRACE,DEBUG_INFO_MSGS
log4cplus.logger.fatal_msgs = TRACE,FATAL_MSGS
log4cplus.appender.ALL_MSGS=log4cplus::RollingFileAppender
log4cplus.appender.ALL_MSGS.File=all_msgs.log
log4cplus.appender.ALL_MSGS.layout=log4cplus::TTCCLayout
log4cplus.appender.TRACE_MSGS=log4cplus::RollingFileAppender
log4cplus.appender.TRACE_MSGS.File=trace_msgs.log
log4cplus.appender.TRACE_MSGS.layout=log4cplus::TTCCLayout
log4cplus.appender.TRACE_MSGS.filters.1=log4cplus::spi::LogLevelMatchFilter
log4cplus.appender.TRACE_MSGS.filters.1.LogLevelToMatch=TRACE
log4cplus.appender.TRACE_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.TRACE_MSGS.filters.2=log4cplus::spi::DenyAllFilter
log4cplus.appender.DEBUG_INFO_MSGS=log4cplus::RollingFileAppender
log4cplus.appender.DEBUG_INFO_MSGS.File=debug_info_msgs.log
log4cplus.appender.DEBUG_INFO_MSGS.layout=log4cplus::TTCCLayout
log4cplus.appender.DEBUG_INFO_MSGS.filters.1=log4cplus::spi::LogLevelRangeFilter
log4cplus.appender.DEBUG_INFO_MSGS.filters.1.LogLevelMin=DEBUG
log4cplus.appender.DEBUG_INFO_MSGS.filters.1.LogLevelMax=INFO
log4cplus.appender.DEBUG_INFO_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.DEBUG_INFO_MSGS.filters.2=log4cplus::spi::DenyAllFilter
log4cplus.appender.FATAL_MSGS=log4cplus::RollingFileAppender
log4cplus.appender.FATAL_MSGS.File=fatal_msgs.log
log4cplus.appender.FATAL_MSGS.layout=log4cplus::TTCCLayout
log4cplus.appender.FATAL_MSGS.filters.1=log4cplus::spi::StringMatchFilter
log4cplus.appender.FATAL_MSGS.filters.1.StringToMatch=FATAL
log4cplus.appender.FATAL_MSGS.filters.1.AcceptOnMatch=true
log4cplus.appender.FATAL_MSGS.filters.2=log4cplus::spi::DenyAllFilter
代碼示例如下：
/**//*
設(shè)置日志等級(jí)，輸出對(duì)應(yīng)等級(jí)的日志
*/
#include "stdafx.h"
#pragma comment(lib,"../bin/log4cplusD.lib")
#include <log4cplus/logger.h>
#include <log4cplus/fileappender.h>
#include <log4cplus/consoleappender.h>
#include <conio.h>
#include <iostream>
#include <log4cplus/configurator.h>
using namespace std;
using namespace log4cplus;
static Logger logger1 = Logger::getInstance(LOG4CPLUS_TEXT("TRACE_MSGS"));
static Logger logger2 = Logger::getInstance(LOG4CPLUS_TEXT("log"));
void printDebug(){
/**//* LOG4CPLUS_TRACE(logger, "::printDebug()");
LOG4CPLUS_DEBUG(logger, "This is a DEBUG message");
LOG4CPLUS_INFO(logger, "This is a INFO message");
LOG4CPLUS_WARN(logger, "This is a WARN message");
LOG4CPLUS_ERROR(logger, "This is a ERROR message");
LOG4CPLUS_FATAL(logger, "This is a FATAL message");
*/
LOG4CPLUS_TRACE(logger1, "::printDebug()");
}
int _tmain(int argc, _TCHAR* argv[]){
//
PropertyConfigurator::doConfigure(LOG4CPLUS_TEXT("urconfig.properties"));
//入root的logger寫入記錄
Logger root = Logger::getRoot();
LOG4CPLUS_FATAL(root,"向all_msgs.log文件中寫入信息，因?yàn)橄騬oot，自動(dòng)往所有的字文件寫入!");
//只向log4cplus.logger.trace_msgs = TRACE,TRACE_MSGS對(duì)應(yīng)的
//log4cplus.appender.TRACE_MSGS文件寫入日志
Logger logger1 = Logger::getInstance(LOG4CPLUS_TEXT("TRACE_MSGS"));
LOG4CPLUS_TRACE(logger1,"只向all_msgs.log或trace_msgs.log文件寫入日志!");
return 0;
}
結(jié)果如下：
all_msgs.log:
10 [5840] FATAL root <> - 向所有的文件中寫入信息，因?yàn)橄騬oot，自動(dòng)往所有的字文件寫入!
10 [5840] TRACE TRACE_MSGS <> - 只向trace_msgs.log文件寫入日志!
trace_msgs.log:
10 [5840] TRACE TRACE_MSGS <> - 只向trace_msgs.log文件寫入日志!
其他文件為空