SLF4J使用简介

本文目录

1 SLF4J简介

2 SLF4J相关包

3 绑定规则

4 配置及使用

5 相关文章

---

1 SLF4J简介

Slf4J（Simple Logging Façade for Java），即简单日志门面，提供统一的日志调用接口，但并未提供相应的具体实现。

应用程序启动时，动态绑定具体的日志框架，例如：log4j、logback、java.util.logging等。

2 SLF4J相关包

slf4j-api（SLF4J API Module）

提供统一接口

slf4j-simple（SLF4J Simple Binding）

提供SLF4J简单的接口实现，默认将日志信息输出至控制台，可通过SimpleLogger进行行为配置。

slf4j-log4j12（SLF4J Log4J 12 Binding）

提供绑定接口实现类，在接口中绑定Log4J日志框架（依赖Log4J相应包）。

slf4j-jcl（SLF4J JCL Binding）

提供绑定接口实现类，在接口中绑定Commons Logging日志框架。

jcl-over-slf4j（JCL 1.2 Implemented Over SLF4J）

使用jcl-over-slf4j.jar替换commons-logging.jar，无需修改原来的日志代码，即可从JCL迁移至SLF4J框架。

通过实现JCL的接口，底层转调SLF4J的接口，达到迁移目的。

log4j-over-slf4j（Log4J Implemented Over SLF4J）

使用log4j-over-slf4j.jar替换log4j.jar，无需修改原来的日志代码，即可从Log4J迁移至SLF4J框架。

通过实现Log4J的接口，底层转调SLF4J的接口，达到迁移目的。

注意：

（1）用于替换Log4J（旧版本），而不是替换Log4J2（新版本）。

（2）若Log4J是通过配置文件进行配置，该迁移生效；若直接通过调用代码进行配置，该迁移无法生效。

jul-to-slf4j（JUL To SLF4J Bridge）

不同于上述两种迁移方式，jul-to-slf4j.jar并不能替换java.util.logging.jar，而是将所有来自jul的记录转至slf4j接口，所以，这种伪迁移会消耗一定资源。

3 绑定规则

1、在classpath中寻找org/slf4j/impl/StaticLoggerBinder.class文件，即寻找实现了绑定接口的类，在接口的实现方法中，完成日志接口绑定操作。

2、若找到多个org/slf4j/impl/StaticLoggerBinder.class文件，即检测到冲突，抛出异常。

下列包都实现了上述绑定接口，同时存在会发生冲突（包括，但不限于）：

slf4j-simple.jar

slf4j-log4j12.jar

slf4j-jcl.jar

log4j-slf4j-impl.jar

logback-classic.jar

4 配置及使用

（1）依赖项：slf4j-api、slf4j-log4j12（或log4j-slf4j-impl）、log4j2相关包

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>${slf4j.version}</version>
</dependency>

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

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-core</artifactId>
    <version>${log4j.version}</version>
</dependency>

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-api</artifactId>
    <version>${log4j.version}</version>
</dependency>

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-web</artifactId>
    <version>${log4j.version}</version>
</dependency>  

（2）使用示例：

private static final Logger logger = LoggerFactory.getLogger(Xxxx.class);
logger.info("Message");

使用手册：SLF4J Manual

5 相关文章

《Log4j2使用简介》