1.简介
Apache Log4j 是一个非常古老的日志框架，并且是多年来最受欢迎的日志框架。 它引入了现代日志框架仍在使用的基本概念，如分层日志级别和记录器。
2015 年 8 月 5 日，该项目管理委员会宣布 Log4j 1.x 已达到使用寿命。 建议用户使用 Log4j 1 升级到 Apache Log4j 2。因此宏哥觉得有必要介绍一下Log4j 2，今天就单独一篇介绍一下。
2.Log4j2简介
Apache Log4j 2是对 Log4j 的升级，它比其前身 Log4j 1.x 提供了重大改进，并提供了 Logback 中可用的许多改进，同时修复了 Logback 架构中的一些固有问题。
与 Logback 一样，Log4j2 提供对 SLF4J 的支持，自动重新加载日志配置，并支持高级过滤选项。 除了这些功能外，它还允许基于 lambda 表达式对日志语句进行延迟评估，为低延迟系统提供异步记录器，并提供无垃圾模式以避免由垃圾收集器操作引起的任何延迟。
所有这些功能使 Log4j2 成为这三个日志框架中最先进和最快的。
3.log4j2优点
log4j2参考了logback的一些优秀的设计，并且修复了一些问题，因此带来了一些重大的提升，主要有：
（1）异常处理：在logback中，Appender中的异常不会被应用感知到，但是在log4j2中，提供了一些异常处理机制。
（2）性能提升：log4j2相较于log4j 1和logback都具有很明显的性能提升。
（3）自动重载配置：参考了logback的设计，提供自动刷新参数配置，可以动态的修改日志的级别而不需要重启应用。
（4）无垃圾机制，log4j2在大部分情况下，都可以使用其设计的一套无垃圾机制，避免频繁的日志收集导致的jvm gc。
4.log4j2配置说明
log4j 2.x版本不再支持像1.x中的.properties后缀的文件配置方式，2.x版本常用.xml后缀的文件进行配置，除此之外还包含.json和.jsn配置文件
log4j2虽然采用xml风格进行配置，依然包含三个组件,分别是 Logger(记录器)、Appender(输出目的地)、Layout(日志布局)。
4.1XML配置文件解析
（1）根节点Configuration有两个属性:status和monitorinterval,有两个子节点:Appenders和Loggers(表明可以定义多个Appender和Logger).
status用来指定log4j本身的打印日志的级别.monitorinterval为log4j 2.x新特点自动重载配置。指定自动重新配置的监测间隔时间，单位是s,最小是5s。
（2）Appenders节点，常见的有三种子节点:Console、File、RollingFile
Console节点用来定义输出到控制台的Appender.File节点用来定义输出到指定位置的文件的Appender.RollingFile节点用来定义超过指定大小自动删除旧的创建新的的Appender.
通过在子节点中加入<PatternLayout pattern="自定义信息格式"/>进行日志布局
%c 输出所属类的全名，可写为 %c{Num} ,Num类名输出的范围 如："com.sun.aaa.classB",%C{2}将使日志输出输出范围为：aaa.classB%d 输出日志时间其格式为 可指定格式 如 %d{HH:mm:ss}等%l 输出日志事件发生位置，包括类目名、发生线程，在代码中的行数%n 换行符%m 输出代码指定信息，如info(“message”),输出message%p 输出日志的优先级，即 FATAL ,ERROR 等%r 输出从启动到显示该条日志信息所耗费的时间（毫秒数）%t 输出产生该日志事件的线程名
（3）Loggers节点，常见的有两种:Root和Logger.
Root节点用来指定项目的根日志，如果没有单独指定Logger，那么就会默认使用该Root日志输出
Logger节点用来单独指定日志的形式，比如要为指定包下的class指定不同的日志级别等。
5.日志的级别
我们现在要调用logger的方法，不过在这个Logger对象中，有很多方法，所以要先了解log4j的日志级别，log4j规定了默认的几个级别：trace<debug<info<warn<error<fatal等。这里要说明一下：
级别之间是包含的关系，意思是如果你设置日志级别是trace，则大于等于这个级别的日志都会输出。
基本上默认的级别没多大区别，就是一个默认的设定。你可以通过它的API自己定义级别。你也可以随意调用这些方法，不过你要在配置文件里面好好处理了，否则就起不到日志的作用了，而且也不易读，相当于一个规范，你要完全定义一套也可以，不用没多大必要。
这不同的级别的含义大家都很容易理解，这里就简单介绍一下：
trace：是追踪，就是程序推进以下，你就可以写个trace输出，所以trace应该会特别多，不过没关系，我们可以设置最低日志级别不让他输出。
debug：调试么，我一般就只用这个作为最低级别，trace压根不用。是在没办法就用eclipse或者idea的debug功能就好了么。
info：输出一下你感兴趣的或者重要的信息，这个用的最多了。
warn：有些信息不是错误信息，但是也要给程序员的一些提示，类似于eclipse中代码的验证不是有error 和warn（不算错误但是也请注意，比如以下depressed的方法）。
error：错误信息。用的也比较多。
fatal：级别比较高了。重大错误，这种级别你可以直接停止程序了，是不应该出现的错误么！不用那么紧张，其实就是一个程度的问题。
6.环境准备
6.1准备工作
1.下载地址：https://logging.apache.org/log4j/2.x/download.html 宏哥可以通过下载地址下载最新版本是2.17.2。如下图所示：
2.去官方下载log4j 2，导入jar包，基本上你只需要导入下面两个jar包就可以了(xx是乱七八糟的版本号)：
（1）log4j-core-xx.jar
（2）log4j-api-xx.jar
下载好了之后，将jar包添加到Eclipse项目的lib中去。如下图所示：
到此准备工作已经完成了，下边宏哥开始实战！
7.项目实战
7.1开始使用
我们知道，要在某个类中使用log4j记录日志，只需要申明下面的成员变量（其实不一定要是成员变量，只是为了方便调用而已）
代码语言：javascript复制private static Logger logger = LogManager.getLogger(MyApp.class.getName());这里getLogger有一个参数指定的是这个logger的名称，这个名称在配置文件里面可是有需要的，这个待会儿再说。
声明了Logger对象，我们就可以在代码中使用他了。
7.2代码设计
1.在这里宏哥随便写个测试类，调用就是这么简单，log4j的核心在配置文件上。如下图所示：
2.如果没有自定义配置文件，上面这个类在写一个main方法，调用测试类的方法。就可以运行代码测试你写的测试类。如下图所示：
7.3参考代码
代码语言：javascript复制import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
/**
* @author 北京-宏哥
*
* @公众号:北京宏哥
*
* 《手把手教你》系列基础篇（八十六）-java selenium自动化测试-框架设计基础-Log4j 2实现日志输出（详解教程）
*
* 2022年3月24日
*/
public class Test {
static Logger logger = LogManager.getLogger(Test.class.getName());
public boolean hello() {
logger.entry(); // trace级别的信息，单独列出来是希望你在某个方法或者程序逻辑开始的时候调用，和logger.trace("entry")基本一个意思
logger.error("Did it again!"); // error级别的信息，参数就是你输出的信息
logger.info("我是info信息"); // info级别的信息
logger.debug("我是debug信息");
logger.warn("我是warn信息");
logger.fatal("我是fatal信息");
logger.log(Level.DEBUG, "我是debug信息"); // 这个就是制定Level类型的调用：谁闲着没事调用这个，也不一定哦！
logger.exit(); // 和entry()对应的结束方法，和logger.trace("exit");一个意思
return false;
}
public static void main(String[] args) {
Test t = new Test();
t.hello();
}
}7.4运行代码
1.运行代码，右键Run AS->Java Appliance，控制台输出，如下图所示：
从上图可以看到，只有>=ERROR的日志输出来了（这是因为Log4j有一个默认的配置，它的日志级别是ERROR，输出只有控制台）。
7.5定义日志级别
1.宏哥自己新建一个xml文件放在SRC目录下，即根目录下。命令为log4j2.xml，定义好了日志，把日志级别改成了TRACE，如下图所示：
2.参考XML：
代码语言：javascript复制<?xml version="1.0" encoding="UTF-8"?>
<configuration status="OFF">
<appenders>
<Console name="Console" target="SYSTEM_OUT">
<PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
</appenders>
<loggers>
<root level="TRACE">
<appender-ref ref="Console"/>
</root>
</loggers>
</configuration> 3.再次运行代码，控制台输出如下图所示：
从上边的xml文件可以看到宏哥把configuration>loggers>root的level属性改为trace，就可以输出刚才写的所有信息了。
8.外部引用xml配置文件
8.1代码设计
8.2参考代码
代码语言：javascript复制package testSuites;
import java.io.File;
import java.io.FileInputStream;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.core.config.ConfigurationSource;
import org.apache.logging.log4j.core.config.Configurator;
/**
* @author 北京-宏哥
*
* @公众号:北京宏哥
*
* 《手把手教你》系列基础篇（八十六）-java selenium自动化测试-框架设计基础-Log4j2实现日志输出（详解教程）
*
* 2022年3月27日
*/
public class ConfigTest {
private static Logger logger = LogManager.getLogger(ConfigTest.class);
/**
* log4j 2读取配置文件
* log4j 2读取的配置文件可以分为三类：src下的配置文件、绝对路径的配置文件、相对路径的配置文件
*/
//第一类 加载src下的配置文件
public static void test0(){
//src下的配置文件会默认的被log4j的框架加载，我们就不显示的加载了
//直接测试
logger.info("我打印了.......");
//输出内容
//11:06:16.957 [main] INFO testSuites.ConfigTest - 我打印了.......
}
//第二类 绝对路径的配置文件
public static void test1(){
//我们将log4j2.xml放在D盘下
//这是需要手动的加载
//绝对路径配置文件
ConfigurationSource source;
try {
//方法1 使用 public ConfigurationSource(InputStream stream) throws IOException 构造函数
source = new ConfigurationSource(new FileInputStream("F:\workspace\Bjhg_Selenium\log4j2.xml"));
//方法2 使用 public ConfigurationSource(InputStream stream, File file)构造函数
File config=new File("F:\workspace\Bjhg_Selenium\log4j2.xml");
source = new ConfigurationSource(new FileInputStream(config),config);
//方法3 使用 public ConfigurationSource(InputStream stream, URL url) 构造函数
String path="F:\workspace\Bjhg_Selenium\log4j2.xml";
source = new ConfigurationSource(new FileInputStream(path),new File(path).toURL());
//source.setFile(new File("D:log4j2.xml"));
//source.setInputStream(new FileInputStream("D:log4j2.xml"));
Configurator.initialize(null, source);
Logger logger = LogManager.getLogger(ConfigTest.class.getName());
logger.trace("trace...");
logger.debug("debug...");
logger.info("info...");
logger.warn("warn...");
logger.error("error...");
logger.fatal("fatal...");
//一下是运行效果
/*11:57:38.457 [main] ERROR testSuites.ConfigTest - error...
11:57:38.461 [main] FATAL testSuites.ConfigTest - fatal...*/
} catch (Exception e) {
e.printStackTrace();
}
}
//第三类 相对路径的配置文件加载
public static void test2(){
//这里需要注意路径中不要出现中文和空格，如果存在中文，请使用url转码
ConfigurationSource source;
try {
//方法1 使用System.getProperty
String config=System.getProperty("user.dir");
source = new ConfigurationSource(new FileInputStream(config "/log4j2.xml"));
Configurator.initialize(null, source);
Logger logger = LogManager.getLogger(ConfigTest.class.getName());
logger.trace("trace...");
logger.debug("debug...");
logger.info("info...");
logger.warn("warn...");
logger.error("error...");
logger.fatal("fatal...");
//输出内容
/*11:57:38.457 [main] ERROR testSuites.ConfigTest - error...
11:57:38.461 [main] FATAL testSuites.ConfigTest - fatal...*/
} catch (Exception e) {
e.printStackTrace();
}
}
public static void main(String[] args) {
//test0();
//test1();
test2();
}
} 8.3运行代码
1.运行代码，右键Run AS->Java Appliance，控制台输出，如下图所示：
9.小结
好了，时间也不早了，今天就分享和讲解到这里，希望对您有所帮助，感谢您耐心地阅读！
