compact1, compact2, compact3

java.util.logging

Class StreamHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.StreamHandler

已知直接子类：

ConsoleHandler ， FileHandler ， SocketHandler

public class StreamHandler
extends Handler

基于流的日志记录Handler 。

这主要是作为用于实现其他日志记录的基类或支持类Handlers 。

LogRecords发表于给定的java.io.OutputStream 。

配置：默认情况下，每个StreamHandler使用以下LogManager 配置属性进行初始化，其中<handler-name>引用处理程序的完全限定类名。 如果未定义属性（或具有无效值），则使用指定的默认值。

• <处理程序名> .LEVEL指定了Handler（默认为Level.INFO）的默认级别。
• <handler-name> .filter指定要使用的Filter类的名称（默认为Filter ）。
• <handler-name> .formatter指定要使用的Formatter类的名称（默认为java.util.logging.SimpleFormatter ）。
• <handler-name>。编码要使用的字符集编码的名称（默认为默认平台编码）。

例如，StreamHandler的StreamHandler将是：

• java.util.logging.StreamHandler.level = INFO
• java.util.logging.StreamHandler.formatter = java.util.logging.SimpleFormatter

对于自定义处理程序，例如com.foo.MyHandler，属性将是：

• com.foo.MyHandler.level = INFO
• com.foo.MyHandler.formatter = java.util.logging.SimpleFormatter

从以下版本开始：

1.4

构造方法摘要

构造方法

Constructor and Description
StreamHandler() 创建一个 StreamHandler ，没有当前的输出流。
StreamHandler(OutputStream out, Formatter formatter) 创建一个 StreamHandler与给定的 Formatter和输出流。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭当前的输出流。
void	flush() 刷新任何缓冲的消息。
boolean	isLoggable(LogRecord record) 检查 Handler是否会实际记录给定的 LogRecord 。
void	publish(LogRecord record) 格式化并发布 LogRecord 。
void	setEncoding(String encoding) 组（或改变）由此 Handler使用的字符编码。
protected void	setOutputStream(OutputStream out) 更改输出流。

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, reportError, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

StreamHandler

public StreamHandler()

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

StreamHandler

public StreamHandler(OutputStream out,
                     Formatter formatter)

创建一个 StreamHandler与给定的 Formatter和输出流。

参数

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 - 支持的字符编码的名称。 可以为空，表示默认的平台编码。

异常

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

UnsupportedEncodingException - 如果不支持命名编码。

publish

public void publish(LogRecord record)

格式化并发布LogRecord 。

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

如果这是要写入给定OutputStream第LogRecord，被写入LogRecord前Formatter的‘头部’字符串写入流。

Specified by:

publish在 Handler

参数

record - 日志事件的描述。 空值记录被默认忽略并且未发布

isLoggable

public boolean isLoggable(LogRecord record)

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

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

重写：

isLoggable在 Handler

参数

record - a LogRecord

结果

如果 LogRecord将被记录，则为true。

flush

public void flush()

刷新任何缓冲的消息。

Specified by:

flush在类别 Handler

close

public void close()
           throws SecurityException

关闭当前的输出流。

Formatter的“尾”字符串在关闭之前被写入流中。 另外，如果Formatter的“头”字符串还没有被写入到流中，它将被写在“尾”字符串之前。

Specified by:

close在 Handler

异常

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