SpringBoot的日志信息及Lombok的常用注解

这篇具有很好参考价值的文章主要介绍了SpringBoot的日志信息及Lombok的常用注解。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

一. 日志的介绍

1. 什么是日志

日志是我们程序重要组成部分,它是程序在运行过程当中输出的一些提示或异常信息,我们可以通过日志来观察程序执行的情况,如果程序出现 Bug,我们可以根据日志去发现和排查程序的 Bug。

SpringBoot 项目在启动的时候,就会有默认的日志输出,如下图所示:
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
之所以会有上面的输出,是因为 SpringBoot 中内置了日志框架。

SpringBoot 中内置了 SLF4J 和 logback 两个日志框架,用户层面并不是直接操作具体的日志对象,而是使用 SLF4J 提供给用户的 API 进而由 logback 操作具体的日志对象实现日志。
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

SLF4J 这类框架是使用“门面模式”来实现的,SLF4J 其实和 JDBC 很像,我们知道使用 JDBC 操作数据库,一套 JDBC 代码就可以操作很多种数据库,可以是 MySQL,Oracle,DB2,SqlServer等,而这个JDBC 就相当于代理一样,来代理去操作数据库,我们不必关心各种数据库的实现,只需关注 JDBC 提供给我们的的 API 即可。

类似的,SLF4J 中也并不是真正完成了日志实现的框架,它只是一个门面或者一个代理,我们调用 SLF4J 的 API,SLF4J 中还会去调用 logback 这样的日志实现框架,此时我们就不必关心日志实现的细节,这一层面我们是感知不到的,这就是门面模式所带来的好处,还有一个好处就是如果日志实现层出现了漏洞,只需要修改更换日志实现的框架即可,而 SLF4J 可以匹配相应的日志框架,此时虽然日志实现的框架发生了改变,但我们写的代码仍然不受影响,这样就使得系统的依赖性降低,利于系统更新和维护。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

2. 日志的作用

  1. 能够帮助程序猿排除程序的 Bug。
  2. 记录用户登录日志,方便分析用户是正常登录还是恶意破解用户。
  3. 记录系统的操作日志,方便数据恢复和定位操作人。
  4. 记录程序的执行时间,方便为以后优化程序提供数据支持。

二. 日志的使用

使用日志框架可以配置日志的级别来控制日志的输出,而我们日常使用System.out.printf来输出日志是无法做到这一点的。

1. 日志格式说明

对于控制台输出的日志,它的各部分含义如下:
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
信息中的包名有部分是简写,取的是包名的第一个字母;
根据这些信息,我们就可以知道日志是发生在什么时间,在哪个线程,哪个类,以及具体的日志信息。

2. 自定义日志的输出

1️⃣第一步,在类中先获取到日志对象,这个日志对象来自于日志框架SLF4J

假设我们在类LogController设置自定义日志的输出,则日志对象创建代码如下:

每一个类都对应一个日志对象,可以通过日志工厂LoggerFactory获取的,导包的时候要注意Logger对象是在org.slf4j包下的,不要导错。

// 获取日志对象
private static Logger log =
        LoggerFactory.getLogger(LogController.class);

getLogger()一般传入传入当前类的类型,这里的参数用来定位日志的归属类,以方便日志输出,输出的日志信息中有了日志的定位, 才能更方便、更直观的定位到问题类。

2️⃣第二步,使用日志对象提供的方法来实现自定义日志的打印。

日志对象提供的方法有很多,可以设定不同级别的日志信息输出。
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
🍂示例代码:

@RestController相当于是将@Controller@ResponseBody这两个注解合起来的效果。

package com.example.springboot2.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class LogController {
    // 获取日志对象
    private static Logger log =
            LoggerFactory.getLogger(LogController.class);
    
    @RequestMapping("/log")
    public void log() {
        log.trace("我是trace");
        log.debug("我是debug");
        log.info(("我是info"));
        log.warn("我是warn");
        log.error("我是error");
    }
}

我们启动程序后,访问http://127.0.0.1:8080/log后,控制台就有相应的日志输出了。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

观察输出结果,我们的代码是写了 5 个级别的日志输出的,为什么这里结果只有 3 个结果呢?这是因为SpringBoot 项目下,默认日志级别为info,低于info日志级别的都不会输出。

