Log4j 使用参考规范.pdf

Log4j 使用参考规范 Log4j 使用参考规范 Reviewed Date Version Action Description Author by 2008-05- 16 1.0 Create 初稿 曾会锋 Log4j 使用参考规范 目 录 1．简介 1 1． 1 概述 1 1．2 库文件 1 1．3 主要组件2 2 ． 配置2 1． 1 相关配置文件2 1．2 详细配置说明3 1．2 ．1 Logger 五级输出3 1.2.2 输出方式(Appender) 4 1．2 ．3 输出格式（Layout ）9 3 ．调用 11 4 ．注意的问题 12 4 ．1 配置文件区分大小写 12 4 ．2 配置文件放置地方 12 5 ．参考文档 12 第 2 页 共 14 页 Log4j 使用参考规范 1．简介 1 1 概述 程序开发环境中的日志记录是由嵌入在程序中以输出一些对开发人员有用信息的语句 所组成。例如，跟踪语句（trace ），结构转储和常见的System.out.println 或printf 调试语句。 log4j 提供分级方法在程序中嵌入日志记录语句。日志信息具有多种输出格式 多个输出级 别。 使用一个专门的日志记录包，可以减轻对成千上万的 System.out.println 语句的维护成 本，因为日志记录可以通过配置脚本在运行时得以控制。log4j 维护嵌入在程序代码中的日 志记录语句。通过规范日志记录的处理过程，一些人认为应该鼓励更多的使用日志记录并且 获得更高程度的效率。 五级输出，依次为 DEBUG 、INFO 、WARN 、ERROR、FATAL 。使用者可根据不同的 需求，设定不同的输出级别，则得到不同级别的输出结果。 1 2 库文件 目前log4j 有三个可供使用的版本，其中2.0 版本需要JAVA5 （logging services designed for Java 5 and later ）；1.3 版不被推荐 用，我们使用的最多的是1.2 版。目前可download 的 是1.2.15 版。下载地址： /dyn/closer.cgi/logging/log4j / 1.2.15/apache-log4j - 1.2.15.zip 库文件一般为名为log4j .j ar, 使用时加入lib 路径下。 第 1 页 共 14 页 Log4j 使用参考规范 图1.2.1 l