JAVA主流日志框架梳理学习及使用

发布时间:2023年12月19日

前言目前市面上有挺多JAVA的日志框架,比如JUL(JDK自带的日志框架),Log4j,Logback,Log4j2等,有人可能有疑问说还有slf4j,不过slf4j不是一种日志框架的具体实现,而是一种日志门面(日志门面可以理解为是一种统一的接口,只是为了规范日志,没有具体的实现;可以类比USB接口,对于USB接口有好多个厂商,这多个厂商生产出来的USB头都是一样的,使得我们用起来就很方便,slf4j其实也是一样)。虽然市面上有很多日志框架,但是笔者之前只是能够简单的使用日志框架,而且使用时总感觉似懂非懂,对目前市面上的日志框架并没有一个整体且系统的了解。因此,笔者利用周末这两天系统的学习了一下目前市面上的框架,也就有了这篇文章,希望这篇文章能够帮助大家对JAVA日志框架有个清晰的认识。

笔者这篇文件是对该视频内容的提炼,需要的可以自行观看。如果想快速了解日志的重点内容,那么可以继续往下看。
视频链接

一、市面上主要日志简介

目前市面上主要的日志框架有:JUL(JDK自带的日志框架),Log4j,Logback,Log4j2
日志门面:slf4jlog4j2也是一种日志门面,不过因为其实现了丰富的日志功能,所以不把其当做一种日志门面了
日志框架(门面)出现的先后顺序:JUL,Log4j在slf4j门面技术出现之前,logback,Log4j2在slf4j门面技术出现之后。因为JUL,Log4j在slf4j出现之前就有了,所以这两个日志的实现并没有遵循slf4j的规范(不过可以通过导入适配器的依赖来使用)。因为Log4j2是对Log4j的升级,JUL功能比较弱(不过因为是JDK自带的日志实现,不需要导入依赖,使用起来比较方便),所以本文只介绍Logback和Log4j2。
主流日志使用方式:slf4j+Logback、slf4j+Log4j2

使用方式:配置文件。

在使用各种库时,第一步都是导入对应的依赖,日志框架也是一样。此外,对于记录的日志会有不同的日志级别,日志显示(或写入文件)的条件就是当前日志级别大于所设置的日志级别时才会打印,如果不设置日志级别,系统会有默认的日志级别。

日志级别由高到低: error > warn>info>debug>trace(这个日志级别是针对slf4j门面的日志级别,各种日志框架的日志级别都大同小异)

二、slf4j+Logback使用

2.1 导入依赖

在导入依赖时我们需要导入slf4j的依赖(slf4j-api)logback的依赖,因为依赖的传递性,logback-classic的依赖中包含了slf4j-api的依赖,所以我们在实际的使用中只需要导入logback-classic的依赖即可:
依赖情况
依赖

 <dependency>
     <groupId>ch.qos.logback</groupId>
     <artifactId>logback-classic</artifactId>
     <version>1.2.3</version>
 </dependency>

2.2 使用方式

对于日志,我们分别测试下面这几种情况:

2.2.1不使用配置文件
2.2.2使用配置文件

2.2.2.1输出到控制台
2.2.2.2输出到文件
2.2.2.3输出到文件(对文件拆分)

2.2.1 不使用配置文件

项目结构
在这里插入图片描述
执行右面的test01输出如下:
在这里插入图片描述
如上图所示,当不添加配置文件时,默认的输出格式如上所示。只有trace日志级别的日志没有输出,所以logback系统默认的日志级别是debug级别。

日志级别的值

/**
 * The <code>OFF</code> is used to turn off logging.
 */
public static final Level OFF = new Level(OFF_INT, "OFF");

/**
 * The <code>ERROR</code> level designates error events which may or not
 * be fatal to the application.
 */
public static final Level ERROR = new Level(ERROR_INT, "ERROR");

/**
 * The <code>WARN</code> level designates potentially harmful situations.
 */
public static final Level WARN = new Level(WARN_INT, "WARN");

/**
 * The <code>INFO</code> level designates informational messages
 * highlighting overall progress of the application.
 */
public static final Level INFO = new Level(INFO_INT, "INFO");

/**
 * The <code>DEBUG</code> level designates informational events of lower
 * importance.
 */
public static final Level DEBUG = new Level(DEBUG_INT, "DEBUG");

