快精灵印艺坊 您身边的文印专家
广州名片 深圳名片 会员卡 贵宾卡 印刷 设计教程
产品展示 在线订购 会员中心 产品模板 设计指南 在线编辑
 首页 名片设计   CorelDRAW   Illustrator   AuotoCAD   Painter   其他软件   Photoshop   Fireworks   Flash  

 » 彩色名片
 » PVC卡
 » 彩色磁性卡
 » 彩页/画册
 » 个性印务
 » 彩色不干胶
 » 明信片
   » 明信片
   » 彩色书签
   » 门挂
 » 其他产品与服务
   » 创业锦囊
   » 办公用品
     » 信封、信纸
     » 便签纸、斜面纸砖
     » 无碳复印纸
   » 海报
   » 大篇幅印刷
     » KT板
     » 海报
     » 横幅

给你的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和优先权系统,你可以控制日志记录,并为你产品的发布调整它,而不需要消耗系统的大量资源。







返回类别: 教程
上一教程: 只有一个复选框的全选处理
下一教程: 一点心情,写java结课考试之前

您可以阅读与"给你的Java应用程序加上日志功能"相关的教程:
· 在JAVA应用程序中如何实现FTP的功能 (转)
· 在JAVA应用程序中如何实现FTP的功能
· 为您的Java应用程序添加退出事件处理
· 在JAVA应用程序中显示数据库的BLOB图像
· 使用 AOP 来维护遗留 Java 应用程序
    微笑服务 优质保证 索取样品