Log4j的常见用法

对于log4j，一般常用的只要保存如下的内容为属性文件即可：

 #log4j.rootLogger=DEBUG,A1,R
 log4j.rootLogger=INFO,A1,R
 log4j.appender.A1=org.apache.log4j.ConsoleAppender
 log4j.appender.A1.layout=org.apache.log4j.PatternLayout
 log4j.appender.A1.layout.ConversionPattern=%-d{yyyy-MM-dd HH:mm:ss,SSS} [%c]-[%p] %m%n

 log4j.appender.R=org.apache.log4j.RollingFileAppender
 #log4j.appender.R.File=F:/log4j/log.txt
 log4j.appender.R.MaxFileSize=500KB
 log4j.appender.R.MaxBackupIndex=10
 log4j.appender.R.layout=org.apache.log4j.PatternLayout
 log4j.appender.R.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss,SSS} [%t] [%c] [%p] - %m%n

 #log4j.logger.org.springframework.transaction.interceptor=DEBUG

注：上面的第8行是用在在磁盘上生成一个名称为log.txt的文件，这个路径得自己手动建立

下面作一个简要介绍：

一、Log4j基础 
1. Log4j简介 
  Log4j是Apache的一个开源项目，通过Log4j，我们可以记录程序运行时的出错信息，便于软件开发人员分析错误原因，修正Bug。Log4j也可以充当集成开发环境中的调试器的作用，向文件或控制台打印代码的调试信息。Log4j还可以监视程序运行的情况，周期性的记录到文件中或数据库中，以便日后进行统计分析。

2. Log4j由三种主要的组件组成 
  1）Logger组件 
    记录器组件负责产生日志，并能够对日志进行分类筛选，控制什么样的日志应该被输出。可以同时定义多个记录器，每个记录器有自己的名字，记录器之间通过名字来表明隶属关系（如记录器a.b是a.b.c的父亲）。在Log4j中有一个根记录器（org.apache.log4j.Logger类）永远存在，且不可以通过名字检索或引用，可以通过它的静态方法getRootLogger()方法得到它，而其他的记录器则通过静态方法getLogger(String name)来实例化。 
  2）Appender组件 
    在Log4j中，信息通过Appender组件输出到目的地，包括控制台、文件、GUI组件、远程套接字服务器、JMS、NT事件记录器及远程UNIX Syslog守护进程。如下： 
      org.apache.log4j.ConsoleAppender（控制台）， 
      org.apache.log4j.FileAppender（文件）， 
      org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件）， 
      org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件）， 
      org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方） 
  3）Layout组件 
    Layout组件负责格式化输出的日志信息，一个Appender只能有一个Layout。Log4j提供的layout有如下几种： 
      org.apache.log4j.HTMLLayout（以HTML表格形式布局）， 
      org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串）， 
      org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）， 
      org.apache.log4j.xml.XMLLayout（由一系列中log4j.dtd中定义的<log4j:event>元素组件）， 
      org.apache.log4j.PatternLayout（可以灵活地指定布局模式，同c语言的printf()一样灵活）

3. 记录器的日志级别 
  记录器的日志级别在org.apache.log4j.Level类中定义，一共有5种可能的级别，从低到高依次是DEBUG，INFO，WARN，ERROR和FATAL。如果一个记录器没有指定日志级别，那么它将从最近的一个指定了级别的祖先继承级别。

三、Log4j示例 
1. 引入Log4j 
  Log4j官方下载地址（这个是2.0版）： http://logging.apache.org/log4j/

这个是集中下载的：http://logging.apache.org/

这个是1.0版，一般推荐使用这个http://logging.apache.org/log4j/1.2/download.html

2. log4j.properties