/**
 * The <code>TRACE</code> level designates informational events of very low
 * importance.
 */
public static final Level TRACE = new Level(TRACE_INT, "TRACE");

/**
 * The <code>ALL</code> is used to turn on all logging.
 */
public static final Level ALL = new Level(ALL_INT, "ALL");

//对应的具体值
public static final int OFF_INT = Integer.MAX_VALUE;
public static final int ERROR_INT = 40000;
public static final int WARN_INT = 30000;
public static final int INFO_INT = 20000;
public static final int DEBUG_INT = 10000;
public static final int TRACE_INT = 5000;
public static final int ALL_INT = Integer.MIN_VALUE;

2.2.2 使用配置文件

2.2.1 输出到控制台

配置文件名:logback.xml
内容

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <root level="ALL">
        <appender-ref ref="consoleAppender"/>
    </root>
</configuration>

看这个配置文件,我们可以看到所有的内容都包含在configuration标签中,configuration标签内部定义了property,appender,root标签,其中property标签是定义配置文件内的变量,方便我们使用(即在后面直接引用该变量就行)。其中appender标签和root标签是需要我们重点关注的内容。
我们知道日志一般可以输出到控制台或者文件中,对于具体输出到控制台还是输出到文件中就是通过appender来控制的。因此,我们可以通过appender标签来定义一个变量。其中,appender标签的name属性就是变量名,class属性就是变量的类型。appender标签内的target标签不太重要,设置的具体值等同于Java中的System.outSystem.errappender标签内的encoder标签其实是定义日志的输出格式,我们看到的日志一般都会包括日志级别,线程名称,时间,文件全类名,消息等信息,就是通过该标签控制。所以这些是appender标签的核心内容。

虽然appender标签定义了具体的appender变量,但决定是否使用该变量时通过下面的root标签来控制的,我们可以看到root标签有个level属性,我们将该属性值设置为ALL,则表示所有的日志级别都会显示。root标签下的appender-ref属性则是决定具体使用哪个appender变量。可以看到appender-ref标签的ref属性值为consoleAppender,说明使用了变量名为consoleAppenderappender输出器。
执行效果如下:
在这里插入图片描述
可以看到,所有的日志信息全都输出了(同样执行的test01()方法)。此外,日志显示为红色,这其实就是System.err设置的效果。而且我们可以看到输出的日志具有特定的格式,即[INFO ] 2023-12-18 08:26:32.869 com.xlb.LogBackDemo test01 main 14:info 信息含义为日志级别 时间 当前类全限定名 当前执行日志的方法 线程名 行号:消息体。这种输出格式即是我们通过encoder标签下的pattern标签定义的。格式化的含义具体如下:

%-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
%d{yyyy-MM-dd HH:mm:ss.SSS} 日期
%c 当前类全限定名
%M 当前执行日志的方法
%L 行号
%thread 线程名称
%m或者%msg 信息
%n 换行
2.2.2.2 输出到文件

我们上面是将日志成功输出到了控制台,下面我们将日志输出到文件,大致过程和上面类似。
修改后的配置文件如下:

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <root level="ALL">
        <appender-ref ref="fileAppender"/>
    </root>
</configuration>

实际上我们就只修改了这三个地方
在这里插入图片描述

最上面指定了日志文件的输出路径的变量(指定位置为当前项目下的log文件夹),中间添加了一个输出到文件的appender,增加了file标签,在其内部定义了日志文件的输出路径,下面在root标签中指定了我们新添加的appender
输出结果如下:
在这里插入图片描述
在这里插入图片描述
可以看到,控制台没有日志输出,但是文件中有日志输出。

2.2.2.3 输出到控制台和文件

修改后的配置如下

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <root level="ALL">
        <appender-ref ref="fileAppender"/>
        <appender-ref ref="consoleAppender"/>
    </root>
</configuration>

在这里插入图片描述
可以看到,对于新的配置文件我们只是增加了上面一行,即在root标签中同时也使用了控制台的appender
输出结果如下
在这里插入图片描述
在这里插入图片描述
可以看到,日志记录输出到了控制台和文件中,而且文件中的日志是追加的方式记录的(可以查看日志的时间来看当前的日志记录)。
从这个案例我们可以知道,日志可以指定多个appender,指定多个appender只需要增加对应的appender引用即可。

2.2.2.3 输出到文件(对文件拆分)

