log4j配置与使用

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"?>
<!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为Console的appender定义的是控制台输入日志类型

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节点。