SpringBoot 日志文件

  • 1. 认识日志文件
  • 1.1. 日志文件有什么用?
  • 1.2 日志文件的格式
  • 2. 自定义日志文件的打印
  • 3. 日志的持久化
  • 3.0 什么时日志持久化
  • 3.1 设置日志名称
  • 3.2 设置日志目录
  • 3.3 持久化日志的特点
  • 4. 日志的级别
  • 5. 设置“日志级别”来筛选日志
  • 6. 简化日志打印——lombok
  • 6.1 添加lombok依赖
  • 6.2 使⽤ @slf4j 注解输出⽇志
  • 6.3 lombok原理解释


1. 认识日志文件

1.1. 日志文件有什么用?

日志就是我们在运行SpringBoot时,控制台上打印出来的如下内容:

spring boot 日志保存位置 springboot 日志文件_spring boot 日志保存位置


它是用来发现程序在运行时的错误

1.2 日志文件的格式

spring boot 日志保存位置 springboot 日志文件_日志文件_02

2. 自定义日志文件的打印

实现步骤:

  1. 得到日志对象
  2. 通过设置日志级别来筛选和控制日志内容
@RestController
public class TestController {
    //1.得到日志对象
    private static Logger log = LoggerFactory.getLogger(TestController.class);
    @RequestMapping("/hi")
    public String sayhi(){
        log.info("Hi,Spring Boot Log!");
        return "打印成功";
    }
}

运行程序:

spring boot 日志保存位置 springboot 日志文件_spring boot 日志保存位置_03

注意:在选择Logger 和 LoggerFactory时,都选择s l f 4 j:

spring boot 日志保存位置 springboot 日志文件_日志文件_04

那么为什么要选择slf4j呢?
因为 Spring Boot 中内置了⽇志框架 Slf4j,所以咱们可以直接在程序中调⽤slf4j来输出日志。

3. 日志的持久化

3.0 什么时日志持久化

在⽣产环境上咱们需要将⽇志保存下来,以便出现问题之后追
溯问题,把⽇志保存下来的过程就叫做持久化。

持久化日志会有两种方式:

  1. 通过设置日志名称
  2. 通过设置日志目录

3.1 设置日志名称

配置文件:

# 日志的保存名称
logging:
  file:
    name: springboot.log

运行程序,就会创建一个log文件:

spring boot 日志保存位置 springboot 日志文件_spring boot_05

如果没有创建的话,就先删除掉项目目录下的target包,重新运行一遍:

spring boot 日志保存位置 springboot 日志文件_spring boot_06

3.2 设置日志目录

配置文件:

# 日志的保存目录
logging:
  file:
    path: C:\work\

运行程序,就在C:\work\创建一个spring.log文件:

spring boot 日志保存位置 springboot 日志文件_java_07

3.3 持久化日志的特点

  1. 日志不会丢失,会一直追加
  2. 当日志较大时,会自动分割成多个文件(随着日志的增多,打开一个大的文件比较费时)

4. 日志的级别

日志级别分为:

  1. trace:微量,少许的意思,级别最低;
  2. debug:需要调试时候的关键信息打印;
  3. info:普通的打印信息(默认⽇志级别);
  4. warn:警告,不影响使⽤,但需要注意的问题;
  5. error:错误信息,级别较⾼的错误⽇志信息;
  6. fatal:致命的,因为代码异常导致程序退出执⾏的事件。

spring boot 日志保存位置 springboot 日志文件_spring boot_08


设置日志级别的目的就是筛选日志,当设置日志级别为info时,控制台上面就不会打印debug和trace级别的日志。也就是不会打印比设置的日志级别低的日志。

5. 设置“日志级别”来筛选日志

通过配置文件来设置日志级别:

logging:
  level:
    root: error  //日志级别设置文error

测试代码:

@RestController
public class TestController {
    //1.得到日志对象
    private static Logger log = LoggerFactory.getLogger(TestController.class);
    @RequestMapping("/hi")
    public String sayhi(){
        //打印日志
        log.trace("hi,i am trace");
        log.debug("hi,i am debug");
        log.info("hi,i am info");
        log.warn("hi,i am warn");
        log.error("hi,i am error");
        return "打印成功";
    }
}

运行程序,结果:

spring boot 日志保存位置 springboot 日志文件_spring boot_09


控制台打印的日志里面只有级别 >= error的.当然,特可以精细化设置日志级别:

spring boot 日志保存位置 springboot 日志文件_日志文件_10

6. 简化日志打印——lombok

每次都使⽤ LoggerFactory.getLogger(xxx.class) 很繁琐,且每个类都添加⼀遍,也很麻烦,这⾥讲⼀种更好⽤的⽇志输出⽅式,使⽤ lombok 来更简单的输出,具体步骤如下:

  1. 添加 lombok 框架⽀持。
  2. 使⽤ @slf4j 注解输出⽇志。

6.1 添加lombok依赖

<dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<version>1.18.20</version>
	<optional>true</optional>
</dependency>

6.2 使⽤ @slf4j 注解输出⽇志

@slf4j 就是lombok框架下面的一个注解,作用就是添加一个名为log的日志对象

@RestController
@Slf4j
public class TestController {
    @RequestMapping("/hi")
    public String sayhi(){
        //打印日志
        log.trace("hi,i am trace");
        log.debug("hi,i am debug");
        log.info("hi,i am info");
        log.warn("hi,i am warn");
        log.error("hi,i am error");
        return "打印成功";
    }
}

注意:使⽤ @Slf4j 注解,在程序中使⽤ log 对象即可输⼊⽇志,并且只能使⽤ log 对象才能输出,这是 lombok 提供的对象名

6.3 lombok原理解释

Lombok 的作⽤如下图所示:

spring boot 日志保存位置 springboot 日志文件_spring boot_11


即自动给他加上如下代码:

spring boot 日志保存位置 springboot 日志文件_spring_12


我们为可以在target里面看一下源代码的字节码,进而验证上述观点:

spring boot 日志保存位置 springboot 日志文件_java_13


在之前用到的@Data,也是属于lombok注解,要想使用更多的lombok注解,可以在网上搜一下,然后放心使用就行。