写点什么

SLF4J 门面日志框架源码探索 | 京东云技术团队

  • 2023-06-21
    北京
  • 本文字数:5780 字

    阅读完需:约 19 分钟

SLF4J门面日志框架源码探索 | 京东云技术团队

1 SLF4J 介绍

SLF4J 即 Simple Logging Facade for Java,它提供了 Java 中所有日志框架的简单外观或抽象。因此,它使用户能够使用单个依赖项处理任何日志框架,例如:Log4j,Logback 和 JUL(java.util.logging)。通过在类路径中插入适当的 jar 文件(绑定),可以在部署时插入所需的日志框架。如果要更换日志框架,仅仅替换依赖的 slf4j bindings。比如,从 java.util.logging 替换为 log4j,仅仅需要用 slf4j-log4j12-1.7.28.jar 替换 slf4j-jdk14-1.7.28.jar。

2 SLF4J 源码分析

我们通过代码入手,层层加码,直观感受 SLF4J 打印日志,并跟踪代码追本溯源。主要了解,SLF4J 是如何作为门面和其他日志框架进行解耦。

2.1 pom 只引用依赖 slf4j-api,版本是 1.7.30

        <dependency>            <groupId>org.slf4j</groupId>            <artifactId>slf4j-api</artifactId>            <version>1.7.30</version>        </dependency>
复制代码

2.1.1 执行一个 Demo

public class HelloSlf4j {
public static void main(String[] args) { Logger logger = LoggerFactory.getLogger(HelloSlf4j.class); logger.info("Hello World info"); }}
复制代码

2.1.2 日志提示信息

绑定 org.slf4j.impl.StaticLoggerBinder 失败。如果在类路径上没有找到绑定,那么 SL​​F4J 将默认为无操作实现



2.1.3 跟踪源码

点开方法 getLogger(),可以直观看到 LoggerFactory 使用静态工厂创建 Logger。通过以下方法,逐步点击,报错也很容易找到,可以在 bind()方法看到打印的异常日志信息。


org.slf4j.LoggerFactory#getLogger(java.lang.Class<?>)


org.slf4j.LoggerFactory#getLogger(java.lang.String)


org.slf4j.LoggerFactory#getILoggerFactory


org.slf4j.LoggerFactory#performInitialization


org.slf4j.LoggerFactory#bind


