阿里巴巴开发手册强制使用SLF4J作为门面担当的秘密，被我发现了

系统管理员 2021-05-12 11:50 253阅读 0赞

之前已经详细、全面地介绍了 [Log4j][]，相信小伙伴们已经完全掌握了。那我在读嵩山版的阿里巴巴开发手册（没有的小伙伴，记着找我要）的时候，就发现了一条「**强制**」性质的日志规约：

> 应用中不可以直接使用日志系统（Log4j、Logback）中的 API，而应该使用日志框架中的 API，比如说 SLF4J，使用门面模式的日志框架，有利于维护和统一各个类的日志处理方式。

（为什么我把这段文字手敲了下来呢，因为我发现阿里巴巴开发手册上的有语病，瞧下面红色标出的部分）

![2d3efe3b45c73ac4377c147c56fd77f8.png][]

（维护和统一，把统一放在最后面读起来真的是别扭，和的有点牵强，请问手册的小编是数学老师教的语文吧？）

![eb9903d48b8ad6992457c30ab0941247.png][]

那看到这条强制性的规约，我就忍不住想要问：“为什么阿里巴巴开发手册会强制使用 SLF4J 作为 Log4J 的门面担当呢？”究竟这背后藏了什么“不可告人”的秘密？

（请小伙伴们自行配上 CCTV 12 台的那种 BGM）

PS：顺带给小伙伴们普及一点小知识，阿里巴巴开发手册上出现的 Jakarta 其实是 Apache 软件基金会下的一个开源项目。其实 Commons 是以前隶属于 Jakarta，现在是作为 Apache 下的一个单独项目，阿里巴巴开发手册上的描述已经不太恰当了，换成是 Apache Commons Logging 会更合适一点。

（忍不住又给阿里巴巴开发手册挑了一个毛病，请原谅我“一丝不苟”的做事态度）

### 01、SLF4J 是什么 ###

SLF4J 是 Simple Logging Facade for Java 的缩写（for≈4），也就是简易的日志门面，以外观模式（Facade pattern，一种设计模式，为子系统中的一组接口提供一个统一的高层接口，使得子系统更容易使用）实现，支持 java.util.logging、Log4J 和 Logback。

SLF4J 的作者就是 Log4J 和 Logback 的作者，他的 GitHub 主页长下面这样：

![86412b89b39fa69ca3e1ee13c7143677.png][]

一股秋风瑟瑟的清冷感扑面而来，有没有？可能巨佬不屑于维护他的 GitHub 主页吧？我的 GitHub 主页够凄惨了，没想到巨佬比我还惨，终于可以吹牛逼地说，“我，沉默王二，GitHub 主页比 SLF4J、Log4J 和 Logback 的作者 Ceki Gulcu 绿多了。。。。。。”

![2c8ac8443378e338052c4dfb444a5cc6.png][]

1996 年初，欧洲安全电子市场项目决定编写自己的跟踪 API，最后该 API 演变成了 Log4j，已经推出就备受宠爱。

2002 年 2 月，Sun 推出了自己的日志包 java.util.logging（可称 JUL），据说实现思想借鉴了 Log4j，毕竟此时的 Log4j 已经很成熟了。

2002 年 8 月，Apache 就推出了自己的日志包，也就是阿里巴巴开发手册上提到的 JCL（Jakarta Commons Logging）。JCL 的野心很大，它在 JUL 和 Log4j 的基础上提供了一个抽象层的接口，方便使用者在 JUL 和 Log4j 之间切换。

![3fbfe327204cceb6f56f7909db452371.png][]

但 JCL 好像并不怎么招人喜欢，有人是这样抱怨的：

![882022a12b1efe1d8e0ea224872cbcbe.png][]

Ceki Gulcu 也觉得 JCL 不好，要不然他也不会在 2005 年自己撸一个名叫 SLF4J 的新项目，对吧？但出来混总是要付出代价的，SLF4J 只有接口，没有实现，总不能强逼着 Java 和 Apache 去实现 SLF4J 接口吧？这太难了，不现实。

但巨佬之所以称之为巨佬，是因为他拥有超出普通人的惊人之处，他在 SLF4J 和 JUL、Log4j、JCL 之间搭了三座桥：

![fbc36b87874ba6e46b68dc905715f5fd.png][]

巨佬动手，丰衣足食，有没有？狠起来连自己的 Log4j 都搭个桥。

面对巨佬的霸气，我只想弱弱地说一句，“ SLF4J 这个门面担当，你以为好当的啊？”