如果日志文件一直追加,那么日志文件就可能变得非常大,不方便日志管理,或者有时候同类型的日志需要归档,所以我们需要对日志文件进行拆分管理,对文件拆分管理方式如下。
修改配置文件

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="rollAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <file>${logDir}\roll_logback.log</file>

        <!--        指定拆分规则-->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${logDir}/roll.%d{yyyy-MM-dd}.log%i.gz</fileNamePattern>
            <maxFileSize>1KB</maxFileSize>
        </rollingPolicy>

    </appender>

    <root level="ALL">
        <appender-ref ref="rollAppender"/>
    </root>
</configuration>

在这里插入图片描述
对于日志规则的拆分,如上所示,同样只需要修改这两处。

因为设置了日志文件的大小为1KB,所以我们使用for循环来追加操作,达到拆分文件的目的,演示如下:

代码:

@Test
    public void test02(){
        Logger logger = LoggerFactory.getLogger(LogBackDemo.class);

        for (int i = 0; i < 200; i++) {
            logger.trace("trace 信息");
            logger.debug("debug 信息");
            logger.info("info 信息");
            logger.warn("warn 信息");
            logger.error("error 信息");
        }
    }

输出:
在这里插入图片描述
在这里插入图片描述
可以看到日志文件按照我们设置的格式进行了拆分。

2.2.2.4 输出为html格式

除了上面几种格式,还可以将logback输出为html的格式,只需要下面这样设置即可:

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="rollAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <file>${logDir}\roll_logback.log</file>

        <!--        指定拆分规则-->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${logDir}/roll.%d{yyyy-MM-dd}.log%i.gz</fileNamePattern>
            <maxFileSize>1KB</maxFileSize>
        </rollingPolicy>

    </appender>

<!--    html格式-->
    <appender name="htmlAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\myHtmllog.html</file>
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="ch.qos.logback.classic.html.HTMLLayout">
                <pattern>${pattern}</pattern>
            </layout>
        </encoder>
    </appender>

    <root level="ALL">
        <appender-ref ref="htmlAppender"/>
    </root>
</configuration>

在这里插入图片描述
同样改动很小,输出如下(使用test01):
在这里插入图片描述
可以看到有个html文件。
浏览器打开该html日志文件展示如下:
在这里插入图片描述
可以看到自动为我们添加了特定的样式,使得日志以表格的形式展示。

2.2.2.5 过滤器

实际使用时,可能每个appender我们想设置的日志级别都不同,那么此时我们就需要一个过滤器,该过滤器也是通过设置日志级别来控制是否输出当前appender的日志。

配置如下

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <!--    过滤器-->
    <appender name="consoleFilterAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <!--        配置过滤器(等于配置的级别才会输出)-->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!--            设置日志的输出级别-->
            <level>INFO</level>
            <!--            高于level中设置的级别,则打印日志-->
            <onMatch>ACCEPT</onMatch>
            <!--            低于level中设置的级别,则不打印-->
            <onMismatch>DENY</onMismatch>
        </filter>

<!--        &lt;!&ndash;        配置临界值过滤器(输出大于等于level的日志)&ndash;&gt;-->
<!--        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">-->
<!--            &lt;!&ndash;            设置日志的输出级别&ndash;&gt;-->
<!--            <level>INFO</level>-->
<!--        </filter>-->
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="rollAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <file>${logDir}\roll_logback.log</file>

        <!--        指定拆分规则-->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${logDir}/roll.%d{yyyy-MM-dd}.log%i.gz</fileNamePattern>
            <maxFileSize>1KB</maxFileSize>
        </rollingPolicy>

    </appender>

<!--    html格式-->
    <appender name="htmlAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\myHtmllog.html</file>
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="ch.qos.logback.classic.html.HTMLLayout">
                <pattern>${pattern}</pattern>
            </layout>
        </encoder>
    </appender>

    <root level="ALL">
        <appender-ref ref="consoleFilterAppender"/>
    </root>

</configuration>

在这里插入图片描述
在这里插入图片描述
在consoleAppender里设置了INFO级别的日志级别,不过root标签下的日志级别是ALL,我们看下输出:
在这里插入图片描述
可以看到只输出了INFO级别的日志,即我们在日志中配的INFO级别。下面我们看一下另一种过滤器:

