【编程开发】- 01 日志框架

日志实现框架

Log4j

Log4j是目前最为流行的Java日志框架之一，1999年发布首个版本，2012年发布最后一个版本，2015年正式宣布终止，官方也已不建议使用，并逐步被Logback和Log4j2等日志框架所替代，可是无法掩饰光辉历程，以及优良的设计理念。尽管Log4j有着出色的历史战绩，但早已不是Java日志框架的最优选择，还在使用该日志框架的项目往往是历史遗留问题。

Log4j API核心类：

(相关资料图)

JUL

Java Logging是Java标准的日志框架，也称为Java Logging API，即JSR 47。从Java 1.4版本开始，Java Logging成为Java SE的功能模块，其实现类存放在java.util.logging包下。

使用Java Logging最大好处是它属于JDK内置，不需要添加额外依赖，默认配置文件位于：jre/lib/logging.properties，具体可以查看LogManager类readConfiguration方法，启动的时候可以通过设置VM参数java.util.logging.config.file指定配置文件。

Java Logging API核心类：

Logback

Logback是Log4j创始人设计的又一个开源日志框架，可以看成Log4j的替代者，在架构和特征上有着相当提升。Logback当前分成三个模块：

Logback核心类：

核心架构

上图是logback日志框架的输出日志的核心流程：

Logger和Appender是日志框架比较核心组件，Logger代表日志输入源，其配置样例见下：

Appender代表日志输出源，其配置样例见下：

Logger和Appender相互独立，都可以实现对日志过滤操作，同时可以实现多对多映射关系，在开发中可以对这些特性灵活应用。比如：生产中一个很常见的做法就是构建一个Level=Error的Appender，然后让所有的Logger都指向该Appender就可以实现汇聚系统中所有Error级别的日志，可以快速监测系统运行是否出现异常状况。

Appender

节点被配置时，必须配置两个属性name和class。name指定Appender的名称，而class指定Appender具体的实现类。

Appender核心类结构图：

UnsynchronizedAppenderBase:非线程安全的Appender基类，即public void doAppend(E eventObject)没有使用synchronized关键字，而AppenderBase类中的doAppend()方法都使用了synchronized关键字：public synchronized void doAppend(E eventObject)。

Level

日志可以分配级别，包括：ALL、TRACE、DEBUG、INFO、WARN、ERROR、OFF，其中ALL和OFF日志级别是用于Appender或Logger过滤使用。

Logger

通过LoggerFactory获取Logger：Logger getLogger(String name)，LoggerFactory采用工厂设计模式，内部维护一个Map缓存所有生成的Logger实例信息：Map loggerCache = new ConcurrentHashMap()。

继承规则

Logger是有层次关系的，我们可一般性的理解为包名之间的父子继承关系。每个Logger通常以class全限名称为其名称。子Logger通常会从父Logger继承Logger级别、Appender等信息。

统一日志API

日志框架无论Log4j还是Logback，虽然它们功能完备，但是各自API相互独立，并且各自为政。当应用系统在团队协作开发时，由于工程师人员可能有所偏好，因此，可能导致一套系统同时出现多套日志框架情况。

其次，最流行的日志框架基本上基于实现类编程，而非接口编程，因此，暴露一些无关紧要的细节给用户，这种耦合性是没有必要的。

诸如此类的原因，开源社区提供统一日志API框架，最为流行的是：

统一日志API，即日志门面接口层，直白点讲：提供了操作日志的接口，而具体实现交由Logback、Log4j等日志实现框架，这样就可以实现程序与具体日志框架间的解耦，对于底层日志框架的改变，并不影响到上层的业务代码，可以灵活切换日志框架。

日志体系

现在日志框架众多：slf4j、jcl、jul、log4j、log4j2、logback等，它们之间存在什么样的关系，我们在开发过程中又如何选取这些日志框架呢？

首先，看下Java日志体系：

通过上图可以概括日志体系大致分为三层：日志接口门面层、绑定/桥接层以及日志实现层。

jcl-over-slf4j.jar(jcl -> slf4j):将commons-logging日志桥接到slf4jjul-to-slf4j.jar(jul -> slf4j):java.util.logging的日志桥接到slf4jlog4j-over-slf4j.jar(log4j -> slf4j):将log4j的日志，桥接到slf4jslf4j-log4j12.jar(slf4j -> log4j):slf4j绑定到log4j，所以这个包不能和log4j-over-slf4j.jar不能同时使用，会出现死循环slf4j-jcl.jar(slf4j -> jcl):slf4j绑定到commons-logging日志框架上slf4j-jdk14.jar(slf4j -> jul):slf4j绑定到jdk日志框架上，不能喝jul-to-slf4j.jar同时使用，会出现死循环slf4j-nop.jar:slf4j的空接口输出绑定，丢弃所有日志输出slf4j-simple.jar:slf4j自带的简单日志输出接口log4j-slf4j-impl.jar(slf4j -> log4j2):将slf4j绑定到log4j2日志框架上，不能和log4j-to-slf4j同时使用log4j-to-slf4j.jar(log4j2 -> slf4j):将log4j2日志桥接到slf4j上，不能和log4j-slf4j-impl同时使用

