handler类,是计算机用语,是Java子类及继承接口。
接口
Java子类及继承接口
java.util.logging
类 Handler
java.lang.Object
java.util.logging.Handler
直接已知子类
MemoryHandler, StreamHandler
public abstract class Handlerextends ObjectHandler 对象从 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 - 日志事件的描述。忽略 null 记录,并且也不发布它。
--------------------------------------------------------------------------------
flush
public abstract void flush()刷新所有的缓冲输出。
--------------------------------------------------------------------------------
close
public abstract void close()
throws SecurityException关闭 Handler,并释放所有相关的资源。
Close 方法将执行 flush,然后关闭 Handler。调用 close 方法后,就不应再使用该 Handler。要么默认忽略方法调用,要么抛出运行时异常。
抛出:
--------------------------------------------------------------------------------
setFormatter
public void setFormatter(Formatter newFormatter)
throws SecurityException设置 Formatter。将该 Formatter 用于格式化该 Handler 的 LogRecords。
某些 Handlers 不能使用 Formatters,在此情形下将记住而不是使用 Formatter。
参数:
newFormatter - Formatter 将使用(不可为空)
抛出:
--------------------------------------------------------------------------------
getFormatter
public Formatter getFormatter()返回该 Handler 的 Formatter。
返回:
Formatter(可以为空)。
--------------------------------------------------------------------------------
setEncoding
public void setEncoding(String encoding)
throws SecurityException,
UnsupportedEncodingException设置该 Handler 所用的字符编码。
应在将任何 LogRecords 写入 Handler 之前设置编码。
参数:
encoding - 所支持
字符编码的名称。可以为空,以表明应为默认平台编码。
抛出:
UnsupportedEncodingException - 如果不支持指定的编码。
--------------------------------------------------------------------------------
getEncoding
public String getEncoding()返回该 Handler 的字符编码。
返回:
编码名称。可以为空,以表明应使用默认编码。
--------------------------------------------------------------------------------
setFilter
public void setFilter(Filter newFilter)
throws SecurityException设置 Filter,以控制该 Handler 的输出。
对于 publish 的每个调用,Handler 将调用该 Filter (如果不为空),以检查是否应发布或放弃 LogRecord。
参数:
newFilter - Filter 对象(可以为空)
抛出:
--------------------------------------------------------------------------------
getFilter
public Filter getFilter()获得该 Handler 的当前 Filter。
返回:
Filter 对象(可以为空)
--------------------------------------------------------------------------------
setErrorManager
public void setErrorManager(ErrorManager em)为该 Handler 定义一个 ErrorManager。
参数:
em - 新的 ErrorManager
抛出:
--------------------------------------------------------------------------------
getErrorManager
public ErrorManager getErrorManager()获取该 Handler 的 ErrorManager。
抛出:
--------------------------------------------------------------------------------
reportError
protected void reportError(String msg,
Exception ex,
int code)用于向该 Handler 的 ErrorManager 报告错误的受保护便利方法。注意,该方法无需进行安全检查即可获取和使用 ErrorManager。因此,可在调用者无特权的环境下使用该方法。
参数:
msg - 描述性字符串(可以为空)
ex - 异常(可以为空)
code - 在 ErrorManager 中定义的
错误代码--------------------------------------------------------------------------------
setLevel
public void setLevel(Level newLevel)
throws SecurityException设置日志级别,指定该 Handler 所记录的信息级别。将丢弃低于该值的信息级别。
其目的在于允许开发人员打开大多数日志,但是限制将信息发送到特定 Handlers。
参数:
newLevel - 日志级别的新值
抛出:
--------------------------------------------------------------------------------
getLevel
public Level getLevel()获得用于指定该 Handler 所记录信息的日志级别。将丢弃低于该值的信息级别。
返回:
正在记录的信息级别。
--------------------------------------------------------------------------------
isLoggable
public boolean isLoggable(LogRecord record)检查该 Handler 是否实际记录给定的 LogRecord。
该方法检查 LogRecord 是否具有适当的 Level,以及是否满足任何 Filter。它也可进行其他 Handler 特定的检查,以防处理程序记录 LogRecord。如果 LogRecord 为 Null,将返回 False。
参数:
record - 一个 LogRecord
返回:
如果要记录 LogRecord,则返回 true。