20155206 2016-2017-2 《Java程序设计》第8周学习总结

教材学习内容总结

第十五章通用API

15.1　日志

日志API简介

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

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

简单来说，Logger是记录信息的起点，要输出的信息，必须先通过Logger的Lever与Filter过滤，在通过Handler的Lever与Filter过滤，格式化信息的动作交给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实例。实际上进行信息输出时，目前Logger的Handler处理完，还会传播给父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创建时，会自动指定OutputStream为System.err，所以日志信息会显示在控制台。
FileHandler创建时会建立日志输出时使用的FileOutputStream，文档位置与名称可以使用模式Pattern字符串指定。
SocketHandler创建时可以指定主机位置与端口，内部将自动建立网络联机，将日志信息传送至指定的主机。

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

FileHandler默认的Formatter是XMLFormatter；
ConsoleHandler默认使用SimpleFormatter；这两个类是Formatter的子类，可以通过Handler的setFormatter()方法设定Formatter。
自定义Handler、Formatter与Filter

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

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

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