<filter class="ch.qos.logback.classic.filter.ThresholdFilter">
   <!--            设置日志的输出级别-->
    <level>INFO</level>
</filter>

将上面的过滤器换成这个(ThresholdFilter),我们再看下输出:
在这里插入图片描述
可以看到大于等于INFO级别的日志都进行了输出。从上面的输出可以看出这两种过滤器的差别。

2.2.2.6 异步日志

因为日志和业务逻辑无关,日志只是便于我们处理问题。所以在项目中一般都会使用异步日志,来提升业务逻辑的处理速度。异步日志的使用如下:

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>
    
    <!--    过滤器-->
    <appender name="consoleFilterAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <!--        配置过滤器(等于配置的级别才会输出)-->
<!--        <filter class="ch.qos.logback.classic.filter.LevelFilter">-->
<!--            &lt;!&ndash;            设置日志的输出级别&ndash;&gt;-->
<!--            <level>INFO</level>-->
<!--            &lt;!&ndash;            高于level中设置的级别,则打印日志&ndash;&gt;-->
<!--            <onMatch>ACCEPT</onMatch>-->
<!--            &lt;!&ndash;            低于level中设置的级别,则不打印&ndash;&gt;-->
<!--            <onMismatch>DENY</onMismatch>-->
<!--        </filter>-->

<!--        &lt;!&ndash;        配置临界值过滤器(输出大于等于level的日志)&ndash;&gt;-->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <!--            设置日志的输出级别-->
            <level>INFO</level>
        </filter>
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="rollAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <file>${logDir}\roll_logback.log</file>

        <!--        指定拆分规则-->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${logDir}/roll.%d{yyyy-MM-dd}.log%i.gz</fileNamePattern>
            <maxFileSize>1KB</maxFileSize>
        </rollingPolicy>

    </appender>

<!--    html格式-->
    <appender name="htmlAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\myHtmllog.html</file>
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="ch.qos.logback.classic.html.HTMLLayout">
                <pattern>${pattern}</pattern>
            </layout>
        </encoder>
    </appender>

    <!--    引入异步日志-->
    <appender name="asyncAppender" class="ch.qos.logback.classic.AsyncAppender">
        <appender-ref ref="consoleAppender"/>
    </appender>
    
    <root level="ALL">
        <appender-ref ref="asyncAppender"/>
    </root>

</configuration>

在这里插入图片描述
可以看到,使用异步日志很简单,我们只需要如上定义,最终日志输出来的就是异步日志,注意异步日志里面引用我们定义好的输出到控制台的consoleAppender
下面我们看下输出:

@Test
    public void test03(){
        Logger logger = LoggerFactory.getLogger(LogBackDemo.class);

        for (int i = 0; i < 200; i++) {
            logger.trace("trace 信息");
            logger.debug("debug 信息");
            logger.info("info 信息");
            logger.warn("warn 信息");
            logger.error("error 信息");
        }

        for (int i = 0; i < 200; i++) {
            System.out.println("======================");
        }
    }

在这里插入图片描述
我们可以看到输出的日志时穿插执行的,即可以证明日志时异步输出的。

2.2.2.7 自定义日志

我们在上面使用的日志其实都是rootLogger,我们应该记得在XML文件最后定义了root标签,这个定义的其实就是rootLogger,rootLogger是日志框架自带的,是所有日志的父级日志。什么是父级日志?对于市面上的所有日志框架,其实是有父子关系的,不过这种父子关系不是通过继承实现,而是通过包路径来体现的。如果包路径越具体,说明其越是儿子。例如:三个包com.aaa.bbb.ccc,和com.aaa.bbb和com.aaa中,com.aaa是com.aaa.bbb与com.aaa.bbb.ccc的父级日志,com.aaa.bbb是com.aaa.bbb.ccc的父级日志。对于父级日志的设置可以对子级日志生效;所以如果想一次生效多个日志,那么可以对父级进行设置。而rootLogger就是所有包的父级日志。那这个日志包路径什么时候指定的呢?我们可以看下面这一行代码:

Logger logger = LoggerFactory.getLogger(LogBackDemo.class);

可以看到,上面参数列表中我们传入了类,java内部通过反射机制可以获得该类的全路径;因为这个方法进行了重载,所以也可以直接指定全路径名。
想要引入自定义日志,需要下面这样配置
自定义日志引入

<?xml version="1.0" encoding="UTF-8" ?>

