Log4j完全使用手册(未完)-优快云博客

<o:p></o:p>

Log4j完全使用手册<o:p></o:p>

<o:p></o:p>

作者的手稿,2000年11月20日<o:p></o:p>

Ceki Gülcü<o:p></o:p>

<o:p></o:p>

本手册适用于log4j1.2以后版本<o:p></o:p>

<o:p></o:p>

The complete log4j Manual<o:p></o:p>

by Ceki Gülcü<o:p></o:p>

The illustration of the Dromaeosaur (a feathered Dinosaur) on the cover is copyrighted by Mick Ellison.<o:p></o:p>

Reproduced with permission.<o:p></o:p>

You are authorized to download one copy of the electronic book entitled "The complete log4j Manual"<o:p></o:p>

and associated software written by Ceki Gülcü, hereafter referred to as the Work. The Author grants you<o:p></o:p>

a nonexclusive, nontransferable license to use this Work according to the terms and conditions herein.<o:p></o:p>

This License permits you to install the Work for your personal use only.<o:p></o:p>

You may not (i) modify or translate all or part of the Work (ii) create derivative works of the<o:p></o:p>

Work (iii) sublicense, publish, loan, lease, rent, distribute, sell, timeshare, or transfer all or part of<o:p></o:p>

the Work or any rights granted hereunder to any other person or entity; (ii) duplicate the Work,<o:p></o:p>

except for a single backup or archival copy; (iii) alter or remove any proprietary notices (including<o:p></o:p>

copyright notices), labels or marks appearing in the Work.<o:p></o:p>

The Work is owned by its author and is protected by international copyright and other intellectual property<o:p></o:p>

laws. The Author reserves all rights in the Work not expressly granted herein. This license and your<o:p></o:p>

right to use the Work terminate automatically if you violate any part of this Agreement. In the event of<o:p></o:p>

termination, you must destroy the original and all copies of the Work.<o:p></o:p>

THE WORK IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS<o:p></o:p>

OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,<o:p></o:p>

FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. IN NO<o:p></o:p>

EVENT SHALL CEKI GüLCü OR ANY OTHER CONTRIBUTOR BE LIABLE FOR ANY CLAIM,<o:p></o:p>

DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR<o:p></o:p>

OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE WORK OR THE USE<o:p></o:p>

OR OTHER DEALINGS IN THE WORK.<o:p></o:p>

THE WORK COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS.<o:p></o:p>

CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES<o:p></o:p>

WILL BE INCORPORATED IN NEW EDITIONS OF THE WORK. THE AUTHORS MAY MAKE<o:p></o:p>

IMPROVEMENTS AND/OR CHANGES IN THE PUBLICATION(S) AND/OR THE PROGRAM(S)<o:p></o:p>

DESCRIBED IN THIS WORK AT ANY TIME.<o:p></o:p>

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems,<o:p></o:p>

Inc., in the United States and other countries.<o:p></o:p>

<o:p></o:p>

Table of Contents目录<o:p></o:p>

目录............................ ......................................................... .......................................................I<o:p></o:p>

前言......................................................... ....................................................................................IV<o:p></o:p>

本书内容...................................................................................................... IV<o:p></o:p>

排版约定....................................................................................... V<o:p></o:p>

建议与评论................................................................................................. VI<o:p></o:p>

致谢............................................................................................................ VI<o:p></o:p>

1. 绪言........................................................................................................... 1<o:p></o:p>

安装........................................................................................................................... 2<o:p></o:p>

运行示例....................................................................................................... 2<o:p></o:p>

第一步................................................................................................................... 3<o:p></o:p>

在你的应用程序中使用log4j.................................................................. 4<o:p></o:p>

2. log4j架构............................................................................................ 6<o:p></o:p>

日志记录器层次.............................................................................................................. 6<o:p></o:p>

日志创建与修补(CREATION AND RETRIEVAL)............................................................................. 8<o:p></o:p>

级别.................................................................................................................................. 9<o:p></o:p>

日志级别过滤器........................................................................................................ 13<o:p></o:p>

HIERARCHY-WIDE THRESHOLD FILTER................................................................................ 14<o:p></o:p>

输出源.......................................................................................................................... 16<o:p></o:p>

布局器............................................................................................................................. 19<o:p></o:p>

