Log4Qt 日志格式化（PatternLayout）
星標/置頂 公眾號??，硬核文章第一時間送達！
1
繼承關系圖
Log4Qt 提供了各種布局對象，通過使用這些 Layout，我們可以根據自己的喜好來格式化日志輸出，自由指定日志級別、線程名稱、Logger 名稱、日期時間等信息。
Log4Qt::Layout 繼承關系圖：
在該層次結構中，頂級類是 Layout，它是 Log4Qt API 中所有其他布局類的基類。
PatternLayout：根據一個模式字符串輸出日志事件SimpleLayout：輸出日志事件的級別和消息TTCCLayout：輸出日志事件的時間、線程名稱、Logger 名稱和嵌套的診斷上下文信息
注意：這里列出來的這幾個 Layout 比較常用，也是我們重點講解的內容。此外，還有一些其它 Layout（例如：BinaryLayout、XMLLayout 等），這里并沒有列出，希望通過后面分享的知識，大家能夠快速熟悉它們的用法。
這些類擴展了 Layout，并根據提供的模式重寫了 format() 方法來構造日志信息。
在內部，PatternLayout 和 TTCCLayout 通過 PatternFormatter 來實現格式化。當 PatternFormatter 解析模式字符串時，它會根據發(fā)現的信息創(chuàng)建了一個 PatternConverter 鏈，每個 PatternConverter 會處理 LoggingEvent 的某個成員。
2
轉換字符
轉換字符：用于指定數據的類型，例如：類別、級別、日期、線程名稱。
轉換說明符以百分號（%）開始，后跟轉換字符。Log4Qt 中的轉換字符有：
| 轉換字符 | 含義 |
|---|---|
| c{section_count} | Logger 名稱。參數 section_count 可選，從 logger 名稱的末尾處計數，分隔符是“::”。 |
| d{format_string} | 日期。參數 format_string 可選，被用于 QDateTime::toString()。 |
| m | 消息 |
| p | 級別名稱 |
| r | 啟動應用程序的相對日期/時間 |
| t | 線程名稱 |
| x | NDC（嵌套的診斷上下文）名稱 |
| X | MDC（映射的診斷上下文）名稱 |
| F | 文件名稱 |
| M | 方法名稱 |
| L | 行號 |
| l | 位置信息 |
| n | 平臺相關的行分隔符（Windows：\r\n，Linux：\n） |
| % | 序列 %% 輸出一個百分號 % |
3
PatternLayout
如果想生成基于模式的特定格式的日志信息，那么可以使用 PatternLayout 來進行格式化。
枚舉 ConversionPattern 定義了兩個常用的模式：
| 枚舉 | 模式字符串 |
|---|---|
| DEFAULT_CONVERSION_PATTERN | “%m,%n” |
| TTCC_CONVERSION_PATTERN | “%r [%t] %p %c %x - %m%n” |
創(chuàng)建一個 PatternLayout，并將日志信息輸出至控制臺中：
#include <QCoreApplication>
#include <log4qt/logger.h>
#include <log4qt/patternlayout.h>
#include <log4qt/consoleappender.h>
#include <log4qt/loggerrepository.h>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// 創(chuàng)建一個 PatternLayout（根據模式字符串輸出日志事件）
Log4Qt::Logger *logger = Log4Qt::Logger::rootLogger();
Log4Qt::PatternLayout *layout = new Log4Qt::PatternLayout();
layout->setHeader("----- Header -----"); // 設置標頭信息
layout->setFooter("----- Footer -----"); // 設置頁腳信息
layout->setName("My Layout");
// layout->setConversionPattern(Log4Qt::PatternLayout::TTCC_CONVERSION_PATTERN);
// layout->setConversionPattern("%d{yyyy-MM-dd hh:mm:ss} - %m%n");
// layout->setConversionPattern("The output message is: %m%n");
layout->activateOptions();
// 創(chuàng)建一個 ConsoleAppender（將日志內容輸出到控制臺上）
Log4Qt::ConsoleAppender *appender = new Log4Qt::ConsoleAppender(layout, Log4Qt::ConsoleAppender::STDOUT_TARGET);
appender->setName("My Appender");
appender->activateOptions();
logger->addAppender(appender);
logger->setLevel(Log4Qt::Level::DEBUG_INT);
logger->debug("Hello, Log4Qt!");
// 關閉 logger
logger->removeAllAppenders();
logger->loggerRepository()->shutdown();
return a.exec();
}
注意：除正文之外，還可以為日志消息指定標頭和頁腳。布局對象的內容類型默認為 text/plain，如果要自定義布局并制定其他類型，需要重寫 Layout 的 contentType() 方法。
默認情況下，轉換模式為 DEFAULT_CONVERSION_PATTERN，只會輸出簡單的日志信息：
----- Header -----
Hello, Log4Qt!
----- Footer -----
由于我們在代碼中指定了標頭和頁腳，所以在日志信息的前后會輸出相關信息，這有時在區(qū)分日志時會很有用。
和其他布局相比，PatternLayout 很大的一個優(yōu)勢在于靈活。除了上述方式之外，還可以指定其它模式。
若要修改默認模式，可以打開代碼中的注釋部分：
layout->setConversionPattern(Log4Qt::PatternLayout::TTCC_CONVERSION_PATTERN);
運行程序，這時不僅會輸出日志信息，還會輸出啟動時間、線程名稱、logger 名稱：
4 [0x000001bdc8415750] DEBUG root - Hello, Log4Qt!
實際上，這采用的是和 TTCCLayout 相同的模式，從名字就可以看出。
此外，還可以通過自定義模式字符串來指定日期時間：
layout->setConversionPattern("%d{yyyy-MM-dd hh:mm:ss} - %m%n");
運行程序，輸出如下：
2021-08-17 22:54:04 - Hello, Log4Qt!
如果想額外為消息添加一些文本，也非常簡單：
layout->setConversionPattern("The output message is: %m%n");
運行程序，輸出如下：
The output message is: Hello, Log4Qt!
通過這種方式，我們可以自由地在轉換模式中插入任何文本，使用起來相當方便。
出于靈活性考慮，在以后的使用中，配置文件將是我們的首選，所以務必要學會如何有效地利用它。
編寫一個配置文件 - log4qt.properties，執(zhí)行與上例中使用相同的任務：
# 定義 rootLogger
log4j.rootLogger=DEBUG, console
# 定義 ConsoleAppender
log4j.appender.console=org.apache.log4j.ConsoleAppender
log4j.appender.console.immediateFlush=true
log4j.appender.console.target=STDOUT_TARGET
# 為 ConsoleAppender 定義 Layout
log4j.appender.console.layout=org.apache.log4j.PatternLayout
log4j.appender.console.layout.header=----- Header -----
log4j.appender.console.layout.footer=----- Footer -----
log4j.appender.console.layout.conversionPattern=%r [%t] %p %c %x - %m%n
#include <QCoreApplication>
#include <log4qt/logger.h>
#include <log4qt/loggerrepository.h>
int main(int argc, char *argv[])
{
QCoreApplication a(argc, argv);
// 獲取 rootLogger
Log4Qt::Logger* logger = Log4Qt::Logger::rootLogger();
// 打印消息
logger->debug("Hello, Log4Qt!");
// 關閉 rootLogger
logger->removeAllAppenders();
logger->loggerRepository()->shutdown();
return a.exec();
}
注意：最后記得關閉 logger，否則不會釋放資源，也不會輸出 Footer。
運行程序，輸出如下：
----- Header -----
65 [0x000001d25ec81f70] DEBUG root - Hello, Log4Qt!
----- Footer -----
可以看出，使用配置文件和純代碼的效果是一樣的。
關注公眾號「高效程序員」??，一起優(yōu)秀！