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。
我们通过代码入手,层层加码,直观感受SLF4J打印日志,并跟踪代码追本溯源。主要了解,SLF4J是如何作为门面和其他日志框架进行解耦。
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.30</version>
</dependency>
public class HelloSlf4j {
public static void main(String[] args) {
Logger logger = LoggerFactory.getLogger(HelloSlf4j.class);
logger.info("Hello World info");
}
}
绑定org.slf4j.impl.StaticLoggerBinder失败。如果在类路径上没有找到绑定,那么 SLF4J 将默认为无操作实现
点开方法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);
}
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
<version>1.2.3</version>
</dependency>
可以看到正常的打印日志信息,并且没有任何异常
这个时候如果再点击进入方法StaticLoggerBinder.getSingleton(),发现类StaticLoggerBinder是由包logback-classic提供的,并且实现了SLF4J中的接口LoggerFactoryBinder。StaticLoggerBinder的创建用到了单例模式,该类主要目的返回一个创建Logger的工厂。这里实际返回了ch.qos.logback.classic.LoggerContext的实例,再由该实例创建ch.qos.logback.classic.Logger。
UML类图如下:
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<version>2.9.1</version>
</dependency>
打印日志如下,提示绑定了两个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
如果Pom文件先引入log4j-slf4j-impl,再引入logback-classic
根据日志打印结果,可以看到实际绑定的是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.
反编译看slf4j-api-1.7.30-sources.jar,发现压根没有这个类org.slf4j.impl.StaticLoggerBinder,他怎么会编译成功呢?猜想是不是打包的时候把这个类排除掉了呢?通过git下载源码发现slf4j源码其实是有这个文件的,org/slf4j/impl/StaticLoggerBinder.class;这里使用了一个小技巧,打包的时候把实现类排除掉了,虽然不太优雅,但是思路很巧妙。
该版本通过使用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;
}
slf4j已经提供了常用日志框架的桥接包,以及详细的文档描述,使用起来非常简单。
下图是SLF4J官网中提供的,表示了各种日志实现框架和SLF4J的关系:
在slf4j中用到了一些经典的设计模式,比如门面模式、单例模式、静态工厂模式等,我们来分析以下几种设计模式。
1)解释
门面模式,也叫外观模式,要求一个子系统的外部与其内部的通信必须通过一个统一的对象进行。门面模式提供一个高层次的接口,使得子系统更易于使用。使用了门面模式,使客户端调用变得更加简单。
Slf4j制定了log日志的使用标准,提供了高层次的接口, 我们编码过程只需要依赖接口Logger和工厂类 LoggerFactory就可以实现日志的打印,完全不用关心日志内部的实现细节是logback实现的方式,还是log4j的实现方式。
2)图解
Logger logger = LoggerFactory.getLogger(HelloSlf4j.class);
logger.info("Hello World info");
3)优点
解耦,减少系统的相互依赖。所有的依赖都是对门面对象的依赖,与子系统无关,业务层的开发不需要关心底层日志框架的实现及细节,在编码的时候也不需要考虑日后更换框架所带来的成本。
接口和实现分离,屏蔽了底层的实现细节,面向接口编程。
1)解释
单例模式,确保一个类仅有一个实例,并提供一个访问它的全局访问点。
在SLF4J的适配包中都需要实现类StaticLoggerBinder,而类StaticLoggerBinder的实现就用了单例模式,而且是最简单的实现方法,在静态初始化器中直接new StaticLoggerBinder(),提供全局访问方法获取该实例。
2)UML图
3)优点
在单例模式中,活动的单例只有一个实例,对单例类的所有实例化得到的都是相同的一个实例。这样就防止其它对象对自己的实例化,确保所有的对象都访问一个实例
单例模式具有一定的伸缩性,类自己来控制实例化进程,类就在改变实例化进程上有相应的伸缩性。
提供了对唯一实例的受控访问。
在内存里只有一个实例,减少了内存的开销,提高系统的性能。
作者:京东物流 曹俊
来源:京东云开发者社区