浅谈SpringBoot是如何实现日志的-eolink官网

浅谈SpringBoot是如何实现日志的

前言

休息日闲着无聊看了下 SpringBoot 中的日志实现，把我的理解跟大家说下。

门面模式

说到日志框架不得不说门面模式。门面模式，其核心为外部与一个子系统的通信必须通过一个统一的外观对象进行，使得子系统更易于使用。用一张图来表示门面模式的结构为：

简单来说，该模式就是把一些复杂的流程封装成一个接口供给外部用户更简单的使用。这个模式中，设计到3个角色。

1）.门面角色：外观模式的核心。它被客户角色调用，它熟悉子系统的功能。内部根据客户角色的需求预定了几种功能的组合（模块）。

2）.子系统（模块）角色：实现了子系统的功能。它对客户角色和 Facade 是未知的。它内部可以有系统内的相互交互，也可以由供外界调用的接口。

3）.客户角色：通过调用 Facede 来完成要实现的功能。

市面上的日志框架

日志门面

日志实现

JCL（Jakarta Commons Logging）、SLF4j（Simple Logging Facade for java）、 jboss-logging

Log4j 、JUL（java.util.logging）、Log4j2 、 Logback

简单说下，上表的日志门面对应了门面模式中的 Facede 对象，它们只是一个接口层，并不提供日志实现；而日志实现则对应着各个子系统或者模块，日志记录的具体逻辑实现，就写在这些右边的框架里面；那我们的应用程序就相当于客户端。

为什么要使用门面模式？

试想下我们开发系统的场景，需要用到很多包，而这些包又有自己的日志框架，于是就会出现这样的情况：我们自己的系统中使用了 Logback 这个日志系统，我们的系统使用了 HibxQAvVtiXDlernate，Hibernate 中使用的日志系统为 jboss-logging，我们的系统又使用了 Spring ，Spring 中使用的日志系统为 commons-logging。

这样，我们的系统就不得不同时支持并维护 Logback、jboss-logging、commons-logging 三种日志框架，非常不便。解决这个问题的方式就是引入一个接口层，由接口层决定使用哪一种日志系统，而调用端只需要做的事情就是打印日志而不需要关心如何打印日志，而上表的日志门面就是这种接口层。

鉴于此，我们选择日志时，就必须从上表左边的日志门面和右边的日志实现各选择一个框架，而 SpringBoot 底层默认选用的就是 SLF4j 和 Logback 来实现日志输出。

SLF4j 使用

官方文档给出这样一个例子：

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