3. 日志级别

🍂日志级别分为一下几种:

  • trace:微量,少许的意思,级别最低。
  • debug:需要调试时候的关键信息打印。
  • info:普通的打印信息(默认日志级别)。
  • warn:警告,不影响使用,但需要注意的问题。
  • error:错误信息,级别较高的错误日志信息。
  • fatal:致命的,因为代码异常导致程序退出执行的事件,不支持用户自定义。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

SpringBoot 项目默认的日志级别是info,那么比info日志级别低的是不能输出的,也就是debugtrace的日志是不会输出的,只有大于等于info级别的日志才会输出。

🍂日志级别的作用:

  1. 日志级别可以帮我们筛选出重要的信息,比如设置日志级别为 error,那么就可以只看程序的报错日志了,对于普通的调试日志和业务日志就可以忽略了,从而节省开发者信息筛选的时间。
  2. 日志级别可以控制不同环境下,⼀个程序是否需要打印日志,如开发环境我们就需要很详细的日志信息, 而生产环境为了保证性能和安全性就会输⼊尽量少的⽇志,通过日志的级别就可以实现此需求。

简单来说,就是过滤信息,将业务不需要的日志屏蔽掉。

4. 日志级别的配置

日志级别是可以通过配置文件进行设置的,日志级别包括两类,一类是全局日志级别,另一类就是局部日志级别,全局日志级别可以影响全局日志的输出,而局部日志级别只会影响一个局部的日志输出,并且局部日志级别配置大于全局日志级别的配置。

🎯全局日志级别配置,如修改默认日志级别为trace

properties 日志格式:

# 设置全局日志级别
logging.level.root=trace

yml 日志格式:

logging:
	level:
		root: trace

运行上面我们的自定义日志代码,此时就会发现,我们所有的自定义日志信息都会输出,并且随着程序启动相比较默认情况下会有更多的日志信息输出,毕竟这里设置的是全局的配置文件,会影响全局。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
🎯下面来介绍局部日志级别的配置,我们将LogController类的日志级别设置为warn,此时只会LogController类中日志输出级别,并不会影响其他位置的日志信息输出。

properties 格式配置文件:

# 设置夹局部的日志级别 (包名/包名+类名)
logging.level.com.example.demo.controller.LogController=warn

yml 格式配置文件:

logging:
	level:
		com:
			example:
				demo:
					controller: 
                    	LogController :warn

控制台结果:

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

yml 格式配置文件可以一步设置全局和局部的日志级别,比如:

logging:
  level:
    root: info
    com:
      example:
        springboot2:
          controller: error
          service: warn

root设置的是全局日志级别,项目中所有日志级别都是info;和root同级下可设置局部具体类的日志级别m这里就是com.example.springboot2.controllercom.example.springboot2.service包下的类,级别分别为errorwarn

5. 日志持久化

前面的介绍都是将日志输出在控制台上的,然而我们在生产环境下往往需要将日志保存下来,以便于后续出现问题时去追溯原因,将日志保存下来的过程就称之为持久化。

实现日志持久化的方式就是将日志信息保存到磁盘,同样可以通过设置配置文件实现。

🎯方式1:设置日志保存路径

properties 格式配置文件:

logging.file.path=D:\\bit\\logs

yml 格式配置文件:

logging:
  file:
    path: D:\\bit\\logs

启动程序,此时 SpringBoot 就会将控制台中打印的日志写到对应的目录了,日志文件默认名的为spring.log

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

🎯方式2:设置日志保存文件

properties 格式配置文件:

logging.file.name=D:\\bit\\log\\logging.log

yml 格式配置文件:

logging:
  file:
    name: D:\\bit\\log\\logging.log

效果如下:
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

还要注意,多次访问程序产生的日志是以追加的形式保存到日志文件当中的,SpringBoot 默认保存日志文件的大小为10MB**,**超出范围就会自动创建新的日志文件,然后保存到新的日志文件当中。

当然,也可以通过配置文件自定义日志文件的大小,配置方式如下:

# properties格式
logging.logback.rollingpolicy.max-file-size=10MB

