当我们开发应用程序时,它可能不会按照我们预期的运行,这个时候通常我们会DEBUG,来观察程序中的代码分支(if,else),观察一些变量在运行中的值等等以便确定程序的运行过程。但是,在生产环境,我们通常没有办法,或者不能够很容易去进行DEBUG。因此,更好的方法是使用日志工具。
在生产环境中,日志是查找问题来源的重要依据。应用程序运行时的产生的各种信息,包括记录程序运行时产生的错误信息、状态信息、调试信息和执行时间信息等等,都可以通过日志来进行记录。
在JAVA中,有哪些记录日志的方法呢?
介绍之前我们对下文做如下约定:
- 依赖方式均以
maven denpendency
方式给出。- 下文所说的
系统属性
指的是java
中的System Property
,即通过System.setProperty
设置或者通过java -D
设置的系统属性。- 本文只会简单介绍各个日志库的配置方式及基本用法,详细的配置项及更高级的用法请移步官方文档。
最原始的方式
你一定记得在刚开始学习Java时,下面这种写法:
1 | System.out.println("variable is :" + variable); |
或者这样,
1 | try{ |
在程序中打印变量的值,在异常发生时打印异常栈,这都有助于分析程序的运行过程,但是这种方式缺乏灵活性,一般也只会在初学时用到。
严格来说,这根本算不上记录日志。。。
我们需要的日志工具库至少应该满足:
- 输出目标(也就是日志库中
appender
或者handler
)
上述方式会将日志打印到控制台,但是在现实的应用场景中,我们可能需要将输出到文件系统,数据库,数据总线等系统中。 - 环境(可以灵活的设置日志级别
level
)
我们需要根据环境不同来决定是否输出某些日志信息,生产环境只输出必要的信息,而在非生产环境,更多的调试信息会更有助于我们解决问题。
JDKLog(JUL)
JDK在java.util.logging
包下提供了日志相关的API,不过在JDK1.4才加入,在此之前,JDK中并不包含日志记录相关的API和实现。
依赖
不需要任何外部依赖,JDK自身提供的。
配置
JDK通过java.util.logging.config.file
系统属性来读取自定义配置文件的位置,如果不配置,JDK中有默认的配置文件,位置在[path/to/jre]/lib/logging.properties
。
配置文件示例
1 | # 全局的日志handler |
SimpleFormatter.format
如何自定义格式?参见:
https://docs.oracle.com/javase/7/docs/api/java/util/logging/SimpleFormatter.html#method_detail
用法
1 | import java.util.logging.Logger; |
Log4j
Log4j 是Apache的一个用于JAVA的日志库。是出现较早的日志工具,目前已经发展到Log4j2.X,但是这里我们讨论的是Log4j1.X,Log4j2.X下文会单独讨论。
依赖
1 | <dependency> |
配置
Log4j没有任何默认的日志配置,如果没有配置文件。你将会遇到:
1 | log4j:WARN No appenders could be found for logger (xx.xx.xx). |
我们看下Log4j默认的初始化过程(具体过程在org.apache.log4j.LogManager
类中):
- 设置
log4j.defaultInitOverride
为除了false
之外的其他值都会导致Log4j
跳过初始化过程。(但是一般我们不会这么做) - 试图将
log4j.configuration
系统属性转换为一个URL
(java.net.URL
),从该URL加载配置,如果转换失败,则从classpath
中寻找log4j.configuration
系统属性配置的文件,从该文件加载配置 - 如果没有设置
log4j.configuration
属性,则在classpath
目录下寻找log4j.xml
文件,从该文件加载配置。 - 如果仍然没有,则在
classpath
目录下寻找log4j.properties
文件,从该文件加载配置。 - 如果以上均失败了,中止初始化。
从以上流程可以看出,最简单的配置方式就是提供log4j.xml
或者log4j.properties
文件。
log4j.xml
文件示例:
1 |
|
用法:
1 | import org.apache.log4j.Logger; |
休息一下
除了
JUL
和Log4J
这样的日志记录库之外,还有一类库用来封装不同的日志记录库。这样的封装库中一开始以Apache Commons Logging
框架最为流行,现在比较流行的是SLF4J
。这样封装库的API都比较简单,只是在日志记录库的API基础上做了一层简单的封装,屏蔽不同实现之间的区别。
这样做典型的好处是可以在一个公共的项目中,可以通过这类公共的API去操作日志,但是具体的实现由调用方去指定。这样可以避免在依赖多个不同的日志库时需要对多种不同的日志库提供实现及配置。
commoning-log(JCL)
JCL provides thin-wrapper Log implementations for other logging tools, including Log4J, Avalon LogKit (the Avalon Framework’s logging infrastructure), JDK 1.4, and an implementation of JDK 1.4 logging APIs (JSR-47) for pre-1.4 systems.
JCL内置支持的日志实现工具包括Log4J
、Avalon LogKit
(项目目前已经关闭)、JDK 1.4和为JDK1.4之前系统提供的JDK log API的实现(JSR-47)。这几个中使用最多的还是Log4j
。
依赖
1 | <dependency> |
为了实现具体的日志实现,则需要引入具体的依赖库,如果用Log4j
,那么需要引入Log4j
的依赖:
1 | <dependency> |
配置
JCL
的配置文件是classpath
路径中的commons-logging.properties
。JCL
中使用LogFactory
来获取具体的Log
,LogFactory
可以通过org.apache.commons.logging.LogFactory
属性指定,当然JCL
提供了默认的LogFactory
,默认的Logfactory
通过如下流程决定使用哪种具体的日志实现:
- 寻找
LogFactory
中名为org.apache.commons.logging.Log
(同时兼容1.0版本之前的org.apache.commons.logging.log
)的属性指定的Log
。这里的属性指的是通过
LogFactory
类的getAttribute
方法获得的,注意定义在commons-logging.properties
文件中的每个属性都会成为这个默认的LogFactory
的Attribte
. - 如果没有找到,寻找系统属性中名为
org.apache.commons.logging.Log
(同时兼容1.0版本之前的org.apache.commons.logging.log
)的属性指定的Log
。 - 如果依然没有找到,
Log4j
是可用的(可以找到Log4j
相关的类),使用Log4j
。 - 如果没有找到
Log4j
,JDK版本在1.4以上,那么使用JDKLog
。 - 使用JCL内置的
SimpleLog
。
如果我们使用Log4j
,JDKLog
,我们可以不用配置commons-logging
,注意着并不等于不用配置Log4j
或者JDKLog
,在使用了commons-logging
之后,不管是Log4j
还是JDKLog
,配置方式都是与单独使用时是相同的,commoons-logging
和具体的日志实现的配置是分开的。
用法
1 | import org.apache.commons.logging.Log; |
slf4j
slf4j
与commons-logging
相似,是有一个日志门面框架。slf4j
支持log4j
,JDKLog
,logback
同时支持commons-logging
(相当于两层门面)。
依赖
1 | <dependency> |
slf4j-api
提供Log的接口,而具体使用哪种实现则需要提供另一类包:绑定包(SLF4J bindings
),每一种绑定包对应一种实现:
binding jar | 支持日志实现 |
---|---|
slf4j-log4j12.jar |
log4j 1.2 |
slf4j-jdk14.jar |
JDKLog |
slf4j-jcl.jar |
commons-logging |
同时logback
内置slf4j实现,所以使用logback
并不需要binding jar
。
引入了对应的binding jar
之后,我们还需要引入日志实现库所需要的依赖。
例如如果我们用Log4j
作为日志实现,除了slf4j-api
需要引入,还需要引入
1 | <dependency> |
配置
Slf4j
并不需要单独配置,只要引入相应日志的binding jar
以及其对应依赖并配置即可。
这里的绑定实际上是加载org.slf4j.impl.StaticLoggerBinder
类,每个binding jar
中都有这样一个类。如果找到多个绑定,则取决于加载的先后顺序。
用法
1 | import org.slf4j.Logger; |
slf4j bridging
如果在你依赖的模块中使用了别的日志库,而在你的项目中你使用的是slf4j
,这个时候slf4j
提供了一些桥接模块可以避免你同时对多个日志库进行配置,这些桥接模块可以重定向对其他日志库的调用到slf4j
.
官方图表达的很清晰:
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日志相关的功能。
依赖
1 | <dependency> |
logback-classic
这个包内部依赖logback-coer
和slf4j-api
。所以不需要再额外引入。另外我们在上一节说到,logback提供了对slf4j接口的原生实现,所以不需要提供bingding jar
。
配置
logback通过以下步骤完成初始化:
- logback尝试在classpath目录下寻找
logback-test.xml
文件。 - 如果不存在,logback尝试在classpath目录下寻找
logback.groovy
文件。 - 如果不存在,logback尝试在classpath目录下寻找
logback.xml
文件。 - 如果都不存在,在classpath目录下寻找
META-INF\services\ch.qos.logback.classic.spi.Configurator
,这个文件的内容是com.qos.logback.classic.spi.Configurator
接口的实现类的全限定名,logback将使用该类作为配置类。 - 如果仍然没有找到,那么logback使用默认的
BasicConfigurator
类作为配置类,这个Configurator
将日志输出至控制台。
logback.xml
示例:
1 |
|
用法
既然logback内置了对slf4j的实现,那么他的使用方式就和slf4j的使用方式一样。
1 | import org.slf4j.Logger; |
Log4j 2
以上我们说的全部都是Log4j 1
,而Log4j
现在已经升级到了2.X
版本。Log4j 2
已经不仅仅是一个日志实现框架了,他也能够作为一个门面框架来使用,并提供对其他框架丰富的支持。我们只介绍他单纯作为一个日志实现框架的用法,更多的用法请移步官网自行查阅。
依赖
1 | <dependency> |
配置
Log4j 2
通过初始化实现自动配置的流程如下:
- 检查
log4j.configurationFile
系统属性,如果有设置,将使用 - 如果没有设置,依次从classpath中寻找配置文件,顺序依次为:
log4j2-test.properties
log4j2-test.yaml
或者log4j2-test.yml
log4j2-test.json
或者log4j2-test.jsn
log4j2-test.xml
log4j2.properties
log4j2.yaml
或者log4j2.yml
log4j2.json
或者log4j2.jsn
log4j2.xml
- 如果这么多文件都没有没有找到,则会有一个默认的配置,这个配置会将日志输出至控制台。
Log4J2.X的xml配置方式上有一些不同,主要的不同可以看这里:Migrating from Log4j 1.x
log4j2.xml
配置文件示例:
1 |
|
用法
在使用方式上,也有了变化,主要变化是在Log4J1.X中Logger是具体的类,而在Log4J2.X中,Logger变成了接口(log4j-api包中),在log4j-core中提供具体实现。这样做的好处是使用log4j的api同时可以使用其他不同日志库的实现。
1 | //注意类的位置不同了 |
几种框架的关系
以上介绍的这几种框架可以分为两类(log4j 2 暂时不做区分):
- JUL, Log4j 1 和 Logback 是真正的日志实现。
- commons-logging和sl4j是在真正日志实现之上的门面框架。每个框架都有自己一个简单实现,也可以使用一个另外的日志实现。
commons-logging和slf4j都可以作为JDKLog和Log4j 1的日志门面,此外slf4j还能够作为commons-logging本身和logback的门面框架。
他们之间的关系可以用下图表示: