<script type="text/javascript">
</script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>
<script type="text/javascript">
</script><script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>
Log4j
简明手册1. 概述本文主要描述
Log4j的API的唯一特性和它的设计原理。
Log4j是一个基于许多作者的开放源码的项目。它允许开发员以任意的间隔来控制日志的输出。它通过设在外部的配置文件而达到运行时灵活的设置。最重要的是，
Log4j有一个平稳的学习曲线。注意：根据来自用户的反馈判断，它很容易使人上瘾。2. 导言几乎所有的大型应用程序都包括它的自己的日志和跟踪API。顺应这个规则，E.U. SEMPER 项目决定写它自己的跟踪PAI。这是1996年初。在无数次加强，几次变形和许多工作后，那个API变成了如今的
Log4j，一个流行的java日志包。这个包以Apache Software License协议发布，一个成熟的开放源吗协议。最新的
Log4j版本，包括全部的源码，class文件和文档，你可以在http://jakarta.apache.org/
Log4j/上找到。顺便，
Log4j已经给C, C++, C#, Python, Ruby, and Eiffel 语言都提供了接口。为了调试而插入日志输出到代码里是一个低技术成分的方法，但它可能也是唯一的方法，因为调试器并不是一直可用或者可以适应的，尤其对于多线程的分布使式的大型程序而言。经验指出调试是软件开发周期中一个重要的组成部分。
Log4j拥有几个优点：首先，它提供关于运行程序的准确的环境。一旦代码被插入，不需要人工干预就可以产生调试信息。其次，日志输出可以被有计划的保存在永久媒体中以便日后研究。另外，除了在开发周期中，一个充分详尽的日志包可以被用来作为以后的统计工具。
Log4j当然还有它的缺点，它可能减慢程序。如果太详细，它可能导致屏幕盲目滚动。排除这些情况，
Log4j是可靠的，快速的，可以扩展的。因为日志很少是一个应用程序的主要目的, 设计者们正努力使得
Log4j API学习和使用简单化。3. 日志类别、输出源和布局
Log4j有三个主要的组件：日志类别（
Loggers）、输出源（ Appenders）和布局（Layouts）。这三种类型的组件一起工作使得开发员可以根据信息的类型和级别记录它们，并且在运行时控制这些信息的输出格式和位置。3.1 日志类别的层次结构(
Loggers)
Log4j首要的相对于简单的使用System.out.println()方法的优点是基于它的在禁止一些特定的信息输出的同时不妨碍其它信息的输出的能力。这个能力源自于日志命名空间，也就是说，所有日志声明的空间，它根据一些开发员选择的公式而分类。以前的观察引导我们选择类别作为包的中心概念。然而，自从
Log4j的1.2版本，
Logger类被Cata
Log类所取代，对于那些熟悉
Log4j以前版本的人来说，
Logger类可以被想象成仅仅是Category 类的别名。
Loggers 被指定为实体，
Logger的名字是大小写敏感的，它们遵循以下的命名规则：² 命名继承如果类别的名称（后面加一个点）是其子类别名称的前缀，则它就是另一个类别的祖辈。如果一个类别(
Logger)和它的子类别之间没有其它的继承关系，我们就称之为parent与child的关系。例如，类别"com.foo"是类别"com.foo.Bar"的parent。相似的，"java"是"java.util"的parent，是"java.util.Vector"的父辈。.这个命名规则应该被大多数的开发员所熟悉。根(root) 类别位于
Logger继承结构的最上层。它有两种例外：1.它一直存在2.它不能根据名称而获得。 调用类的静态方法
Logger.getRoot
Logger可以得到它。其它所有的
Logger可以通过静态方法
Logger.get
Logger而得到它们自己的实例。这个方法取希望的
Logger名作为参数。
Logger的一些基本的方法示例如下：package org.apache.
Log4j;public
Logger class {// Creation & retrieval methods:public static
Logger getRoot
Logger();public static
Logger get
Logger(String name);// printing methods:public void debug(Object message);public void info(Object message);public void warn(Object message);public void error(Object message);// generic printing method:public void
Log(Level l, Object message);}
Loggers可以被分配的级别。所有级别的集合包括：DEBUGINFOWARNERRORFATAL它们被定义于org.apache.
Log4j.Level 类。虽然我们不鼓励，但是你们可以通过继承Level类来定义你们自己的级别。我们随后将介绍一个比较好的方法。如果一个
Logger没有被分配一个级别，那么它将从一个被分配了级别的最接近它的ancestor哪里继承。正规的说：² 级别继承对于一个给定的
Logger C，它的继承的级别等于从C开始上溯到的第一个拥有非空级别的
Logger的级别。为了保证所有的
Logger最终能够继承到一个级别，根
Logger通常有一个已经定义了的级别。以下四个表中的数据演示了根据以上规则得到的结果。类别名分配的级别继承的级别rootProotProotX noneProotX.Y noneProotX.Y.ZnoneProotExample 1在例子1中，只有根
Logger定义了一个级别，它的级别的值--"Proot"被所有其它的
Loggers X, X.Y, 和X.Y.Z所继承。类别名分配的级别继承的级别rootProotProotX PxPxX.Y PxyPxyX.Y.ZPxyzPxyzExample 2在例子2中，所有的
Logger都有一个被分配的级别值，所以它们不需要级别继承。类别名分配的级别继承的级别rootProotProotX PxPxX.Y nonePxX.Y.ZPxyzPxyzExample 3在例子3中，根
Logger，以及X和X.Y.Z被分别分配了级别Proot，Px和Pxyz。
Logger X.Y从它的parent X继承了级别值Px。类别名分配的级别继承的级别rootProotProotX PxPxX.Y nonePxX.Y.ZnonePxExample 4在例子4中，根
Logger和X被分别分配了级别"Proot"和"Px"，
Logger X.Y 和 X.Y.Z从被分配了级别的最接近它们的ancestor X那里得到继承。我们需要通过调用
Logger的输出的实例方法之一来实现日志请求。这些输出的方法是debug, info, warn, error, fatal 和
Log.通过定义输出方法来区分日志的请求的级别。例如，如果c是一个
Logger的实例，那么声明 c.info 就是一个INFO级别的日志请求。如果一个日志的请求的级别高于或等于日志的级别那么它就能被启用。反之，将被禁用。一个没有被安排级别的
Logger将从它的父辈中得到继承。这个规则总结如下。² 基本的选择规则假如在一个级别为q的
Logger中发生一个级别为p的日志请求，如果p>=q,那么请求将被启用。这是
Log4j的核心原则。它假设级别是有序的。对于标准级别，我们定义DEBUG < INFO < WARN < ERROR < FATAL. 以下是关于这条规则的一个例子。// get a
Logger instance named "com.foo"
Logger
Logger =
Logger.get
Logger("com.foo");// Now set its level. Normally you do not need to set the // level of a
Logger progamitcally. This is usually done // in configuration files.cat.setLevel(Level.INFO);
Logger bar
Logger =
Logger.get
Logger("com.foo.Bar");// This request is enabled, because WARN >= INFO.
Logger.warn("Low fuel level.");// This request is disabled, because DEBUG < INFO.
Logger.debug("Starting search for nearest gas station."); // The
Logger instance bar
Logger, named "com.foo.Bar",// will inherit its level from the
Logger named // "com.foo" Thus, the following request is enabled // because INFO >= INFO. bar
Logger.info("Located nearest gas station."); // This request is disabled, because DEBUG < INFO.bar
Logger.debug("Exiting gas station search"); 调用get
Logger方法将返回一个同名的
Logger对象的实例。例如，Categoty x =
Logger.get
Logger("wombat");Categoty y =
Logger.get
Logger("wombat");x和y参照的是同一个
Logger对象。这样我们就可以先定义一个
Logger，然后在代码的其它地方不需传参就可以重新得到我们已经定义了的
Logger的实例.同基本的生物学理论--父先于子相反，
Log4j 的
Loggers可以以任何顺序创造和配置。特别是，一个后实例化的"parent"
Logger能够找到并且连接它的子
Logger。配置
Log4j的环境通常在一个应用程序被初始化的时候进行，最好的方法是通过读一个配置文件。这个方法我们将简短介绍。
Log4j使得通过软件组件命名
Logger很容易。我们可以通过
Logger的静态的初始化方法在每一个类里定义一个
Logger，令
Logger的名字等于类名的全局名，而实现
Logger的命名。这是一个实效的简单的定义一个
Logger的方法。因为日志输出带有产生日志的类的名字，这个命名策略使得我们更容易定位到一个日志信息的来源。虽然普通，但却是命名
Logger的常用策略之一。
Log4j没有限制定义
Logger的可能。开发员可以自由的按照它们的意愿定义
Logger的名称。然而，以类的所在位置来命名
Logger好象是目前已知的最好方法。3.2 输出源（Appenders）和布局（Layouts）有选择的能用或者禁用日志请求仅仅是
Log4j的一部分功能。
Log4j允许日志请求被输出到多个输出源。用
Log4j的话说，一个输出源被称做一个Appender. 。Appender包括console（控制台）, files（文件）, GUI components（图形的组件）, remote socket servers（socket 服务）, JMS（java信息服务）, NT Event
Loggers（NT的事件日志）, and remote UNIX Sys
Log daemons（远程UNIX的后台日志服务）。它也可以做到异步记录。一个
Logger可以设置超过一个的appender。用addAppender 方法添加一个appender到一个给定的
Logger。对于一个给定的
Logger它每个生效的日志请求都被转发到该
Logger所有的appender上和该
Logger的父辈
Logger的appender上。换句话说，appender自动从它的父辈获得继承。举例来说，如果一个根
Logger拥有一个console appender，那么所有生效的日志请求至少会被输出到console上。如果一个名为C的
Logger有一个file类型的appender，那么它就会对它自己以及所有它的子
Logger生效。我们也可以通过设置appender的additivity flag 为false，来重载appender的默认行为，以便继承的属性不在生效。调节输出源（appender）添加性的规则如下。输出源的可添加性（Appender Additivity ）一个名为C的
Logger的日志定义的输出将延续到它自身以及它的ancestor
Logger的appenders。这就是术语"appender additivity"的含义。 然而，
Logger C的一个ancestor
Logger P，它的附加标志被设为false，那么C的输出将被定位到所有C的appender，以及从它开始上溯到P的所有ancestor
Logger的appender。
Loggers的附加标记（additivity flag）默认为true。下表是一个例子。
LoggerName AddedAppenders AdditivityFlag Output Targets Comment root A1 not applicable A1 The root
Logger is anonymous but can be accessed with the
Logger.getRoot
Logger() method. There is no default appender attached to root. x A-x1, A-x2 true A1, A-x1, A-x2 Appenders of "x" and root. x.y none true A1, A-x1, A-x2 Appenders of "x" and root. x.y.z A-xyz1 true A1, A-x1, A-x2, A-xyz1 Appenders in "x.y.z", "x" and root. security A-sec false A-sec No appender accumulation since the additivity flag is set to false. security.access none true A-sec Only appenders of "security" because the additivity flag in "security" is set to false. 经常，用户希望自定义不但输出源，而且定义输出格式。这个是通过在一个appender上附加一个layout来完成的。layout是负责根据用户的希望来格式化日志请求。而appender是负责发送格式化的输出到它的目的地。PatternLayout，作为
Log4j标准版中的一部分，让用户指以类似C语言的printf方法的格式来指定日志的输出格式。例如，转化模式为"%r [%t] %-5p %c - %m%n" 的PatternLayout 将输出类似如下的信息：176 [main] INFO org.foo.Bar - Located nearest gas station.第一个栏位是自从程序开始后消逝的毫秒数。第二个栏位是做出日志的线程。第三个栏位是
Log的级别。第四个栏位是日志请求相关的
Logger的名字。而"-"后的文字是信息的表述。
Log4j将根据用户定义的公式来修饰日志信息的内容。例如，如果你经常需要记录Oranges，一个在你当前的项目被用到的对象类型，那么你可以注册一个OrangeRenderer ，它将在一个orange需要被记录时被调用。对象渲染类似的类的结构继承。例如，假设oranges是fruits，如果你注册了一个FruitRenderer，所有的水果包括oranges将被FruitRenderer所渲染。除非你注册了一个orange。对象渲染必须实现ObjectRenderer接口。 <script type="text/javascript">
</script> <script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>
<script type="text/javascript">
</script><script type="text/javascript" src="http://pagead2.googlesyndication.com/pagead/show_ads.js"> </script>
扫一扫
225
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
