教材学习内容总结

第十五章 通用API

15.1 日志

日志API简介

java.util.logging包提供了日志功能相关类与接口,不必额外配置日志组件,就可在标准Java平台使用是其好处。使用日志的起点是Logger类,Logger类的构造函数标示为protected,不是java.util.logging同包的类不能直接以new创建,要取得Logger实例,必修使用Logger的静态方法getLogger()

调用getLogger()时,必须指定Logger实例所属名称空间,名称空间以“.”作为层级区分,名称空间层级相同的Logger,其父Logger组态相同。通常在哪个类中取得的Logger,名称空间就会命名为哪个类全名。

简单来说,Logger是记录信息的起点,要输出的信息,必须先通过LoggerLeverFilter过滤,在通过HandlerLeverFilter过滤,格式化信息的动作交给Formatter,输出信息的动作实际上是Handler负责。

Logger有层级关系,名称空间层级相同的Logger,父Logger组态会相同,每个Logger处理完自己的日志动作后,会向父Logger传播,让父Logger也可以处理日志。
指定日志层级
取得的Logger实例之父Logger组态,就是Logger.GLOBAL_LOGGER_NAME名称空间Logger实例,可通过getParent()取得设定的Logger实例,可通过getLevel()取得设定的Level实例。

Logger的信息处理会往父Logger传播,在没有做任何组态设定的情况下,默认取得的Logger实例,层级必须大于或等于Logger.GLOBAL_LOGGER_NAME名称空间Logger实例设定的Lever.INFO,才有可能输出信息。

可以通过setLevel()设定Level实例,若log()时指定的Lever实例内含的int值小于Logger设定的Level实例内含的int值,Level就不会记录信息。

在经过Logger过滤之后,还得再经过Handler的过滤,一个Logger可以拥有多个Handler,可通过Logger的addHandler()新增Handler实例。实际上进行信息输出时,目前LoggerHandler处理完,还会传播给父Logger的所有Handler处理,可通过getHandlers()方法取得目前已有的Handler实例数组。

在没有做任何组态设定的情况下,取得的Logger实例,只会使用Logger.GLOBAL_LOGGER_NAME名称空间Logger实例拥有的Handler,默认是使用ConsoleHandler,为Handler的子类,作用是在控制台下输出日志信息,,默认地层级是Level.INFO
使用Handler与Formatter

负责日志输出的是Handler实例。标准API中提供几个Handler操作类:
MemoryHandler不会格式化日志信息,信息会暂存于内存缓冲区,直到超过缓冲区大小,才将信息输出至指定的目标Handler
StreamHandler可自行指定信息输出时使用的OutputStream实例,它与子类都会使用指定Formatter格式化信息。
ConsoleHandler创建时,会自动指定OutputStreamSystem.err,所以日志信息会显示在控制台。
FileHandler创建时会建立日志输出时使用的FileOutputStream,文档位置与名称可以使用模式Pattern字符串指定。
SocketHandler创建时可以指定主机位置与端口,内部将自动建立网络联机,将日志信息传送至指定的主机。

Logger可以使用addHandler()新增Handler实例,使用removeHandler()移除Handler

FileHandler默认的FormatterXMLFormatter
ConsoleHandler默认使用SimpleFormatter;这两个类是Formatter的子类,可以通过HandlersetFormatter()方法设定Formatter
自定义Handler、Formatter与Filter

如果java.util.logging包中提供的Handler成果都不符合需求,可以继承Handler类,操作抽象方法publish()flush()close()方法来自定义Handler

在职责分配上,Handler是负责输出,格式化是交由Formatter,而信息过滤是交由Filter。Handler有默认的isLoggable()操作,会先依据Level过滤信息,再使用指定的Filter过滤信息。format()方法会传入LogRecord,存储所有日志信息。

LoggerHandler默认只会一句层级过滤信息,LoggerHandler都有setFilter()方法,可以指定Filter操作对象。
使用logging.properties
通过logging.properties来设定Logger组态,较使用程序撰写更为方便。

15.2.1 使用ResourceBundle

ResourceBundle的静态getBundle()方法会取得一个ResourceBundle的实例,所给定的自变量名称是信息文档的主文件名,getBundle()会自动找到对应的.properties文档,取得ResourceBundle实例后,可以使用getString()指定键来取得。

15.2.2 使用Locale

国际化的三个标准是地区(Locale)信息、资源包(Resource bundle)与基础名称(Base name)
P471 LoggerDemo 运行结果
20145205 《Java程序设计》第8周学习总结

P474 LoggerDemo2 运行结果
20145205 《Java程序设计》第8周学习总结

P488 ReplaceDemo 运行结果
20145205 《Java程序设计》第8周学习总结

P489 SplitDemo2 运行结果
20145205 《Java程序设计》第8周学习总结

P483 SplitDemo 运行结果
20145205 《Java程序设计》第8周学习总结

P489 SplitDemo3 运行结果
20145205 《Java程序设计》第8周学习总结

遇到的问题

20145205 《Java程序设计》第8周学习总结
本章的一个代码,我在敲上去之后,并且按照书上运行的后显示了如上的错误,但是我并没有调试出来= =,这就很尴尬了。

其他(感悟、思考等,可选)

本周虽然学习量相比于前几周不算多,代码也不多,而且有着之前的基础也不是很难,但是我感觉学习的压力却比以往更大,因为本周终于体会到了欠下的总是要还的这句话,因为之前用git推代码的时候,出来了错误,也没有去理她,但是本周的实验的却需要git,所以一直在忙于调试git,所以很尴尬,虽然有些时候会很累,但是不能留下尾巴,不然真的会很麻烦的。学习也是一样,如果自己不去解决遇到的问题,越拖越大,早晚一天会出现大的问题。

学习进度条

代码行数(新增/累积) 博客量(新增/累积) 学习时间(新增/累积) 重要成长
目标 4500行 25篇 350小时
第一周 100/100 1/2 15/15
第二周 150/250 1/3 12/27
第三周 400/650 1/4 22/49
第四周 510/1160 1/5 32/81
第五周 831/1991 1/6 35/116
第六周 945/1991 2/6 26/142
第七周 236/2227 3/9 18/160
第八周 267/2494 2/11 18/178

参考资料

相关文章: