Simple Logging Facade for Java(简单日志门面--门面一词总觉有些别扭,还没找到更好的词),简称 SLF4J,是作为各种日志框架的简单门面或者抽象的。比如,那些日志框架有 java.util.logging, log4j 和 logback 等,SLF4j 允许终端用户在部署的时候插入自己想要的日志框架。
Hello World
依照编程的传统,这个例子描绘了简单的方式来使用 SLF4j 输出 "Hello world"。它从获得一个名为 "HelloWorld" 的 logger 开始。接着使用这个 logger 输出 "Hello World" 日志消息。
import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class HelloWorld { public static void main(String[] args) { Logger logger = LoggerFactory.getLogger(HelloWorld.class); logger.info("Hello World"); } }
要运行上面的例子,你首先需要下载 slf4j 的发行包,然后解压。完了之后,把下面两个 jar 文件加到你的类路径上:
● slf4j-api-1.5.11.jar
● slf4j-simple-1.5.11.jar
编译并运行 HelloWorld,将会在控制台打印出如下输出。
0 [main] INFO HelloWorld - Hello World
典型使用模式
下面的示例代码说明了 SLF4J 的典型使用模式。注意到在 15 行使用了 {} 占位符。可参考 FAQ 中的问题 "什么是日志最快捷的方式" 得到更详细的说明。
import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class Wombat { final Logger logger = LoggerFactory.getLogger(Wombat.class); Integer t; Integer oldT; public void setTemperature(Integer temperature) { oldT = t; t = temperature; logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT); if (temperature.intValue() > 50) { logger.info("Temperature has risen above 50 degrees."); } } }
在部署时和某个日志框架进行绑定
以前面提到过,SLF4J 支持多种日志框架。SLF4J 发行包中自带几个 jar 文件作为 "SLF4J bindings" 的参考。
slf4j-nop-1.5.11.jar
绑定到 NOP,沉默的忽略掉所有的日志
slf4j-simple-1.5.11.jar
绑定到 Simple 实现,输出所有的事件到 System.err。只有 INFO 或更高级别的信息才会被打印出来。
这种绑定方式对于小应用程序是很有用的。
slf4j-log4j12-1.5.11.jar
绑定 1.2 版的 log4j,一个被广泛使用的日志框架。需要你把 log4j.jar 放置到你的类路径下。
slf4j-jdk14-1.5.11.jar
绑定 java.util.logging, 它也是 JDK 1.4 日志的参考实现(例子)
绑定 Jakarta Commons Logging. 这种绑定会把所有的 SLF4J 日志代理到 JCL。
还有由 SLF4J 绑定而发展出来的项目,如 logback,它自身实现了 SLF4J。Logback 的ch.qos.logback.classic.Logger 类就是直接实现了 SLF4J 的 org.slf4j.Logger 接口的。因此,联合使用 SLF4J 和 logback 可以完全的解决零内存和计算负载的问题。
想要切换日志框架的话,仅仅是替换掉类路径下的 slf4j 绑定。例如,将要从ava.util.logging 切换到 log4j,只需要用 slf4j-log4j12-1.5.11.jar 替换掉 slf4j-jdk14-1.5.11.jar。
SLF4J 不依赖于任何的类加载器机制。实际上,每一个 SLF4J 绑定都会在编译时使用一种也只能使用一种特定日志框架。例如,slf4j-log4j12-1.5.11.jar 绑定会在编译时使用 log4j。在你的代码中,除了 slf4j-api-1.5.11.jar 之外,你只需简单的把你选择的一个且只能一个绑定放到正确的类路径下。不要在你的类路径上放置超过了一个的绑定。这里图形化描述了这一大意。
SLF4J 接口和它的各种适配器相当的简单。多数熟悉 Java 语言的开发者应当能在一个小时内读懂并完全理解它的代码。不需要类加载器相关的知识也能用好它,它不会直接涉及到类加载器。因而,要是 SLF4J 遇到类加载器或是内存溢出的问题,应该去查查是否是 Jakarta Commons Logging(JCL) 造成的。
组件和库
广泛发布的组件和库的作者不会在他们的代码中使用 SLF4J 接口,这是以避免在组件和库的终端用户上导入日志框架。他或是她也许会在部署时通过往类路径上插入想要的 slf4j 绑定来选择所要日志框架,这也可以在尔后在类路径上用另一个来替换当前的绑定,然后重启应用。这种方法已被证明是简单且很具鲁棒性的。
通过 SLF4J 统一日志
经常地,一个给定的项目用到了各种组件,它们依赖了非 SLF4J 的不同日志 API。一般会发现项目混搭使用了 JCL、java.util.logging、log4j 和 SLF4J。这时个要把日志统一到单一通道上是令人向往的。SLF4J 通过提供桥接到 JCL、java.util.logging 和 log4j 的模块恰好满足了这一通用需求。更详细信息,请参看页面 Bridging legacy APIs。
线程映射表(MDC) 支持
"Mapped Diagnostic Context" (有译作线程映射表)实质上就是一日志框架维护的 map,日志框架通过提供了的键值对向其中插入日志信息。
SLF4J 支持 MDC,或者说线程映射表。如果下层日志框架提供 MDC 特性,那么 SLF4J 将会把 MDC 支持委派给下层框架 。注意,当前只有 log4j 和 logbak 具有 MDC 特性。要是下层框架不提供 MDC 支持的话,比如 java.util.logging, SLF4J 仍将会存储 MDC 数据,但是需要用户定制代码来获取那些信息。
因此,作为一个 SLF4J 用户,想要得到 MDC 优点的话就要用到 log4j 或者 logback,但也不会强制这些框架与你的用户间产生依赖。
更多 MDC 的相关信息,请参见 logback 手册的 MDC 章节。
行动纲要
部署时选择你的日志框架 | 在部署时通过在你的类路径上放上相应的 jar 文件就可以插入你想要的日志框架. |
快速失败操作 | 由于是 JVM 决定的类加载方式, 所经框架绑定会在一开始就被自动校验. SLF4J 在不存在绑定的时候以警告提示而放弃执行. |
绑定流行的日志框架 | SLF4J 支持流行的日志框架, 例如 log4j, java.util.logging, Simple logging 和 NOP. logback 项目原生的支持 SLF4J. |
桥接到遗留 API | JCL over SLF4J 实现, 如 jcl-over-slf4j.jar, 允许你的项目逐步迁移到到 SLF4J , 不会破坏现有软件使用 JCL 的兼容性. 类似的, log4j-over-slf4j.jar 和 jul-to-slf4j 模块允许你各自转换 log4j 和 java.util.logging 到 SLF4J 来. 详细信息,参看页面 B桥接遗留 API. |
迁移你的源代码 | slf4j-migrator 工具能帮助迁移你的源代码来使用 SLF4J. |
支持参数化日志信息 | 所有的 SLF4J 绑定都支持参数化日志信息,这可以显著地 改善性能. |
本文链接 http://unmi.cc/new-common-logging-slf4j-guide/, 来自 隔叶黄莺 Unmi Blog
相关推荐
SLF4J(Simple Logging Facade for Java)是Java日志框架的一个抽象层,它提供了一个API,允许开发者选择自己偏好的日志实现,如Log4j、Java Util Logging、Logback等。SLF4J的主要目标是为各种日志框架提供一个简单...
2. **配置Log4j**:创建一个`log4j.properties`或`log4j.xml`文件,定义日志级别、输出格式、目的地等。例如: ```properties log4j.rootLogger=DEBUG, stdout, file log4j.appender.stdout=org.apache.log4j....
常用日志框架章节二:JUL1. 快速入门2. 日志级别3. Logger直接父子关系4. 配置文件5. 原理解析章节三:Log4j1. 快速入门2. Log4j组件解析3. Layout格式4. Appender输出5. 自定义Logger章节四:JCL1. 快速入门2. ...
**日志框架Log4j详解** 日志框架在软件开发中扮演着至关重要的角色,它提供了记录应用程序运行过程中的各种信息、错误和调试细节的功能。Log4j是Apache组织开发的一个开源日志组件,广泛应用于Java平台。这篇教程将...
Logback是一个日志框架,它与Log4j可以说是同类的日志框架。Logback的主要特点是高性能、灵活性高、可扩展性强、易于使用和维护。 2.2. Slf4j+Logback 的快速实践 Slf4j是一个通用的日志门面接口,Logback是Slf4j...
Log4j是Apache组织提供的一款广泛使用的开源日志框架,适用于Java应用程序。本资料包包含了关于Log4j的详细学习资源,包括文档、PPT以及一个简单的入门工程,帮助初学者快速掌握Log4j的使用。 **1. Log4j基础概念**...
Spring Boot 的一个主要特性是为日志记录提供了默认支持,同时允许用户灵活地集成各种日志框架。其中,SLF4J(Simple Logging Facade for Java)是一个日志门面,它为各种日志API提供了一个统一的接口。Logback 是 ...
《log4j从入门到详解》是一份深入探讨日志框架log4j的教程资料,主要面向对Java日志管理有需求的开发者。log4j是Apache组织开发的一个开源项目,它提供了一种灵活的日志记录方案,广泛应用于Java应用程序中,以帮助...
日志介绍 日志的作用和...log4j2 "log4j2的日志框架 log4j2的配置 异步日志的使用" spring整合log "依赖的选择 日志的配置文件" SpringBoot日志 "SpringBoot日志 中间转换包统一日志框架 SpringBoot修改日志的默认配置
1. **Log4j**:Apache Log4j 是一个广泛使用的日志库,提供了丰富的控制级别,如DEBUG、INFO、WARN、ERROR和FATAL。在MyBatis中,你需要在类路径下提供log4j.properties或log4j.xml配置文件,设置所需的日志级别和...
1. **工具选择**:Java 提供多种日志库,如JUL、JCL、Log4j、SLF4J、Logback和Log4j2,选择哪个工具成为开发者面临的问题。 **三、Java 日志演化历史** Java日志经历了从JUL(Java Util Logging)到Apache Commons...
2. **日志框架SLF4J**:访问SLF4J官网下载`slf4j1.5.2.zip`,解压后获取`slf4j-api-1.5.2.jar`与`slf4j-log4j12-1.5.2.jar`。 3. **Log4j**:需添加Log4j的jar包。若使用`slf4j-log4j12-XXX.jar`,则需同时安装`log4...
slf4net项目充当各种日志记录框架(例如log4net和NLog)的轻量级抽象层。 这允许最终用户在部署时插入所需的日志记录框架。 该项目的灵感来自(它试图尽可能地跟进)和更早的。 安装slf4net 在nuget.org上找到slf...
- **slf4j-api-1.5.2.jar** 及 **slf4j-log4j12-1.5.2.jar**:用于日志记录的 SLF4J API 和 Log4J 实现。 - **log4j-1.2.14.jar**:提供对 Log4J 的支持。 **第二步:创建并配置工程** - **新建 Java 工程**:选择...
Logback是Java世界里广泛使用的日志处理框架,它由Ceki Gülcü创建,作为Log4j的后继者,旨在提供更高的性能、更灵活的配置以及更低的内存占用。本手册将帮助读者快速掌握Logback的基本概念、配置方法以及在HAP框架...
Logback是Log4j的后继者,由Ceki Gülcü开发,提供了更高的性能和更丰富的功能。"入门实例"意味着我们将关注基础知识和简单示例,帮助初学者理解如何在项目中配置和使用Logback。 描述中的链接指向了一个个人博客...