SpringBoot系列之日志框架介绍及其原理简介
SpringBoot系列之日志框架介绍及其原理简介
1、常用日志框架简介
市面上常用日志框架:JUL、JCL、jboss-logging、logback、log4j、log4j2、slf4j、etc.
其中日志门面,也是一系列接口api的有slf4j(Simple Logging Facade for Java)、JCL(Jakarta Commons Logging)、jboss-loggin
注意:常用的slf4j等只是一日志门面,是一个日志的抽象层,非日志实现,具体的实现用通过log4j或者logback等框架去实现
2、在项目中使用slf4j
日志调用的,还是建议引入slf4j对应的jar和其实现框架log4j或者logback,然后调用的还是如下进行调用,配好日志实现框架的配置,就可以进行日志跟踪
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
public class HelloWorld {
public static void main(String[] args) {
Logger logger = LoggerFactory.getLogger(HelloWorld.class);
logger.info("Hello World");
}
}
slf官方手册:slf4j官方手册链接
如图来自slf4j官方的图,图例已经很好的介绍了slf4j的使用场景:
- 如左一图示,直接导slf4j API工程是不能实现日志打印的
- logback的使用,需要导入slf4j API工程和其实现logback-classic.jar、logback-core.jar
- log4j的使用,同样导入slf4j API工程,还要再加比较关键的适配层jar:slf4j-log412.jar,然后log4j.jar才能适配slf4j
- JTL(java util logging)也是通过适配层的slf4j-jdk14.jar先进行适配,然后jtl框架才能正常实现slf4j的api
- etc.
3、系统日志统一到slf4j
ok,学到这里应该有个疑问?在Spring项目中,比如Spring framework框架,Hibernate etc.,这些框架是否有自己的日志实现,很显示,基本每个框架都有自己的日志实现,比如,spring framework就是使用commons-logging进行日志打印的,而Hibernate是通过(jboss-logging)的,etc.,所以这么一堆日志框架堆在一个项目中,是否可以实现统一的日志打印?比如统一到实现slf4j门面
在slf4j官网:http://www.slf4j.org/legacy.html,这个页面已经提供了比较合理的兼容统一实现
如官网的图例所示,主要提供引入一些桥接的jar,比如JCL框架可以引入jcl-over-slf4j.jar
log4j可以引入log4j-over-slf4j
官方说法:
为了简化从JCL到SLF4J的迁移,SLF4J发行版包括jar文件jcl-over-slf4j.jar。该jar文件旨在替代JCL
注意问题:
jcl-slf4j.jar,这个jar需要注意了,使用过程不要和jcl-over-slf4j一起用
jcl-over-slf4j.jar不应与slf4j-jcl.jar混淆
JCL-over-SLF4J(即jcl-over-slf4j.jar)在出于向后兼容性原因而需要支持JCL的情况下非常有用。它可以用于解决与JCL相关的问题,而不必采用SLF4J API,该决定可以推迟到以后。
另一方面,在为组件采用SLF4J API 之后,slf4j-jcl.jar很有用 ,该组件需要嵌入在正式要求JCL的更大的应用程序环境中。您的软件组件仍可以使用SLF4J API,而不会破坏大型应用程序。实际上,slf4j-jcl.jar会将所有日志记录决策委派给JCL,以便您的组件对SLF4J API的依赖关系对于更大的整体而言是透明的。
请注意,不能同时部署jcl-over-slf4j.jar和 slf4j-jcl.jar。前一个jar文件将使JCL将日志记录系统的选择委派给SLF4J,后一个jar文件将使SLF4J将日志记录系统的选择委派给JCL,从而导致无限循环。
ok,对于log4j-over-slf4j.jar使用过程同样注意
log4j-over-slf4j.jar和slf4j-log4j12.jar不能同时存在
slf4j-log4j12.jar的存在(即SLF4J的log4j绑定)将强制将所有SLF4J调用委派给log4j。log4j-over-slf4j.jar的存在将把所有log4j API调用委派给它们的SLF4J等效项。如果两者同时存在,则slf4j调用将委派给log4j,而log4j调用将重定向到SLF4j,从而导致无限循环。
对于这些竟然的jar是如何实现偷梁换柱的?我们可以点开对应的jar,如图所示:这个jar的包名命名都和jcl的一样,目的是实现偷梁换柱,强制不使用jcl的api,而实现slf4j
ok,可以归纳统一项目使用slf4j的过程,首先系统还是用排除其它日志实现jar,然后引入桥接的jar,等覆盖了之后,就可以加上对应的实现jar包,实现日志打印
4、Springboot日志场景启动器
ok,有了前面的知识后,我们可以继续学习Springboot的日志实现了,从前面的知识可以知道,slf4j只是一个日志门面工程,并非实现,在很多项目里都有日志框架混用的情况,针对此种起来,可以加入一些桥接的偷梁换柱jar,然后再加上对应的实现jar就可以
然后Springboot其实也是类似这种实现,首先,Springboot默认使用slf4j作为门面工程,在实现过程也是有用这些偷梁换柱的桥接jar进行slf4j统一,然后再引用logback作为日志实现的jar,先快速创建一个Springboot项目:Springboot系列之快速创建项目教程
创建好项目之后,是默认会引入日志框架的,首先在pom文件,右键->maven->show dependencies显示jar依赖图
如图所示,Springboot的场景启动项目spring-boot-strater集成了spring-boot-strater-logging,spring-boot-strater-logging都是以logback为默认的日志实现框架,当然本博客是以Springboot2.2.1.RELEASE版本为例子的
当然每个版本的实现略有不同,不过基本都一致,给出尚硅谷老师给的图片:
ok,Springboot项目已经对日志做了一个比较好的兼容,还有一个日志jar冲突问题需要注意,因为Springboot项目是统一为slf4j门面的,很显然Springboot在项目实现中就已经做了其它日志jar门面的排除,比如spring项目就已经将jcljar排除了,如图:
所以,在项目使用中,引入其它的jar,都要考虑是否有对应的日志实现jar,要做必要的排除,以免造成jar冲突
ok,这篇博客是对常用日志框架的介绍,有了这些必要的知识之后,就可以实践一下了,详情的可以参数我的博客,SpringBoot系列日志框架使用教程