对象操作OBJECT RENDERING ............................................................................................................. 19<o:p></o:p>

A PEEK UNDER THE HOOD.................................................................................................... 20<o:p></o:p>

日志事件类 ........................................................................................................ 22<o:p></o:p>

性能..................................................................................................................... 23<o:p></o:p>

3. 配置脚本CONFIGURATION SCRIPTS.................................................................................... 28<o:p></o:p>

使用基本配置的简单方法............................................................. 28<o:p></o:p>

属性格式的配置文件语法.............................................. 32<o:p></o:p>

设置深度和广度的入口....................................................................... 37<o:p></o:p>

设置日志记录器的级别........................................................................................ 38<o:p></o:p>

设置一个输出源的入口........................................................................ 41<o:p></o:p>

多输出源.......................................................................................................... 42<o:p></o:p>

用XML配置文件........................................................................................... 45<o:p></o:p>

XML脚本的语法.................................................................................................... 46<o:p></o:p>

设置深度和广度的入口 (XML)............................................................... 53<o:p></o:p>

设置日志记录器的级别(XML) ........................................................................... 54<o:p></o:p>

设置一个输出源的入口(XML)............................................................ 57<o:p></o:p>

多输出源(XML)............................................................................................. 59<o:p></o:p>

重新加载配置文件..................................................................................... 62<o:p></o:p>

用log4j嵌入库(EMBEDDED LIBRARIES).................................................................................... 64<o:p></o:p>

ii TABLE OF CONTENTS<o:p></o:p>

默认初始化.................................................................................................... 66<o:p></o:p>

用web配置器初始化log4j...................................................................... 69<o:p></o:p>

在tomcat下的默认初始化......................................................................... 70<o:p></o:p>

初始化sevlet..................................................................................................... 71<o:p></o:p>

在应用服务器初始化log4j............................................................... 72<o:p></o:p>

4. 输出源................................................................................................................. 75<o:p></o:p>

APPENDERSKELETON ........................................................................................................... 76<o:p></o:p>

WRITERAPPENDER............................................................................................................... 79<o:p></o:p>

CONSOLEAPPENDER............................................................................................................. 82<o:p></o:p>

FILEAPPENDER.................................................................................................................... 83<o:p></o:p>

ROLLINGFILEAPPENDER ...................................................................................................... 84<o:p></o:p>

DAILYROLLINGFILEAPPENDER............................................................................................ 86<o:p></o:p>

SOCKETAPPENDER ............................................................................................................... 88<o:p></o:p>

JMSAPPENDER.................................................................................................................... 91<o:p></o:p>

SMTPAPPENDER................................................................................................................ 101<o:p></o:p>

ASYNCAPPENDER............................................................................................................... 105<o:p></o:p>

HANDLING ERRORS............................................................................................................ 108<o:p></o:p>

写你自己的输出源........................................................................................ 110<o:p></o:p>

5. 布局器...................................................................................................................... 113<o:p></o:p>

写你自己的输出源............................................................................................ 113<o:p></o:p>

PATTERNLAYOUT............................................................................................................... 116<o:p></o:p>

XMLLAYOUT..................................................................................................................... 120<o:p></o:p>

HTMLLAYOUT .................................................................................................................. 121<o:p></o:p>

6. 自定义过滤器................................................................................................... 123<o:p></o:p>

写你自己的过滤器............................................................................................... 126<o:p></o:p>

7. 诊断环境...................................................................................... 128<o:p></o:p>

映射诊断环境...................................................................................... 128<o:p></o:p>

嵌套诊断环境....................................................................................... 135<o:p></o:p>

8. 扩张log4j................................................................................................. 138<o:p></o:p>

写你自己的级别(LEVEL) ............................................................................................. 139<o:p></o:p>

写自己的日志记录器(LOGGER)类................................................................................. 143<o:p></o:p>

包装日志记录器类.......................................................................................... 144<o:p></o:p>

更广的上下文......................................................................................................... 153<o:p></o:p>

9. 变化................................................................................................................... 163<o:p></o:p>

在版本1.1.星河1.2之间的变化........................................................................... 163<o:p></o:p>

日志记录器(LOGGER)取代范畴类(CATEGORY)......................................................................... 163<o:p></o:p>