springboot日志功能的详细介绍

一. 主流日志框架

市场上存在非常多的日志框架。JUL（java.util.logging），JCL（Apache Commons Logging），Log4j，Log4j2，Logback、 SLF4j、 jboss-logging等。Spring Boot在框架内容部使用JCL，spring-boot-starter-logging采用了 slf4j+logback的形式，Spring Boot也能自动适配（jul、 log4j2、 logback） 并 简化配置。

在写log4j的两种配置方式（xml和propertiies）时我就在想“为什么使用log4j时需要导入self4j、log4j和整合jar包”？

经过一番的周折之后，终于获取到了答案，其实答案很简单，日志分为两类：日志门面和日志实现两种，这两个之间的关系相当于java中接口和实现类的关系，接下来对上面的日志框架做一下简单的分类：

他们之间不是一一对应关系，只是这样写看起来美观点。

二、日志的使用

• SpringBoot：底层是Spring框架，Spring框架默认是用JCL
• SpringBoot选用SLF4j和logback
• 以后开发的时候，日志记录方法的调用，不应该来直接调用日志的实现类，而是调用日志抽象层里面的方法；给系统里面导入slf4j的jar和logback的实现jar

public class HelloWorld {
  Logger logger = LoggerFactory.getLogger(HelloWorld.class);  
}

1、jar包的引入

从上面可知，导入日志需要在上面表中选择一个日志门面和一个日志实现。下面以Slf4j为例展示其对应关系如下：

这里又有一个问题，springboot默认使用SLF4j和logback，底层spring默认使用JCL，然后如果导入了Hibernate（jboss-logging），如何使别的框架和我一起统一使用slf4j进行输出？

查看Slf4j的官方文档时，确实有解决方法，如下：

其解决思路如下：

• 将系统中其他日志框架先排除出去；
• 用中间包来替换原有的日志框架；
• 我们导入slf4j其他的实现

springboot中的日志关系

<dependency>
    <groupId>org.springframework.boot</groupId>
     <artifactId>spring‐boot‐starter</artifactId>
</dependency>

 

总结：

• SpringBoot底层也是使用slf4j+logback的方式进行日志记录
• SpringBoot也把其他的日志都替换成了slf4j；
• 中间替换包如：log4j-to-slf4j.jar...

<!--移除JCL日志框架-->
<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring‐core</artifactId>
    <exclusions>
        <exclusion>
            <groupId>commons‐logging</groupId>
            <artifactId>commons‐logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

springboot的处理方法和上面的图解如出一辙，先把其它都转换为Slf4j,支持多种日志实现。springboot2.1.6.RELEASE默认导入了Slf4j、logback和log4j,因此你不需要导入日志的相关jar包就可以使用日志的功能！

2、配置文件的编写

• 每一个日志的实现框架都有自己的配置文件。使用slf4j以后，配置文件还是做成日志实现框架自己本身的配置文 件；
• log4j的配置文件请参考：https://javacfox.github.io/2019/06/28/Log4j%E6%97%A5%E5%BF%97%E9%85%8D%E7%BD%AE/
• logback的配置文件请参考：

#指定日志配置文件路径
# logging.config=classpath:/logback-spring.xml

# 日志文件存放路径
#logging.path=/spring/log


# 指定日志文件名
# logging.file=my.log

# 历史日志文件的最大保存量
# logging.file.max-history=100000

# 指定日志打印级别,可以配置多个
#logging.level.com.hiberate.orcal_and_hiberate=debug
##
### 日志文件最大空间
##logging.file.max-size=10M

# 日志输出格式：
# %d表示日期时间，
# %thread表示线程名，
# %‐5level：级别从左显示5个字符宽度
# %logger{50}表示logger名字最长50个字符，否则按照句点分割。
# %msg：日志消息，
# %n是换行符

# 日志控制台打印格式
#logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level%logger{50}-%msg%n
#
## 日志输出的时间格式
#logging.pattern.dateformat=%d{yyyy-MM-dd HH:mm:ss.SSS}
#
## 日志输出到文件中的格式
#logging.pattern.file=%d{yyyy-MM-dd HH:mm:ss.SSS}[%thread]%-5level%logger{50}-%msg%n
#
## 在输出日志中添加输出级别
#logging.pattern.level=%5p
#
#logging.exception-conversion-word=%wEx