最为熟悉和使用率较高的log4j其实就位于日志实现层，即其为一种日志实现框架。既然log4j已经足够系统使用进行日志输出了，为啥还多此一举弄个日志接口门面层和绑定/桥接层？看下图：

系统A集成了模块A、模块B、模块C三个模块，但是这三个模块使用了不同的日志实现框架，现在系统A相当于同时存在了三个日志框架，那如何进行配置呢？每个框架都构建一个配置文件这种肯定是不行的，没法进行统一管理，日志较为混乱。

现在看下如何解决上述问题：

模块A、模块B、模块C采用slf4j日志接口框架，而非具体日志实现类，具体使用哪种日志实现框架是由系统A配置决定的，系统A把slf4j绑定到logback，则统一采用logback日志框架，slf4j绑定到log4j则统一采用log4j日志框架。日志接口 --> 日志绑定 --> 日志实现，日志接口和日志实现进行了解耦，模块只关注接口不关注实现，具体采用哪种实现是由其所在的系统环境决定，这样就可以实现日志的统一配置和管理。

对于上述解决方案，如果模块A、模块B、模块C是新开发统一采用slf4j日志接口框架没问题，但是对于旧系统，比如模块B、模块C都是很久之前开发的模块，分别采用了不同的日志实现框架，见下图：

如果系统A把slf4j绑定到logback日志框架上，但是模块B、模块C由于没有采用slf4j，绑定对于它们来说是无效的，这时候就要使用桥接。

桥接的大致结构如上图，通过桥接把log4j、jdk log等日志实现框架桥接到slf4j上，由于slf4j又被绑定到了logback上，则模块B和模块C最终会被logback纳管，而不是log4j和jdk log，同样可以实现日志统一配置管理。

以上就是项目开发中经常遇到的问题，以及绑定和桥接之间的区别。

spring体系中日志框架

Spring框架

Spring Framework 4.X及之前的版本，都是使用的标准版JCL日志框架，该依赖由spring-core间接引入。Spring框架的日志信息都是使用JCL标准接口来进行输出。下面说下项目中常碰到的三种情况：

使用spring 4.X及之前版本的框架时一定要注意上面情况，否则很容易出现业务日志输出正常，但是spring框架本身日志没有输出的情况，导致一些错误无法察觉或者不利于排查。

spring5.0带来了commons-logging桥接模块的封装，它被叫做spring-jcl而不是标准版jcl，无需添加额外依赖包，可自动检测绑定到Log4j2、SLF4J。

SpringBoot框架

springboot-1.X- springboot-2.X:

从SpringBoot框架可以看出，默认采用SLF4J+Logback组合的日志框架，通过桥接模式将其它日志框架桥接到SLF4J上。

SLF4J

SLF4J(Simple Logging Facade For Java)是一个为Java程序提供日志输出的统一接口，并不是一个具体的日志实现方案，就像我们经常使用的JDBC一样，只是了一些标准规范接口。因此，单独的SLF4J是不能工作的，它必须搭配其他具体的日志实现方案。

SLF4J和Logback是同一个作者开发的，所以Logback天然与SLF4J适配，不需要引入额外适配库。

这里还有个比较有意思的事情，SLF4J项目提供了很多适配库、桥接库，唯独没有提供对Log4j2的适配库和桥接库，不过Apache Logging项目组自己开发了：log4j-slf4j-impl和log4j-to-slf4j。

JCL

Jakarta commons-logging简称JCL，是apache提供的一个通用日志门面接口，最后版本更新停留在2014年，且默认只能提供对Log4j、Java Logging进行适配。

JCL已慢慢淡出人们的视线，一些历史遗留项目也开始慢慢由JCL转向SLF4J，如：Spring 5.0开始没有再依赖原生的JCL框架，SpringBoot默认采用SLF4J+Logback。SLF4J已经成为了Java日志组件的明星选手，可以完美替代JCL，使用JCL桥接库也能完美兼容一切使用JCL作为日志门面的类库，现在的新系统已经没有不使用SLF4J作为统一日志API接口层的理由了。

核心原理

SLF4J和JCL对比，二者最大区别在于它们的绑定机制的不同，这也决定了为什么JCL会被慢慢的淘汰掉的根本原因。

SLF4J绑定原理

