Log4J的配置文件(Configuration File)就是用来设置记录器的级别、存放器和布局的,它可接key=value格式的设置或xml格式的设置信息。通过配置,可以创建出Log4J的运行环境。
Log4j配置介绍
1. 配置文件Log4J配置文件的基本格式如下:














其中 [level] 是日志输出级别,共有5级:






Appender 为日志输出目的地,Log4j提供的appender有以下几种:





Layout:日志输出格式,Log4j提供的layout有以下几种:




打印参数: Log4J采用类似C语言中的printf函数的打印格式格式化日志信息,如下:









2. 在代码中初始化Logger:
1)在程序中调用BasicConfigurator.configure()方法:给根记录器增加一个ConsoleAppender,输出格式通过PatternLayout设为"%-4r [%t] %-5p %c %x - %m%n",还有根记录器的默认级别是Level.DEBUG.
2)配置放在文件里,通过命令行参数传递文件名字,通过PropertyConfigurator.configure(args[x])解析并配置;
3)配置放在文件里,通过环境变量传递文件名等信息,利用log4j默认的初始化过程解析并配置;
4)配置放在文件里,通过应用服务器配置传递文件名等信息,利用一个特殊的servlet来完成配置。
3. 为不同的 Appender 设置日志输出级别:
当调试系统时,我们往往注意的只是异常级别的日志输出,但是通常所有级别的输出都是放在一个文件里的,如果日志输出的级别是BUG!?那就慢慢去找吧。
这时我们也许会想要是能把异常信息单独输出到一个文件里该多好啊。当然可以,Log4j已经提供了这样的功能,我们只需要在配置中修改Appender的Threshold 就能实现,比如下面的例子:
[配置文件]

























[代码中使用]








运行一下,看看异常信息是不是保存在了一个单独的文件error.log中。
附录: Log4j在项目中的实际应用
用Log4j配置多个logger(log4j-1.2.16.jar)
1. 添加log4j-xxx.jar 包,并build path
2. 在项目src目录下添加log4j.properties配置文件(内容如下)
3. 新建一个Log.java类,其他类调用Log类来使用Log4j。
log4j.properties 配置文件:
log4j.rootLogger=DEBUG, stdout, D, InfoAppender, E
#log4j.rootCategory=ERROR
log4j.logger.fileLog= INFO,customAppender
#INFO cannot be removed
log4j.additivity.fileLog = false
log4j.appender.customAppender=org.apache.log4j.FileAppender
log4j.appender.customAppender.File=logs/custom.log
#log4j.appender.customAppender.MaxFileSize= 100000KB
#log4j.appender.customAppender.MaxBackupIndex= 3
#log4j.appender.customAppender.ImmediateFlush=true
log4j.appender.customAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.customAppender.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}] %m%n
log4j.appender.customAppender.Threshold = INFO
#log4j.logger.org.apache.commons.httpclient=info
#log4j.logger.httpclient.wire.content=info
#log4j.logger.httpclient.wire.header=info
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.Target =System.out
# Pattern to output the caller's file name and line number.
#log4j.appender.stdout.layout.ConversionPattern=%-4r %-5p [%d{yyyy-MM-dd HH:mm:ss}] %m%n
log4j.appender.stdout.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}] %m%n
log4j.appender.stdout.Threshold = INFO
log4j.appender.D=org.apache.log4j.RollingFileAppender
log4j.appender.D.File=logs/debug.log
log4j.appender.D.MaxFileSize= 100000KB
# Keep one backup file
log4j.appender.D.MaxBackupIndex= 3
log4j.appender.D.layout=org.apache.log4j.PatternLayout
log4j.appender.D.layout.ConversionPattern=%-4r %-5p [%d{yyyy-MM-dd HH:mm:ss}] %m%n
log4j.appender.D.Threshold = DEBUG
log4j.appender.debug.append=false
log4j.appender.InfoAppender=org.apache.log4j.RollingFileAppender
log4j.appender.InfoAppender.File=logs/info.log
log4j.appender.InfoAppender.MaxFileSize= 100000KB
# Keep one backup file
log4j.appender.InfoAppender.MaxBackupIndex= 3
log4j.appender.InfoAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.InfoAppender.layout.ConversionPattern=[%d{yyyy-MM-dd HH:mm:ss}] %m%n
log4j.appender.InfoAppender.Threshold = INFO
log4j.appender.debug.append=false
log4j.appender.E=org.apache.log4j.RollingFileAppender
log4j.appender.E.File=logs/error.log
log4j.appender.E.MaxFileSize= 100000KB
# Keep one backup file
log4j.appender.E.MaxBackupIndex= 3
log4j.appender.E.layout=org.apache.log4j.PatternLayout
log4j.appender.E.layout.ConversionPattern=%-4r %-5p [%d{yyyy-MM-dd HH:mm:ss}] %m%n
log4j.appender.E.Threshold = ERROR
log4j.appender.debug.append=false
Log.java类
package edu.ustc.common;
import org.apache.log4j.Logger;
public class Log {
// static Logger log = Logger.getLogger(Log.class.getName());
static Logger log = Logger.getRootLogger();
static Logger cutsomLog = Logger.getLogger("fileLog");
public static void logDebug(String message) {
log.debug(message);
}
public static void logInfo(String message) {
log.info(message);
}
public static void logWarn(String message) {
log.warn(message);
}
public static void logError(String message) {
log.error(message);
}
public static void logCustomInfo(String message) {
cutsomLog.info(message);
}
}
说明:
- log4j.rootLogger//==配置跟logger日志级别及日志输出位置,如:
log4j.rootLogger=ERROR,file,stdout表示,日志级别为ERROR的日志输出到控制台和file中。
但如果日志要分别输出到不同的文件中,如根据功能模块输出到不同文件,则无需将不同位置在此设置,否则在无法按照功能模块输出日志,导致不同文件记录相同的日志。
- log4j.additivity是子Logger是否继承父Logger 的 输出源(appender)的标志位。
具体说,默认情况下子Logger会继承父Logger的appender,也就是说子Logger 会在父Logger的appender里输出。若是additivity设为false,则子Logger只会在自己的appender里输出,而不会在父Logger的appender里输出。
参考文献:
http://www.blogjava.net/zJun/archive/2006/06/28/55511.html