Log4j 2體系結構

Log4j 2體系結構

下圖是Log4j官網給出的類圖：

咱們先依次看一下每一個類的定義是什麼。

1. 前置知識

LoggerContext

// todo 不太理解

Configuration

Configuration類對應的是正在使用的配置文件，例如log4j2.xml。它包含了全部可用的Appender、LoggerConfig、以及Filter的定義。

During reconfiguration two Configuration objects will exist. Once all Loggers have been redirected to the new Configuration, the old Configuration will be stopped and discarded.

在從新配置時（即配置文件有改動時），可能會並存兩個 Configuration對象。一旦全部的 Logger都被重定向到新的配置，舊配置對應的 Configuration對象就會被廢棄。

Logger

Logger對象經過LogManager.getLogger方式得到，通常每一個類都有各自的Logger對象，名稱與該類的全量名一致。Logger應該只是一個接口，自己不執行任何直接操做。，擁有名字並與一個LoggerConfig相關聯。

The Logger itself performs no direct actions. It simply has a name and is associated with a LoggerConfig.

Logger的行爲由與其關聯的LoggerConfig控制，當其與其餘的LoggerConfig相關聯時，它的行爲也會做相應的改變。

LoggerConfig

LoggerConfig對象對應着配置文件（例如log4j2.xml）中的<Logger>。它包含了一系列Filter定義以及對一系列Appender的引用。

LoggerConfig objects are created when Loggers are declared in the logging configuration.

Log4j 1.x與Log4j 2.x的不一樣在於，日誌的層次結構發生了變化。在1.x中，日誌的層次結構是經過Logger之間的關係維護的，而在2.x中，是用LoggerConfig對象之間的關係維護的。

In Log4j 1.x the Logger Hierarchy was maintained through a relationship between Loggers. In Log4j 2 this relationship no longer exists. Instead, the hierarchy is maintained in the relationship between LoggerConfig objects.

命名原則

在Log4j 2.x中，Logger和LoggerConfig會根據名稱進行關聯，並且它們的命名都知足以下的層次關係：
名爲java的LoggerConfig是名爲java.util的LoggerConfig父配置，是名爲java.util.Vector的LoggerConfig的祖先配置。
反過來，名爲java.util.Vector的LoggerConfig是名爲java.util的LoggerConfig的子配置，是名爲java的LoggerConfig的子孫配置。

A LoggerConfig is said to be an ancestor of another LoggerConfig if its name followed by a dot is a prefix of the descendant logger name. A LoggerConfig is said to be a parent of a child LoggerConfig if there are no ancestors between itself and the descendant LoggerConfig.

Root LoggerConfig在整個LoggerConfig體系的最頂層，它沒有任何祖先配置。能夠經過LogManager.getLogger(LogManager.ROOT_LOGGER_NAME)或LogManager.getRootLogger()的方式得到與Root LoggerConfig相關聯的Logger。

日誌等級

在Log4j 2.x中，每一個LoggerConfig都會被分配一個Log level。Log4j 2.x內建支持的Log level爲：TRACE < DEBUG < INFO < WARN < ERROR < FATAL。除了這些內建等級，Log4j 2.x也容許用戶去自定義等級（不過官方並不推薦這麼作）。

除了等級機制，可使用Marker機制來實現更細粒度的控制，更多信息請參考[]()。

接下來，咱們用下面5組實例來介紹一下Log4j 2.x中的Level Inheritance（等級繼承）機制。

Logger Name	Assigned LoggerConfig	LoggerConfig Level	Logger Level
root	root	DEBUG	DEBUG
X	root	DEBUG	DEBUG
X.Y	root	DEBUG	DEBUG
X.Y.Z	root	DEBUG	DEBUG

上表中，只有名爲root的 Logger被賦予了名爲root的 LoggerConfig且 LoggerConfig的等級爲DEBUG，因此名爲root的 Logger的等級也爲DEBUG。其它的 Logger都沒有特別分配 LoggerConfig，所以會繼承它們的祖先配置root。

Logger Name	Assigned LoggerConfig	LoggerConfig Level	Logger Level
root	root	DEBUG	DEBUG
X	X	ERROR	ERROR
X.Y	X.Y	INFO	INFO
X.Y.Z	X.Y.Z	WARN	WARN

上表中，每一個 Logger都與各自同名的 LoggerCongfig所關聯，所以它們的等級都與相關聯的 LoggerConfig的等級保持一致。

Logger Name	Assigned LoggerConfig	LoggerConfig Level	Logger Level
root	root	DEBUG	DEBUG
X	X	ERROR	ERROR
X.Y	X	ERROR	ERROR
X.Y.Z	X.Y.Z	WARN	WARN

上表中，惟獨沒有爲名爲X.Y的 Logger分配同名的 LoggerConfig，所以它將與名爲X的 LoggerConfig相關聯（父配置，而非是祖先配置root）。

Logger Name	Assigned LoggerConfig	LoggerConfig Level	Logger Level
root	root	DEBUG	DEBUG
X	X	ERROR	ERROR
X.Y	X.Y	INFO	INFO
X.YZ	X	ERROR	ERROR

從上表中能夠看出，層次結構是以 .做爲分割的，而不是最長的名稱匹配長度。因此X.YZ的父配置爲X，而不是X.Y。

Logger Name	Assigned LoggerConfig	LoggerConfig Level	Logger Level
root	root	DEBUG	DEBUG
X	X	ERROR	ERROR
X.Y	X.Y		ERROR
X.Y.Z	X.Y		ERROR

上表中，雖然名爲X.Y的 Logger與其同名 LoggerCongfig相關聯，但未被賦予等級，將繼承名爲X的 LoggerConfig的等級ERROR。

下標展現了根據等級的過濾規則：

Event Level							LoggerConfig Level
-	TRACE	DEBUG	INFO	WARN	ERROR	FATAL	OFF
ALL	YES	YES	YES	YES	YES	YES	YES
TRACE	YES	NO	NO	NO	NO	NO	NO
DEBUG	YES	YES	NO	NO	NO	NO	NO
INFO	YES	YES	YES	NO	NO	NO	NO
WARN	YES	YES	YES	YES	NO	NO	NO
ERROR	YES	YES	YES	YES	YES	NO	NO
FATAL	YES	YES	YES	YES	YES	YES	NO
OFF	NO	NO	NO	NO	NO	NO	NO

Appender

Appender指日誌輸出的目的地。Log4j 2.x支持控制檯、文件、遠程socket服務器、Apache Flume、JMS、遠程Unix Syslog守護進程和數據庫API等做爲日誌輸出的目的地。關於這些類型的詳細信息，請參考Appenders。

In log4j speak, an output destination is called an Appender.

Layout

Filter

StrSubsitutor和StrLookup