<configuration>

    <!--
            %-10level 日志级别(设置10个字符,字符不够空格补齐,左对齐)
            %d{yyyy-MM-dd HH:mm:ss.SSS} 日期
            %c 当前类全限定名
            %M 当前执行日志的方法
            %L 行号
            %thread 线程名称
            %m或者%msg 信息
            %n 换行
            -->
    <property name="pattern" value="[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n"/>
    <property name="logDir" value="F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOGBACK_StudyV2\\log"/>

    <appender name="consoleAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <!--    过滤器-->
    <appender name="consoleFilterAppender" class="ch.qos.logback.core.ConsoleAppender">
        <target>
            System.err
        </target>

        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <!--        配置过滤器(等于配置的级别才会输出)-->
<!--        <filter class="ch.qos.logback.classic.filter.LevelFilter">-->
<!--            &lt;!&ndash;            设置日志的输出级别&ndash;&gt;-->
<!--            <level>INFO</level>-->
<!--            &lt;!&ndash;            高于level中设置的级别,则打印日志&ndash;&gt;-->
<!--            <onMatch>ACCEPT</onMatch>-->
<!--            &lt;!&ndash;            低于level中设置的级别,则不打印&ndash;&gt;-->
<!--            <onMismatch>DENY</onMismatch>-->
<!--        </filter>-->

<!--        &lt;!&ndash;        配置临界值过滤器(输出大于等于level的日志)&ndash;&gt;-->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <!--            设置日志的输出级别-->
            <level>INFO</level>
        </filter>
    </appender>

    <appender name="fileAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\mylog.log</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>
    </appender>

    <appender name="rollAppender" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <pattern>${pattern}</pattern>
        </encoder>

        <file>${logDir}\roll_logback.log</file>

        <!--        指定拆分规则-->
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${logDir}/roll.%d{yyyy-MM-dd}.log%i.gz</fileNamePattern>
            <maxFileSize>1KB</maxFileSize>
        </rollingPolicy>

    </appender>

<!--    html格式-->
    <appender name="htmlAppender" class="ch.qos.logback.core.FileAppender">
        <file>${logDir}\myHtmllog.html</file>
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="ch.qos.logback.classic.html.HTMLLayout">
                <pattern>${pattern}</pattern>
            </layout>
        </encoder>
    </appender>

    <!--    引入异步日志-->
    <appender name="asyncAppender" class="ch.qos.logback.classic.AsyncAppender">
        <appender-ref ref="consoleAppender"/>
    </appender>

    <root level="ALL">
        <appender-ref ref="consoleAppender"/>
    </root>

    <!--    自定义日志-->
    <logger name="com.xlb" level="info" additivity="false">
        <appender-ref ref="consoleAppender"/>
    </logger>

</configuration>

在这里插入图片描述
输出如下(使用test01)
在这里插入图片描述
可以看到输出了INFO,WARN,ERROR日志级别的日志。如果我们既有父级目录,又有子级目录,以子级日志目录设置的日志级别为准,如下我将父级日志设置成INFO级别,将子级日志设置成ALL级别,并且去掉additivity=false属性,显示如下:
在这里插入图片描述
可以看到同样的日志输出了两份,下面加上additivity=false再看下输出:
在这里插入图片描述
可以看到日志输出只有一份,并且是以子级日志级别为准的。

三、slf4j+Log4j2使用

slf4j+Log4j2日志的使用和slf4j+logback的使用大同小异

3.1 导入依赖

<dependencies>
   <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.12</version>
    </dependency>

    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-slf4j2-impl</artifactId>
        <version>2.19.0</version>
    </dependency>

    <dependency>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
        <version>2.19.0</version>
    </dependency>
</dependencies>

测试类:

package com.xlb;

import org.junit.Test;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class LOG4J2Demo {
    @Test
    public void test01(){
        Logger logger = LoggerFactory.getLogger(LOG4J2Demo.class);

        logger.trace("trace 信息");
        logger.debug("debug 信息");
        logger.info("info 信息");
        logger.warn("warn 信息");
        logger.error("error 信息");
    }
}

3.2.1 不使用配置文件

在这里插入图片描述
可以看到只输出了ERROR级别的日志,因此log4j2的日志的默认日志级别为error级别。

3.2.2 使用配置文件

