log4j作为Java日志记录框架,已经成为Java开发日志的标配,大多数Java应用都会使用log4j来记录日志,今天简单介绍
一下log4j的配置与使用,记录自己的学习过程。
第一步、在Eclipse中新建普通Java工程,并引入log4j相关jar包。
这里必须的jar包有log4j-1.2.17.jar、commons-logging-1.2.jar、commons-logging-api-1.1.jar、dom4j-1.6.1.jar。
如图:我的工程目录如下
第二步、配置log4j.xml文件,也可以是log4j.properties配置文件,建议使用xml配置文件。
<?xml version="1.0" encoding="UTF-8"?>其中name为Console的appender定义的是控制台输入日志类型
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/'>
<appender name="Console" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{ISO8601}(%-4r ms)[%-5p][%t]%c %x: %m%n" />
</layout>
</appender>
<appender name="LogFile" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="${log.dir}/server.log" />
<param name="DatePattern" value="'.'yyyy-MM-dd" />
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{ISO8601}(%-4r ms)[%-5p][%t]%c %x: %m%n" />
</layout>
</appender>
<logger name="com.lenovo.action" additivity="false">
<level value="error"/>
<appender-ref ref="LogFile"/>
</logger>
<root>
<level value="info"/>
<appender-ref ref="Console"/>
<appender-ref ref="LogFile"/>
</root>
</log4j:configuration>
name为LogFile的appender定义的是文件日志类型
最后在root节点将这两者都要引入,否则某一种日志将不会输出。
logger可以自定义日志输出,指定输出目录,日志级别。在实际打印日志中有很重要的作用,最后会测试自定义日志。
这里有必要详细介绍一下日志的级别和日志输出格式
日志级别按照优先级分为:Off>Fatal>Error>Warn>Info>Debug>All,实际开发中建议使用四种级别即Error、Warn、
Info、Debug,同时为了减少日志输出,也会提高日志级别。
自定义日志有时也是为了减少日志的输出,只打印有用的信息,便于故障分析和数据挖掘。
日志输出格式常用字段说明:
%d 日志记录时间可以格式化,
%m 原始信息
%n 换行
%p loglevel等级
%c 类名
%L 行号
%l 位置 %F%L组合效果
%F 文件名
%t 日志线程名
%-5p 输出日志级别,最多五个字按照左侧对齐
%5p 输出日志级别,最多五个字按照默认右对齐
第三步、编写简单的测试类。
package com.lenovo.action;在实际使用日志时,先获取日志对象,
import org.apache.log4j.Logger;
public class LoggerTest {
private static Logger logger = Logger.getLogger(LoggerTest.class);
public static void main(String[] args) {
logger.info("info: i am an info message");
logger.warn("warn: i am a warn message");
logger.error("error: i am an error message");
logger.debug("debug: i am a debug message");
}
}
private static Logger logger = Logger.getLogger(LoggerTest.class);
然后使用日志对象根据日志打印级别打印日志,例如打印info级别的日志。
logger.info("info: i am an info message");
第四步、验证日志输出(控制台日志和文件日志)
上面的测试代码分别记录了四个级别的日志,最终打印在控制台和文件的日志是一致的,因为我把控制台和
文件日志都加入了log4j.xml配置文件的root节点。
因为我日志级别设置的是info,所以比info小的级别日志debug未出现在日志中,这是符合预期的。
先看控制台日志输出:
日志文件日志输出:
我们还看到日志文件保存的地方还生成了一个后缀带日期的文件,这个文件就是文件日志生成的一个策略,
按天生成新的日志,把之前的日志另存一个当天的日期后缀的文件,我们也可以配置按照日志大小限制策
略生成日志(RollingFileAppender类型),即日志达到一个上限,会生成一个新的日志。
有时候我们看到控制台输出了日志,却看不到日志文件里面记录的日志时,可以检查一下,是否把文件日志
配置加入到root节点。