JDK1.4的java.util.Logging包的使用说明与示例
Sun公司推出的JDK1.4版本在java.util.Logging软件包中新增加了处理应用程序日志工作的核心API函数。这个Java日志软件包提供了一种为Java应用程序嵌入多级日志的简单而又灵活的方法。<!----><o:p></o:p>
简要介绍<o:p></o:p>
java.util.Logging包括1个接口: Filter;15个类: Logger, LogManager, ErrorManager, Level, LogRecord, LoggingPermission, Handler, MemoryHandler, StreamHandler, ConsoleHandler, FileHandler, SocketHandler, Formatter, SimpleFormatter, XMLFormatter,下面是这些类的简单关系是<o:p></o:p>
<o:p></o:p>
处理器的继承关系<o:p></o:p>
<!----><v:rect id="_x0000_s1027" style="MARGIN-TOP: 8.8pt; Z-INDEX: 2; LEFT: 0px; MARGIN-LEFT: 0px; WIDTH: 423pt; POSITION: absolute; HEIGHT: 171.6pt; TEXT-ALIGN: left"><v:textbox>
|
<o:p></o:p> |
|
Handler |
|
MemoryHandler |
|
ConsoleHandler |
|
StreamHandler |
|
FileHandler |
|
SocketHandler |
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
格式化器的继承关系<o:p></o:p>
<o:p></o:p>
<v:rect id="_x0000_s1026" style="MARGIN-TOP: 1.05pt; Z-INDEX: 1; LEFT: 0px; MARGIN-LEFT: 9pt; WIDTH: 387pt; POSITION: absolute; HEIGHT: 163.8pt; TEXT-ALIGN: left"><v:textbox>
|
<o:p></o:p> |
|
Formatter |
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<v:line id="_x0000_s1047" style="Z-INDEX: 22; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="153pt,1.05pt" from="153pt,-30.15pt"><v:stroke endarrow="block"></v:stroke></v:line><v:line id="_x0000_s1046" style="Z-INDEX: 21; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="279pt,-30.15pt" from="153pt,-30.15pt"></v:line><v:roundrect id="_x0000_s1043" style="MARGIN-TOP: 1.05pt; Z-INDEX: 18; LEFT: 0px; MARGIN-LEFT: 99pt; WIDTH: 99pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox style="mso-next-textbox: #_x0000_s1043">
|
SimpleFormatter |
|
XMLFormatter |
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
<o:p></o:p>
类/接口功能概要<o:p></o:p>
1. Filter(过滤器):控制日志记录的输出粒度, 粒度范围超过了Level类提供的功能,在每个handler的setFilter方法中设置该类型<o:p></o:p>
2. Logger(日志记录器): 为了利用日志软件包，Logger对象并调用Logger中多个记录方法中的某一个，例如info(String message)。日志记录器Logger创建一个LogRecord（包含应用程序具体的日志信息）对象并把它传递到一个或者多个Handler，Handler对象再把它输出到目标，这样就实现了日志记录的输出。在日志的输出过程中，Logger和Handler对象可以根据日志等级和过滤器（Filter）来判断那些日志需要记录下来。同时，Handler与Formatter协同工作，Formatter对日志信息进行格式化，决定日志记录如何输出到日志<o:p></o:p>
3. LogManager(日志管理器):管理一个日志记录器对象的名称空间,所有已命名的日志记录器都被保存在这个名称空间中;管理一套日志记录的控制属性,这些是简单的值对像,可以被Handler和logging对象使用来进行自我配置;<o:p></o:p>
4. ErrorManager(错误管理器): ErrorManager对象依附在Handler对象上,用来处理在记录日志期间发生在Handler对象上的任何错误.但在处理输出日志时,假如Handler对象遇到问题时, Handler并没有抛出异常给日志记录的调用者,而是用依附在Handler上的ErrorManager来处理。<o:p></o:p>
5. Level(等级): Java 日志软件包对每一个日志消息都赋以一个等级，以控制日志记录的输出。等级是一个整型数据，记录的等级越高，那么这个整型数据也就越大。下面的等级是在Level类中定义的（按照从低到高的顺序排列）：<o:p></o:p>
| 级别<o:p></o:p> |
重要性<o:p></o:p> |
日志记录器相应的日志方法<o:p></o:p> |
级别数值<o:p></o:p> |
| SEVERE<o:p></o:p> |
非常重要<o:p></o:p> |
severe(String message);<o:p></o:p> |
1000<o:p></o:p> |
| WARNING<o:p></o:p> |
针对警告<o:p></o:p> |
warning(String message);<o:p></o:p> |
900<o:p></o:p> |
| INFO<o:p></o:p> |
信息化的运行时间消息<o:p></o:p> |
info(String message);<o:p></o:p> |
800<o:p></o:p> |
| CONFIG<o:p></o:p> |
静态设置的消息<o:p></o:p> |
config(String message);<o:p></o:p> |
700<o:p></o:p> |
| FINE<o:p></o:p> |
提供追踪信息<o:p></o:p> |
fine(String message);<o:p></o:p> |
500<o:p></o:p> |
| FINER<o:p></o:p> |
显示详细的追踪信息<o:p></o:p> |
finer(String message);<o:p></o:p> |
400<o:p></o:p> |
| FINEST<o:p></o:p> |
更详细的追踪信息<o:p></o:p> |
finest(String message);<o:p></o:p> |
300<o:p></o:p> |
| ALL<o:p></o:p> |
显示所有应该日志记录的信息<o:p></o:p> |
没有可应用的<o:p></o:p> |
Integer.MIN_VALUE<o:p></o:p> |
| OFF<o:p></o:p> |
关闭日志<o:p></o:p> |
没有可应用的<o:p></o:p> |
Integer.MAX_VALUE<o:p></o:p> |
<o:p></o:p>
6. LogRecord(记录信息): LogRecord对象用来在日志框架和单个日志记录Handler之间传递日志记录请求,当一个LogRecord被传递进框架时, 在逻辑上它是属于框架的,不应该被客户应用程序使用或更新<o:p></o:p>
注意:假如客户应用程序没有指定一个显式的来源方法名称和来源类名称, 当他们(方法或类)第一次被访问时(由于对getSourceMethodName或者getSourceClassName方法的调用),LogRecord类将通过分析调用堆栈,自动推断他们.因此,假如一个日志处理器想停止传递一个LogRecord给另一个线程,或者通过RMI传播,并且假如它后来想得到方法和类名,它应该调用getSourceClassName或getSourceMethodName来确保有值被填入.<o:p></o:p>
7. LoggingPermission(记录许可):当代码和一个调用日志记录控制方法的安全管理器(SecurityManager)一起运行的时候,安全管理器(SecurityManager)将检测这个许可.当前仅仅有一个LoggingPermission.这值控制,并且它有控制日志记录配置的能力,例如添加或删除Handler,添加或删除过滤器,或者改变日志等级.程序员不必直接创建LoggingPermission对象.而是由读取的安全策略文件(security policy file)来创建<o:p></o:p>
8. Handler(处理器): Handler对象从Logger那里获得日志信息并且将它输出。可能会输出到控制台，或者输出到文件，或者把这些日志信息发送到网络中的日志服务，或者把它们转发给操作系统日志，或者其他什么。。JDK1.4日志API提供了两大类Handler对象。MemoryHandler简单的把日志消息保存在循环内存缓冲（circular memory buffer），当特定的触发事件发生时，再把它们发布到目标handler。典型的触发事件是接收到等级符合发布等级的日志消息。如果需要其它发布标准，MemoryHandler类可以扩展，重写日志方法来按照用户定义的日志记录条件来发布内存缓冲。StreamHandler向指定的输出流发布日志记录。Java日志API指定了三种StreamHandler对象。ConsoleHandler向标准错误流发布日志记录。FileHandler向指定的文件发布日志记录，它也可以配置成向循环文件集写入日志记录。SocketHandler向网络流发布日志记录（与其它应用通信）。可以通过调用setLevel(Level.OFF)使处理器无效,也可以通过调用setLevel方法的一个适当的等级使其有效.处理器类用LogManager属性来设置处理器的过滤器,格式化和等级的默认值.<o:p></o:p>
9. MemoryHandler(存储处理器):把请求缓冲在内存的循环缓冲区内,通常这个处理器简单地把引入的LogRecord存贮在缓冲区,并丢弃以前的记录.这个缓冲很便宜并且避免了格式化.在某些特殊情况下, MemoryHandler将把当前缓冲区中内容