# yml格式
logging:
	logback:
    	rollingpolicy:
    		max-file-size: 10MB

6. 更简单的输出日志-Lomok

每次都使⽤ LoggerFactory.getLogger(xxx.class) 很繁琐,且每个类都添加⼀遍,也很麻烦,在 Lombok 中有一个@Slf4j注解,可以使用该注解更简单的输出日志。

准备工作,首先要确保你的 IDEA 中有 Lombok 这个插件,没有的话去下载一下。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

然后,添加 Lombok 依赖,可以使用 Edit Starters 插件快捷添加。
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

刷新一下,依赖就添加好了。
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

🍂使用方法:在想打印日志的类上加上 @Slf4j 注解即可,它会为当前类提供一个 log 对象。

要注意使用 @Slf4j 注解,在程序中使用 log 对象即可输⼊⽇志,并且只能使⽤ log 对象才能输出,这是 lombok 提供的对象名;代码中输入 log 后就会有相关方法的提醒(前提是安装了 lombok 插件)。

package com.example.springboot2.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@Slf4j  // 当前的类中就可以直接使用 log 对象, @Slf4j 产生一个 log 对象, 直接使用即可
public class LogController2 {
    @RequestMapping("/log2")
    public void log2(){
        log.trace("我是trace");
        log.debug("我是debug");
        log.info(("我是info"));
        log.warn("我是warn");
        log.error("我是error");
    }

}

启动程序,访问路路径http://127.0.0.1:8080/log2,同样可以输出日志,代码更简单。
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
@Slf4j 注解替代了日志对象获取的代码:

private  final static Logger log = LoggerFactory.getLogger(LogController2.class);

7. Lombok框架实现原理以及其他常见注解

Lombok 框架其实在编译的时候,将依据注解去替生成对应的代码,比如就像上面的日志对象创建,加上一个 @Slf4j 注解后,在编译时就会将类似与上面创建日志对象的代码生成到我们所写代码里面去,包括Lombok 其他的注解,如生成 Setter 的注解 @Setter,生成 Getter 的注解 @Getter 等都是通过编译时期间实现的。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解
🍂Lombok作用:
SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

比如上面我们写的代码最终生成相应的字节码文件就在 target 目录中,target 目录中的代码才是项目最终执行的代码,查看 target 目录如下:

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

我们来对比一下我们LogController2.java原文件代码和程序运行起来后生成LogController2.class文件中的代码(由 IDEA 反编译显示)。

SpringBoot的日志信息及Lombok的常用注解,JavaEE,spring boot,后端,java,日志,Lombok,注解

发现代码中的 @Slf4j 注解就不存存在了,被 log 对象替代了,所以,Lombok 是不会影响程序运行的信能的,它要完成的工作都是在编译生成字节码文件前完成的。
🍂其他常用注解:
基本注解:

注解 作用
@Setter ⾃动添加 setter 方法
@Getter ⾃动添加 getter 方法
@ToString ⾃动添加 toString 方法
@EqualsAndHashCode ⾃动添加 equals 和 hashCode 方法
@NoArgsConstructor ⾃动添加⽆参构造方法
@AllArgsConstructor ⾃动添加全属性构造⽅法,顺序按照属性的定义顺序
@NonNull 属性不能为 null
@RequireArgsConstructor ⾃动添加必需属性的构造方法,final + @NonNull 的 属性为必需

组合注解:

注解 作用
@Data @Getter + @Setter + @ToString + @EqualsAndHashCode + @RequiredArgsConstructor + @NoArgsConstructor

日志注解:

注解 作用
@Slf4j 添加⼀个名为 log 的日志,使用 slf4j

使用 Lombok 提供给我们的这些注释,可以很好的帮助我们消除项目中大量冗余的代码,可以使得我们的 Java 类可以看起来非常的干净整洁。文章来源地址https://www.toymoban.com/news/detail-657695.html

