【发布时间】:2017-05-28 17:55:26
【问题描述】:
我们已将所有代码迁移到使用 slf4 API 以使用通用 API,但是现在我们正在考虑从 log4j 1.x 升级到 log4j 2.x。如果我们使用 slf4j API 和 log4j2 作为实现,我们是否能够使用 log4j2 的所有功能?
【问题讨论】:
标签: java logging log4j slf4j log4j2
我们已将所有代码迁移到使用 slf4 API 以使用通用 API,但是现在我们正在考虑从 log4j 1.x 升级到 log4j 2.x。如果我们使用 slf4j API 和 log4j2 作为实现,我们是否能够使用 log4j2 的所有功能?
【问题讨论】:
标签: java logging log4j slf4j log4j2
Log4j2 API 比 SLF4J API 更丰富,并且许多 Log4j2 API 功能无法通过 SLF4J 访问。详情见下文。
Log4j2 实现的功能,例如异步记录器、查找、过滤器、布局和附加器,由配置控制,无论您在应用程序中使用何种日志记录 API,都可以使用。
另请参阅answer 以了解不同但相关的问题为什么对 Log4j2 API 进行编程是安全的。
SLF4J 中没有 10 个 Log4j2 API 功能
(1) Message API 允许应用程序记录除文本之外的结构化对象。在内部,Log4j2 将记录的所有内容转换为消息,并将其公开给 API 为应用程序与下游日志组件(过滤器、布局、附加程序)交互提供了各种可能性。如果您将自定义组件开发为 Log4j2 的插件,以及使用内置组件,这将非常有用。有关内置示例,请参阅如何使用 StructuredDataMessage 对 Rfc5424Layout 进行细粒度控制。
(2) Java 8 lambda support 允许您延迟创建参数或记录消息,而无需明确检查请求的日志级别是否已启用。
// Java-8 style optimization: no need to explicitly check the log level:
// the lambda expression is not evaluated if the TRACE level is not enabled
logger.trace("Some long-running operation returned {}", () -> expensiveOperation());
(3) 将 {} 样式参数与 String::format %s %d 样式参数混合。 {} 样式具有更好的性能并且可以与任何参数类型一起使用,但 printf 样式可以对格式进行细粒度控制。 Log4j2 允许您轻松混合这些参数样式。例如:
logger.debug("Opening connection to {}...", someDataSource);
logger.printf(Level.INFO, "Logging in user %1$s with birthday %2$tm %2$te,%2$tY", user.getName(), user.getBirthdayCalendar());
(4) CloseableThreadContext 比 SLF4J 中的普通 ThreadContext (MDC) 提供了一些额外的便利:它会在您完成后自动删除项目。例如:
// Add to the ThreadContext map for this try block only;
try (final CloseableThreadContext.Instance ctc = CloseableThreadContext
.put("id", UUID.randomUUID().toString())
.put("loginId", session.getAttribute("loginId"))) {
logger.debug("Message 1");
// call some other code that also does logging
...
logger.debug("Message 2");
...
} // "id" and "loginId" are now removed from the ThreadContext map
(5) Log4j2 的ThreadContext,除了键值对之外,还有push 和pop 方法来支持堆栈功能(在Log4j 1 中曾经称为NDC)。
(6) SLF4J 不支持 FATAL 日志级别。
(7) Log4j2 支持custom log levels。这些可以与log 方法一起使用,例如:logger.log(Level.getLevel("FINE"), "... msg"),或者您可以为您的自定义日志级别生成一个带有便捷方法的自定义记录器包装器。
(8) Log4j2 API 接受任何对象,而不仅仅是字符串。这是允许 Log4j2 成为“garbage-free”的原因之一,这意味着它将避免分配新对象。如果您的对象是 Number、CharSequence 或当它实现 (Log4j2) StringBuilderFormattable 接口时,则不会创建任何临时字符串而记录您的对象。
如果您记录 10 个或更少的参数,Log4j2 API 也将避免创建可变参数数组。如果您记录超过 2 个参数,SLF4J 会创建 vararg 数组。
(9) 直接使用 Log4j2 API 即可免费获得上述内容。最重要的是,如果您真的很想避免创建临时对象(例如一些交互式游戏和低延迟金融应用程序),您可以使用 Unbox 实用程序类避免自动装箱原始参数。
(10) SLF4J Markers 使用粗粒度同步可能会对多线程应用程序的性能产生影响 (SLF4J-240)。请参阅此 performance test results 页面的高级过滤部分。
免责声明:我为 Log4j2 做出贡献。
【讨论】: