关于log4j的配置文件

因为要在spring中添加Mongodb，在网上查阅资料的时候我发现有人在web.xml中添加如下代码：

<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>classpath:config/properties/log4j.properties</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener>

可以定义log4j的配置文件的路径。

因为我向来是把这个文件放在src下的。这种可配置的做法让我迷惑：

这种可配置的做法依赖于web.xml，那么也就是说只有web项目才能使用。而且要配置springframework下的一个Log4jConfigListener。所以这种做法更加奇怪。

我尝试在src下和classpath:config/properties/下都放了log4j.properties文件，但是log文件的输出路径不同。结果系统启动的时候会在两个位置都创建log文件。不过，最后经过我的验证，只有web.xml中配置的log文件会打印出内容，另外一个log文件甚至不是"占用"状态，可以删除不会报错。

后来我把web.xml中的这段配置删除，src下的配置的log文件就开始生效，保持占用状态，可以输出错误日志。

后来我翻了spring的源代码，发现spring只是从web.xml中取出了配置的路径，然后调用了log4j的代码，设置给了log4g配置文件的路径而已。摘出部分代码如下：

import org.apache.log4j.LogManager;
import org.apache.log4j.PropertyConfigurator;
import org.apache.log4j.xml.DOMConfigurator;
public static void initLogging(String location) throws FileNotFoundException {
String resolvedLocation = SystemPropertyUtils.resolvePlaceholders(location);
URL url = ResourceUtils.getURL(resolvedLocation);
if (ResourceUtils.URL_PROTOCOL_FILE.equals(url.getProtocol()) && !ResourceUtils.getFile(url).exists()) {
throw new FileNotFoundException("Log4j config file [" + resolvedLocation + "] not found");
}
if (resolvedLocation.toLowerCase().endsWith(XML_FILE_EXTENSION)) {
DOMConfigurator.configure(url);
}
else {
PropertyConfigurator.configure(url);
}
}

最终我的结论是，web.xml中配置的路径将优先生效，并发挥作用。

在整个过程中，还有一个经验是，如果log4g.properties的内容有错误，那么在启动的时候，会报和没有配置log4g. properties文件一样的错误：

log4j:WARN No appenders could be found for logger (org.springframework.web.context.ContextLoader).
log4j:WARN Please initialize the log4j system properly.
log4j:WARN See http://logging.apache.org/log4j/1.2/faq.html#noconfig for more info.

所以一旦有这个错误，可能并不是你的配置文件的位置不对，而是你的配置文件的内容有问题。

一个简单的log4j.properties文件的内容如下：

log4j.rootLogger = ERROR,C1
#logger
log4j.logger.com.zjf =DEBUG,F1
log4j.additivity.com.zjf =false
#u5E94u7528u4E8Eu63A7u5236u53F0
log4j.appender.C1=org.apache.log4j.ConsoleAppender
#log4j.appender.C1.Threshold=WARNING
log4j.appender.C1.Target=System.out
#log4j.appender.C1.Encoding=UTF-8
log4j.appender.C1.layout=org.apache.log4j.PatternLayout
log4j.appender.C1.layout.ConversionPattern=[CONSOLE] %d - %c -%-4r [%t] %-5p %c %x - %m%n
#u6BCFu5929u5EFAu65B0u65E5u5FD7
log4j.appender.A1=org.apache.log4j.DailyRollingFileAppender
log4j.appender.A1.File=E:\log\log4j_daily.log
#log4j.appender.A1.Encoding=UTF-8
#log4j.appender.A1.Threshold=DEBUG
log4j.appender.A1.DatePattern=.yyyy-MM-dd
log4j.appender.A1.layout=org.apache.log4j.PatternLayout
log4j.appender.A1.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L : %m%n
#u5E94u7528u4E8Eu6587u4EF6
log4j.appender.F1=org.apache.log4j.FileAppender
log4j.appender.F1.File=E:\log\Spring.log
log4j.appender.F1.Append=true
#log4j.appender.F1.Threshold=DEBUG
#log4j.appender.F1.Encoding=UTF-8
log4j.appender.F1.layout=org.apache.log4j.PatternLayout
log4j.appender.F1.layout.ConversionPattern=[framework] %d - %c -%-4r [%t] %-5p %c %x - %m%n

appender的内容是一个类，整个类都实现了org.apache.log4j.Appender接口，有以下几种：

•org.apache.log4j.ConsoleAppender（控制台），
•org.apache.log4j.FileAppender（文件），
•org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），
•org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）
•org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

Appender的配置要么是它对象的类的一个属性（有get方法），要么是对应的一个类。

如：

//定义C1为ConsoleAppender 输出到控制台
log4j.appender.C1=org.apache.log4j.ConsoleAppender
//以下都是ConsoleAppender的属性
log4j.appender.C1.Threshold=WARNING
log4j.appender.C1.Target=System.out
log4j.appender.C1.Encoding=UTF-8
// layout描述输出格式 PatternLayout是一个实现类
log4j.appender.C1.layout=org.apache.log4j.PatternLayout
//这个是PatternLayout的属性
log4j.appender.C1.layout.ConversionPattern=[CONSOLE] %d - %c -%-4r [%t] %-5p %c %x - %m%n

Log4j提供的layout有以下几种：

•org.apache.log4j.HTMLLayout（以HTML表格形式布局），
•org.apache.log4j.PatternLayout（可以灵活地指定布局模式），
•org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）
•org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

Log4j提供的level有：

OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。Log4j建议只使用四个级别，优先级从高到低分别是ERROR、WARN、INFO、DEBUG。

关于rootLogger ：

log4j.rootLogger = [ level ] , appenderName, appenderName, …

rootLogger 和 rootCategory是同义词，或者说Category和Logger是同义词。原始的叫法是Category，后来为了与jdk1.4的日志功能保持一致，改为叫Logger。

关于logger的树状层级：

如果存在这样几个logger：

log4j.rootLogger = ERROR,A1

log4j.logger.x = INFO,A2

log4j.logger.x.y= INFO,A3

这三个logger是一个从上到下的树状结构，下面的节点会自动从上面的节点继承Appender，而不继承Level，上面的三个等效于：

log4j.rootLogger = ERROR,A1

log4j.logger.x = INFO,A1,,A2

log4j.logger.x.y= INFO,A1,A2,A3

如果要拒绝这种集成，可以设置additivity为false，如下：

log4j.rootLogger = ERROR,A1

log4j.logger.x = INFO,A2

log4j. additivity.x =false

log4j.logger.x.y= INFO,A3

这样log4j.logger.x将不再继承A1， log4j.logger.x.y从log4j.logger.x继承，也将没有A1。

对于logger的这种树状结构，当遇到日志记录时，将会根据Logger所在的包的路径进行匹配，从Logger树的叶子结点网上匹配配置的所有Logger，遇到第一个匹配（也就是最长的包路径匹配）就停止，不再往上走了。然后根据这个匹配的Logger（这个Logger也可能会从父Logger继承Appender）来进行输出。