log4j日志输出规范.docxVIP

Log4j 使用参考规范 日期版本动作描述作者审核人2016-10-12V1.0创建初稿胡延彬 目录  TOC \o 1-3 \h \z \u  HYPERLINK \l _Toc464030131 简介  PAGEREF _Toc464030131 \h 3  HYPERLINK \l _Toc464030132 1. 概述  PAGEREF _Toc464030132 \h 3  HYPERLINK \l _Toc464030133 2. 库主件  PAGEREF _Toc464030133 \h 3  HYPERLINK \l _Toc464030134 3. 主要组件  PAGEREF _Toc464030134 \h 3  HYPERLINK \l _Toc464030135 配置  PAGEREF _Toc464030135 \h 4  HYPERLINK \l _Toc464030136 1. 相关配置文件  PAGEREF _Toc464030136 \h 4  HYPERLINK \l _Toc464030137 2. 详细配置说明  PAGEREF _Toc464030137 \h 5  HYPERLINK \l _Toc464030138 3. 输出方式  PAGEREF _Toc464030138 \h 5  HYPERLINK \l _Toc464030139 4. 输出格式  PAGEREF _Toc464030139 \h 6  HYPERLINK \l _Toc464030140 调用  PAGEREF _Toc464030140 \h 7  HYPERLINK \l _Toc464030141 注意问题  PAGEREF _Toc464030141 \h 7  HYPERLINK \l _Toc464030142 参考文档  PAGEREF _Toc464030142 \h 8  简介 1. 概述 程序开发环境中的日志记录是由嵌入在程序中以输出一些对开发人员有用信息的语句 所组成。例如，跟踪语句（trace），结构转储和常见的System.out.println或printf调试语句。 log4j 提供分级方法在程序中嵌入日志记录语句。日志信息具有多种输出格式和多个输出级 别。 使用一个专门的日志记录包，可以减轻对成千上万的System.out.println 语句的维护成 本，因为日志记录可以通过配置脚本在运行时得以控制。log4j 维护嵌入在程序代码中的日 志记录语句。通过规范日志记录的处理过程，一些人认为应该鼓励更多的使用日志记录并且 获得更高程度的效率。 五级输出，依次为DEBUG、INFO、WARN、ERROR、FATAL。使用者可根据不同的 需求，设定不同的输出级别，则得到不同级别的输出结果。 （在正式生产环境中，一般设定为 warn） 2. 库主件 目前log4j 2.0 版本需要JAVA5（logging services designed for Java 5 and later）；1.3 版不被推荐使用，我们使用的最多的是1.2版。目前可download 的是1.2.17 版。下载地址： HYPERLINK /dyn/closer.cgi/logging/log4j/ /dyn/closer.cgi/logging/log4j/ 库文件一般为名为log4j.jar, 使用时加入lib路径下。 3. 主要组件 Log4j有三个主要组件： loggers、appenders和layouts。这三个组件协同工作，使开发 人员能够根据消息类型和级别来记录消息，并且在程序运行期控制消息的输出格式位置。 Logger：记录器； Logger 负责处理日志记录的大部分操作。 Appender：挂载点； Appender 负责控制日志记录操作的输出。 Layout：布局； Layout 负责格式化Appender 的输出。 配置 1. 相关配置文件 Log4j 的配置文件可以使用XML 文件和property 文件。这里我们主要使用perties 配置文件，其比较直观，便于修改和维护。下面是一个log4j 配置文件的例 子： log4j.rootLogger=warn, logfile, errorLogger, console log4j.appender.console=org.apache.log4j.ConsoleAppender log4j.appender.