1、slf4j定义好两个接口规范：

public interface LoggerFactoryBinder {    //获取一个ILoggerFactory实现类，采用工厂设计模式创建Logger    public ILoggerFactory getLoggerFactory();    public String getLoggerFactoryClassStr();}

public interface ILoggerFactory {    public Logger getLogger(String name);}

第一个接口LoggerFactoryBinder定义绑定类，如果日志框架需要和slf4j进行绑定，就要提供一个该接口实现类，并且名称是StaticLoggerBinder，这样，在slf4j模块中，使用StaticLoggerBinder.getSingleton();就可以获取到这个绑定类，进而通过StaticLoggerBinder绑定类的getLoggerFactory()获取到Logger生产工厂ILoggerFactory。

注意：这里的绑定机制利用到了类加载原理，如果存在多个绑定类StaticLoggerBinder，根据类路径的前后顺序，只有有一个会被加载进来，这个加载进来的就实现了绑定。

2、ILoggerFactory也是slf4j模块提供的一个接口，因为各个日志框架中LoggerFactory不统一，所以slf4j提供一个接口，让各个日志框架把自己的LoggerFactory包装成ILoggerFactory接口，这样slf4j模块下就可以统一使用。这里利用到的是设计模式中的：适配模式。系统间对接比较常用的一种设计模式，系统间接口不统一，通过适配模式实现一致。

3、可以看下，slf4j和log4j绑定使用slf4j-log4j12.jar，这个模块下StaticLoggerBinder实现见下：

public class StaticLoggerBinder implements LoggerFactoryBinder {    private static final StaticLoggerBinder SINGLETON = new StaticLoggerBinder();    public static final StaticLoggerBinder getSingleton() {        return SINGLETON;    }    public static String REQUESTED_API_VERSION = "1.6.99";     private static final String loggerFactoryClassStr = Log4jLoggerFactory.class.getName();    private final ILoggerFactory loggerFactory;    private StaticLoggerBinder() {        loggerFactory = new Log4jLoggerFactory();        try {            @SuppressWarnings("unused")            Level level = Level.TRACE;        } catch (NoSuchFieldError nsfe) {            Util.report("This version of SLF4J requires log4j version 1.2.12 or later. See also http://www.slf4j.org/codes.html#log4j_version");        }    }    public ILoggerFactory getLoggerFactory() {        return loggerFactory;    }    public String getLoggerFactoryClassStr() {        return loggerFactoryClassStr;    }}

4、StaticLoggerBinder：静态绑定，这个静态是相对于JCL所使用的动态绑定来说的，为什么说是静态的呢？因为你如果要绑定，需要在环境中添加绑定相关的jar，这样slf4j就可以加载到绑定包中的StaticLoggerBinder类实现绑定。

接口和实现类之间采用一种松耦合的设计，有利于灵活的扩展，但是在使用时有需要一种技术把它们关联起来，这是软件设计中比较常用到的设计思想，JDK 1.6对此专门提供了一种技术：SPI。SLF4J从1.8版本起，也开始使用SPI方式实现绑定，而不再采用通过寻找指定类StaticLoggerBinder的方式进行绑定。下面代码就是slf4j-1.8中使用SPI进行绑定核心代码：

private static List findServiceProviders() {    ServiceLoader serviceLoader = ServiceLoader.load(SLF4JServiceProvider.class);    List providerList = new ArrayList();    for (SLF4JServiceProvider provider : serviceLoader) {        providerList.add(provider);    }    return providerList;}

SLF4JServiceProvider就是类似于上面的LoggerFactoryBinder接口，通过它可以获取到ILoggerFactory，这样其它日志框架和slf4j进行集成时只需要提供一个SLF4JServiceProvider接口的实现类即可，不再要求必须是像之前固定名称必须是：StaticLoggerBinder，固定名称带来的一个问题是包路径也要一致，无形中存在侵入性，而使用SPI方式更加的灵活。比如我们常用到的JDBC也使用到SPI，感兴趣的可以多了解下，对系统设计还是比较实用的一种技术。

JCL绑定原理

JCL采用动态绑定机制，缺点是容易引发混乱，在一个复杂甚至混乱的依赖环境下，确定当前正在生效的日志服务是很费力的，特别是在程序开发和设计人员并不理解JCL的机制时。

JCL动态绑定的核心逻辑位于LogFactoryImpl类的discoverLogImplementation方法中如下代码块：

for(int i=0; i

String[] classesToDiscover = {            "org.apache.commons.logging.impl.Log4JLogger",            "org.apache.commons.logging.impl.Jdk14Logger",            "org.apache.commons.logging.impl.Jdk13LumberjackLogger",            "org.apache.commons.logging.impl.SimpleLog"};