给你的Java应用程序加上日志功能

每个应用程序都需要某种方式同外部世界进行通信并收集数据。这可以利用数据库通过接口来实现，也可以用文本文件来完成。在面对这么多选择的时候，使用普通文本文件来收集和调试数据似乎已经被遗忘了。尽管文本文件无法像最新、最酷的技术那样带给你快感，但是它们（确实）是收集数据和诊断应用程序故障的有效手段。






log4j程序包
java编程语言里可以用的库使得向文件写入数据变容易了，但是为什么还要在有好程序包可用的情况下重新发明车轮呢？java 2 sdk的1.4版将一个日志编写api内置进了语言里，但是在它变得更加成熟之前，我还是更愿意坚持使用更加可靠的工具??比如log4j程序包。我发现它很强健，很可靠，很容易扩展，而且很容易实现。你可以从apache jakarta计划获得log4j。要使用这个程序包，你只需要把log4j.jar文件放在用于应用程序的classpath目录里。

类别从根开始
log4j这个程序包按照类别的概念来组织。在你的应用程序运行期间，log4j可以有任意多个类别。但是总会有一个根类别，它是类别层次开始的地方。类别用点符号来命名，就像java程序包一样。这使得将专门的日志放在你的应用程序变得很容易，而应用程序能够使用代码的已有结构来控制日志statement的处理方式。

类别是可以继承的，所以一个叫做com.versatilesolutions.example的类别可以从com.versatilesolutions类别继承其设置。你可以为类别赋予优先权，让其控制应用程序能够记录的日志量。可用的优先权有调试（debug）、信息（info）、警告（warn）、错误（error），以及致命错误（fatal）等。在调用日志记录程序的时候，你要使用和不同优先权相对应的方法，来指定日志statement的优先权。如果你正在进行的操作很耗资源，那么你可以检查一下当前的优先权是否在活动，以保证耗资源的操作只在statement真正被日志记录的时候进行。

日志的类型和布局
当日志程序包接收到statement的时候，log4j用appender来指定进行什么类型的日志记录。log4j的标准appender有屏幕、文件、旋转文件，以及能够在中央地点收集日志数据的远程appender。appender被用于类别，这样的话，应用程序不同的部分就有不同的日志目的地。

一旦你为类别设置好了优先权和appender，那么剩下的唯一要求就是指定布局了。布局被用来控制你日志statement的具体格式，例如日期、时间、模块名称，以及线程的id。我不会讲到所有可用的格式，因为你可以从log4j的文档里获得这些格式完整的摘要。

log4j的配置可以用xml文件或者java属性文件来完成。我更喜欢利用java属性文件这一技术，因为使用xml文件实现这一目的的例子太多了。listing a里是一个用来配置log4j的属性文件。


这个属性文件里的第一个非注释行指出，根类别具有调试的优先权，而且拥有三个appender，分别由a1、a2和a3来识别。剩下的部分指定了用于每个标识符的appender。在这个属性里，appender是一个控制台（屏幕）、一个旋转文件（rotating file），以及一个udp广播器。

udp广播器是我加到log4j程序包里的一个appender，这样我可以用交互方式来观察日志statement。每个appender都附加有一个布局对象。在本文里，我们用到了patternlayout，它后面接有转化模式。这个转化模式里的字符被用来指定输出。%这个符号用于指定格式字符。在这个例子里，%-5p表示用5个字符取得优先权（p）的左对齐。然后是日期（%d）、线程信息（%t），以及消息（%m），后面还接有行结束字符（%n）。

要在你的应用程序里使用log4j，你需要使用propertyconfigurator来加载这个属性文件。在你启动类里加上下面这一行就能够实现目的：
import org.apache.log4j.propertyconfigurator;
….
propertyconfigurator.configure("path/to/file.properties");

一旦配置被加载，那么要求日志记录能力的应用程序里的每个类都需要参考类别对象。由于类别采用程序包命名的惯例，所以我常常将类的名称用作类别（名称），即使这不是必需的，是否需要还取决于你如何安排配置。声明一个用于类的静态变量就会让日志程序可供使用：
import org.apache.log4j.category;
….
private static final category log = category.getinstance(myclass.class.getname());


记录事件
现在，在你的应用程序里记录日志就很容易了。你只需要调用一个方法就行了，这个方法和你正在记录的消息的优先权相对应。例如下面是一条调试消息：
log.debug("log4j really works!");

如果你想要确保调试优先权是活动的，那么你就要在进行调试调用之前检查它。要注意，即使你发送消息，它也不会被记录下来，除非优先权被正确地设置。检查当前的优先权，只是在尝试日志操作之前避免耗资源操作的一种方法。下面是在日志陈述之前检查优先权的一个例子。
if ( log.isdebugenabled() ) {
log.debug("another log statement.”);
}

你还可以给日志方法加上一个异常，这样的话，异常的细节就会被记录在日志消息里。这个调用的格式如下：
log.warn("oops caught an exception.", myexception);

这应该就是你需要的一切
如果你当前的应用程序或者未来的发展需要一个强健的日志记录工具，那么试一下log4j程序包。它提供了极大的灵活性，有了可配置的appender和优先权系统，你可以控制日志记录，并为你产品的发布调整它，而不需要消耗系统的大量资源。