Java日志框架体系讲解

Java日志框架讲解

Java的日志框架有很多，常用的有log4j1.x，log4j2.x，logback，jul，jcl等等，这些框架如何使用？他们如何与slf4j-api搭配使用？不搭配slf4j-api能否单独使用？使用过程中需要注意哪些事项？

实际开发中我们也会遇到很多问题，本篇文章就是为了讲解下Java的日志体系。

我会尽可能的讲解清楚，如有问题，欢迎指正！！！

日志体系图

下图是SlF4j日志的体系图。

image

理解了上图，其实就理解了Slf4j日志框架的体系。

查看上图时，特别注意颜色的区分，不同颜色有不同的说明，接下来我具体讲解下。

image

：代表的应用，这没有什么可说的。

image

：代表的是Slf4j Api（slf4j-api.jar）,这个jar是日志框架的门面，里面是对日志的抽象（接口），它将暴漏给应用来使用。

image

：这些日志的实现（provider），是直接实现slf4j-api.jar相关接口实现的。

image

：代表适配层，是因为有些日志的实现（provider）并没有直接使用slf4j-api而是有自己的接口，此时就需要使用适配将其和slf4j-api打通。

image

：没有原生实现sfl4j-api的日志框架，这些框架需要使用适配层与``sfl4j-api`接口适配。

纵向看，每个application都对应一种实现方式。接下来一一来说明下具体实现方式。

SLF4J官网文档地址

说明

本文使用的sfl4j-api版本是2.0.6版本，JDK是17

未绑定实现

未绑定实现肯定是不能使用的，也就是说只有slf4j-api的接口定义，没有具体地实现。

示例项目：slf4j-unbound

依赖说明

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.itlab1024.log</groupId>
    <artifactId>slf4j-unbound</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>2.0.6</version>
        </dependency>
    </dependencies>
</project>

只引入了slf4j-api!

测试类

package com.itlab1024.log;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class com.itlab1024.log.Main {
    public static final Logger logger = LoggerFactory.getLogger(com.itlab1024.log.Main.class);
    public static void main(String[] args) {
        logger.debug("debug");
        logger.info("info");
        logger.warn("warn");
        logger.error("error");
    }
}

运行结果

image

日志并没有正常输出，从红色文字提示可知道，没有提供Slf4j的实现框架（provider）。

绑定logback实现

通常使用logback只需要引入logback-classic即可，它内部的pom依赖了sfl4j-api和logback-core，会自动下载下来响应的依赖。

示例项目：slf4j-logback-classic

官网地址

依赖说明

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.itlab1024.log</groupId>
    <artifactId>slf4j-logback-classic</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>1.4.5</version>
        </dependency>
    </dependencies>
</project>

上面pom中我只依赖了logback-classic。通过idea工具可以看到该项目的所有依赖情况：

image-20230113114548311

可以看到，自动下载了logback-core:1.4.5和slf4j-api:2.0.4，当然也可以手动引入这两个依赖（不同版本）。

测试类

package com.itlab1024.log;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class com.itlab1024.log.Main {
    public static final Logger logger = LoggerFactory.getLogger(com.itlab1024.log.Main.class);
    public static void main(String[] args) {
        logger.debug("debug");
        logger.info("info");
        logger.warn("warn");
        logger.error("error");
    }
}

运行结果

image-20230113114827808

可以看到能够正常打印日志信息。

配置文件

logback支持使用xml的方式配置日志的相关信息，需要在classpath下（maven项目的resources下），创建logback.xml文件。

<configuration  xmlns="http://ch.qos.logback/xml/ns/logback"
                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                xsi:schemaLocation="http://ch.qos.logback/xml/ns/logback
                https://raw.githubusercontent.com/enricopulatzo/logback-XSD/master/src/main/xsd/logback.xsd">

    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <!-- encoders are assigned the type
             ch.qos.logback.classic.encoder.PatternLayoutEncoder by default -->
        <encoder>
            <pattern>ITLab1024---%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} -%kvp- %msg%n</pattern>
        </encoder>
    </appender>

    <root level="debug">
        <appender-ref ref="STDOUT" />
    </root>
</configuration>

特别注意config的配置，此配置会让你在xml中编辑的时候，自动提示！！！，可以去看我的另一个博客IDEA下Logback.xml自动提示功能配置 - 知乎 (zhihu.com)

再次运行程序查看运行结果：

image

可以看到，配置文件已经生效。

绑定reload4j（log4j 1.x升级版）

log4j的1.x版本是一个通用版本，但是由于2022年的log4j漏洞原因，slf4j-log4j模块在build时，会自动重定向至slf4j-reload4j模块。也就是说如果想用log4j的话，就直接使用哦个reload4j吧。

示例项目：slf4j-reload4j

官网地址

依赖说明

通常只需要引入slf4j-reload4j即可，会自动下载其他依赖项slf4j-api和reload4j。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.itlab1024.log</groupId>
    <artifactId>slf4j-reload4j</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-reload4j</artifactId>
            <version>2.0.6</version>
        </dependency>
    </dependencies>
</project>

看下下载下来的依赖项

image-20230113132913298

测试类

package com.itlab1024.log;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class com.itlab1024.log.Main {
    public static final Logger logger = LoggerFactory.getLogger(com.itlab1024.log.Main.class);
    public static void main(String[] args) {
        logger.debug("debug");
        logger.info("info");
        logger.warn("warn");
        logger.error("error");
    }
}

测试结果

初次运行，很遗憾，出问题了。

image-20230113133247685

为什么呢？这是因为log4j 环境的配置通常在应用程序初始化。首选方法是通过读取配置文件。所以要在classpath下添加log4j.properties(xml)文件。

增加log4j.properties文件内容如下：

log4j.rootLogger=debug, stdout

log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout

# Pattern to output the caller's file name and line number.
log4j.appender.stdout.layout.ConversionPattern=%5p [%t] (%F:%L) - %m%n

再次运行：

image-20230113133950011

日志正常输出。

绑定jul（java.util.logging）

这是JDK自带的日志框架，官方地址是：Java Logging Overview (oracle.com)

示例项目：slf4j-jul

依赖说明

只需要引入依赖slf4j-jdk14即可，会将其依赖的slf4j-api自动下载。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.itlab1024.log</groupId>
    <artifactId>sfl4j-jul</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-jdk14</artifactId>
            <version>2.0.6</version>
        </dependency>
    </dependencies>
</project>

依赖截图如下：

image-20230113135202950

测试类

package com.itlab1024.log;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class com.itlab1024.log.Main {
    public static final Logger logger = LoggerFactory.getLogger(com.itlab1024.log.Main.class);
    public static void main(String[] args) {
        logger.debug("debug");
        logger.info("info");
        logger.warn("warn");
        logger.error("error");
    }
}

运行结果

image-20230113135356194

配置文件

juc的配置文件名称是logging.properties。

官方提供了默认的文件配置。在JDK目录下的conf文件夹下能够找到。

############################################################
#   Default Logging Configuration File
#
# You can use a different file by specifying a filename
# with the java.util.logging.config.file system property.
# For example, java -Djava.util.logging.config.file=myfile
############################################################

############################################################
#   Global properties
############################################################

# "handlers" specifies a comma-separated list of log Handler
# classes.  These handlers will be installed during VM startup.
# Note that these classes must be on the system classpath.
# By default we only configure a ConsoleHandler, which will only
# show messages at the INFO and above levels.
handlers= java.util.logging.ConsoleHandler

# To also add the FileHandler, use the following line instead.
#handlers= java.util.logging.FileHandler, java.util.logging.ConsoleHandler

# Default global logging level.
# This specifies which kinds of events are logged across
# all loggers.  For any given facility this global level
# can be overridden by a facility-specific level
# Note that the ConsoleHandler also has a separate level
# setting to limit messages printed to the console.
.level= INFO

############################################################
# Handler specific properties.
# Describes specific configuration info for Handlers.
############################################################

# default file output is in user's home directory.
java.util.logging.FileHandler.pattern = %h/java%u.log
java.util.logging.FileHandler.limit = 50000
java.util.logging.FileHandler.count = 1
# Default number of locks FileHandler can obtain synchronously.
# This specifies maximum number of attempts to obtain lock file by FileHandler
# implemented by incrementing the unique field %u as per FileHandler API documentation.
java.util.logging.FileHandler.maxLocks = 100
java.util.logging.FileHandler.formatter = java.util.logging.XMLFormatter

# Limit the messages that are printed on the console to INFO and above.
java.util.logging.ConsoleHandler.level = INFO
java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter

# Example to customize the SimpleFormatter output format
# to print one-line log message like this:
#     <level>: <log message> [<date/time>]
#
# java.util.logging.SimpleFormatter.format=%4$s: %5$s [%1$tc]%n

############################################################
# Facility-specific properties.
# Provides extra control for each logger.
############################################################

# For example, set the com.xyz.foo logger to only log SEVERE
# messages:
# com.xyz.foo.level = SEVERE

绑定slf4j-simple

示例项目：slf4j-simple

依赖说明

只要引入sfl4j-simple即可，会自动下载slf4j-api依赖

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.itlab1024</groupId>
    <artifactId>slf4j-simple</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
            <version>2.0.6</version>
        </dependency>
    </dependencies>

</project>

依赖情况

image-20230113140203234

测试类

package com.itlab1024.log;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class com.itlab1024.log.Main {
    public static final Logger logger = LoggerFactory.getLogger(com.itlab1024.log.Main.class);
    public static void main(String[] args) {
        logger.debug("debug");
        logger.info("info");
        logger.warn("warn");
        logger.error("error");
    }
}

运行结果

image-20230113140715105

未打印出来debug的日志，是因为默认的日志级别是info。

配置文件

配置文件名称是simplelogger.properties，比如配置如下配置文件。

org.slf4j.simpleLogger.defaultLogLevel=DEBUG
org.slf4j.simpleLogger.showDateTime=true
org.slf4j.simpleLogger.dateTimeFormat=yyyy-MM-dd HH:mm:ss
org.slf4j.simpleLogger.showLogName=true

默认日志级别我修改为了DEBUG

运行结果：

image-20230113141549920

可以看到debug级别的日志被打印了出来。

绑定log4j2

Apache Log4j 2 是对 Log4j的升级，对其前身 Log4j 1.x和提供了 Logback 中可用的许多改进，同时修复了 Logback架构中的一些固有问题。

log4j2并未在上图中展示，但是并不是说起不能与slf4j-api融合，相反，官方已经给了解决方案。

Log4j – Apache Log4j 2

示例项目：slf4j-log4j2

依赖说明

log4j也不是直接实现的slf4j-api，而是实现的log4j-api，如果搭配slf4j-api，则需要引入桥接jarlog4j-slf4j-impl。当依赖下载的时候会自动下载

slf4j-api。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.itlab1024</groupId>
    <artifactId>slf4j-log4j2</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

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

上面引入了三个依赖，这三个是必须要引入的。看下最终下载的所有依赖。

image-20230113142930317

测试类

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class Main {
    public static final Logger logger = LoggerFactory.getLogger(Main.class);
    public static void main(String[] args) {
        logger.debug("debug");
        logger.info("info");
        logger.warn("warn");
        logger.error("error");
    }
}

运行结果

image-20230113143053539

配置文件

log4j2支持4中文件格式，XML, JSON, YAML, Properties。名称默认是log4j2

比如我增加配置文件log4j2.xml

<?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>
        <Root level="debug">
            <AppenderRef ref="Console"/>
        </Root>
    </Loggers>
</Configuration>

再次执行程序查看结果：

image-20230113143624118

因为我修改了日志级别，所以日志都打印出来了。

本篇文章主要是介绍几种日志框架的基本使用，并未深入讲解比如配置文件如何配置，如何修改默认配置等等内容。

博主信息

github: https://github.com/itlab1024

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 215,012评论 6赞 497
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 91,628评论 3赞 389
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 160,653评论 0赞 350
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 57,485评论 1赞 288
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 66,574评论 6赞 386
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 50,590评论 1赞 293
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 39,596评论 3赞 414
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 38,340评论 0赞 270
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 44,794评论 1赞 307
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 37,102评论 2赞 330
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 39,276评论 1赞 344
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 34,940评论 5赞 339
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 40,583评论 3赞 322
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 31,201评论 0赞 21
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 32,441评论 1赞 268
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 47,173评论 2赞 366
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 44,136评论 2赞 352

Java日志框架体系讲解

Java日志框架讲解

日志体系图

说明

未绑定实现

依赖说明

测试类

运行结果

绑定logback实现

依赖说明

测试类

运行结果

配置文件

绑定reload4j（log4j 1.x升级版）

依赖说明

测试类

测试结果

绑定jul（java.util.logging）

依赖说明

测试类

运行结果

配置文件

绑定slf4j-simple

依赖说明

测试类

运行结果

配置文件

绑定log4j2

依赖说明

测试类

运行结果

配置文件

博主信息

推荐阅读更多精彩内容