### 02、SLF4J 解决了什么痛点 ###

春秋战国的时候，每个国家都有自己的货币，用别国的货币也不合适，对吧？那在发生贸易的时候就比较麻烦了，货币不统一，就没法直接交易，因为货币可能不等价。

那秦始皇统一六国后，就推出了新的货币政策，全国都用一种货币，那之前的问题就解决掉了。

你看，同样的道理，日志系统有 JUL、JCL，Ceki Gulcu 自己又写了 2 种，Log4j 和 Logback，各有各的优缺点，再加上使用者千千万，萝卜白菜各有所爱，这就导致不同的应用可能会用不同的日志系统。

假设我们正在开发一套系统，打算用 SLF4J 作为门面，Log4j 作为日志系统，我们在项目中使用了 A 框架，而 A 框架的门面是 JCL，日志系统是 JUL，那就相等于要维护两套日志系统，对吧？

![eaa3789ecba96f07001956ff1e4e577c.png][]

这就难受了！

Ceki Gulcu 想到了这个问题，并且帮我们解决了！来看 SLF4J 官网给出的解决方案。

![901feedc72d795be8b26fa4677504c1a.png][]

*  使用 jcl-over-slf4j.jar 替换 commons-logging.jar
 *  引入 jul-to-slf4j.jar

为了模拟这个过程，我们来建一个使用 JCL 的项目。

第一步，在 pom.xml 文件中引入 commons-logging.jar：

<dependency>
        <groupId>commons-logging</groupId>
        <artifactId>commons-logging</artifactId>
        <version>1.2</version>
    </dependency>

第二步，新建测试类：

package com.itwanger;
    
    import org.apache.commons.logging.Log;
    import org.apache.commons.logging.LogFactory;
    
    /** * @author 微信搜「沉默王二」，回复关键字 PDF */
    public class Demo { 
        private static Log logger = LogFactory.getLog(Demo.class);
        public static void main(String[] args) { 
            logger.info("jcl");
        }
    }

该类会通过 LogFactory 获取一个 Log 对象，并且使用 `info()` 方法打印一行日志。

调试这段代码的过程中你会发现，Log 的实现有四种：

![0196e9f64f69e6af560089a20461e175.png][]

如果没有绑定 Log4j 的话，就会默认选择 Jdk14Logger——它返回的 Logger 对象，正是 java.util.logging.Logger，也就是 JUL。

因此，就可以在控制台看到以下信息：

10月 21, 2020 3:13:30 下午 com.itwanger.Demo main
    信息: jcl

怎么把使用 JCL 的项目改造成使用 SLF4J 的呢？

第三步，使用 jcl-over-slf4j.jar 替换 commons-logging.jar，并加入 jul-to-slf4j.jar、slf4j-log4j12.jar（会自动引入 slf4j-api.jar 和 log4j.jar）：

第四步，在 resources 目录下创建 log4j.properties 文件，内容如下所示：

### 设置###
    log4j.rootLogger = debug,stdout,D
    
    ### 输出信息到控制台 ###
    log4j.appender.stdout = org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.Target = System.out
    log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
    
    ### 输出DEBUG 级别以上的日志到=debug.log ###
    log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
    log4j.appender.D.File = debug.log
    log4j.appender.D.Append = true
    log4j.appender.D.Threshold = DEBUG 
    log4j.appender.D.layout = org.apache.log4j.PatternLayout
    log4j.appender.D.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

再次运行 Demo 类，你会发现 target 目录下会生成一个名叫 debug.log 的文件，内容如下所示：

2020-10-21 15:32:06  [ main:0 ] - [ INFO ]  jcl

并且可以在控制台看到以下信息：

[INFO ] 2020-10-21 15:32:06,192 method:com.itwanger.Demo.main(Demo.java:12)
    jcl

仔细对比一下，你就会发现，这次输出的格式和之前不一样，这就是因为 Log4j 和 JUL 的日志格式不同导致的。

另外，你有没有发现？我们并没有改动测试类 Demo，它里面使用的仍然是 JCL 获取 Log 的方式：

private static Log logger = LogFactory.getLog(Demo.class);

但输出的格式已经切换到 Log4j 了！

SLF4J 除了提供这种解决方案，绑定 Log4j 替换 JUL 和 JCL；还提供了绑定 Logback 替换 JUL、JCL、Log4j 的方案：

![1c3830ae7c98dec8e022f7f795ef0db5.png][]

还有绑定 JUL 替换 JCL 和 Log4j 的方案：

