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

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

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

代码都是调试OK的。

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

[html] view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>   
2. <!-- 主要配置为error日志与debug日志分别打印文件，errorLog按照分钟存档，debugLog按照日志文件大小存档，最多保存10个。 -->  
3. <configuration status="debug" monitorInterval="30">   
4. <Properties>  
5.     <Property name="log.path">.</Property>  
6. </Properties>  
7.   
8. <appenders>  
9.     <!--Appender 1. 输出到Console，指定输出格式和过滤器等级为ERROR -->  
10.     <span style="white-space:pre">    </span><Console name="Console" target="SYSTEM_OUT">   
11.         <PatternLayout pattern="[%-5level][%d{yyyy-MM-dd HH:mm:ss}][%F:%L] - %m%n" />   
12.         <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>  
13.     </Console>   
14.       
15.     <!--Appender 2. 输出到滚动保存的文件, 触发保存日志文件的条件是日志文件大于3KB，只保存最新的10个日志-->  
16.     <RollingFile name="debugLog" fileName="${log.path}/debug.log" filePattern="${log.path}/debug-%i.log">  
17.         <ThresholdFilter level="DEBUG" onMatch="ACCEPT" onMismatch="DENY"/>  
18.         <PatternLayout pattern="[%-5level][%d{yyyy-MM-dd HH:mm:ss}][%F:%L] - %m%n" />  
19.         <SizeBasedTriggeringPolicy size="3KB" />  
20.         <!-- DefaultRolloverStrategy 中的参数max，可以限制 SizeBasedTriggeringPolicy中size超出后，只保留max个存档-->  
21.         <DefaultRolloverStrategy max="10"/>  
22.     </RollingFile>  
23.       
24.     <!--Appender 3. 输出到滚动保存的文件, 触发保存日志文件的条件是每分钟第一次的日志事件。ERROR日志是按分钟产生日志 -->  
25.     <RollingFile name="errorLog" fileName="${log.path}/error.log" filePattern="${log.path}/error-%d{yyyy-MM-dd_HH-mm}.log">  
26.         <ThresholdFilter level="ERROR" onMatch="ACCEPT" onMismatch="DENY"/>  
27.         <PatternLayout pattern="[%-5level][%d{yyyy-MM-dd HH:mm:ss}][%C:%F:%L] - %m%n" />  
28.         <TimeBasedTriggeringPolicy />  
29.     </RollingFile>  
30.       
31. </appenders>   
32.   
33. <loggers>  
34.     <root level="trace">  
35.         <appender-ref ref="Console" />  
36.         <appender-ref ref="debugLog" />  
37.         <appender-ref ref="errorLog" />  
38.     </root>   
39. </loggers>  
40. </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

1. package com.ocean.log4j2;  
2.   
3. import org.apache.logging.log4j.LogManager;  
4. import org.apache.logging.log4j.Logger;  
5.   
6. public class Log4j2Testing {  
7.   
8.     private static Logger logger = LogManager.getLogger(LogManager.ROOT_LOGGER_NAME);  
9.       
10.     public static void main(String[] args) {  
11.         // TODO Auto-generated method stub  
12.   
13.         for(int i=0; i<10; i++){  
14.             logger.trace("===root trace");  
15.             logger.debug("===root debug");  
16.             logger.info("===root info");  
17.             logger.warn("===root warn");  
18.             logger.error("===root error");  
19.             logger.fatal("===root fatal");  
20.               
21.             try {  
22.                 Thread.sleep(10000);//等10秒钟  
23.             } catch (InterruptedException e) {  
24.                 // TODO Auto-generated catch block  
25.                 e.printStackTrace();  
26.             }  
27.         }  
28.     }  
29.   
30. }  

对于初次使用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配置文件自定义路径，日志文件动态命名等特性。敬请关注: )