private final static void bind() {        try {            Set<URL> staticLoggerBinderPathSet = null;            // skip check under android, see also            // http://jira.qos.ch/browse/SLF4J-328            if (!isAndroid()) {                staticLoggerBinderPathSet = findPossibleStaticLoggerBinderPathSet();                reportMultipleBindingAmbiguity(staticLoggerBinderPathSet);            }            // the next line does the binding            StaticLoggerBinder.getSingleton();            INITIALIZATION_STATE = SUCCESSFUL_INITIALIZATION;            reportActualBinding(staticLoggerBinderPathSet);        } catch (NoClassDefFoundError ncde) {            String msg = ncde.getMessage();            if (messageContainsOrgSlf4jImplStaticLoggerBinder(msg)) {                INITIALIZATION_STATE = NOP_FALLBACK_INITIALIZATION;                Util.report("Failed to load class "org.slf4j.impl.StaticLoggerBinder".");                Util.report("Defaulting to no-operation (NOP) logger implementation");                Util.report("See " + NO_STATICLOGGERBINDER_URL + " for further details.");            } else {                failedBinding(ncde);                throw ncde;            }        } catch (java.lang.NoSuchMethodError nsme) {            String msg = nsme.getMessage();            if (msg != null && msg.contains("org.slf4j.impl.StaticLoggerBinder.getSingleton()")) {                INITIALIZATION_STATE = FAILED_INITIALIZATION;                Util.report("slf4j-api 1.6.x (or later) is incompatible with this binding.");                Util.report("Your binding is version 1.5.5 or earlier.");                Util.report("Upgrade your binding to version 1.6.x.");            }            throw nsme;        } catch (Exception e) {            failedBinding(e);            throw new IllegalStateException("Unexpected initialization failure", e);        } finally {            postBindCleanUp();        }    }
复制代码


进一步分析绑定方法 findPossibleStaticLoggerBinderPathSet(),可以发现在当前 ClassPath 下查询了所有该路径的资源“org/slf4j/impl/StaticLoggerBinder.class”,这里可能没有加载到任何文件,也可能绑定多个,对没有绑定和绑定多个的场景进行了友好提示。这里通过路径加载资源的目的主要用来对加载的各种异常场景提示。


再往下代码 StaticLoggerBinder.getSingleton()才是实际的绑定,并且获取 StaticLoggerBinder 的实例。这里如果反编译,你会发现根本没有这个类 StaticLoggerBinder。


如果没有加载到文件,正如上边 demo 执行的结果一样,命中 NoSuchMethodError 异常,并打印没有绑定场景的提示信息。


方法 findPossibleStaticLoggerBinderPathSet()的源码如下,可以发现类加载器通过路径获取 URL 资源。


            ClassLoader loggerFactoryClassLoader = LoggerFactory.class.getClassLoader();            Enumeration<URL> paths;            if (loggerFactoryClassLoader == null) {                paths = ClassLoader.getSystemResources(STATIC_LOGGER_BINDER_PATH);            } else {                paths = loggerFactoryClassLoader.getResources(STATIC_LOGGER_BINDER_PATH);            }
复制代码

2.2 pom 引用依赖 logback-classic

        <dependency>            <groupId>ch.qos.logback</groupId>            <artifactId>logback-classic</artifactId>            <version>1.2.3</version>        </dependency>
复制代码

2.2.1 执行 demo

可以看到正常的打印日志信息,并且没有任何异常



2.2.2 跟踪源码

这个时候如果再点击进入方法 StaticLoggerBinder.getSingleton(),发现类 StaticLoggerBinder 是由包 logback-classic 提供的,并且实现了 SLF4J 中的接口 LoggerFactoryBinder。StaticLoggerBinder 的创建用到了单例模式,该类主要目的返回一个创建 Logger 的工厂。这里实际返回了 ch.qos.logback.classic.LoggerContext 的实例,再由该实例创建 ch.qos.logback.classic.Logger。


UML 类图如下:



2.3 pom 再引入 log4j-slf4j-impl

        <dependency>            <groupId>org.apache.logging.log4j</groupId>            <artifactId>log4j-slf4j-impl</artifactId>            <version>2.9.1</version>        </dependency>
复制代码

2.3.1 执行 demo

打印日志如下,提示绑定了两个 StaticLoggerBinder.class,但最终实际绑定的是 ch.qos.logback.classic.util.ContextSelectorStaticBinder。这里边也验证了一旦一个类被加载之后,全局限定名相同的类就无法被加载了。这里 Jar 包被加载的顺序直接决定了类加载的顺序。


SLF4J: Found binding in [jar:file:/D:/.m2/repository/ch/qos/logback/logback-classic/1.2.3/logback-classic-1.2.3.jar!/org/slf4j/impl/StaticLoggerBinder.class]SLF4J: Found binding in [jar:file:/D:/.m2/repository/org/apache/logging/log4j/log4j-slf4j-impl/2.9.1/log4j-slf4j-impl-2.9.1.jar!/org/slf4j/impl/StaticLoggerBinder.class]SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation.SLF4J: Actual binding is of type [ch.qos.logback.classic.util.ContextSelectorStaticBinder]18:19:43.521 [main] INFO com.cj.HelloSlf4j - Hello World info
复制代码

2.4 log4j-slf4j-impl 和 logback-classic 的引入位置变换

如果 Pom 文件先引入 log4j-slf4j-impl,再引入 logback-classic

2.4.1 执行 demo

根据日志打印结果,可以看到实际绑定的是 org.apache.logging.slf4j.Log4jLoggerFactory;但是没有正常打印出日志,需要进行 log4j2 的日志配置。说明实际绑定的是 og4j-slf4j-impl 包中的 org/slf4j/impl/StaticLoggerBinder.class 文件;这里也验证了如果有引入了多个桥接包,实际绑定的是先加载到的文件;


SLF4J: Class path contains multiple SLF4J bindings.SLF4J: Found binding in [jar:file:/D:/.m2/repository/org/apache/logging/log4j/log4j-slf4j-impl/2.9.1/log4j-slf4j-impl-2.9.1.jar!/org/slf4j/impl/StaticLoggerBinder.class]SLF4J: Found binding in [jar:file:/D:/.m2/repository/ch/qos/logback/logback-classic/1.2.3/logback-classic-1.2.3.jar!/org/slf4j/impl/StaticLoggerBinder.class]SLF4J: See http://www.slf4j.org/codes.html#multiple_bindings for an explanation.SLF4J: Actual binding is of type [org.apache.logging.slf4j.Log4jLoggerFactory]ERROR StatusLogger No log4j2 configuration file found. Using default configuration: logging only errors to the console. Set system property 'log4j2.debug' to show Log4j2 internal initialization logging.
复制代码

2.5 类加载方式的变化

2.5.1 slf4j-api-1.7.30 版本的打包技巧

反编译看 slf4j-api-1.7.30-sources.jar,发现压根没有这个类 org.slf4j.impl.StaticLoggerBinder,他怎么会编译成功呢?猜想是不是打包的时候把这个类排除掉了呢?通过 git 下载源码发现 slf4j 源码其实是有这个文件的,org/slf4j/impl/StaticLoggerBinder.class;这里使用了一个小技巧,打包的时候把实现类排除掉了,虽然不太优雅,但是思路很巧妙。

2.5.2 slf4j-api-2.0.0 版本引入 SPI(Service Provider Interface)

该版本通过使用 SPI 方式进行实现类的加载,感觉比之前的实现方式优雅了很多。桥接包只需要在这个位置:META-INF/services/,定义一个文件 org.slf4j.spi.SLF4JServiceProvider(命名为 SLFJ4 提供的接口名),并且文件中指定实现类。只要引入这个桥接包,就可以适配到对应实现的日志框架。


以下是 SPI 方式加载的源码


private static List<SLF4JServiceProvider> findServiceProviders() {        ServiceLoader<SLF4JServiceProvider> serviceLoader = ServiceLoader.load(SLF4JServiceProvider.class);        List<SLF4JServiceProvider> providerList = new ArrayList();        Iterator var2 = serviceLoader.iterator();
while(var2.hasNext()) { SLF4JServiceProvider provider = (SLF4JServiceProvider)var2.next(); providerList.add(provider); }
return providerList; }
复制代码

2.5.3 类加载方式对比


2.6 SLF4J 官方已经实现绑定的日志框架

slf4j 已经提供了常用日志框架的桥接包,以及详细的文档描述,使用起来非常简单。


下图是 SLF4J 官网中提供的,表示了各种日志实现框架和 SLF4J 的关系:



2.7 总结

  • SLF4J API 旨在一次绑定一个且仅一个底层日志框架。而且引入 SLF4J 后,不管是否可以加载到 StaticLoggerBinder,或者加载到多个 StaticLoggerBinder,都进行友好提示,用户体验上考虑都很周到。如果类路径上存在多个绑定,SLF4J 将发出警告,列出这些绑定的位置。当类路径上有多个绑定可用时,应该选择一个希望使用的绑定,然后删除其他绑定。

  • 单纯看 SLF4J 源码,其实整体设计实现上都很简单明确,定位非常清楚,就是做好门面。

  • 鉴于 SLF4J 接口及其部署模型的简单性,新日志框架的开发人员应该会发现编写 SLF4J 绑定非常容易。

  • 对于目前比较主流的日志框架都通过实现适配进行兼容支持。只要用户选择了 SLF4J,就可以确保以后变更日志框架的自由。

3 SLF4J 设计模式的使用

在 slf4j 中用到了一些经典的设计模式,比如门面模式、单例模式、静态工厂模式等,我们来分析以下几种设计模式。

3.1 门面模式(Facade Pattern)

1)解释


门面模式,也叫外观模式,要求一个子系统的外部与其内部的通信必须通过一个统一的对象进行。门面模式提供一个高层次的接口,使得子系统更易于使用。使用了门面模式,使客户端调用变得更加简单。


Slf4j 制定了 log 日志的使用标准,提供了高层次的接口, 我们编码过程只需要依赖接口 Logger 和工厂类 LoggerFactory 就可以实现日志的打印,完全不用关心日志内部的实现细节是 logback 实现的方式,还是 log4j 的实现方式。


2)图解



        Logger logger = LoggerFactory.getLogger(HelloSlf4j.class);        logger.info("Hello World info");
