PatternLayout提供了打印 Thread Context Map 和Thread Context Stack 内容的方法:
? ? ? Use %X by itself to include the full contents of the Map. Use %X{key} to include the specified key. Use %x to include the full contents of the Stack.
四. Configuration
本章只介绍常用和特殊的配置， 全部内容参考 :
http://logging.apache.org/log4j/2.x/manual/configuration.html
插入到应用中的日志代码，需要很合理的规划。据统计，应用中有大约 百分之四 的代码是专门用来记录日志的 。因此即便是一个较小规模的应用，其中也有很多的日志代码。因此， 不用手工修改的去管理这些日志代码成为一种必要。
Log4j2可以通过4种方式进行配置 :
(1) 通过 XML， JSON， YAML，或者 Properties的配置文件 。
(2)编程方式， 通过创建 一个ConfigurationFactory和 Configuration的实现。
(3)编程方式，通过调用 Configuration暴露的API， 为默认的 configuration增加组件。 (4)编程方式，通过调用 Logger的内部方法 。
本章主要介绍通过配置文件的方式配置Log4j2
1. 自动配置
Log4j2可以在初始化的时候自动完成配置，当log4j2启动时，会定位所有的 ConfigurationFactory的配置，并且按照优先级的高底加载它们。Log4j2包括四种 ConfigurationFactory的实现，JSON， YAML， properties，XML。 1. Log4j2将从system property(JVM启动参数，或者System.setProperty设置)读取 log4j.configurationFile属
性，如果设置了对应的文件，Log4j2的 ConfigurationFactory 将尝试根据文件扩展名来加载文件。 2. 如果
systemproperty 没有设置，propertiesConfigurationFactory 将在
classpath
中查
找 log4j2-test.properties文件。 3. 如果没有找到，YAMLConfigurationFactory 将在 classpath中查找log4j2-test.yaml或者
log4j2-test.yml文件。
4. 如果没有找到， JsonConfigurationFactory 将在classpath中查找log4j2-test.json 或者
log4j2-test.jsn
5. 如果没有找到XML ConfigurationFactory 将在 classpath中查找log4j2-test.xml
6. 如果 test文件找不到，则PropertiesConfigurationFactory 将在classpath中查找log4j2.properties文
件
7. 如果未找到，YAML ConfigurationFactory 将在classpath中查找log4j2.yaml或者log4j2.yml 8. 如果未找到，JSON ConfigurationFactory 将在 classpath中查找log4j2.json或者log4j2.jsn 9. 如果未找到，XML ConfigurationFactory 将在classpath中查找log4j2.xml
10. 如果都未找到，DefaultConfiguration 将被使用，默认将日志输出到 console控制台。
例子 : MyApp 使用log4j2 1. import com.foo.Bar; 2.
3. // Import log4j classes.
4. import org.apache.logging.log4j.Logger; 5. import org.apache.logging.log4j.LogManager; 6.
7. publicclassMyApp{ 8.
9. // Define a static logger variable so that it references the 10. // Logger instance named \
11. privatestaticfinalLogger logger =LogManager.getLogger(MyApp.class); 12.
13. publicstaticvoid main(finalString... args){ 14.
15. // Set up a simple configuration that logs on the console. 16.
17. logger.trace(\); 18. Bar bar =newBar(); 19. if(!bar.doIt()){
20. logger.error(\); 21. }
22. logger.trace(\); 23. } 24. }
MyApp 引入log4j2相关的类，在类中定义了一个名为MyApp 的静态 Logger， 另外一个类 Bar 内容如下 : 1. package com.foo;
2. import org.apache.logging.log4j.Logger; 3. import org.apache.logging.log4j.LogManager; 4.
5. publicclassBar{
6. staticfinalLogger logger =LogManager.getLogger(Bar.class.getName()); 7.
8. publicboolean doIt(){ 9. logger.entry();
10. logger.error(\); 11. return logger.exit(false); 12. } 13. }
如果没有加载任何配置文件，log4j将提供一个默认的configuration 。默认的configuration 是通过DefaultConfiguration 定义的，将设置如下 :
? Root Logger将使用 ConsoleAppender
? ConsoleAppender 将使用PatternLayout的格式是 : \? 日志级别是 Level.ERROR
所以上面例子打印如下 :
17:13:01.540 [main] ERROR com.foo.Bar - Did it again! 17:13:01.540 [main] ERROR MyApp - Didn't do it.
默认配置相当于如下的 XML配置 :
1. 2.
4.
5.
9.
10. 11. 12. 13.
2. Additivity
假设只想将 com.foo.Bar的日志级别设置为 TRACE， 仅仅改变日志级别就不能达到这样的要求 ，解决方案是新增一个 Logger。
1.
3. 4.
使用这个配置，com.foo.Bar 的所有日志将被记录，而其他模块只有 Error日志会被记录。
在这个配置中 ，com.foo.Bar 仍然将日志打印到 Console中，因为 com.foo.Bar并没有配置任何appenders ，所以就会使用 Root Logger的配置。事实上，如下配置
1. 2.
4.
5.
9.
12.
13. 14. 15. 16.
将打印 :
17:13:01.540 [main] TRACE com.foo.Bar - entry 17:13:01.540 [main] TRACE com.foo.Bar - entry
17:13:01.540 [main] ERROR com.foo.Bar - Did it again! 17:13:01.540 [main] ERROR com.foo.Bar - Did it again! 17:13:01.540 [main] TRACE com.foo.Bar - exit (false) 17:13:01.540 [main] TRACE com.foo.Bar - exit (false) 17:13:01.540 [main] ERROR MyApp - Didn't do it.
可以看到 com.foo.Bar 中的TRACE 被打印了2次，这是因为com.foo.Bar的appender 先被第一次使用，在
console中打印内容，然后com.foo.Bar的父Logger，即 Roor Logger被引用， logevent会传递到 Root Logger，然后在Console中再次打印。这就是所谓的additivity。在很多时候这个功能是需要禁用的，如下 : 1.