Apache Log4j 架构

2011-05-02

作者：聂勇欢迎转载，请保留作者信息并说明文章来源！

Apache Log4j是当前在J2EE和J2SE开发中用得最多的日志框架（几乎所有项目都用它），因为它具有出色的性能、灵活的配置以及丰富的功能，并且在业务有特殊的要求时，可以使用自定义组件来代替框架中已有的组件来满足要求。

一、组件介绍 | Component Introducation

Log4j主要有三个组件：

负责供客户端代码调用，执行debug(Object msg)、info(Object msg)、warn(Object msg)、error(Object msg)等方法。
Logger类结构

Logger 继承自 Category，Logger有三个子类：

Logger 一共有如下日志级别：

另外，还有两个特殊的日志级别：

负责日志的输出，Log4j已经实现了多种不同目标的输出方式，可以向文件输出日志、向控制台输出日志、向Socket输出日志等。当前Log4j-1.2.6中Appender的子类实现及其层次结构如下：

负责日志信息的格式化。
Layout类结构

已经实现的类有：

参数	作用
%c	logger名字空间的全称，如果加上{<层数>}表示列出从最内层算起的指定层数的名字空间。
%C	调用logger的类的全名（包含包路径）。
%d	日志记录时间，{<日期格式>}使用ISO8601定义的日期格式。
%F	调用logger的源文件名。
%l	日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数。
%L	调用logger的代码行。
%m	输出消息。
%M	调用logger的方法名。
%n	当前平台下的换行符。
%p	该条日志的优先级。
%r	从程序启动时到记录该条日志时已经经过的毫秒数。
%t	产生该日志事件的线程名。
%x	按NDC（Nested Diagnostic Context，线程堆栈）顺序输出日志。
%X	按MDC（Mapped Diagnostic Context，线程映射表）输出日志。通常用于多个客户端连接同一台服务器，方便服务器区分是那个客户端访问留下来的日志。
%%	显示一个百分号。

调用Log4j输出日志时，调用各个组件的顺序如下图所示：
1、日志信息传入 Logger。
2、将日志信息封装成 LoggingEvent 对象并传入 Appender。
4、在 Appender 中调用 Filter 对日志信息进行过滤，调用 Layout 对日志信息进行格式化，然后输出。