Log4j的使用之配置

对log4j环境的配置就是对root logger的配置，包括把root logger设置为哪个级别(level)；为它增加哪些appender，等等。这些可以通过设置系统属性的方法来隐式地完成，也可以在程序里调用XXXConfigurator.configure()方法来显式地完成。

可以通过两种方式来对log4j进行配置

A）程序配置

BasicConfigurator.configure()方法使用最简的方法配置log4j环境。注：所谓配置log4j环境，就是指配置root logger，因为所有其它的logger都是root logger的后代，所以它们（默认情况下）都将继承root logger的性质。

BasicConfigurator.configure()完成的任务是：

1. 用默认pattern创建PatternLayout对象p：
   PatternLayout p = new PatternLayout("%-4r[%t]%-5p%c%x - %m%n");
2. 用p创建ConsoleAppender对象a，目标是system.out，标准输出设备：
   ConsoleAppender a = new ConsoleAppender(p,ConsoleAppender.SYSTEM_OUT);
3. 为root logger增加一个ConsoleAppender p：
   rootLogger.addAppender(p);
4. 把root logger的log level设置为DEBUG级别：
   rootLogger.setLevel(Level.DEBUG);

B) 文件配置

B1)Xml格式的配置文件

 log4j的xml配置文件的树状结构如下所示，注意下图只显示了常用的部分。 :.

          xml declaration and dtd
            |
          log4j:configuration
            |
            +-- appender (name, class)
            |     |
            |     +-- param (name, value)
            |     +-- layout (class)
            |           |
            |           +-- param (name, value)
            +-- logger (name, additivity)
            |     |
            |     +-- level (class, value)
            |     |     |
            |     |     +-- param (name, value)
            |     +-- appender-ref (ref)
            +-- root
                  |
                  +-- param (name, class)
                  +-- level
                  |     |
                  |     +-- param (name, value)
                  +-- appender-ref (ref) 

创建ConsoleAppender对象
ConsoleAppender的构造方法不接受其它的参数。 :.

          ... ... ... ...
          <appender name="console.log" class="org.apache.log4j.ConsoleAppender">
            <layout ... >
              ... ...
            </layout>
          </appender>
          ... ... ... ...
       

 

创建FileAppender对象
可以为FileAppender类的构造方法传递两个参数：File表示日志文件名；Append表示如文件已存在，是否把日志追加到文件尾部，可能取值为"true"和"false"（默认）。 :.

          ... ... ... ...
          <appender name="file.log" class="org.apache.log4j.FileAppender">
            <param name="File" value="/tmp/log.txt" />
            <param name="Append" value="false" />
            <layout ... >
              ... ...
            </layout>
          </appender>
          ... ... ... ...
       

 

创建RollingFileAppender对象
除了File和Append以外，还可以为RollingFileAppender类的构造方法传递两个参数：MaxBackupIndex备份日志文件的个数（默认是1个）；MaxFileSize表示日志文件允许的最大字节数（默认是10M）。 :.

          ... ... ... ...
          <appender name="rollingFile.log" class="org.apache.log4j.RollingFileAppender">
            <param name="File" value="/tmp/rollingLog.txt" />
            <param name="Append" value="false" />
            <param name="MaxBackupIndex" value="2" />
            <param name="MaxFileSize" value="1024" />
            <layout ... >
              ... ...
            </layout>
          </appender>
          ... ... ... ...
       

 

创建PatternLayout对象
可以为PatternLayout类的构造方法传递参数ConversionPattern。 :.

          ... ... ... ...
          <layout class="org.apache.log4j.PatternLayout>
            <param name="Conversion" value="%d [%t] %p - %m%n" />
          </layout>
          ... ... ... ...
       

 一个完整的例子如下：

log4j.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="appender1" class="org.apache.log4j.FileAppender">
    <param name="File" value="gasturbine.log1.txt"/>
    <param name="Append" value="false"/>
    <layout class="org.apache.log4j.PatternLayout">
      <param name="ConversionPattern" value="%d [%t] %p - %m%n"/>
    </layout>
  </appender>
 
 <appender name="appender2" class="org.apache.log4j.RollingFileAppender">
  <param name="File" value="gasturbine.log2.txt" />
  <param name="Append" value="false" />
  <param name="MaxBackupIndex" value="5" />
  <param name="MaxFileSize" value="1024" />
  <layout class="org.apache.log4j.PatternLayout">
   <param name="ConversionPattern" value="%d [%t] %p - %m%n" />
  </layout>
 </appender>
 
  <root>
    <level value ="debug"/>
    <appender-ref ref="appender1"/>
    <appender-ref ref="appender2"/>
  </root>
 
</log4j:configuration>

    可以用下面这种方法把配置信息文件读入到Java程序中:

  DOMConfigurator.configure("classes/log4j.xml");

B1)文本文件形式的配置文件

      
一个例子：

log4j.properties

#Logger
log4j.rootLogger=DEBUG, appender1,appender2

#Appender1
log4j.appender.appender1=org.apache.log4j.FileAppender
log4j.appender.appender1.File=gasturbine.log1.txt

#Appender2
log4j.appender.appender2=org.apache.log4j.RollingFileAppender
log4j.appender.appender2.File=gasturbine.log2.txt
log4j.appender.appender2.MaxFileSize=1024KB
log4j.appender.appender2.MaxBackupIndex=5

#Layout1
log4j.appender.appender1.layout=org.apache.log4j.PatternLayout
log4j.appender.appender1.layout.ConversionPattern=[%d] %t %c %-5p - %m%n

#Layout2
log4j.appender.appender2.layout=org.apache.log4j.PatternLayout
log4j.appender.appender2.layout.ConversionPattern=[%d] %t %c %-5p - %m%n

#define the level of package
log4j.logger.gasturbine.model.component.compmodel.volume=DEBUG

与xml文件功能非常累似，就不再废话了

注意装载方式：PropertyConfigurator.configure("classes/log4j.properties");