源码阅读-logback解析之对接日志门面slf4j
内容导读
互联网集市收集整理的这篇技术教程文章主要介绍了源码阅读-logback解析之对接日志门面slf4j，小编现在分享给大家，供广大互联网技能从业者学习和参考。文章包含8922字，纯文字阅读大概需要13分钟。
内容图文
一.引言
日志在排除线上问题、跟踪线上系统运行情况中发挥着重要的作用。在java应用的开发中，有许多的日志框架。
这些日志框架大致可以分为两类，一类是日志门面（JCL、slf4j），定义日志的抽象接口。另一类是日志的实现(JUL、log4j、log4j2、logback),负责真正的处理日志。
日志框架的发展的前因后果
为什么会有这么多的日志框架，从Java日志框架的发展史里大概可以一探究竟。
log4j是Java社区最早的日志框架，推出后一度成为Java的事实日志标准，据说Apache曾建议Sun把log4j加入到Java标准库中，但是被Sun拒绝。
在Java1.4中，Sun在标准库中推出了自己的日志框架java.util.logging，功能相对简陋
虽然JUL相对简陋，但还是有类库采用了它，这就出现了同一个项目中同时使用log4j和JUL要维护两套配置的问题，Apache试图解决这个问题，推出了JCL日志门面（接口），定义了一套日志接口，底层实现支持log4j和JUL，但是并没有解决多套配置的问题
log4j的主力开发Ceki Gülcü由于某些原因离开了Apache，创建了slf4j日志门面（接口），并实现了性能比log4j性能更好的logback（如果Ceki Gülcü没有离开Apache，这应该就是log4j2的codebase了）
Apache不甘示弱，成立了不兼容log4j 1.x的log4j2项目，引入了logback的特性（还酸酸地说解决了logback架构上存在的问题），但目前采用率不是很高
日志框架的选择
那么面对这些日志框架，该如何选择呢？如果你是在开发一个新的项目（类库）而不是维护一个上古的遗留代码，那么在打印日志时推荐使用日志门面，秉承面向接口编程的思想，与具体的日志实现框架解耦，这样日后可以很容易地切换到其他的日志实现框架。
特别是当你的代码以SDK的方式提供给别人使用时，使用日志门面能避免使用方可能出现的日志框架冲突问题。如果你的SDK里使用了log4j，而使用方的应用里使用的logback，这时使用方就不得不分别针对log4j和logback维护两套日志配置文件，来确保所有日志正常的输出。
在目前已有的两个日志门面框架中，slf4j规避了JCL在部分场景下因为ClassLoader导致绑定日志实现框架失败的问题；能支持以上提到的所有日志实现框架；且slf4j支持占位符功能，在需要拼接日志的情况在接口层面就比JCL有更好的性能，所以推荐使用slf4j，下面简单多介绍下slf4j。
// slf4j的占位符功能
LOGGER.info("hello {}", name);
二.slf4j-api
slf4j-api为各种日志框架提供了一个统一的接口，使用户可以用统一的接口来记录日志，但是可以动态的决定真正的实现框架。logback、log4j、common-logging等都实现了这个接口。所以阅读logback源码之前，首先看看logback是如何与slf4j对接的。
slf4j-api最重要的是三个接口和一个入口类。
两个接口分别是org.slf4j.ILoggerFactory、org.slf4j.Logger和org.slf4j.spi.LoggerFactoryBinder。
入口类是org.slf4j.LoggerFactory。
1.org.slf4j.ILoggerFactory接口只提供了一个获取Logger的动作，由具体的日志框架实现者去实现该接口。
/**
* ILoggerFactory logger工厂接口
* 提供获取Logger动作
* 由具体的日志框架实现者去实现该接口
*/
public interface ILoggerFactory {
/**
* 获取Logger
*
* @param name the name of the Logger to return
* @return a Logger instance
*/
public Logger getLogger(String name);
}
2.org.slf4j.Logger接口提供了打印不同等级日志的动作和获取loggerName等动作。
3.org.slf4j.spi.LoggerFactoryBinder接口提供了获取ILoggerFactory的实现类的动作。一个内部接口去帮助LoggerFactory绑定合适的ILoggerFactory的实例。
由指定路径的实现类org.slf4j.impl.StaticLoggerBinder 去实现该接口，每一个实现slf4j门面的日志框架都有一个实现该接口的org.slf4j.impl.StaticLoggerBinder。
public interface LoggerFactoryBinder {
public ILoggerFactory getLoggerFactory();
public String getLoggerFactoryClassStr();
}
4..org.slf4j.LoggerFactory是一个入口类，通过调用ILoggerFactory的实现类获取Logger对象，稍后我们分析LoggerFactory的源码。
首先看一个简单的例子：
public class HelloWorld1 {
public static void main(String[] args) {
Logger logger = LoggerFactory.getLogger("chapters.introduction.HelloWorld1");
logger.debug("Hello world.");
}
}
不管实现框架是什么，要获取Logger对象，都是通过这个LoggerFactory的getLogger()方法，所以这个类也非常重要。具体实现框架和slf4j的对接，就是通过这个类LoggerFactory，让我们来看看这个类是如何对接slf4j的。
getLogger(String name)
1.获取ILoggerFactory的实现类，并调用getLogger(name)方法返回Logger对象。
public static Logger getLogger(String name) {
//获得ILoggerFactory的实现类
//把获取实际Logger的工作，委托给具体的日志框架上，比如log4j、logback、common-logging等
ILoggerFactory iLoggerFactory = getILoggerFactory();
return iLoggerFactory.getLogger(name);
}
getILoggerFactory()
1.首先用一个静态变量INITIALIZATION_STATE标识初始化状态，初始值=0，用双重检查锁判断这个状态，如果没有初始化，则将状态置为1，并且调用performInitialization()方法去初始化。
2.当初始化状态=1，则调用StaticLoggerBinder.getSingleton().getLoggerFactory()获取ILoggerFactory接口的实现类。
当初始化状态=4，则意味着没有可绑定的实现框架，返回一个空的ILoggerFactory接口实现类NOPLoggerFactory。内部getLogger(name)方法返回一个NOPLogger对象，其中打印方法中什么也没做。
当初始化状态=2，则初始化过程中发生异常，直接抛出IllegalStateException()异常。
当初始化状态=3，则正在进行初始化，返回一个替代工厂SubstituteLoggerFactory。
static final int UNINITIALIZED = 0; //未初始化
static final int ONGOING_INITIALIZATION = 1; //正在初始化
static final int FAILED_INITIALIZATION = 2; //失败初始化
static final int SUCCESSFUL_INITIALIZATION = 3; //成功初始化
static final int NOP_FALLBACK_INITIALIZATION = 4; //空初始化
static volatile int INITIALIZATION_STATE = UNINITIALIZED; //初始化状态
static final SubstituteLoggerFactory SUBST_FACTORY = new SubstituteLoggerFactory(); //替代工厂
static final NOPLoggerFactory NOP_FALLBACK_FACTORY = new NOPLoggerFactory(); //空工厂
/**
* Return the {@link ILoggerFactory} instance in use.
* <p/>
* <p/>
* ILoggerFactory instance is bound with this class at compile time.
* ILoggerFactory 实例在编译时期和该类绑定
* @return the ILoggerFactory instance in use
*/
public static ILoggerFactory getILoggerFactory() {
//判断是否初始化
//双重检查锁 并发情况下重复执行初始化
if (INITIALIZATION_STATE == UNINITIALIZED) {//若已经初始化则无需竞争锁 提高性能
synchronized (LoggerFactory.class) {
if (INITIALIZATION_STATE == UNINITIALIZED) {
INITIALIZATION_STATE = ONGOING_INITIALIZATION;
performInitialization();
}
}
}
switch (INITIALIZATION_STATE) {
case SUCCESSFUL_INITIALIZATION:
return StaticLoggerBinder.getSingleton().getLoggerFactory();
case NOP_FALLBACK_INITIALIZATION:
return NOP_FALLBACK_FACTORY;
case FAILED_INITIALIZATION:
throw new IllegalStateException(UNSUCCESSFUL_INIT_MSG);
case ONGOING_INITIALIZATION:
// support re-entrant behavior.
// See also http://jira.qos.ch/browse/SLF4J-97
return SUBST_FACTORY;
}
throw new IllegalStateException("Unreachable code");
}
performInitialization()
1.调用bind()执行绑定。
2.如果初始化成功，则进行版本检查。
private final static void performInitialization() {
//执行绑定
bind();
//成功获取binder实现
if (INITIALIZATION_STATE == SUCCESSFUL_INITIALIZATION) {
//这里会获取binder的静态变量REQUESTED_API_VERSION(要求API的版本号)和slf4j做比较
versionSanityCheck();
}
}
bind()
1.首先是检查classpath里是否存在多个日志框架，如果有就会抛出警告信息，提示用户只保留一个。
2.这段代码提到了一个最关键的StaticLoggerBinder类，这个类实现LoggerFactoryBinder接口，提供获取ILoggerFactory实现类的方法，检查是否有这个类存在，以及这个类有没有getSingleton()方法，如果有，就视为绑定成功。其实这个类还必须有getLoggerFactory()方法，否则虽然绑定成功，但是到了运行期，一样会抛出NoSuchMethodException。我认为这里是slf4j设计不好的地方，应该在bind()方法里，就检查一下StaticLoggerBinder有没有实现getLoggerFactory()方法。
private final static void bind() {
try {
Set<URL> staticLoggerBinderPathSet = null;
// skip check under android, see also
// http://jira.qos.ch/browse/SLF4J-328
//判断系统变量java.vendor.url是否包含android 默认是不会包含的
if (!isAndroid()) {
//在classpath下查找org/slf4j/impl/StaticLoggerBinder.class
staticLoggerBinderPathSet = findPossibleStaticLoggerBinderPathSet();
//检查是否找到多个binder
reportMultipleBindingAmbiguity(staticLoggerBinderPathSet);
}
// the next line does the binding
//饿汉单例 首先初始化binder实例
StaticLoggerBinder.getSingleton();
//初始化状态置为成功
INITIALIZATION_STATE = SUCCESSFUL_INITIALIZATION;
//报告实际绑定路径
reportActualBinding(staticLoggerBinderPathSet);
fixSubstituteLoggers();
replayEvents();
// release all resources in SUBST_FACTORY
SUBST_FACTORY.clear();
} 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);
}
}
总结一下大致流程：
1.LoggerFactory通过StaticLoggerBinder获取ILoggerFactory的实现类。
2.通过ILoggerFactory的实现类获取Logger的实现类返回。
内容总结
以上是互联网集市为您收集整理的源码阅读-logback解析之对接日志门面slf4j全部内容，希望文章能够帮你解决源码阅读-logback解析之对接日志门面slf4j所遇到的程序开发问题。 如果觉得互联网集市技术教程内容还不错，欢迎将互联网集市网站推荐给程序员好友。
内容备注
版权声明：本文内容由互联网用户自发贡献，该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 gblab@vip.qq.com 举报，一经查实，本站将立刻删除。
内容手机端
扫描二维码推送至手机访问。