到了这里,关于SpringBoot的日志信息及Lombok的常用注解的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 【Spring Boot】Spring Boot日志详情:基于lombok的日志输出

    日志文件是一种记录计算机系统或应用程序运行状态和活动的文件。日志文件可以包含各种重要信息,如错误报告、警告、事件、用户活动等。日志文件通常用于故障排除、性能优化、安全审计和法律合规等方面。日志文件可以在本地存储,也可以通过网络传输到远程服务器

    2024年02月12日
    浏览(41)
  • SpringBoot 使用lombok的@RequiredArgsConstructor注解进行Bean注入

    参考资料: lombok 使用 @RequiredArgsConstructor 注解完成 spring 注入问题 ⏹当我们使用 @Autowired 进行Bean注入的时候,IDEA会提示警告,不建议使用此方式进行注入。Spring官方更推荐使用构造方法进行注入。 ⏹随之而来的问题就是如果一个类中要注入多个对象的话,构造方法进行注入

    2024年02月11日
    浏览(41)
  • 【SpringBoot】讲清楚日志文件&&lombok

    提示:以下是本篇文章正文内容,下面案例可供参考 ⽇志是程序的重要组成部分,想象⼀下,如果程序报错了,不让你打开控制台看⽇志,那么你能找到报错的原因吗? 答案是否定的,写程序不是买彩票,不能完全靠猜,因此⽇志对于我们来说,最主要的⽤途就是排除和定

    2024年02月05日
    浏览(140)
  • SpringBoot日志持久化以及使用lombok输出日志

    上一篇文章介绍了日志级别和自定义输出日志 链接 https://blog.csdn.net/qq_45875349/article/details/132510387?csdn_share_tail=%7B%22type%22%3A%22blog%22%2C%22rType%22%3A%22article%22%2C%22rId%22%3A%22132510387%22%2C%22source%22%3A%22qq_45875349%22%7D 那么想要将控制台上的日志信息,保存在硬盘上,以便出问题之后追溯

    2024年02月11日
    浏览(49)
  • JavaEE——SpringMVC中的常用注解

    目录 1、@RestController (1)、@Controller (2)、@ResponseBody 2、RequestMappping (1)、定义 (2)、使用 【1】、修饰方法 【2】、修饰类 【3】、指定方法类型 【4】、简化版指定方法 (3)、获取参数 【1】、传递单个/多个参数 【2】、传递对象 3、@RequestParam 4、@RequestBody 5、@PathVar

    2024年02月15日
    浏览(72)
  • javaee spring aop 注解实现

    2024年02月09日
    浏览(45)
  • JavaEE进阶5/25(Spring 注解)

    1.五大类注解详解(重点 1.Controller 控制器,用于业务逻辑层,来控制用户的行为。它用来检查用户参数的有效性。 当用户的参数有效的话会继续分发到服务层。controller可以理解为程序的安保系统 2.Service 服务层。归属服务层,调用 持久化类 实现相应的功能。(服务层不直接

    2024年02月07日
    浏览(40)
  • 【JavaEE进阶】SpringMVC中的常用注解和用法

    目录 学习Spring MVC 建立连接 @RequestMapping 注解介绍 @RequestMapping 使用 传参介绍 传递单个参数 传递多个参数 传递对象 后端参数重命名(后端参数映射)@RequestParam 非必传参数设置 传递数组 传递集合 传递JSON数据 获取URL中参数@PathVariable 上传文件@RequestPart 获取Cookie/Session 响应

    2024年04月14日
    浏览(86)
  • 【JavaEE进阶】 Spring使用注解存储对象

    在博主前面所写的《【JavaEE进阶】 Spring 的创建和使⽤》中我们已经可以实现基本的 Spring 读取和存储对象的操作了,但在操作的过程中我们发现读取和存储对象并没有想象中的那么“简单”,所以接下来我们要学习更加简单的操作 Bean 对象的⽅法。 在 Spring 中想要更简单的存

    2024年02月05日
    浏览(44)
  • JavaEE——Spring中存取Bean的注解

    目录 一、存储Bean对象 1、定义 2、存储方式 (1)、类注解 【1】、@Controller(控制器存储) 【2】、@Service(服务存储) 【3】、@Repository(仓库存储) 【4】、@Component(组件存储) 【5】、@Configuration(配置存储) (2)、方法注解@Bean 3、重命名Bean 二、获取Bean对象 1、注入关

    2024年02月16日
    浏览(33)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包