JDK1.4的java.util.Logging包的使用说明与示例

wangjian5748

浏览: 209443 次
性别:
来自: 上海

最近访客更多访客>>

lixibin_0829

RunningSnail90

bookong

studyaaaa

博主相关

博客

微博

相册

留言

关于我

文章分类

全部博客 (142)

社区版块

存档分类

Java 应用服务器网络应用 F#配置管理

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>

</v:textbox></v:rect><v:shapetype id="_x0000_t176" path="m@0,0qx0@0l0@2qy@0,21600l@1,21600qx21600@2l21600@0qy@1,0xe" adj="2700" o:spt="176" coordsize="21600,21600"><v:stroke joinstyle="miter"></v:stroke><v:formulas><v:f eqn="val #0"></v:f><v:f eqn="sum width 0 #0"></v:f><v:f eqn="sum height 0 #0"></v:f><v:f eqn="prod @0 2929 10000"></v:f><v:f eqn="sum width 0 @3"></v:f><v:f eqn="sum height 0 @3"></v:f><v:f eqn="val width"></v:f><v:f eqn="val height"></v:f><v:f eqn="prod width 1 2"></v:f><v:f eqn="prod height 1 2"></v:f></v:formulas><v:path textboxrect="@3,@3,@4,@5" o:connectlocs="@8,0;0,@9;@8,@7;@6,@9" o:connecttype="custom" limo="10800,10800" gradientshapeok="t"></v:path></v:shapetype><v:shape id="_x0000_s1028" style="MARGIN-TOP: 23.05pt; Z-INDEX: 3; LEFT: 0px; MARGIN-LEFT: 153pt; WIDTH: 54pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" type="#_x0000_t176"><v:textbox>

Handler

</v:textbox></v:shape><v:roundrect id="_x0000_s1029" style="MARGIN-TOP: 72.25pt; Z-INDEX: 4; LEFT: 0px; MARGIN-LEFT: 54pt; WIDTH: 108pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox style="mso-next-textbox: #_x0000_s1029">

MemoryHandler

</v:textbox></v:roundrect><v:roundrect id="_x0000_s1030" style="MARGIN-TOP: 122.85pt; Z-INDEX: 5; LEFT: 0px; MARGIN-LEFT: 99pt; WIDTH: 99pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox>

ConsoleHandler

</v:textbox></v:roundrect><v:roundrect id="_x0000_s1031" style="MARGIN-TOP: 72.25pt; Z-INDEX: 6; LEFT: 0px; MARGIN-LEFT: 198pt; WIDTH: 99pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox>

StreamHandler

</v:textbox></v:roundrect><v:roundrect id="_x0000_s1032" style="MARGIN-TOP: 122.85pt; Z-INDEX: 7; LEFT: 0px; MARGIN-LEFT: 207pt; WIDTH: 81pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox>

FileHandler

</v:textbox></v:roundrect><v:roundrect id="_x0000_s1033" style="MARGIN-TOP: 122.85pt; Z-INDEX: 8; LEFT: 0px; MARGIN-LEFT: 297pt; WIDTH: 90pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox>

SocketHandler

</v:textbox></v:roundrect><v:line id="_x0000_s1034" style="Z-INDEX: 9; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="180pt,51.55pt" from="180pt,43.75pt"></v:line><v:line id="_x0000_s1035" style="Z-INDEX: 10; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="243pt,51.55pt" from="126pt,51.55pt"></v:line><v:line id="_x0000_s1036" style="Z-INDEX: 11; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="126pt,74.95pt" from="126pt,51.55pt"><v:stroke endarrow="block"></v:stroke></v:line><v:line id="_x0000_s1037" style="Z-INDEX: 12; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="243pt,74.95pt" from="243pt,51.55pt"><v:stroke endarrow="block"></v:stroke></v:line><v:line id="_x0000_s1038" style="Z-INDEX: 13; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="243pt,125.5pt" from="243pt,94.3pt"><v:stroke endarrow="block"></v:stroke></v:line><v:line id="_x0000_s1039" style="Z-INDEX: 14; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="333pt,108.55pt" from="162pt,108.55pt"></v:line><v:line id="_x0000_s1040" style="Z-INDEX: 15; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="162pt,124.15pt" from="162pt,108.55pt"><v:stroke endarrow="block"></v:stroke></v:line><v:line id="_x0000_s1041" style="Z-INDEX: 16; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="333pt,124.15pt" from="333pt,108.55pt"><v:stroke endarrow="block"></v:stroke></v:line> <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>

</v:textbox></v:rect><v:roundrect id="_x0000_s1042" style="MARGIN-TOP: 37.35pt; Z-INDEX: 17; LEFT: 0px; MARGIN-LEFT: 180pt; WIDTH: 1in; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox style="mso-next-textbox: #_x0000_s1042">

Formatter

</v:textbox></v:roundrect><v:line id="_x0000_s1045" style="Z-INDEX: 20; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="3in,73.65pt" from="3in,58.05pt"></v:line><v:line id="_x0000_s1048" style="Z-INDEX: 23; LEFT: 0px; POSITION: absolute; TEXT-ALIGN: left" to="279pt,103.5pt" from="279pt,72.3pt"><v:stroke endarrow="block"></v:stroke></v:line> <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

</v:textbox></v:roundrect><v:roundrect id="_x0000_s1044" style="MARGIN-TOP: 1.05pt; Z-INDEX: 19; LEFT: 0px; MARGIN-LEFT: 243pt; WIDTH: 99pt; POSITION: absolute; HEIGHT: 23.4pt; TEXT-ALIGN: left" arcsize="10923f"><v:textbox style="mso-next-textbox: #_x0000_s1044">

XMLFormatter

</v:textbox></v:roundrect> <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>