3.2.2.1 输出到控制台
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
        </Console>
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="consoleAppender"/>
        </Root>
    </Loggers>
</Configuration>

默认输出
在这里插入图片描述

<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="consoleAppender"/>
        </Root>
    </Loggers>
</Configuration>

格式化输出
在这里插入图片描述

3.2.2.2 输出到文件

我们上面是将日志成功输出到了控制台,下面我们将日志输出到文件,大致过程和上面类似。
修改配置文件如下:

<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="fileAppender"/>
        </Root>
    </Loggers>
</Configuration>
3.2.2.3 输出到控制台和文件
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="consoleAppender"/>
            <AppenderRef ref="fileAppender"/>
        </Root>
    </Loggers>
</Configuration>
3.2.2.4 输出到文件(对文件拆分)
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>

        <!--
        fileName:日志文件名
        $${date:yyyy-MM-dd}:表示以日期为文件夹对日志文件进行归档
-->
        <RollingFile name="rollingFile" fileName="${logDir}/rollog.log"
                     filePattern="${logDir}/$${date:yyyy-MM-dd}/rollog-%d{yyyy-MM-dd-HH-mm}-%i.log">

            <Policies>
                <!--                在系统启动时,触发拆分规则,产生一个日志文件-->
                <OnStartupTriggeringPolicy/>
                <!--                按照文件的大小进行拆分-->
                <SizeBasedTriggeringPolicy size="10KB"/>
                <!--                按照时间节点进行拆分,拆分规则就是filePattern-->
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="rollingFile"/>
        </Root>
    </Loggers>
</Configuration>
3.2.2.5 自定义日志
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>

        <!--
        fileName:日志文件名
        $${date:yyyy-MM-dd}:表示以日期为文件夹对日志文件进行归档
-->
        <RollingFile name="rollingFile" fileName="${logDir}/rollog.log"
                     filePattern="${logDir}/$${date:yyyy-MM-dd}/rollog-%d{yyyy-MM-dd-HH-mm}-%i.log">

            <Policies>
                <!--                在系统启动时,触发拆分规则,产生一个日志文件-->
                <OnStartupTriggeringPolicy/>
                <!--                按照文件的大小进行拆分-->
                <SizeBasedTriggeringPolicy size="10KB"/>
                <!--                按照时间节点进行拆分,拆分规则就是filePattern-->
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>
    </Appenders>

    <Loggers>
        <!--        自定义Logger-->
        <Logger name="com.xlb" level="INFO"
                     includeLocation="false" additivity="false">
            <!--            将控制台输出的consoleAppender,设置为异步打印-->
            <AppenderRef ref="consoleAppender"/>
        </Logger>

        <Root level="trace">
            <AppenderRef ref="consoleAppender"/>
        </Root>

    </Loggers>
</Configuration>
3.2.2.5 异步日志
3.2.2.6.1 xml中配置异步日志
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>

        <!--
        fileName:日志文件名
        $${date:yyyy-MM-dd}:表示以日期为文件夹对日志文件进行归档
-->
        <RollingFile name="rollingFile" fileName="${logDir}/rollog.log"
                     filePattern="${logDir}/$${date:yyyy-MM-dd}/rollog-%d{yyyy-MM-dd-HH-mm}-%i.log">

            <Policies>
                <!--                在系统启动时,触发拆分规则,产生一个日志文件-->
                <OnStartupTriggeringPolicy/>
                <!--                按照文件的大小进行拆分-->
                <SizeBasedTriggeringPolicy size="10KB"/>
                <!--                按照时间节点进行拆分,拆分规则就是filePattern-->
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>

        <!--        异步日志-->
        <Async name="myAsync">
            <AppenderRef ref="consoleAppender"/>
        </Async>
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="rollingFile"/>
        </Root>
    </Loggers>
</Configuration>
3.2.2.6.2 全局异步日志

全局日志需要在properties文件中指明,xml文件中不需要特殊声明异步日志(文件名为log4j2.component.properties)

Log4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>

        <!--
        fileName:日志文件名
        $${date:yyyy-MM-dd}:表示以日期为文件夹对日志文件进行归档
