Log4j 2 介绍

本文为转载学习

英文原文：Apache.org，编译：ImportNew - 滕开选

译文链接：http://www.importnew.com/3046.html

关于Log4j 2 

Log4j 2 是Log4j的升级版，与以前的版本Log4j 1.x相比、有重大的改进，在修正了Logback固有的架构问题的同时，改进了许多Logback所具备的功能。
Log4j 2的特性以及改进有：

• API分离：Log4j将API与实现分离开来。开发人员如今能够很清楚地知道可以使用哪些没有兼容问题的类和方法，同时又容许经过本身实现来加强功能。

• 改进的性能：Log4j 2的性能在某些关键领域比Log4j 1.x更快，并且大多数状况下与Logback至关。更多的信息请参考性能。

• 多个API支持：Log4j 2提供最棒的性能的同时，还支持SLF4J和公共日志记录API。

• 自动配置加载：像Logback同样，一旦配置发生改变，Log4j 2能够自动载入这些更改后的配置信息，又与Logback不一样，配置发生改变时不会丢失任何日志事件。

• 高级过滤功能：与Logback相似，Log4j 2能够支持基于上下文数据、标记，正则表达式以及日志事件中的其余组件的过滤。Log4j 2 可以专门指定适用于全部的事件，不管这些事件在传入Loggers以前仍是正在传给 appenders。另外，过滤器还能够与Loggers关联起来。与Logback不一样的是，Filter公共类能够用于任何状况。

• 插件架构：全部能够配置的组件都以Log4j插件的形式来定义。一样地，不须要修改任何Log4j代码就能够建立新的Appender、Layout、Pattern Convert 等等。Log4j自动识别预约义的插件，若是在配置中引用到这些插件，Log4j就自动载入使用。

• 属性支持：属性能够在配置文件中引用，也能够直接替代或传入潜在的组件，属性在这些组件中可以动态解析。属性能够是配置文件，系统属性，环境变量，线程上下文映射以及事件中的数据中定义的值。用户能够经过增长本身的Lookup插件来定制本身的属性。

文档

Log4j 2用户文档可在这里在线阅读，或下载成PDF格式。

要求

Log4j 2至少要求安装Java 5，然而使用Java 6的加强功能能够提升性能。有些特性须要一些可选的依赖，这些依赖在相关特性的文档中有说明。

资讯

Log4j 2如今已经能够测试。API与Log4j 1.x 不兼容，不过经过适配器能够继续使用Log4j 1.x API。 适配器一样适用于Commons Logging和SLF4J.

文档

Log4j 2用户文档可在这里在线阅读，或下载成PDF格式。

要求

Log4j 2至少要求安装Java 5，然而使用Java 6的加强功能能够提升性能。有些特性须要一些可选的依赖，这些依赖在相关特性的文档中有说明。

资讯

Log4j 2如今已经能够测试。API与Log4j 1.x 不兼容，不过经过适配器能够继续使用Log4j 1.x API。 适配器一样适用于Commons Logging和SLF4J.

Log4j 2.x的构建与安装

构建

Log 4j 运行在Apache 软件基金会下的代码仓库中。Log4j 代码仓库能够找到如何获取当前绝大多的源代码的细节。能够根据Log4j下载说明下载最新的源代码

Log4j 2.x 使用Maven 2或3做为生成工具。在root目录中仅运行”mvn install”就能够生成Log4j.

程序中如何使用

在你的程序中使用Log4j以前必须确保API和Core jars 在程序的classpath中。使用Maven将下面的依赖加入pom.xml.

<dependencies>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-api</artifactId>
<version>2.0-beta3</version>
</dependency>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.0-beta3</version>
</dependency>
</dependecies>

Apache 公共日志记录

公共日志记录在许多组件中使用，不一样的组建能够选择特定的日志记录的实现。为了把这些组件的日志功能集成到Log4j 2，须要加入下面的依赖，并且不能删除Commons Logging jar

<dependencies>
<dependency>
<groupId>org.apache.logging.log4j.adapters</groupId>
<artifactId>log4j-jcl</artifactId>
<version>2.0-beta3</version>
</dependency>
</dependecies>

SLF4J

SLF4J是另外一个受欢迎的日志记录API，经过加入下面的依赖以及SLF4J依赖就能够将其绑定到Log4j 2.

<dependencies>
<dependency>
<groupId>org.apache.logging.log4j.adapters</groupId>
<artifactId>log4j-slf4j-impl</artifactId>
<version>2.0-beta3</version>
</dependency>
</dependecies>

升级注意事项
Apache Log4j 2不支持兼容老版本。若是要升级到Log4j 2请铭记下列几条：

• 须要Java 5

• 简化了XML配置，不兼容logj4 1.x。

• 不支持属性文件配置

• 支持JSON配置

• 虽然Log4j 2不能与Log4j 1.x直接兼容，可是能够经过自带兼容桥梁来下降升级带来的代码更改。