Log4J的属性文件配置：

 ### 定义根记录器日志级别  ###
 log4j.rootLogger = debug,stdout,file1,file2

 ### 输出到控制台 ###
 log4j.appender.stdout = org.apache.log4j.ConsoleAppender
 log4j.appender.stdout.Target = System.out
 log4j.appender.stdout.layout = org.apache.log4j.PatternLayout
 log4j.appender.stdout.layout.ConversionPattern =  %d{ABSOLUTE} %5p %c{ 1 }:%L - %m%n

 ### 输出到日志文件 ###
 log4j.appender.file1 = org.apache.log4j.DailyRollingFileAppender
 log4j.appender.file1.File = logs/log.log
 log4j.appender.file1.Append = true
 ### 输出DEBUG级别以上的日志
 log4j.appender.file1.Threshold = DEBUG
 log4j.appender.file1.layout = org.apache.log4j.PatternLayout
 log4j.appender.file1.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n

 ### 保存异常信息到单独文件 ###
 log4j.appender.file2 = org.apache.log4j.DailyRollingFileAppender
 log4j.appender.file2.File = logs/error.log
 log4j.appender.file2.Append = true
 ### 只输出ERROR级别以上的日志
 log4j.appender.file2.Threshold = ERROR
 log4j.appender.file2.layout = org.apache.log4j.PatternLayout
 log4j.appender.file2.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n 

3. 测试

 package test;

 import org.apache.log4j.Logger;

 public class Test {
     private final static Logger logger = Logger.getLogger(Test.class);

     public static void main(String[] args) {
         // TODO Auto-generated method stub
         System.out.println("Test Begin!");
         logger.debug(" 1. debug ");
         logger.info(" 2. info ");
         logger.warn(" 3. warn ");
         logger.error(" 4. error ");
         logger.fatal(" 5. fatal ");
     }
 }

四、XML文件配置方式

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE log4j:configuration PUBLIC "-//APACHE//DTD LOG4J 1.2//EN" "log4j.dtd">
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" configDebug="true">
    <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="[%-5p] %d [%X{track}] [%X{model}] %m [%t][%c:%L]%n"/>
        </layout>
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="levelMin" value="DEBUG"/>
            <param name="AcceptOnMatch" value="true"/>
        </filter>
    </appender>
    <appender name="ERROR" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="datePattern" value="'.'yyyy-MM-dd-HH"/>
        <param name="File" value="logs/error.log"/>
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="[%-5p] %d [%X{track}] [%X{model}] %m [%t][%c:%L]%n"/>
        </layout>
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="LevelMax" value="FATAL"/>
            <param name="LevelMin" value="ERROR"/>
        </filter>
    </appender>
    <!-- info.log文件只输出info信息 -->
    <appender name="INFO" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="datePattern" value="'.'yyyy-MM-dd-HH"/>
        <param name="File" value="logs/info.log"/>
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="[%-5p] %d [%X{track}] [%X{model}] %m [%t][%c:%L]%n"/>
        </layout>
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="LevelMax" value="INFO"/>
            <param name="LevelMin" value="INFO"/>
        </filter>
    </appender>
    <appender name="WARN" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="datePattern" value="'.'yyyy-MM-dd-HH"/>
        <param name="File" value="logs/warn.log"/>
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="[%-5p] %d [%X{track}] [%X{model}] %m [%t][%c:%L]%n"/>
        </layout>
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="LevelMax" value="WARN"/>
            <param name="LevelMin" value="WARN"/>
        </filter>
    </appender>
    <appender name="DEBUG" class="org.apache.log4j.DailyRollingFileAppender">
        <param name="datePattern" value="'.'yyyy-MM-dd-HH"/>
        <param name="File" value="logs/debug.log"/>
        <param name="Encoding" value="UTF-8"/>
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="[%-5p] %d [%X{track}] [%X{model}] %m [%t][%c:%L]%n"/>
        </layout>
        <filter class="org.apache.log4j.varia.LevelRangeFilter">
            <param name="LevelMax" value="DEBUG"/>
            <param name="LevelMin" value="DEBUG"/>
        </filter>
    </appender>
    <root>
        <priority value="DEBUG"/>
        <appender-ref ref="DEBUG"/>
        <appender-ref ref="INFO"/>
        <appender-ref ref="WARN"/>
        <appender-ref ref="ERROR"/>
        <appender-ref ref="CONSOLE"/>
    </root>
</log4j:configuration>