![0cdf04425f9bcab96b013fef4f75ebee.png][]

太强了，有木有？有的话请在留言区敲出 666。

![d992f6d0f3939ba906996bedf64ed201.png][]

### 03、SLF4J 比 Log4J 强在哪 ###

SLF4J 除了解决掉以上的痛点，帮助我们的应用程序独立于任何特定的日志系统，还有一个非常牛逼的功能，那就是 SLF4J 在打印日志的时候使用了占位符 `{}`，它有点类似于 String 类的 `format()` 方法（使用 `%s` 等填充参数），但更加便捷，这在很大程度上提高了程序的性能。

众所周知，字符串是不可变的，字符串拼接会创建很多不必要的字符串对象，极大的消耗了内存空间。但 Log4J 在打印带参数的日志时，只能使用字符串拼接的方式：

String name = "沉默王二";
    int age = 18;
    logger.debug(name + "，年纪：" + age + "，是个非常不要脸的程序员");

非常笨重，但加入了 SLF4J 后，这个问题迎刃而解。我们来看一下在 Log4j 项目中加入 SLF4J 的详细的步骤。

第一步，把 log4j 的依赖替换为 slf4j-log4j12（Maven 会自动引入 slf4j-api.jar 和 log4j.jar）：

第二步，在 resources 目录下创建 log4j.properties 文件，内容和 [Log4j 那一篇][Log4j]完全相同：

### 设置###
    log4j.rootLogger = debug,stdout,D,E
    
    ### 输出信息到控制台 ###
    log4j.appender.stdout = org.apache.log4j.ConsoleAppender
    log4j.appender.stdout.Target = System.out
    log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
    log4j.appender.stdout.layout.ConversionPattern = [%-5p] %d{yyyy-MM-dd HH:mm:ss,SSS} method:%l%n%m%n
    
    ### 输出DEBUG 级别以上的日志到=debug.log ###
    log4j.appender.D = org.apache.log4j.DailyRollingFileAppender
    log4j.appender.D.File = debug.log
    log4j.appender.D.Append = true
    log4j.appender.D.Threshold = DEBUG 
    log4j.appender.D.layout = org.apache.log4j.PatternLayout
    log4j.appender.D.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n
    
    ### 输出ERROR 级别以上的日志到=error.log ###
    log4j.appender.E = org.apache.log4j.DailyRollingFileAppender
    log4j.appender.E.File =error.log 
    log4j.appender.E.Append = true
    log4j.appender.E.Threshold = ERROR 
    log4j.appender.E.layout = org.apache.log4j.PatternLayout
    log4j.appender.E.layout.ConversionPattern = %d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

第三步，新建测试类：

package com.itwanger;
    
    import org.slf4j.Logger;
    import org.slf4j.LoggerFactory;
    
    /** * @author 微信搜「沉默王二」，回复关键字 PDF */
    public class Log4jSLF4JDemo { 
        private static final Logger logger = LoggerFactory.getLogger(Log4jSLF4JDemo.class);
    
        public static void main(String[] args) { 
            logger.debug("{}，是个非常不要脸的程序员","沉默王二");
        }
    }

看到了吧，使用占位符要比“+”操作符方便的多。并且此时不再需要 `isDebugEnabled()` 先进行判断，`debug()` 方法会在字符串拼接之前执行。

![cf1e6e19d1c68f00cf0afef6936b53ec.png][]

如果只是 Log4J 的话，会先进行字符串拼接，再执行 `debug()` 方法，来看示例代码：

String name = "沉默王二";
    int age = 18;
    logger.debug(name + "，年纪：" + age + "，是个非常不要脸的程序员");

在调试这段代码的时候，你会发现的，如下图所示：

![288929717a6046f8daa16953ce71b510.png][]

这也就意味着，如果日志系统的级别不是 DEBUG，就会多执行了字符串拼接的操作，白白浪费了性能。

注意，阿里巴巴开发手册上还有一条「**强制**」级别的规约：

![5ad3b96dbbaa6347f17ff73fb21e71db.png][]

这是因为如果参数是基本数据类型的话，会先进行自动装箱（`Integer.valueOf()`）。测试代码如下所示：

logger.debug("沉默王二，{}岁", 18);

通过反编译工具就可以看得到：

logger.debug("\u6C89\u9ED8\u738B\u4E8C\uFF0C{}\u5C81", Integer.valueOf(18));

如果参数需要调用其他方法的话，`debug()` 方法会随后调用。

![ce1f27d094c70fd16f337d74b48b9951.png][]

