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>指的完全限定类名初始化的处理程序。如果没有定义属性（或有无效的值），则使用指定的默认值。

• <程序名称> 。级别指定的 Handler默认级别（默认为 Level.INFO）。
• <程序名称> 。过滤器指定使用一个 Filter类的名称（默认为无 Filter）。
• <程序名称> 。格式化指定使用一个 Formatter类的名称（默认为 java.util.logging.SimpleFormatter）。
• 编码使用的字符集的名称（默认为默认平台编码）。

例如，对于StreamHandler性能会：

• java util。记录。streamhandler水平=信息。
• java util。记录。streamhandler格式化= java.util.logging.simpleformatter。

对于自定义处理程序，例如com.foo.myhandler，性能会：

• com。foo。myhandler水平=信息。
• com。foo。myhandler格式化= java.util.logging.simpleformatter。

从以下版本开始：

一点四

构造方法摘要

构造方法

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

方法摘要

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

Constructor Detail

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

设置（或更改）编码的字符

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

Handler使用。

重写：

setEncoding 方法重写，继承类 Handler

参数

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

异常

SecurityException -如果存在一个安全管理，如果对方没有 LoggingPermission("control")。

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

publish

public void publish(LogRecord record)

格式和发布 LogRecord。

的StreamHandler首先检查如果给定的LogRecord至少需要有一个OutputStream和日志级别。如果不是它默默的回报。如果是这样的话，它要求任何相关的Filter检查记录应公布。如果是这样的话，它所谓的Formatter格式记录并将结果写入输出流的电流。

如果这是第一LogRecord被写入一个特定的OutputStream，Formatter的“头”的字符串写入到流前LogRecord写。

Specified by:

publish 方法重写，继承类 Handler

参数

record -日志事件描述。一个空记录被忽略，并没有被发布

isLoggable

public boolean isLoggable(LogRecord record)

看看这 Handler实际上记录了 LogRecord。

该方法检查是否有一个适当的水平，LogRecord是否满足任何Filter。它也将没有输出流已分配但或日志为空返回false。

重写：

isLoggable 方法重写，继承类 Handler

参数

record - LogRecord

结果

如果 LogRecord会记录。

flush

public void flush()

刷新任何缓冲的消息。

Specified by:

flush 方法重写，继承类 Handler

close

public void close()
           throws SecurityException

关闭当前的输出流。

的Formatter的“尾巴”字符串写入流关闭前。此外，如果Formatter的“头”字符串尚未写入到流中，它将被写在“尾巴”的字符串。

Specified by:

close 方法重写，继承类 Handler

异常

SecurityException -如果存在一个安全管理，如果对方没有loggingpermission（“控制”）。