java 日志框架 详解_java日志框架系列（9）：logback框架过滤器（filter）详解

过滤器放在了logback-classic模块中。

1.logback-classic模块中过滤器

分类(2种)：常规过滤器、TurboFilter过滤器。

1.常规过滤器

常规过滤器可以通过自定义进行条件筛选过滤。

目前logback-classic中有2个常规过滤器：级别过滤器(LevelFilter)、临界值过滤器(ThresholdFilter)。在logback-core中还有一个求值过滤器(EvaluatorFilter)。

1.自定义过滤器

创建自定义过滤器很容易，只需要继承Filter抽象类并实现decide()方法。

下面就通过范例来了解如何创建自定义过滤器吧。

1.范例

功能：自定义 SampleFilter 类，当记录事件的消息字段包含字符串“sample”时，它的 decide

方法返回 ACCEPT，其他情况下返回 NEUTRAL。

步骤：(2步)

1.创建继承Filter抽象类的Sample类并实现decide()方法。

2.在xml配置文件中配置过滤器。

定义过滤器SampleFilter，代码如下：

public class SampleFilter extends Filter{

@OverridepublicFilterReply decide(ILoggingEvent event) {if (event.getMessage() != null &&event.getMessage().contains("sample")) {returnFilterReply.ACCEPT;

}else{return FilterReply.NEUTRAL; }

}

}

配置xml配置文件，代码如下：

match就是匹配的意思，那mismatch当然就是不匹配啦。

由于常规过滤器可以根据事件包含的某些信息进行过滤，那么当然可以根据级别进行过滤了。下面介绍一下级别过滤器：

1.级别过滤器(LevelFilter)

级别过滤器xml配置示例：

这个配置表示：当级别为INFO时，decide()方法会响应ACCEPT;否则响应DENY。

标签包含3个子标签： 、 、。

功能： 用于指定过滤的级别。

功能：指定级别匹配时响应的值。值为FilterReply的枚举。

功能：指定级别不匹配时响应的值。值为FilterReply的枚举。

FilterReply的值：ACCEPT 、NEUTRAL、DENY。

2.临界值过滤器(ThresholdFilter)

临界值过滤器xml配置示例：

这个配置表明当级别等于或高于中的子标签指定的级别时，decide()方法会响应NEUTRAL；否则decide方法会响应DENY。

2.TurboFilter过滤器

常用的TurboFilter过滤器(3类)：MDCFilter、MarkerFilter、DuplicateFilter。

TurboFilter过滤器与常规过滤器作用范围不同。

常规过滤器Filter作用范围：仅仅是某个logger。如果与这个loggerA关联的appenderB中配置了常规过滤器C，那么每当这个loggerA发起记录请求的时候都会调用这个常规过滤器C。但是未与appenderB关联的logger发起记录请求时无法调用这个常规过滤器C。

TurboFilter过滤器作用范围：整个Logger上下文。就是所有的logger发起记录请求时都会调用这个TurboFilter类型过滤器。

根据他们的作用范围不同，因此我们可以猜测出在配置文件中他们所处的位置肯定是不同的。

过滤器位置

常规过滤器Filter位置：位于appender内。常规过滤器用标签，是的子标签。

TurboFilter过滤器位置：位于configuration内。TurboFilter过滤器用标签，是子标签。

1.自定义TurboFilter过滤器

想要自定义TurboFilter过滤器，必须创建一个类，且该类必须继承TurboFilter抽象类并实现decide()方法。

下面我们通过示例来了解一下如何创建自定义TurboFilter过滤器。

创建并使用自定义TurboFilter过滤器步骤(2步)：

1.创建继承TurboFilter抽象类的类SampleTurboFilter。

2.在xml配置文件中配置TurboFilter过滤器。

示例：

packagechapters.filters;importorg.slf4j.Marker;importorg.slf4j.MarkerFactory;importch.qos.logback.classic.Level;importch.qos.logback.classic.Logger;importch.qos.logback.classic.turbo.TurboFilter;importch.qos.logback.core.spi.FilterReply;public class SampleTurboFilter extendsTurboFilter {

String marker;

Marker markerToAccept;

@OverridepublicFilterReply decide(Marker marker, Logger logger, Level level,String format, Object[] params, Throwable t) {if (!isStarted()) {returnFilterReply.NEUTRAL;

}if((markerToAccept.equals(marker))) {returnFilterReply.ACCEPT;

}else{returnFilterReply.NEUTRAL;

}

}publicString getMarker() {returnmarker;

}public voidsetMarker(String markerStr) {this.marker =markerStr;

}

@Overridepublic voidstart() {if (marker != null && marker.trim().length() > 0) {

markerToAccept=MarkerFactory.getMarker(marker);super.start();

}

}

}

上面的 TurboFilter 接受包含特定 marker 的事件。如果上述 marker 未找到，则把任务交给过滤器链里的下一个过滤器。

下面在配置文件中使用自定义的TurboFilter过滤器。 配置文件如下所示：

2.logback-classic中直接使用的TurboFilter过滤器

logback-classic实现的TurboFilter过滤器(2种)：MDCFilter、MarkerFilter。

1.MDCFilter过滤器介绍

MDCFilter 类检查在 MDC 里是否存在一个给定值，从而决定响应哪个值(ACCEPT 、NEUTRAL 、DENY)。

配置如下：

注意：标签在标签外面。

2.MarkerFilter过滤器介绍

MarkerFilter会检查与记录事件相关联的某个特定marker是否存在，从而决定响应哪个值(ACCEPT 、NEUTRAL 、DENY)。

配置如下：

3.重复消息过滤器(DuplicateMessageFilter)

重复消息过滤器也是TurboFilter过滤器的一种。

重复消息过滤器的配置如下：

2.logback-core模块中的过滤器

logback-core中只包含了求值过滤器，但是求值过滤器是一个抽象类。

求值过滤器也是有一个常规过滤器。

1.求值过滤器(EvaluatorFilter)