由于 Log4J 得到广泛应用,从使用者的角度考虑,本文所设计的框架,采用了部分 Log4J 的接口和概念,但内部实现则完全不同。使用 Java 实现日志框架,关键的技术在于前面提及的Java日志框架特性的内部实现,特别是:日志的分类和级别、日志分发框架的设计、日志记录器的设计以及在设计中的高性能和高稳定性的考虑。
2.1系统架构
Java日志框架可以分为日志记录模块和日志输出模块两大部分。日志记录模块负责创建和管理日志记录器 (Logger) ,每一个 Logger 对象负责按照不同的级别 (LoggerLevel) 接收各种记录了日志信息的日志对象 (LogItem) , Logger 对象首先获取所有需要记录的日志,并且同步地将日志分派给日志输出模块。日志输出模块则负责日志 输出器 (Appender) 的创建和管理,以及日志的输出。系统中允许有多个不同的日志 输出器 ,日志 输出器 负责将日志记录到存储介质当中。系统结构如下图 1 所示:
图 1 ,Java日志系统结构图
下图 2 使用 UML 类图给出了Java日志系统的架构:
图 2 ,日志系统框架架构图
在图 2 给出的架构中,日志记录器 Logger 是整个日志系统框架的用户使用接口,程序员可以通过该接口记录日志,为了实现对日志进行分类,系统设计允许存在多个 Logger 对象,每一个 Logger 负责一类日志的记录, Logger 类同时实现了对其对象本身的管理。 LoggerLevel 类定义了整个日志系统的级别,在客户端创建和发送日志时,这些级别会被使用到。 Logger 对象在接收到客户端创建和发送的日志消息时,同时将该日志消息包装成日志系统内部所使用的日志对象 LogItem ,日志对象除了发送端所发送的消息以外,还会包装诸如发送端类名、发送事件、发送方法名、发送行号等等。这些额外的消息对于系统的跟踪和调试都非常有价值。包装好的 LogItem 最终被发送给 输出器 ,由这些 输出 器负责将日志信息写入最终媒介, 输出器 的类型和个数均不固定,所有的 输出器 通过 AppenderManager 进行管理,通常通过配置文件即可方便扩展出多个 输出器 。
2.2日志记录部分的设计
如前文所述,日志记录部分负责接收日志系统客户端发送来的日志消息、日志对象的管理等工作。下面详细描述了日志记录部分的设计要点:
1.日志记录器的管理
系统通过保持多个 Logger 对象的方式来进行日志记录的分类。每一个 Logger 对象代表一类日志分类。因此, Logger 对象的名称属性是其唯一标识,通过名称属性获取一个 Logger 对象:
- Logger logger = Logger.getLogger(“LoggerName”);
一般的,使用类名来作为日志记录器的名称,这样做的好处在于能够尽量减少日志记录器命名之间的冲突(因为 Java 类使用包名),同时能够将日志记录分类得尽可能的精细。因此,假定有一 UserManager 类需要使用日志服务,则更一般的使用方式为:
- Logger logger = Logger.getLogger(UserManager.class);
2.日志分级的实现
按照日志目的不同,将日志的级别由低到高分成五个级别:
DEBUG - 表示输出的日志为一个调试信息
INFO - 表示输出的日志是一个系统提示
WARN - 表示输出的日志是一个警告信息
ERROR - 表示输出的日志是一个系统错误
FATAL - 表示输出的日志是一个导致系统崩溃严重错误
这些日志级别定义在 LoggerLevel 接口中,被日志记录器 Logger 在内部使用。而对于日志系统客户端则可使用 Logger 类接口对直接调用并输出这些级别的日志, Logger 的这些接口描述如下:
- public void debug(String msg); // 输出调试信息
- public void info(String msg); // 输出系统提示
- public void warn(String msg); // 输出警告信息
- public void fatal(String msg); // 输出系统错误
- public void error(String msg); // 输出严重错误
通过对 Logger 对象上这些接口的调用,直接为日志信息赋予了级别属性,这样为后继的按照不同级别进行输出的工作奠定了基础。
3.日志对象信息的获取
日志对象上包含了一条日志所具备的所有信息。通常这些信息包括:输出日志的时间、 Java 类、类成员方法、所在行号、日志体、日志级别等等。在 JDK1.4 中可以通过在方法中抛出并且捕获住一个异常,则在捕捉到的异常对象中已经由 JVM 自动填充好了系统调用的堆栈,在 JDK1.4 中则可以使用 java.lang.StackTraceElement 获取到每一个堆栈项的基本信息,通过对日志客户端输出日志方法调用层数的推算,则可以比较容易的获取到 StackTraceElement 对象,从而获取到输出日志时的 Java 类、类成员方法、所在行号等信息。在 JDK1.3 或者更早的版本中,相应的工作则必须通过将异常的堆栈信息输出到字符串中,并分析该字符串格式得到。
2.3日志输出部分的设计
日志输出部分的设计具有一定的难度,在本文设计的日志系统中,日志的输出、多线程的支持、日志系统的扩展性、日志系统的效率等问题都交由日志输出部分进行管理。
1.日志输出器的继承结构
在日志的输出部分采用了二层结构,即定义了一个抽象的日志输出器( AbstractLoggerAppender ) , 然后从该抽象类继承出实际的日志输出器。 AbstractLoggerAppender 定义了一系列的对日志进行过滤的方法,而具体输出到存储媒介的方法则是一个抽象方法,由子类实现。在系统中默认实现了控制台输出器和文件输出器两种,其中控制台输出器的实现颇为简单。
2.文件输出器的内部实现
在日志记录部分的实现中,并没有考虑多线程、高效率等问题,因此文件输出器必须考虑这些问题的处理。在文件输出器内部使用 java.lang.Vector 定 义了一个线程安全的高速缓冲,所有通过日志记录部分分派到文件输出器的日志被直接放置到该高速缓冲当中。同时在文件输出器内部定义一个工作线程,负责定期 将高速缓冲中的内容保存到文件,在保存的过程中同时可以进行日志文件的备份等工作。由于采用了高速缓冲的结构,很显然日志客户端的调用已经不再是一个同步 调用,从而不再会需要等到文件操作后才返回,提高的系统调用的速度。该原理 如图 3 所示:
图 3 ,文件输出器内部结构
2.4设计难点
通过上述设计,一个具有良好扩展能力的高性能Java日志架就已经具有了一定的雏形。在设计过程中几个难点问题需要进一步反思。
一、是否整个系统应当采用完全异步的结构,通过类似于消息机制的方式来进行由日志客户端发送日志给日志系统。这种方式可以作为日志系统框架另一种运行方式,在后继设计中加以考虑。
二、在文件输出器中可以看到,目前虽然可以扩展多个日志输出器,但是目前提供的抽象类中仅仅提供了对日志的过滤机制,而没有提供的缓存机制,目前的缓存机制被放在文件输出器中实现,因此在未来的进一步设计中,可以将文件输出器中的缓存机制上移到抽象类当中。
2.5设计模式
在设计过程中我们特别注意使用了数个经典的设计模式。如: Logger 对象的创建使用了工厂方法模式( Factory Method )、由 AbstractLoggerAppender 和 ConsoleAppender 以及 FileAppender 构成了策略模式( Strategy ),除此以外,还大量使用了单例模式( Singleton )。在设计中适当运用设计模式能够加快设计进度、提高设计质量。
【编辑推荐】