复制代码


3)优点


解耦,减少系统的相互依赖。所有的依赖都是对门面对象的依赖,与子系统无关,业务层的开发不需要关心底层日志框架的实现及细节,在编码的时候也不需要考虑日后更换框架所带来的成本。


接口和实现分离,屏蔽了底层的实现细节,面向接口编程。

3.2 单例模式(Singleton Pattern)

1)解释


单例模式,确保一个类仅有一个实例,并提供一个访问它的全局访问点。


在 SLF4J 的适配包中都需要实现类 StaticLoggerBinder,而类 StaticLoggerBinder 的实现就用了单例模式,而且是最简单的实现方法,在静态初始化器中直接 new StaticLoggerBinder(),提供全局访问方法获取该实例。


2)UML 图



3)优点


在单例模式中,活动的单例只有一个实例,对单例类的所有实例化得到的都是相同的一个实例。这样就防止其它对象对自己的实例化,确保所有的对象都访问一个实例


单例模式具有一定的伸缩性,类自己来控制实例化进程,类就在改变实例化进程上有相应的伸缩性。


提供了对唯一实例的受控访问。


在内存里只有一个实例,减少了内存的开销,提高系统的性能。

4 启示

  • 尽管 SLF4J 整体代码短小但很精炼,可见门面模式运用好的威力。门面模式也为我们提供了对于多版本的实现如何统一定义接口以及兼容提供了参考。

  • SLF4J 定义和实现方案对用户都很友好,同时又提供了各种桥接包,进行完善的文档指导使用。总之各项用户体验都很棒,这也许也是 SLF4J 目前最受欢迎的原因之一吧。

  • 我们要多思考面向接口编程的思想,降低代码耦合度,提高代码扩展性。

  • 使用 SPI 的方式,优雅的加载扩展实现。

  • 好产品是设计出来的,更是优化迭代出来的。

5 参考资料

  • slf4j 官网:https://www.slf4j.org/manual.html

  • 类加载:

  • https://docs.oracle.com/javase/7/docs/api/java/lang/ClassLoader.html

  • https://docs.oracle.com/javase/7/docs/api/java/util/ServiceLoader.html

  • https://www.ibm.com/docs/en/sdk-java-technology/7.1?topic=cl-parent-delegation-model-1


作者:京东物流 曹俊

来源:京东云开发者社区

发布于: 7 小时前阅读数: 3
用户头像

拥抱技术,与开发者携手创造未来! 2018-11-20 加入

我们将持续为人工智能、大数据、云计算、物联网等相关领域的开发者,提供技术干货、行业技术内容、技术落地实践等文章内容。京东云开发者社区官方网站【https://developer.jdcloud.com/】,欢迎大家来玩

评论

发布
暂无评论
SLF4J门面日志框架源码探索 | 京东云技术团队_jdk_京东科技开发者_InfoQ写作社区