log4j加载配置方式和配置详解

log4j配置详解

log4j的配置文件有两种格式分别是xml和properties。本文只讲解properties格式。比较properties简洁易懂。
log4j加载配置文件方式

大家在刚接触log4j时一定都会疑问。log4j的配置文件应该怎么明明并且文件要放在什么目录下。其实log4j加载配置文件有很多方式，大家只需实现以下中的一种即可，推荐用第一种方法，最简单。
src/main/resources 下添加log4j.properties或log4j.xml文件

普通情况下只需将log4j配置文件命名为log4j.properties或log4j.xml(必须这两名之一)，并放在classpath:下。一般放在src/main/resources就行。
配合spring mvc在web.xml中配置Log4jConfigListener、log4jConfigLocation

这种方法好处主要是：
1. 动态的改变记录级别和策略，不需要重启Web应用，如《Effective Enterprise Java》所说。
2. 把log文件定在 /WEB-INF/logs/ 而不需要写绝对路径。

web.xml添加如下配置即可：
<!-- log4j配置，文件路径，因为是跟随项目启动 -->
<context-param>
<param-name>log4jConfigLocation</param-name>
<param-value>classpath:/log4j-customer.properties</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.util.Log4jConfigListener</listener-class>
</listener>

1
2
3
4
5
6
7
8
9

具体可参照: http://www.jb51.net/article/74477.htm

但是这种方式是不被spring官方提倡的，org.springframework.web.util.Log4jConfigListener被加上了@Deprecated注解。主要原因我的理解是log4j的配置文件加载方式有很多种还有是和容器配合（如JBoss）。就是log4j具体加载哪个配置文件是容器决定的。而这种方法则是在web.xml中写死了，可能会和容器的log4j配置相冲突，所有不提倡使用。原话如下：

/**
* Bootstrap listener for custom Log4J initialization in a web environment.
* Delegates to Log4jWebConfigurer (see its javadoc for configuration details).
*
* WARNING: Assumes an expanded WAR file, both for loading the configuration
* file and for writing the log files. If you want to keep your WAR unexpanded or
* don't need application-specific log files within the WAR directory, don't use
* Log4J setup within the application (thus, don't use Log4jConfigListener or
* Log4jConfigServlet). Instead, use a global, VM-wide Log4J setup (for example,
* in JBoss) or JDK 1.4's java.util.logging (which is global too).
*
*/

1
2
3
4
5
6
7
8
9
10
11
12

通过容器或是系统参数传入配置文件的读取路径

这种方法主要是java程序运行时设置『log4j.configuration』参数。参数值是配置文件路径。有些容器可以配合设置log4j配置文件的比如JBoss。其参考如下：

JBoss log4j配置：http://blog.csdn.net/ljhabc1982/article/details/6754084
log4j自动加载配置原理

log4j.jar包中有个LogManager类。其中有段静态代码，在此类被classloader加载时会按一定顺序去加载配置文件：

判断是否设定了系统参数『log4j.configuration』。『log4j.configuration』的值是配置文件的路径。如果有就去加载这个配置文件。
查找资源文件夹（通常是classpath）下是否有log4j.xml，有就用这个文件。
查找资源文件夹（通常是classpath）下是否有log4j.properties，有就用这个文件

源码如下：