-->
        <RollingFile name="rollingFile" fileName="${logDir}/rollog.log"
                     filePattern="${logDir}/$${date:yyyy-MM-dd}/rollog-%d{yyyy-MM-dd-HH-mm}-%i.log">

            <Policies>
                <!--                在系统启动时,触发拆分规则,产生一个日志文件-->
                <OnStartupTriggeringPolicy/>
                <!--                按照文件的大小进行拆分-->
                <SizeBasedTriggeringPolicy size="10KB"/>
                <!--                按照时间节点进行拆分,拆分规则就是filePattern-->
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>

        <!--        异步日志-->
<!--        <Async name="myAsync">-->
<!--            <AppenderRef ref="consoleAppender"/>-->
<!--        </Async>-->
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="consoleAppender"/>
        </Root>
    </Loggers>
</Configuration>

按照上面这种方式声明的也是异步日志

3.2.2.6.3 混合异步日志

混合异步日志需要引入这个依赖,否则会报错

<!--        混合异步日志用-->
 <dependency>
     <groupId>com.lmax</groupId>
     <artifactId>disruptor</artifactId>
     <version>3.4.3</version>
 </dependency>
<?xml version="1.0" encoding="UTF-8" ?>

<Configuration>
    <properties>
        <property name="logDir">F:\\CODE\\JAVA\\LogStudyV2\\LogStudy\\LOG4J2_StudyV2\\log</property>
        <property name="pattern">[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n</property>
    </properties>

    <Appenders>
<!--        输出到控制台-->
        <Console name="consoleAppender" target="SYSTEM_ERR">
            <patternLayout pattern="${pattern}"/>
        </Console>

        <!--        输出到文件-->
        <File name="fileAppender" fileName='${logDir}\\log4j2.log'>
            <!--            配置日志文件格式-->
            <patternLayout pattern="${pattern}"/>
        </File>

        <!--
        fileName:日志文件名
        $${date:yyyy-MM-dd}:表示以日期为文件夹对日志文件进行归档
-->
        <RollingFile name="rollingFile" fileName="${logDir}/rollog.log"
                     filePattern="${logDir}/$${date:yyyy-MM-dd}/rollog-%d{yyyy-MM-dd-HH-mm}-%i.log">

            <Policies>
                <!--                在系统启动时,触发拆分规则,产生一个日志文件-->
                <OnStartupTriggeringPolicy/>
                <!--                按照文件的大小进行拆分-->
                <SizeBasedTriggeringPolicy size="10KB"/>
                <!--                按照时间节点进行拆分,拆分规则就是filePattern-->
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="30"/>
        </RollingFile>

        <!--        异步日志-->
<!--        <Async name="myAsync">-->
<!--            <AppenderRef ref="consoleAppender"/>-->
<!--        </Async>-->
    </Appenders>

    <Loggers>
        <Root level="trace">
            <AppenderRef ref="consoleAppender"/>
        </Root>
        <!--        自定义Logger,让自定义的logger为异步logger
            includeLocation=false表示取出日志中的行号信息(记录日志的行号会使得日志记录的非常慢!)
-->
        <AsyncLogger name="com.xlb" level="trace"
                     includeLocation="false" additivity="false">
            <!--            将控制台输出的consoleAppender,设置为异步打印-->
            <AppenderRef ref="consoleAppender"/>
        </AsyncLogger>
    </Loggers>
</Configuration>

总结:上面介绍大致介绍了市面上这两款日志的使用流程,其实日志的使用基本上就是看如何对配置文件进行配置,配置文件配置好后就可以很方便的使用日志进行记录。其实市面上虽然有好几种日志框架,不过其实现的基本思想都差不多,即有下面几点共性:

1.都会分为不同的日志级别

1.1高于当前设置的日志级别就会打印
1.2低于当前设置的日志级别就不打印
2.都设置有输出处理器
2.1输出到控制台
2.2 输出到文件
2.3拆分文件

3格式化输出:类似于[%-5level] %d{yyyy-MM-dd HH:mm:ss.SSS} %c %M %thread %L:%m%n
4异步日志
5日志父子级关系
6自定义日志

希望这篇文章对日志的使用有所帮助,希望能够一键三连呀~

如果想对日志有更深的理解,可以看下这门b站上的课程,这个可能前面20集左右是一个大佬现场直播手撸一个日志框架(没有借助IDE,在vim中一点点敲出来的,很强!!!),不过课程是使用C++讲解的,有兴趣的可以听一下,保证听完对日志会有一个更加深刻的认识!

文章来源:https://blog.csdn.net/qq_43450920/article/details/135051292
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。