【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）：

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

【完】