Log4j级别示例–订单,优先级,自定义过滤器
如果使用过log4j,您会注意到有许多记录消息的方法。
例如:
logger.trace("My Log message");
logger.debug("My Log message");
logger.info("My Log message");
实际上,它们对应于log4j级别。
Log4j级别
Log4j提供了许多日志记录级别。
以下是完整列表。
跟踪:"跟踪级别"比"调试"指定更详细的信息事件。
调试:调试级别指定对调试应用程序最有用的细粒度信息事件。
INFO:INFO级别指定信息性消息,以粗粒度级别突出显示应用程序的进度。
警告:警告级别表示潜在的有害情况。
错误:错误级别指定可能仍允许应用程序继续运行的错误事件。
严重:致命级别指示非常严重的错误事件,可能会导致应用程序中止。
ALL:ALL具有最低的等级,旨在打开所有日志记录。
OFF:OFF具有最高级别,旨在关闭日志记录。
ALL和OFF是特殊的日志记录级别,应在极端情况下使用。
我从未在任何时间亲自使用过这些。
Log4j级别顺序/优先级
跟踪的优先级最低,而致命的优先级最高。
下面是log4j日志记录级别的顺序。
跟踪<调试<信息<警告<错误<致命。
当我们定义记录器级别时,具有更高优先级日志的任何内容也会被打印出来。
例如,如果记录器级别为INFO,则不会打印调试日志,但是会打印警告日志,因为优先级更高。
Log4j过滤器
假设我们只想记录INFO和FATAL事件,而不要记录WARN和ERROR事件。
在这些情况下,我们可以利用log4j过滤器。
我们可以扩展org.apache.log4j.spi.Filter类,并实现其Decide(LoggingEvent event)方法来提供自定义过滤功能。
package com.theitroad.log4j.filters;
import org.apache.log4j.Level;
import org.apache.log4j.spi.Filter;
import org.apache.log4j.spi.LoggingEvent;
public class MyLog4jFilter extends Filter {
/**
* My custom filter to only log INFO and FATAL events
*/
@Override
public int decide(LoggingEvent event) {
if(event.getLevel() == Level.INFO || event.getLevel() == Level.FATAL)
return ACCEPT;
else return DENY;
}
}
自定义过滤器上方将仅记录INFO和FATAL事件,下面是此事件的XML log4j配置。
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j="https://jakarta.apache.org/log4j/"
debug="false">
<!-- console appender -->
<appender name="console" class="org.apache.log4j.ConsoleAppender">
<param name="Target" value="System.out"
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %c{1} - %m%n"
</layout>
<filter class="com.theitroad.log4j.filters.MyLog4jFilter"
</appender>
<logger name="com.theitroad.log4j" additivity="false">
<level value="TRACE"
<appender-ref ref="console"
</logger>
<root>
<priority value="DEBUG"
<appender-ref ref="console"
</root>
</log4j:configuration>
注意控制台附加程序中Filter类的用法。
下面是执行基本日志记录的简单类。
package com.theitroad.log4j.main;
import org.apache.log4j.Logger;
import org.apache.log4j.PropertyConfigurator;
import org.apache.log4j.xml.DOMConfigurator;
public class Log4jExample {
static {
init();
}
private final static Logger logger = Logger.getLogger(Log4jExample.class);
public static void main(String[] args) {
logger.trace("My Trace Log");
logger.debug("My Debug Log");
logger.info("My Info Log");
logger.warn("My Warn Log");
logger.error("My error log");
logger.fatal("My fatal log");
}
/**
* method to init log4j configurations
*/
private static void init() {
DOMConfigurator.configure("log4j.xml");
}
}
在运行该程序时,它将在控制台中生成以下日志。
INFO Log4jExample - My Info Log FATAL Log4jExample - My fatal log
通过创建自己的自定义过滤器类,我们可以进行更复杂的过滤。
注意,对于这种特殊情况,我们可以使用org.apache.log4j.varia.LevelMatchFilter和org.apache.log4j.varia.DenyAllFilter类,如以下附加程序所示。
<appender name="console" class="org.apache.log4j.ConsoleAppender">
<param name="Target" value="System.out"
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%-5p %c{1} - %m%n"
</layout>
<filter class="org.apache.log4j.varia.LevelMatchFilter">
<param name="LevelToMatch" value="INFO"
<param name="AcceptOnMatch" value="true"
</filter>
<filter class="org.apache.log4j.varia.LevelMatchFilter">
<param name="LevelToMatch" value="FATAL"
<param name="AcceptOnMatch" value="true"
</filter>
<filter class="org.apache.log4j.varia.DenyAllFilter"
</appender>
我们还有" org.apache.log4j.varia.LevelRangeFilter"类,可用于拒绝优先级超出特定范围的消息。

