【log4j2】下载、安装、使用

1. 下载

https://logging.apache.org/log4j/2.x/download.html
下载文件名：apache-log4j-2.14.1-bin.zip

2. 安装

（1）解压【apache-log4j-2.14.1-bin.zip】
解压后文件夹：

（2）拷贝【log4j-api-2.14.1.jar】和【log4j-core-2.14.1.jar】到工程中：

（3）jar文件点右键 ->【Build Path】->【Add to Build Path】
关联jar包后：

3. 使用

（1）准备log4j2的配置文件
log4j2的配置文件只能使用：.xml、.json、.jsn。
log4j2默认读取CLASSPATH根目录下的配置文件。

log4j2.xml例(使用方法参考其中的注释)：

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN"> 
	<properties>
		<!-- 导出文件夹和文件名的变量定义 -->
		<property name="LOG_FOLDER">D:/logs2</property>
		<property name="FILE_NAME">log</property>
	</properties>
	 
	<!-- Appenders:输出的目的地 -->
	<!-- 三种常用的节点：
		Console：输出到控制台
		File：输出到文件
		RollingFile：超过指定大小时，自动创建新的的Appender
	-->
    <Appenders>
    	<!-- target：SYSTEM_OUT/SYSTEM_ERR。默认：SYSTEM_OUT。 -->
        <Console name="Console" target="SYSTEM_OUT">
        	<!-- pattern:输出内容的格式 -->
            <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5p %l - %m%n" />  
        </Console>
        
        <RollingFile name="RollingFile" fileName="${LOG_FOLDER}/${FILE_NAME}.log"
        	filePattern="${LOG_FOLDER}/$${date:yyyy-MM}/${FILE_NAME}-%d{yyyy-MM-dd HH-mm}-%i.log">
        	<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5p %l - %m%n"/>
        	<!-- Policies：触发浮动的策略 -->
        	<Policies>
        		<!-- TimeBasedTriggeringPolicy:时间rollover。 -->
        		<!-- interval属性:根据日期格式中的最小时间单位来决定应该多久发生一次rollover。默认值为1。-->
        		<TimeBasedTriggeringPolicy interval="1"/>
        		<!-- SizeBasedTriggeringPolicy：文件大小rollover。-->
        		<SizeBasedTriggeringPolicy size="10 MB"/>
        	</Policies>
        	<!-- Strategy：执行滚动的策略 -->
        	<!-- 两种：DefaultRolloverStrategy/DirectWriteRolloverStrategy -->
        	<!-- DefaultRolloverStrategy:设置最多备份多少本log文件（其余的删除）。 -->
        	<DefaultRolloverStrategy max="20"/>
        </RollingFile>
    </Appenders>  
    
    <Loggers>
    	<!-- Root节点：指定项目的根日志。
			（如果没有单独指定Logger，就会默认使用Root）
			（没有name和additivity属性） -->
    	<!-- level属性：日志输出级别。
    		共有8个级别，按照从低到高为：All < Trace < Debug < Info < Warn < Error < Fatal < OFF -->
    	<Root level="info">
    		<!-- AppenderRef：指定该日志输出到哪个Appender -->
    		<AppenderRef ref="Console" />
	        <AppenderRef ref="RollingFile" />
	    </Root>
	    
	   <!-- Logger节点：单独指定日志的形式。（可以为指定包下的class指定不同的日志级别） -->
	   <!-- name属性：指定该Logger所适用的类或者类所在的包
	   		level属性:日志输出级别。默认为ERROR。 
	   		additivity： (true：遵循父类的Appender。false：不遵循父类的Appender)。默认值true。 -->
	    <Logger name="abc.Main" level="trace" additivity="false">
	    	<!-- AppenderRef节点:指定该日志输出到哪个Appender -->
	    	<!-- 如果没有指定AppenderRef，默认使用Root。
	    		 如果指定了，那么会在指定的这个Appender和Root的Appender中都会输出。
	    		 可以设置Logger的additivity="false"，使得只在自定义的Appender中输出。
	    	 -->
	    	<AppenderRef ref="Console" level="debug" />
            <AppenderRef ref="RollingFile" level="info" />
        </Logger>
    </Loggers>  
</Configuration>

（2）写出log
Main.java

package abc;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

public class Main {
	
	protected static final Logger logger = LogManager.getLogger(Main.class);

	public static void main(String[] args) throws Exception {
		
		logger.trace("trace message");
		logger.debug("debug message");
		logger.info("info message");
		logger.warn("warn message");
		logger.error("error message");
		logger.fatal("fatal message");
	}
}

（3）运行java程序后，看log。
①控制台（因为设定了DEBUG以上级别，所以输出了DEBUG以上的log）：

②D://logs2/log.log（因为设定了INFO以上级别，所以输出INFO级别以上的log）：

③多执行几次，可以看到，按照配置文件里设定的那样，每分钟滚动。


【完】