也就是说，如果不 `isDebugEnabled()` 的话，在不是 DEBUG 级别的情况下，会多执行自动装箱和调用其他方法的操作——程序的性能就下降了！

测试类运行的结果和之前 Log4J 的一样，小伙伴们可以点击链接跳转到 [Log4j 那篇][Log4j]对比下。

### 04、总结 ###

简单总结一下这篇文章哈。

1）在使用日志系统的时候，一定要使用 SLF4J 作为门面担当。

2）SLF4J 可以统一日志系统，作为上层的抽象接口，不需要关注底层的日志实现，可以是 Log4j，也可以是 Logback，或者 JUL、JCL。

3）SLF4J 在打印日志的时候可以使用占位符，既提高了程序性能（临时字符串少了，垃圾回收的工作量就小），又让代码变得美观统一。

4）小伙伴们如果知道更多秘密的话，建议在留言区贴出来哦。

![96c81d3431114109df104e4da397cff3.png][]

嗯哼，其实我已经写完了整个日志系统，包括 Log4j、 SLF4J、Logback、Log4j 它弟 Log4j 2，但我觉得分开来发的话，更利于 SEO（瞧我这为了流量的心机，手动狗头）。如果你确实需要看完整版的话，我也贴心地为你准备了，点击下面的链接就可以下载 PDF：

> [https://pan.baidu.com/s/1dPwsQhT5OMVapE7hGi7vww][https_pan.baidu.com_s_1dPwsQhT5OMVapE7hGi7vww] 提取码:fxxy

码字不易，日常求个赞吧，动一动金手指，bug 少一个（逃。

[Log4j]: https://mp.weixin.qq.com/s/AXgNnJe8djD901EmhFkWUg
[2d3efe3b45c73ac4377c147c56fd77f8.png]: /images/20210511/ef880bb949024283aeeb020ba77f4713.png
[eb9903d48b8ad6992457c30ab0941247.png]: /images/20210511/ea05d7adbde146d59d493b19ab4b5d3f.png
[86412b89b39fa69ca3e1ee13c7143677.png]: /images/20210511/aa297defb28f4a09937917b49435e008.png
[2c8ac8443378e338052c4dfb444a5cc6.png]: /images/20210511/3b443f83e07b4f94adc6e216b08849a6.png
[3fbfe327204cceb6f56f7909db452371.png]: /images/20210511/709c6704effc493f965710d9cd77e3aa.png
[882022a12b1efe1d8e0ea224872cbcbe.png]: /images/20210511/e7241be875b94ef5af7d1047b8314a33.png
[fbc36b87874ba6e46b68dc905715f5fd.png]: /images/20210511/38172a0ac201452bba3a3af13043a9c0.png
[eaa3789ecba96f07001956ff1e4e577c.png]: /images/20210511/3e5ad17d59564cb1a2b0b1e7a84f6455.png
[901feedc72d795be8b26fa4677504c1a.png]: /images/20210511/86bf339e28bb4456b49b8c92e0f4357f.png
[0196e9f64f69e6af560089a20461e175.png]: /images/20210511/9d1a31db3f094bdf9ef793359933b188.png
[1c3830ae7c98dec8e022f7f795ef0db5.png]: /images/20210511/d8c2eb54d8bd4d0c9f7a12f07c061ed9.png
[0cdf04425f9bcab96b013fef4f75ebee.png]: /images/20210511/39c8cef5fd504dc7a2b4e393b78e2650.png
[d992f6d0f3939ba906996bedf64ed201.png]: /images/20210511/124430b2e76b41f196d703c579e4f894.png
[cf1e6e19d1c68f00cf0afef6936b53ec.png]: /images/20210511/8d0b8f7394f64ca9b38caaaefb7c1747.png
[288929717a6046f8daa16953ce71b510.png]: /images/20210511/9cdf77b952714780beefd07bf924c8d7.png
[5ad3b96dbbaa6347f17ff73fb21e71db.png]: /images/20210511/b5c80c2b0606490ea746ff6eaf969e2f.png
[ce1f27d094c70fd16f337d74b48b9951.png]: /images/20210511/3e993bc96a1848fe86cc33a931bd0ad6.png
[96c81d3431114109df104e4da397cff3.png]: /images/20210511/03ebbf6b67854b4faf14397f5a57d281.png
[https_pan.baidu.com_s_1dPwsQhT5OMVapE7hGi7vww]: https://pan.baidu.com/s/1dPwsQhT5OMVapE7hGi7vww