Log4j2介绍和特性实例(二)--一个实例和初学注意事项(configuration标签中的 status 和 monitorInterval)

上一篇对官方手册中给出的Log4j2新特性进行了翻译，本篇给出一个Log4j2使用的例子。

本例子包括XML配置文件，需要引用的Jar包，需要Import的文件和代码，这样大家对Log4j2的使用有一个直观的认识。

代码都是调试OK的。

1. XML配置文件默认可以放在源码src目录下，log4j2.xml：

[html] view
plain copy

<?xml version="1.0" encoding="UTF-8"?>   

<!-- 主要配置为error日志与debug日志分别打印文件，errorLog按照分钟存档，debugLog按照日志文件大小存档，最多保存10个。 -->  

<configuration status="debug" monitorInterval="30">   

<Properties>  

    <Property name="log.path">.</Property>  

</Properties>  

  

<appenders>  

    <!--Appender 1. 输出到Console，指定输出格式和过滤器等级为ERROR -->  

    <span style="white-space:pre">    </span><Console name="Console" target="SYSTEM_OUT">   

        <PatternLayout pattern="[%-5level][%d{yyyy-MM-dd HH:mm:ss}][%F:%L] - %m%n" />   

        <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>  

    </Console>   

      

    <!--Appender 2. 输出到滚动保存的文件, 触发保存日志文件的条件是日志文件大于3KB，只保存最新的10个日志-->  

    <RollingFile name="debugLog" fileName="${log.path}/debug.log" filePattern="${log.path}/debug-%i.log">  

        <ThresholdFilter level="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>  

        <PatternLayout pattern="[%-5level][%d{yyyy-MM-dd HH:mm:ss}][%F:%L] - %m%n" />  

        <SizeBasedTriggeringPolicy size="3KB" />  

        <!-- DefaultRolloverStrategy 中的参数max，可以限制 SizeBasedTriggeringPolicy中size超出后，只保留max个存档-->  

        <DefaultRolloverStrategy max="10"/>  

    </RollingFile>  

      

    <!--Appender 3. 输出到滚动保存的文件, 触发保存日志文件的条件是每分钟第一次的日志事件。ERROR日志是按分钟产生日志 -->  

    <RollingFile name="errorLog" fileName="${log.path}/error.log" filePattern="${log.path}/error-%d{yyyy-MM-dd_HH-mm}.log">  

        <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>  

        <PatternLayout pattern="[%-5level][%d{yyyy-MM-dd HH:mm:ss}][%C:%F:%L] - %m%n" />  

        <TimeBasedTriggeringPolicy />  

    </RollingFile>  

      

</appenders>   

  

<loggers>  

    <root level="trace">  

        <appender-ref ref="Console" />  

        <appender-ref ref="debugLog" />  

        <appender-ref ref="errorLog" />  

    </root>   

</loggers>  

</configuration>   

XML配置文件的结构就是在logger下可以关联一个到多个appender，即输出的目的地。在Java代码中则可以通过logger去输出日志。

下面是是用户手册中给出的类图，其中Configuration指的就是XML配置文件。

2. 在Java Build Path需要引入external jar包：

log4j-api-2.5.jar

log4j-core-2.5.jar

3. Java测试代码：

[java] view
plain copy

package com.ocean.log4j2;  

  

import org.apache.logging.log4j.LogManager;  

import org.apache.logging.log4j.Logger;  

  

public class Log4j2Testing {  

  

    private static Logger logger = LogManager.getLogger(LogManager.ROOT_LOGGER_NAME);  

      

    public static void main(String[] args) {  

        // TODO Auto-generated method stub  

  

        for(int i=0; i<10; i++){  

            logger.trace("===root trace");  

            logger.debug("===root debug");  

            logger.info("===root info");  

            logger.warn("===root warn");  

            logger.error("===root error");  

            logger.fatal("===root fatal");  

              

            try {  

                Thread.sleep(10000);//等10秒钟  

            } catch (InterruptedException e) {  

                // TODO Auto-generated catch block  

                e.printStackTrace();  

            }  

        }  

    }  

  

}  

对于初次使用Log4j2的朋友，有两点需要注意：

1）在调试的过程中，可以将配置文件中，configuration标签(<configuration status="debug" monitorInterval="30">)中的status设置为debug，这样用户可以在Eclipse的console看到Log4j2启动和加载配置文件时的打印信息。

2）configuration标签(<configuration status="debug" monitorInterval="30">)中的monitorInterval是用来设置配置文件的动态加载时间的，单位是秒。monitorInterval="30"表示每30秒配置文件会动态加载一次。在程序运行过程中，如果修改配置文件，程序会随之改变。

后面的文章将介绍一些Log4j2特性的验证，包括日志文件存档压缩，异步日志，过滤器，自定义日志等级，XML配置文件自定义路径，日志文件动态命名等特性。敬请关注: )