构造方法详细信息

• StreamHandler

  public StreamHandler()

  创建一个 StreamHandler ，没有当前输出流。

• StreamHandler

  public StreamHandler​(OutputStream out,
                       Formatter formatter)

  使用给定的 Formatter和输出流创建 StreamHandler 。

  参数

  out - 目标输出流

  formatter - 用于格式化输出的格式化程序

方法详细信息

• setOutputStream

  protected void setOutputStream​(OutputStream out)
                          throws SecurityException

  更改输出流。

  如果有当前输出流，则写入Formatter的尾部字符串，并刷新并关闭流。 然后用新输出流替换输出流。

  参数

  out - 新输出流。 不能为空。

  异常

  SecurityException - 如果存在安全管理器且调用者没有 LoggingPermission("control") 。

• setEncoding

  public void setEncoding​(String encoding)
                   throws SecurityException,
                          UnsupportedEncodingException

  设置（或更改）此Handler使用的字符编码。

  之前的任何编码应设置LogRecords被写入到Handler 。

  重写：

  setEncoding在类 Handler

  参数

  encoding - 支持的字符编码的名称。 可以为null，表示默认的平台编码。

  异常

  SecurityException - 如果存在安全管理器且呼叫者没有 LoggingPermission("control") 。

  UnsupportedEncodingException - 如果不支持指定的编码。

• publish

  public void publish​(LogRecord record)

  格式化并发布LogRecord 。

  StreamHandler首先检查是否存在OutputStream以及给定的LogRecord是否至少具有所需的日志级别。 如果没有，它会默默地返回。 如果是，则调用任何关联的Filter来检查是否应该发布记录。 如果是，则调用其Formatter格式化记录，然后将结果写入当前输出流。

  如果这是第LogRecord被写入到一个给定的OutputStream ，该Formatter了之前的‘头部’字符串写入流LogRecord写入。

  Specified by:

  publish在类 Handler

  参数

  record - 日志事件的描述。 静默忽略空记录，不会发布

• isLoggable

  public boolean isLoggable​(LogRecord record)

  检查这个Handler是否实际记录给定的LogRecord 。

  此方法检查LogRecord是否具有适当的级别以及它是否满足任何Filter 。 如果尚未分配输出流或LogRecord为null，它也将返回false。

  重写：

  isLoggable在类 Handler

  参数

  record - a LogRecord

  结果

  如果将记录 LogRecord true。

• flush

  public void flush()

  刷新所有缓冲的消息。

  Specified by:

  flush在类 Handler

• close

  public void close()
             throws SecurityException

  关闭当前输出流。

  Formatter的“tail”字符串在关闭之前写入流中。 此外，如果Formatter的“head”字符串尚未写入流，则它将在“tail”字符串之前写入。

  Specified by:

  close在类 Handler

  异常

  SecurityException - 如果存在安全管理器且调用者没有LoggingPermission（“control”）。