package org.apache.log4j;
public class LogManager {
/** @deprecated */
public static final String DEFAULT_CONFIGURATION_FILE = "log4j.properties";
static final String DEFAULT_XML_CONFIGURATION_FILE = "log4j.xml";

//省略多余代码

static {
Hierarchy h = new Hierarchy(new RootLogger(Level.DEBUG));
repositorySelector = new DefaultRepositorySelector(h);
String override = OptionConverter.getSystemProperty("log4j.defaultInitOverride", (String)null);
if (override != null && !"false".equalsIgnoreCase(override)) {
LogLog.debug("Default initialization of overridden by log4j.defaultInitOverrideproperty.");
} else {
String configurationOptionStr = OptionConverter.getSystemProperty("log4j.configuration", (String)null);
String configuratorClassName = OptionConverter.getSystemProperty("log4j.configuratorClass", (String)null);
URL url = null;
if (configurationOptionStr == null) {
url = Loader.getResource("log4j.xml");
if (url == null) {
url = Loader.getResource("log4j.properties");
}
} else {
try {
url = new URL(configurationOptionStr);
} catch (MalformedURLException var7) {
url = Loader.getResource(configurationOptionStr);
}
}

if (url != null) {
LogLog.debug("Using URL [" + url + "] for automatic log4j configuration.");

try {
OptionConverter.selectAndConfigure(url, configuratorClassName, getLoggerRepository());
} catch (NoClassDefFoundError var6) {
LogLog.warn("Error during default initialization", var6);
}
} else {
LogLog.debug("Could not find resource: [" + configurationOptionStr + "].");
}
}

}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

log4j配置文件详解

log4j主要由3大组件组成：Logger、Appender、Layout

Logger：日志记录器，负责收集处理日志记录 （如何处理日志）
Appender：日志输出目的地，负责日志的输出 （输出到什么 地方）
Layout：日志格式化，负责对输出的日志格式化（以什么形式展现）

一个logger可以对应多个appender，一个appender只能对应一个layout。
1、Logger

logger可以有选择的启动和禁用日志的输出，我们经常会在各种框架中看到如：

private static final Logger log = LoggerFactory.getLogger(XX.class);
log就代表了一个Logger实例，他的name就是类“XX”的full quailied name（类的全限定名），按照上图所述，这个log就可以指定多个appender和layout。Logger的名字大小写敏感，其命名有继承机制：例如：name为org.apache.commons的logger会继承name为org.apache的logger。

Log4J中有一个特殊的logger叫做“root”，他是所有logger的根，也就意味着其他所有的logger都会直接或者间接地继承自root。rootlogger可以用Logger.getRootLogger()方法获取。
2、Level：

level用来定义日志的级别，分别可以设置为： OFF（关闭）FATAL（致命的） ERROR（错误）WARN（警告） INFO（信息）DEBUG （调试） ALL（所有），输出日志的策略由此Level决定。
例如：如果logger的Level设置为INFO，那么系统只输出INFO以及以上（WARN、ERROR、FATAL）信息。如果当前logger没有设定Level，那么它在输出日志时采用的策略是：它会使用它继承的Logger的Level作为它自己的Level来处理。如果它的上级也没有设置Level，那么就找上上级，几次类推，直到root为止，（root的Level是不能设为空的，所以最终一定会找到一个Level）。

root的level用 log4j.rootLogger=debug来设置
3、Appender

Appender是日志的输出源，可以控制日志输出到什么地方去。常见的是方式是输出到控制台和保存到文件中。log4j 1.2有几种常见的Appender:

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

properties中添加『og4j.appender.』的前缀来配置Appender。配置示例如下：

#控制台输出
#console log appender ### ConsoleAppender
log4j.appender.ConsoleAppender=org.apache.log4j.ConsoleAppender
log4j.appender.ConsoleAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.ConsoleAppender.layout.ConversionPattern=%d %p [%t] [%c] [%M] - %m%n

#输出所有日志
#all log appender ### AllAppender
log4j.appender.AllAppender=org.apache.log4j.RollingFileAppender
log4j.appender.AllAppender.maxFileSize=50MB
log4j.appender.AllAppender.maxBackupIndex=100
log4j.appender.AllAppender.file=/var/log/com.larrylian.demo/all.log
log4j.appender.AllAppender.threshold=debug
log4j.appender.AllAppender.append=true
log4j.appender.AllAppender.encoding=UTF-8
log4j.appender.AllAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.AllAppender.layout.ConversionPattern=%d %p [%t] [%c] - %m%n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

4、Layout

使用指定的Layout来展示（格式化）日志，常见的Layout有：

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

以上例子的：

log4j.appender.AllAppender.layout=org.apache.log4j.PatternLayout
log4j.appender.AllAppender.layout.ConversionPattern=%d %p [%t] [%c] - %m%n

1
2

就定义日志的输出格式。 『%d %p [%t] [%c] - %m%n』就是日期输出的具体格式其%d、%p表示什么，具体参照:
————————————————
版权声明：本文为CSDN博主「梦幻langel」的原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/mhlangel/article/details/78181607