java开发日志规范(阿里巴巴Java开发手册)

请用语音读文章

功能简介

上一篇介绍了为什么打印日志、什么时候打印日志以及怎么打印日志。本篇介绍下在项目开发中常见的日志组件以及关系。

先看一张图

接口：将所有日志实现适配到了一起。用统一的接口调用。

实现：目前主流的日志实现。

日志门面

SLF4J

SLF4J。即简单日志门面（Simple Logging Facade for java）。不是具体的日志解决方案。而是通过Facade Pattern提供一些Java logging API。它只服务于各种各样的日志系统。按照官方的说法。SLF4J是一个用于日志系统的简单Facade。允许最终用户在部署其应用时使用其所希望的日志系统。

例子

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

public class LogTest {

private static Log logger = LogFactory.getLog(this.getClass());

}

slf4j静态绑定原理：SLF4J 会在编译时会绑定
org.slf4j.impl.StaticLoggerBinder; 该类里面实现对具体日志方案的绑定接入。任何一种基于slf4j 的实现都要有一个这个类。如：org.slf4j.slf4j-log4j12-1.5.6: 提供对 log4j 的一种适配实现。注意：如果有任意两个实现slf4j 的包同时出现。那么就可能出现问题(mvn dependency:tree排查)。

common-logging

common-logging,是apache提供的一个通用的日志接口。用户可以自由选择第三方的日志组件作为具体实现。像log4j。或者jdk自带的logging。 common-logging会通过动态查找的机制。在程序运行时自动找出真正使用的日志库

common-logging动态查找原理：Log 是一个接口声明。LogFactory 的内部会去装载具体的日志系统。并获得实现该Log 接口的实现类。LogFactory 内部装载日志系统的流程如下：

1. 首先。寻找org.apache.commons.logging.LogFactory 属性配置。

2. 利用JDK1.3 开始提供的service 发现机制。会扫描classpah 下的META-INF/services/org.apache.commons.logging.LogFactory文件。若找到则装载里面的配置。使用里面的配置。

3. 从Classpath 里寻找commons-logging.properties 。找到则根据里面的配置加载。

4. 使用默认的配置：如果能找到Log4j 则默认使用log4j 实现。如果没有则使用JDK14Logger 实现。再没有则使用commons-logging 内部提供的SimpleLog 实现。

从上述加载流程来看。只要引入了log4j 并在classpath 配置了log4j.xml 。则commons-logging 就会使log4j 使用正常。而代码里不需要依赖任何log4j 的代码。

slf4j 与 common-logging 比较

common-logging通过动态查找的机制。在程序运行时自动找出真正使用的日志库。由于它使用了ClassLoader寻找和载入底层的日志库。 导致了象OSGI这样的框架无法正常工作。因为OSGI的不同的插件使用自己的ClassLoader。 OSGI的这种机制保证了插件互相独立。然而却使Apache Common-Logging无法工作。

slf4j在编译时静态绑定真正的Log库,因此可以再OSGI中使用。另外。SLF4J 支持参数化的log字符串。避免了之前为了减少字符串拼接的性能损耗而不得不写的if(logger.isDebugEnable())。现在你可以直接写：logger.debug(“current user is: {}”, user)。拼装消息被推迟到了它能够确定是不是要显示这条消息的时候。但是获取参数的代价并没有幸免。

常见日志实现

Log4j

2种配置文件、3个主要组件、7种日志级别

Log4j是Apache的一个开放源代码项目。通过使用Log4j。可以控制日志信息输送的目的地是控制台、文件、数据库等；也可以控制每一条日志的输出格式；通过定义每一条日志信息的级别。我们能够更加细致地控制日志的生成过程。

Log4j有7种不同的log级别。按照等级从低到高依次为：TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF。如果配置为OFF级别。表示关闭log。

Log4j支持两种格式的配置文件：properties和xml。包含三个主要的组件：Logger、appender、Layout。

Log4j2

log4j2和log4j是一个作者。只不过log4j2是重新架构的一款日志组件。他抛弃了之前log4j的不足。以及吸取了优秀的logback的设计重新推出的一款新组件。

1. 插件式结构 Log4j 2支持插件式结构。我们可以根据自己的需要自行扩展Log4j 2. 我们可以实现自己的appender、logger、filter。 2. 配置文件优化 在配置文件中可以引用属性。还可以直接替代或传递到组件。而且支持json格式的配置文件。不像其他的日志框架。它在重新配置的时候不会丢失之前的日志文件。3. Java 5的并发性 Log4j 2利用Java 5中的并发特性支持。尽可能地执行最低层次的加锁。解决了在log4j 1.x中存留的死锁的问题。 4. 异步logger Log4j 2是基于LMAX Disruptor库的。在多线程的场景下。和已有的日志框架相比。异步的logger拥有10倍左右的效率提升。

LogBack

Logback是由log4j创始人设计的又一个开源日记组件。logback当前分成三个模块：logback-core,logback- classic和logback-access。logback-core是其它两个模块的基础模块。logback-classic是log4j的一个 改良版本。此外logback-classic完整实现SLF4J API使你可以很方便地更换成其它日记系统如log4j或JDK14 Logging。logback-access访问模块与Servlet容器集成提供通过Http来访问日记的功能。

Log4j 与 LogBack 比较

LogBack作为一个通用可靠、快速灵活的日志框架。将作为Log4j的替代和SLF4J组成新的日志系统的完整实现。LOGBack声称具有极佳的性能。“ 某些关键操作。比如判定是否记录一条日志语句的操作。其性能得到了显著的提高。这个操作在LogBack中需要3纳秒。而在Log4J中则需要30纳秒。 LogBack创建记录器（logger）的速度也更快：13微秒。而在Log4J中需要23微秒。更重要的是。它获取已存在的记录器只需94纳秒。而 Log4J需要2234纳秒。时间减少到了1/23。跟JUL相比的性能提高也是显著的”。

备注常见组合

1. slf4j+logback

2. slf4j+log4j2

以上就是由优质生活领域创作者 生活常识网 整理编辑的，如果觉得有帮助欢迎收藏转发~