public class HelloWorld {

public static void main(String[] args) {

// HelloWorld.class 就是你要打印的指定类的日志，

// 如果你想在其它类中打印，那就把 HelloWorld.class 替换成目标类名.class 即可。

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

logger.info("Hello World");

}

为了理解 slf4j 的工作原理，我翻了下它的官方文档，看到这么一张图：

简单解释一下，上图 slf4j 有六种用法，一共五种角色，application 不用说，就是我们的系统；SLF4J API 就是日志接口层（门面）；蓝色和最下面灰色的就是具体日志实现（子系统）；而 Adaptation 就是适配层。

解释下，上图第二，第三种用法。其中第二种就是 SpringBoot 的默认用法；而为什么会出现第三种？因为 Log4J 出现得比较早，它根本不知道后面会有 SLF4J 这东西http://。Log4J 不能直接作为 SLF4J 的日志实现，所以中间就出现了适配层。第四种同理。

这里提醒下，每一个日志的实现框架都有自己的配置文件。使用 slf4j 以后，**配置文件还是做成日志实现框架自己本身的配置文件。比如，Logback 就使用 logback.xml、Log4j 就使用 Log4j.xml 文件。

如何让系统中所有的日志都统一到 slf4j ？

我继续浏览了下官网，看见这么一张图：

由上图可以看出，让系统中所有的日志都统一到 slf4j 的做法是：

1、将系统中其他日志框架先排除出去

2、用中间包来替换原有的日志框架

3、我们导入 slf4j 其他的实现

SpringBoot 中的日志关系

SpringBoot 使用以下依赖实现日志功能：

org.springframework.boot

spring-boot-starter-logging

2.1.3.RELEASE

compile

spring-boot-starter-logging 有这么一张关系图：

可见，

1、SpringBoot2.x 底层也是使用 slf4j+logback 或 log4j 的方式进行日志记录；

2、SpringBoot 引入中间替换包把其他的日志都替换成了 slf4j；

3、如果我们要引入其他框架、可以把这个框架的默认日志依赖移除掉。

比如 Spring 使用的是 commons-logging 框架，我们可以这样移除。

org.springframework

spring-core

commons-logging

SpringBoot 能自动适配所有的日志，而且底层使用 slf4j+logback 的方式记录日志，引入其他框架的时候，只需要把这个框架依赖的日志框架排除掉即可。

日志使用

1、默认配置（以 Log4j 框架为例），SpringBoot 默认帮我们配置好了日志：

//记录器

Logger logger = LoggerFactory.getLogger(getClass());

@Test

public void contextLoads() {

//日志的级别；

//由低到高 trace

//可以调整输出的日志级别；日志就只会在这个级别以以后的高级别生效

logger.trace("这是trace日志...");

logger.debug("这是debug日志...");

// SpringBoot 默认给我们使用的是 info 级别的，没有指定级别的就用SpringBoot 默认规定的级别；root 级别

logger.info("这是info日志...");

logger.warn("这是warn日志...");

logger.error("这是error日志...");

}

2、log4j.properties 修改日志默认配置

logging.level.com.nasus=debug

#logging.path=

# 不指定路径在当前项目下生成 springboot.log 日志

# 可以指定完整的路径；

#logging.file=Z:/springboot.log

# 在当前磁盘的根路径下创建 spring 文件夹和里面的 log 文件夹；使用 spring.log 作为默认文件

logging.path=/spring/log

# 在控制台输出的日志的格式

logging.pattern.console=%d{yyyy-MM-dd} [%thread] %-5level %logger{50} - %msg%n

# 指定文件中日志输出的格式

logging.pattern.file=%d{yyyy-MM-dd} === [%thread] === %-5level === %logger{50} ==== %msg%n

3、指定配置

SpringBoot 会自动加载类路径下对应框架的配置文件，所以我们只需给类路径下放上每个日志框架自己的配置文件即可，SpringBoot 就不会使用默认配置了。

框架

命名方式

Logback

logback-spring.xml, logback-spring.groovy, logback.xml or logback.groovy

Log4j2

log4j2-spring.xml or log4j2.xml

JDK (Java Util Logging)

`logging.properties

logback.xml：直接就被日志框架识别了。

logback-spring.xml：日志框架就不直接加载日志的配置项，由 SpringBoot 解析日志配置，可以使用 SpringBoot 的高级 Profile 功能。

可以指定某段配置只在某个环境下生效

例子（以 Logback 框架为例）：

%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level %logger{50} - %msg%n

%d{yyyy-MM-dd HH:mm:ss.SSS} ==== [%thread] ==== %-5level %logger{50} - %msg%n

如果使用 logback.xml 作为日志配置文件，而不是 logback-spring.xml，还要使用profile 功能，会有以下错误：

no applicable action for [springProfile]

切换日志框架

了解了 SpringBoot 的底层日志依赖关系，我们就可以按照 slf4j 的日志适配图，进行相关的切换。

例如，切换成 slf4j+log4j ，可以这样做

org.springframework.boot

spring-boot-starter-web

logback-classic

ch.qos.logback

org.slf4j

slf4j-log4j12

切换成 log4j2 ，就可以这样做。

org.springframework.boot

spring-boot-starter-web

spring-boot-starter-logging

org.springframework.boot

spring-boot-starter-log4j2

最后放上 logback-spring.xml 的详细配置，大家在自己项目可以参考配置。

%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level %logger{50} - %msg%n

%d{yyyy-MM-dd HH:mm:ss.SSS} ==== [%thread] ==== %-5level %logger{50} - %msg%n

${LOG_HOME}/${appName}.log

${LOG_HOME}/${appName}-%d{yyyy-MM-dd}-%i.log

365

100MB

%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] - [ %-5level ] [ %logger{50} : %line ] - %msg%n

//可以调整输出的日志级别；日志就只会在这个级别以以后的高级别生效

logger.trace("这是trace日志...");

logger.debug("这是debug日志...");

// SpringBoot 默认给我们使用的是 info 级别的，没有指定级别的就用SpringBoot 默认规定的级别；root 级别

logger.info("这是info日志...");

logger.warn("这是warn日志...");

logger.error("这是error日志...");

}

2、log4j.properties 修改日志默认配置

logging.level.com.nasus=debug

#logging.path=

# 不指定路径在当前项目下生成 springboot.log 日志

# 可以指定完整的路径；

#logging.file=Z:/springboot.log

# 在当前磁盘的根路径下创建 spring 文件夹和里面的 log 文件夹；使用 spring.log 作为默认文件

logging.path=/spring/log

# 在控制台输出的日志的格式

logging.pattern.console=%d{yyyy-MM-dd} [%thread] %-5level %logger{50} - %msg%n

# 指定文件中日志输出的格式

logging.pattern.file=%d{yyyy-MM-dd} === [%thread] === %-5level === %logger{50} ==== %msg%n

3、指定配置

SpringBoot 会自动加载类路径下对应框架的配置文件，所以我们只需给类路径下放上每个日志框架自己的配置文件即可，SpringBoot 就不会使用默认配置了。

框架

命名方式

Logback

logback-spring.xml, logback-spring.groovy, logback.xml or logback.groovy

Log4j2

log4j2-spring.xml or log4j2.xml

JDK (Java Util Logging)

`logging.properties

logback.xml：直接就被日志框架识别了。

logback-spring.xml：日志框架就不直接加载日志的配置项，由 SpringBoot 解析日志配置，可以使用 SpringBoot 的高级 Profile 功能。

可以指定某段配置只在某个环境下生效

例子（以 Logback 框架为例）：

%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level %logger{50} - %msg%n

%d{yyyy-MM-dd HH:mm:ss.SSS} ==== [%thread] ==== %-5level %logger{50} - %msg%n

如果使用 logback.xml 作为日志配置文件，而不是 logback-spring.xml，还要使用profile 功能，会有以下错误：

no applicable action for [springProfile]

切换日志框架

了解了 SpringBoot 的底层日志依赖关系，我们就可以按照 slf4j 的日志适配图，进行相关的切换。

例如，切换成 slf4j+log4j ，可以这样做

org.springframework.boot

spring-boot-starter-web

logback-classic

ch.qos.logback

org.slf4j

slf4j-log4j12

切换成 log4j2 ，就可以这样做。

org.springframework.boot

spring-boot-starter-web

spring-boot-starter-logging

org.springframework.boot

spring-boot-starter-log4j2

最后放上 logback-spring.xml 的详细配置，大家在自己项目可以参考配置。

%d{yyyy-MM-dd HH:mm:ss.SSS} ----> [%thread] ---> %-5level %logger{50} - %msg%n

%d{yyyy-MM-dd HH:mm:ss.SSS} ==== [%thread] ==== %-5level %logger{50} - %msg%n

${LOG_HOME}/${appName}.log

${LOG_HOME}/${appName}-%d{yyyy-MM-dd}-%i.log

365

100MB

%d{yyyy-MM-dd HH:mm:ss.SSS} [ %thread ] - [ %-5level ] [ %logger{50} : %line ] - %msg%n

Flask接口签名sign原理与实例代码浅析

317 2023-01-10

浅谈SpringBoot是如何实现日志的

多平台统一管理软件接口，如何实现多平台统一管理软件接口

Flask接口签名sign原理与实例代码浅析

java中的接口是类吗

推荐文章

接口调用是什么意思？几种常用接口调用方式

接口设计原则

8款在线 API 接口文档管理工具

api管理系统是什么？

什么是接口调试？接口调试的步骤有哪些？

api 接口管理系统有哪些？

接口测试有几种测试方法

API文档生成工具有哪些？

微服务和api网关区别

交换机配置步骤

最近发表

热评文章

在线接口文档管理工具推荐，支持在线测试，HTTP接口

开源的在线接口文档wiki工具Mindoc的介绍与使

如何优雅的进行接口设计？接口设计的六大原则是什么？

什么是API测试,api检测公司

软件接口设计怎么做？前后端分离软件接口设计思路

接口管理平台推荐，几大接口管理平台总有一款适合你！