关于升级 jar 包等前提要求

按照官方推荐默认放到 resource 目录下面，名称必须叫 log4j2.xml ，其余文件名会读取失败，无需配置其它文件，如下图：

（将图一三个标红的地方应该改为 3.0），结果如图二 图一：

图二：

针对目前代码现状，为了不改动配置和代码，实现了 log4j-1.2-api-2.8.2.jar 预留的相关接口，具体哪个接口需要查看原本工程初始化 log4j 的类用的是哪个接口，比如 org.apache.log4j.xml.DOMConfigurator 类里面的相关接口，如下所示：

该方式只需要按照第一步删除旧的 jar 包，上传新的 jar 包，特别是 log4j-1.2-api-2.8.2.jar 包，即可无缝完成升级

不同的线程输出日志到不同的文件中有关 Log4j2 的内容很多，在此不一一列出，这里只介绍一种常用方法。如果在开发中遇到任何问题，推荐去官方文档中寻找解决方案。

修改 log4j2.xml 配置文件如下，主要是添加 Routes 标签：

实现 StrLookup 中的 lookup 方法，代码如下：

测试方法如下：

要实现该功能，还要从 RoutingAppender 身上做文章。RoutingAppender 主要用来评估 LogEvents，然后将它们路由到下级 Appender。目标 Appender 可以是先前配置的并且可以由其名称引用的 Appender，或者可以根据需要动态地创建 Appender。RoutingAppender 应该在其引用的任何 Appenders 之后配置，以确保它可以正确关闭。 RoutingAppender 中的 name 属性用来指定该 Appender 的名字，它可以包含多个 Routes 子节点，用来标识选择 Appender 的条件，而 Routes 只有一个属性 “pattern”，该 pattern 用来评估所有注册的 Lookups，并且其结果用于选择路由。在 Routes 下可以有多个 Route，每个 Route 都必须配置一个 key，如果这个 key 匹配 “pattern” 的评估结果，那么这个 Route 就被选中。同时每个 Route 都必须引用一个 Appender，如果这个 Route 包含一个 ref 属性，那么这个 Route 将引用一个在配置中定义的 Appender，如果这个 Route 包含一个 Appender 的定义，那么这个 Appender 将会根据 RoutingAppender 的上下文创建并被重用。 废话说多了，直接上配置才简洁明了。log4j2.xml 配置如下：

根据官方的性能测试我们知道，Loggers all async 的性能最高，但是我们在上边使用的是 Sync 模式（方法一，因为 Appender 默认是 synchronous 的）或 Async Appender 模式（方法二），那么如何更进一步让所有的 Loggers 都是 Asynchronous 的，让我们的配置更完美呢？想要使用 Loggers all async 只需要做两步操作。 因为 Loggers all async 是基于 LMAX Disruptor 实现的，所以我们首先需要添加这个依赖

其次是设置系统属性

可以在前面提到的 ThreadLookup 类中，添加静态代码块

在 src/main/resources 目录下添加 log4j2.component.properties 配置文件，其内容为

依旧需要依赖 com.lmax:disruptor，但不需要设置系统属性 log4j2.contextSelector，在配置中可以混合使用同步和异步的 loggers，使用 或者 去指定需要异步的 loggers， 元素还可以包含 和 用于同步的 loggers。 一个混合了同步和异步的 Loggers 配置如下：

在上面示例的配置中，root logger 就是同步的，但是 com.foo.Bar 的 logger 就是异步的。

在使用异步日志的时候需要注意一些事项，如下：