Java java.util.logging 类 Handler（JDK5）

140 阅读 0 评论 0 点赞

所有类

概述

软件包

类

使用

树

已过时

索引

帮助

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.util.logging
类 Handler

java.lang.Object
  java.util.logging.Handler

直接已知子类：: MemoryHandler, StreamHandler

public abstract class Handler
extends Object
extends Object

Handler 对象从 Logger 中获取日志信息，并将这些信息导出。例如，它可将这些信息写入控制台或文件中，也可以将这些信息发送到网络日志服务中，或将其转发到操作系统日志中。

可通过执行 setLevel(Level.OFF) 来禁用 Handler，并可通过执行适当级别的 setLevel 来重新启用。

Handler 类通常使用 LogManager 属性来设置 Handler 的 Filter、Formatter 和 Level 的默认值。有关每个具体的 Handler 类，请参阅指定的文档。

从以下版本开始：: 1.4

构造方法摘要
`protected`	`Handler()` 默认构造方法。

方法摘要
`abstract void`	`close()` 关闭 `Handler`，并释放所有相关的资源。
`abstract void`	`flush()` 刷新和缓冲输出。
`String`	`getEncoding()` 返回该 `Handler` 的字符编码。
`ErrorManager`	`getErrorManager()` 检索该 Handler 的 ErrorManager。
`Filter`	`getFilter()` 获得该 `Handler` 的当前 `Filter`。
`Formatter`	`getFormatter()` 返回该 `Handler` 的 `Formatter`。
`Level`	`getLevel()` 获得用于指定该 `Handler` 所记录信息的日志级别。
`boolean`	`isLoggable(LogRecord record)` 检查该 `Handler` 是否实际记录给定的 `LogRecord`。
`abstract void`	`publish(LogRecord record)` 发布 `LogRecord`。
`protected void`	`reportError(String msg, Exception ex, int code)` 用于向该 Handler 的 ErrorManager 报告错误的受保护便利方法。
`void`	`setEncoding(String encoding)` 设置该 `Handler` 所用的字符编码。
`void`	`setErrorManager(ErrorManager em)` 为该 Handler 定义一个 ErrorManager。
`void`	`setFilter(Filter newFilter)` 设置 `Filter`，以控制该 `Handler` 的输出。
`void`	`setFormatter(Formatter newFormatter)` 设置 `Formatter`。
`void`	`setLevel(Level newLevel)` 设置日志级别，指定该 `Handler` 所记录的信息级别。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

Handler

protected Handler()

默认构造方法。得到的 Handler 具有 Level.ALL 的日志级别，不具有 Formatter 和 Filter。作为 ErrorManager 安装默认的 ErrorManager 实例。

方法详细信息

publish

public abstract void publish(LogRecord record)

发布 LogRecord。

最初向 Logger 对象发出的日志请求，此请求可初始化 LogRecord 并可在此转发这一日志记录。

Handler 负责在必要时进行信息格式化。格式化应该包括本地化。

参数：: record - 对日志事件的描述。默认忽略空记录，并且不进行发布。

flush

public abstract void flush()

刷新和缓冲输出。

close

public abstract void close()
                    throws SecurityException

关闭 Handler，并释放所有相关的资源。

Close 方法将执行 flush，然后关闭 Handler。调用 close 方法后，就不应再使用该 Handler。要么默认忽略方法调用，要么抛出运行时异常。

抛出：: SecurityException - 如果存在安全管理器，且调用方不具有 LoggingPermission("control")。

setFormatter

public void setFormatter(Formatter newFormatter)
                  throws SecurityException

设置 Formatter。将该 Formatter 用于格式化该 Handler 的 LogRecords。

某些 Handlers 不能使用 Formatters，在此情形下将记住而不是使用 Formatter。

参数：: newFormatter - Formatter 将使用（不可为空）
抛出：: SecurityException - 如果存在安全管理器，且调用方不具有 LoggingPermission("control")。

getFormatter

public Formatter getFormatter()

返回该 Handler 的 Formatter。

返回：: Formatter（可以为空）。

setEncoding

public void setEncoding(String encoding)
                 throws SecurityException,
                        UnsupportedEncodingException

设置该 Handler 所用的字符编码。

应在将任何 LogRecords 写入 Handler 之前设置编码。

参数：: encoding - 所支持字符编码的名称。可以为空，以表明应为默认平台编码。
抛出：: SecurityException - 如果存在安全管理器，且调用方不具有 LoggingPermission("control")。; UnsupportedEncodingException - 如果不支持指定的编码。

getEncoding

public String getEncoding()

返回该 Handler 的字符编码。

返回：: 编码名称。可以为空，以表明应使用默认编码。