如果我们希望输出 com.foo.Bar 的 TRACE 等级的日志，而不像影响其他日志的输出。简单的改变日志等级是不能达到我们想要的目的；但是修改也很简单，只要我们添加一个新的 Logger 定义就可以达到目标。
1
2
3
4
| <Logger name="com.foo.Bar" level="TRACE"/>
<Root level="ERROR">
<AppenderRef ref="STDOUT">
</Root>
|
这个配置达到了我们想要的目标，所有 com.foo.Bar 的日志都会被输出，而其他组件的日志仅仅会输出 ERROR 等级的日志。
在上面的例子，所有 com.foo.Bar 的日志都会被输出到控制台。这是因为为 com.foo.Bar 配置的 Logger 没有设定任何的 Appender。
请看如下的配置
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| <?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Logger name="com.foo.Bar" level="trace">
<AppenderRef ref="Console"/>
</Logger>
<Root level="error">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
|
将会输出
1
2
3
4
5
6
| 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] 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 日志被输出了两次。
首先 com.foo.Bar 关联的 Logger 执行了一次，直接输出到控制台。接下来这个 Logger 的父节点，也就是 Root Logger 执行了另一次输出，这是因为日志在 com.foo.Bar 已经被输出，所以也会被父自动输出到控制台。这就是多余性，有的时候多余性的确是非常便捷的功能（前面的例子，我们增加了一个 Logger，但是没有设置 Appender，但是却正常工作了），有的时候却不是很方便，因此这个功能在 Logger 中是可以通过 additivity 的属性进行关闭的（设置成 false）。
译者注：
首先 Additivity 的确不知道该翻译成什么更合适，感觉什么“附加性”“额外性”都不是很合适，最后觉得“多余性”更贴切些，如果有好的建议望指正。
其次这个多余性的特点，个人认为主要是让我们使用 Log4j2 的时候不用为每一个 Logger 指定 Appender 方便配置；当然如果想单独指定 Appender，Log4j2 也是支持的。而且可以设置开关。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
| <?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN">
<Appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</Appenders>
<Loggers>
<Logger name="com.foo.Bar" level="trace" additivity="false">
<AppenderRef ref="Console"/>
</Logger>
<Root level="error">
<AppenderRef ref="Console"/>
</Root>
</Loggers>
</Configuration>
|
上面配置的输出（译者的输出）：
1
2
3
4
| 16:41:37.116 [main] TRACE com.foo.Bar - Enter
16:41:37.118 [main] ERROR com.foo.Bar - Did it again!
16:41:37.119 [main] TRACE com.foo.Bar - Exit with(false)
16:41:37.119 [main] ERROR com.foo.MyApp - Didn't do it.
|
一旦一个日志输出到一个 Logger，这个 Logger 的 additivity 设置为 false，那么这个日志不会再继续向父 Logger 进行传递，忽略其他 Logger 的 additivity 的设置。
