Log4j2介绍和特性实例(四)--过滤器Filter

时间:2021-03-12 21:50:32

Log4j2的过滤器功能使用比较灵活,可以在三钟标签(对应下面类图中的三个类)中添加过滤器Filter,一是在配置文件的<configuration> 标签下,第二是在<loggers>,第三是在<appenders>标签下。

下图摘自用户手册第二章Architecture

Log4j2介绍和特性实例(四)--过滤器Filter

过滤器也有很多种,具体可以参考手册的第十一章Filters,大家可以去具体看一下。下面介绍一种比较实用的过滤器,组合过滤器CompositeFilter。CompositeFilter可以包含多种不同的过滤器,这样,多种过滤条件可以同时过滤日志信息,符合所有条件的日志信息才会被写入日志文件。下面举一个例子:

    <Filters>
<ThresholdFilter level="TRACE" onMatch="NEUTRAL" onMismatch="DENY"/>
<RegexFilter regex=".* test .*" onMatch="NEUTRAL" onMismatch="DENY"/>
<TimeFilter start="05:00:00" end="05:30:00" onMatch=" NEUTRAL " onMismatch="DENY"/>
</Filters>
<Filters>是组合过滤器额标签,它包含的子标签是具体的过滤器,这三个具体过滤器分别是日志等级过滤器,正则表达式过滤器和时间过滤器。

需要说明的是onMatch和onMismatch可以选择的值及其含义。可选的值分别是,ACCEPT, DENY, NEUTRAL,ACCEP和DENY比较好理解就是接受和拒绝的意思,在使用单个过滤器的时候,一般就是使用这两个值。但是在组合过滤器中,如果用接受ACCEPT的话,日志信息就会直接写入日志文件,后续的过滤器不再进行过滤。所以,在组合过滤器中,接受使用NEUTRAL(中立),被第一个过滤器接受的日志信息,会继续用后面的过滤器进行过滤,只有符合所有过滤器条件的日志信息,才会被最终写入日志文件。


下一篇将介绍Log4j2中用户自定义日志等级。谢谢大家的关注。