我们首先学习了Spring的两个核心技术:IOC和AOP,然后为满足真实的项目需求我们又学习了Spring的基础JDBC操作以及如何再Spring框架下整合mybatis数据持久化框架。到目前为止我们已经可以完成简单的Spring后台项目开发工作。但是在实际的项目中,为了方便调试和追踪问题,我们往往需要打印日志信息来帮助我们发现和追踪问题。因此,为完善项目实际开发能力,本文我们主要学习在Spring框架中如何引入目前流行的日志框架Log4J2。
一、Log4j2简介
Log4J2是Log4j 1.x的升级版版,在Log4j 1.x的基础上有显著的改进,并且提供了Logback中许多i可用的功能,同时也修复了一些Logback上的一些固有的问题。
二、引入Log4j2的jar包依赖
官网文档指出,如果需要依赖Log4j2需要依赖log4j-api
、log4j-core
两个jar包,因此我们在gradle.build文件中添加如下依赖:
dependencies {
testCompile group: 'junit', name: 'junit', version: '4.11'
compile 'org.apache.logging.log4j:log4j-api:2.8.1'
compile 'org.apache.logging.log4j:log4j-core:2.8.1'
}
log4j-api
和log4j-core
的依赖版本我们都选择2.8.1
,在命令行下运行如下命令,gradle会自动完成依赖解析。
gradle build
三、Hello-log4j2
在将log4j2整合到Spring之前我们先完成一个使用log4j2最简单的例子:hello-log4j2。
首先创建主java运行程序:
public class Application {
private static final Logger logger = LogManager.getLogger(Application.class);
public static void main(String[] args){
logger.info("Hello, Log4j2!");
}
}
这个例子很简单,我们定义了类Application
并为其定义静态常量logger
,其使用LogManager进行实例化,并获取一个命名的logger对象。在main方法中,我们直接使用logger.info输出“Hello,Log4j2”信息。
Tip : Log4j2 将日志级别分为8个级别:All < Trace < Debug < Info < Warn < Error < Fatal < OFF,级别越高打印的日志越少,Logger也提供了相应的方法对应相应的日志级别。
Log4j2提供XML、JSON、YAML和properties格式进行配置,我们这里主要以XML配置方式进行学习,如果想了解更多的配置方式,读者可自动查看官网文档。
log4j2.xml配置,该文件需在classpath路径下,log4j2会自动进行加载解析:
如上我们定义了最简单的log4j2配置文件,我们对该文件中的元素标签进行简单介绍:
Configuration 标签
log4j的所有配置信息需要包含在该标签下,这里我们用到了status
属性,它用于指定log4j内部日志信息打印级别,这里我们设置为WARN
,它同时可被设置为如下数值:trace
、debug
、info
、error
,共5种不同级别。同时该标签下可包含
和
标签,
用于定义日志信息所传输(写入)的目标地,当然它还会定义输出格式等信息;
关联一个具体的Appender
,上面的配置文件关联的名为“Console”的Appender
,Loggers
内部可定义
和
,统称为Logger,其中Root为所有Logger的父亲,当代码中定义的Logger没有对应匹配的
时则会直接使用Root的配置信息。
Appenders 标签
该标签下定义所有的Appender,其中常见的为Console
、File
、RollingFile
......,这里我们使用Console标签定义一个中断输出,其中target可设置为"SYSTEM_OUT"或者“SYSTEM_ERR”,一般设置为“SYSTEM_OUT”且默认为该值。这里我们使用
来设置了日志输出格式。每个Appender提供了丰富的属性或标签进行设置相应的输出结果,使得我们可以在不改变源代码的情况下,对日志输出进行灵活改动。详细学习该标签下属性的设置超出了本文的范围,我们会放在后面进行学习。
Loggers 标签
该标签下定义所有的Logger,用来关联代码中定义的Logger和Appender。该标签下包含两种标签:
和
。Root为所有Logger的根(父亲),所有的Logger自动继承Root的配置信息。我们使用level来设置该Logger输出的日志级别。并且使用�
来关联一个前面定义好的Appender。
完成以上配置后运行代码我们会在控制台看到如信息:
17:54:29.921 [main] INFO com.liangwei.learnspring.Application - Hello, Log4j2!
如上,我们记录了时间、方法名、日志级别、类名、输出信息。
三、Spring整合Log4j2
Spring强制依赖commons-logging
jar包,该jar包由spring-core
间接引入。commons-logging
是JCL(Jakarta Commons Logging API)的一种典型实现,Spring的框架日志信息都是使用JCL标准接口来进行输出的,如果我们想将Spring的框架日志输出按照log4j的配置方式进行输出,我们需要完成JCL-log4j之间的映射,而log4j为我们提供了相关依赖jar包。为完成Spring框架整合Log4j日志框架,我们只需要增加如下依赖信息:
dependencies {
testCompile group: 'junit', name: 'junit', version: '4.11'
compile 'org.apache.logging.log4j:log4j-api:2.8.1'
compile 'org.apache.logging.log4j:log4j-core:2.8.1'
compile 'org.apache.logging.log4j:log4j-jcl:2.8.1'
compile 'org.springframework:spring-context:4.3.6.RELEASE'
}
如上,我们增加了compile 'org.apache.logging.log4j:log4j-jcl:2.8.1'
配置信息,增加了log4j-jcl的jar包。接下来我们需要修改log4j2.xml文件,来完成Spring框架日志文件的输出:
如上,我们定义了一个名为org.springframework.beans.factory
的Logger,该Logger的日志级别为DEBUG,这样Spring 框架内的DEBUG以上级别的日志信息会被输出,由于该Logger并没有定义AppenderRef信息,因此它自动集成Root设置的Console,该信息会被输出到控制台。
我们在源代码Application.java中增加Spring加载启动代码:
public class Application {
private static final Logger logger = LogManager.getLogger(Application.class);
public static void main(String[] args){
ApplicationContext applicationContext = new ClassPathXmlApplicationContext("dao.xml");
logger.info("Hello, Log4j2!");
}
}
重新运行程序,我们将在控制台看到如下信息:
19:06:24.314 [main] DEBUG org.springframework.core.env.StandardEnvironment - Adding [systemProperties] PropertySource with lowest search precedence
19:06:24.318 [main] DEBUG org.springframework.core.env.StandardEnvironment - Adding [systemEnvironment] PropertySource with lowest search precedence
19:06:24.319 [main] DEBUG org.springframework.core.env.StandardEnvironment - Initialized StandardEnvironment with PropertySources [systemProperties,systemEnvironment]
...... ......
19:06:25.073 [main] INFO com.liangwei.learnspring.Application - Hello, Log4j2!
为保持简洁,省略了大部分Spring框架启动时的信息,读者可自行下载代码进行运行查看。
四、总结
本文我们将log4j2引入Spring框架,我们通过最简单的Hello-log4j程序学习了Log4j2日志框架配置方式:1. 使用LogManager定义Logger;2,配置log4j2.xml文件。最后我们通过增加jar包依赖和配置关于Spring框架日志的Logger将Spring框架日志信息通过Log4j日志框架进行输出,至此,我们已完成将log4j2引入Spring的工作。
当然,本文并没有详细学习log4j2.xml文件的配置以及配置文件中各标签的用法,这超出简单将log4j2引入Spring框架的目的以及本系列文章学习Spring知识的初衷,关于log4j的学习,后面有机会会专门开辟系列文章进行共同学习。
本文实例代码地址