SLF4J简介与使用(整合log4j)

1、概念
SLF4J的全称是Simple Logging Facade for Java，即简单日志门面。SLF4J并非具体的日志框架，而是做为一个简单门面服务于各种日志框架，如java.util.logging, logback和log4j。

SLF4J提供了统一的记录日志的接口，对不一样日志系统的具体实现进行了抽象化，只要按照其提供的方法记录便可，最终日志的格式、记录级别、输出方式等经过绑定具体的日志系统来实现。

使用SLF4J的好处在于，你只须要按统一的方式写记录日志的代码，如：

public class LoggerTest {

    private static final Logger logger = LoggerFactory.getLogger(Tester.class);

    public static void main(String[] args) {
        logger.info("Current Time: {}", System.currentTimeMillis());
    }
}

SLF4J支持{}做为占位符，等价于C语言中的%s，而没必要再进行字符串的拼接，效率有显著的提高（见后面运行结果）。

而无需关心日志是经过哪一个日志系统，以什么风格输出的。由于它们取决于部署项目时绑定的日志系统。 
例如，在项目中使用了SLF4J记录日志，而且绑定了log4j，则日志会以log4j的风格输出；后期须要改成以logback的风格输出日志，只须要将log4j替换成logback便可，不用修改项目中的代码。

2、依赖
SLF4J绑定各种日志框架的原理图：

由上图可知，使用SLF4J依赖于slf4j-api-1.8.0-alpha2.jar，部署时还依赖于要绑定的日志系统的jar包和相应的适配器jar包。

以绑定log4j为例，须要导入如下包：

slf4j-api-1.8.0-alpha2.jar
log4j-1.2.17.jar
slf4j-log4j12-1.8.0-alpha2.jar
若是使用Maven，则只需添加适配器jar包依赖便可：

<dependency> 
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.8.0-alpha2</version>
</dependency>

3、使用示例
这里以SLF4J + log4j为例。

1.在pom.xml中添加依赖（或者手动导入上述3个jar包）：

<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-log4j12</artifactId>
  <version>1.8.0-alpha2</version>
</dependency>

2.配置log4j
在类路径下建立log4j.properties配置文件，这样log4j会自动加载配置文件。

# rootLogger参数分别为：根Logger级别，输出器stdout，输出器log
log4j.rootLogger = info,stdout,log

# 输出信息到控制台
log4j.appender.stdout = org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern = %d [%-5p] %l %rms: %m%n

# 输出DEBUG级别以上的日志到D://logs/debug.log
log4j.appender.log = org.apache.log4j.DailyRollingFileAppender
log4j.appender.log.DatePattern = '.'yyyy-MM-dd
log4j.appender.log.File = D://debug.log
log4j.appender.log.Encoding = UTF-8
#log4j.appender.log.Threshold = INFO
log4j.appender.log.layout = org.apache.log4j.PatternLayout
log4j.appender.log.layout.ConversionPattern = %d [%-5p] (%c.%t): %m%n

将log4j.properties放在类路径下是最简单的作法，固然也能够经过PropertyConfigurator在代码中加载或者经过web.xml加载。3.测试代码

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class LoggerTest {

    private static final Logger logger = LoggerFactory.getLogger(LoggerTest.class);

    public static void main(String[] args) {
        logger.info("Current Time: {}", System.currentTimeMillis());
        logger.info("Current Time: " + System.currentTimeMillis());
        logger.info("Current Time: {}", System.currentTimeMillis());
        logger.trace("trace log");
        logger.warn("warn log");
        logger.debug("debug log");
        logger.info("info log");
        logger.error("error log");
    }
}

4.运行结果

2017-06-16 23:11:05,490 [INFO ] com.jiapengcs.demos.slf4j.LoggerTest.main(LoggerTest.java:14) 0ms: Current Time: 1497625865488
2017-06-16 23:11:05,493 [INFO ] com.jiapengcs.demos.slf4j.LoggerTest.main(LoggerTest.java:15) 3ms: Current Time: 1497625865493
2017-06-16 23:11:05,493 [INFO ] com.jiapengcs.demos.slf4j.LoggerTest.main(LoggerTest.java:16) 3ms: Current Time: 1497625865493
2017-06-16 23:11:05,495 [WARN ] com.jiapengcs.demos.slf4j.LoggerTest.main(LoggerTest.java:18) 5ms: warn log
2017-06-16 23:11:05,495 [INFO ] com.jiapengcs.demos.slf4j.LoggerTest.main(LoggerTest.java:20) 5ms: info log
2017-06-16 23:11:05,495 [ERROR] com.jiapengcs.demos.slf4j.LoggerTest.main(LoggerTest.java:21) 5ms: error log

一般输出日志开销很是大，从上述结果可见，SLF4J经过{}做为占位符的方式输出字符串，相比字符串拼接的方式，效率有显著的提高。

5.更换日志系统
看到这里，你可能会有疑问：既然都用了log4j，为何还要用SLF4J来写记录日志的代码呢，不是画蛇添足吗？

答案是否认的。假设咱们再也不须要log4j，而是但愿改成使用java自带logging记录日志，咱们须要作的仅仅是将pom.xml的依赖项slf4j-log4j12改成slf4j-jdk14便可，无需对上述测试代码作任何修改。

<dependency>
  <groupId>org.slf4j</groupId>
  <artifactId>slf4j-jdk14</artifactId>
  <version>1.8.0-alpha2</version>
</dependency>

是的，就是这么简单。再次运行测试代码：

六月 16, 2017 10:32:30 下午 com.jiapengcs.demos.slf4j.LoggerTest main
信息: Current Time: 1497623550843
六月 16, 2017 10:32:30 下午 com.jiapengcs.demos.slf4j.LoggerTest main
信息: Current Time: 1497623550874
六月 16, 2017 10:32:30 下午 com.jiapengcs.demos.slf4j.LoggerTest main
信息: Current Time: 1497623550875
六月 16, 2017 10:32:30 下午 com.jiapengcs.demos.slf4j.LoggerTest main
警告: warn log
六月 16, 2017 10:32:30 下午 com.jiapengcs.demos.slf4j.LoggerTest main
信息: info log
六月 16, 2017 10:32:30 下午 com.jiapengcs.demos.slf4j.LoggerTest main
严重: error log

咱们发现，此时日志已经变为以logging的方式输出。

4、总结
SLF4J的使用很是简单，甚至连官网上都说鉴于它过轻量，文档篇幅不长。

Given the small size of SLF4J, its documentation is not very lengthy.

在《阿里巴巴Java开发手册(正式版)》中，日志规约一项第一条就强制要求使用SLF4J：

1.【强制】应用中不可直接使用日志系统（Log4j、Logback）中的API，而应依赖使用日志框架SLF4J中的API，使用门面模式的日志框架，有利于维护和各个类的日志处理方式统一。

因此从如今开始使用SLF4J吧！