compact1, compact2, compact3

java.util.logging

Class MemoryHandler

java.lang.Object

java.util.logging.Handler

java.util.logging.MemoryHandler

public class MemoryHandler
extends Handler

Handler在内存中的循环缓冲区缓冲区的要求。

通常这Handler简单存储输入LogRecords到内存缓冲区和抛弃以前的记录。这种缓冲是非常便宜的，并避免格式化成本。在一定的触发条件，该MemoryHandler将推出其当前缓冲区的内容到目标Handler，这通常会将它们发布到外面的世界。

触发缓冲区的一个主要模型有三种：

• 输入LogRecord具有类型大于一个预先定义的水平，这pushLevel。
• 外部类调用push方法。
• 子类重写log方法和扫描每个传入的LogRecord和电话push如果记录匹配所需的某些标准。

配置：默认情况下每个MemoryHandler是使用下面的LogManager配置属性，<handler-name>指的完全限定类名初始化的处理程序。如果没有定义属性（或有无效的值），则使用指定的默认值。如果没有默认值定义然后抛出RuntimeException。

• <程序名称> 。级别指定的 Handler水平（默认为 Level.ALL）。
• <程序名称> 。过滤器指定使用一个 Filter类的名称（默认为无 Filter）。
• <处理程序名称> 。大小定义缓冲区大小（默认为1000）。
• <程序名称> 。推定义 pushLevel（默认为 level.SEVERE）。
• <程序名称> 。目标指定目标 Handler 类的名称。（没有默认）。

例如，对于MemoryHandler性能会：

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

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

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

从以下版本开始：

一点四

构造方法摘要

构造方法

Constructor and Description
MemoryHandler() 创建一个 MemoryHandler和配置基于 LogManager配置属性。
MemoryHandler(Handler target, int size, Level pushLevel) 创建一个 MemoryHandler。

方法摘要

Modifier and Type	Method and Description
void	close() 关闭 Handler和释放所有相关资源。
void	flush() 对目标造成 Handler冲洗。
Level	getPushLevel() 得到 pushLevel。
boolean	isLoggable(LogRecord record) 看看这 Handler实际上日志给 LogRecord进入其内部缓冲区。
void	publish(LogRecord record) 存储在内部缓冲区 LogRecord。
void	push() 将任何缓冲输出到目标 Handler。
void	setPushLevel(Level newLevel) 设置 pushLevel。

Methods inherited from class java.util.logging.Handler

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

Methods inherited from class java.lang.Object

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

Constructor Detail

MemoryHandler

public MemoryHandler()

创建一个 MemoryHandler和配置基于 LogManager配置属性。

MemoryHandler

public MemoryHandler(Handler target,
                     int size,
                     Level pushLevel)

创建一个 MemoryHandler。

的MemoryHandler配置基于LogManager性质（或默认值）除了给pushLevel参数和缓冲区的大小参数的使用。

参数

target的处理程序，发布输出。

size -日志记录数缓冲区（必须大于零）

pushLevel消息层面推进

异常

如果 size is <= 0 IllegalArgumentException

方法详细信息

publish

public void publish(LogRecord record)

存储在内部缓冲区 LogRecord。

如果有一个Filter，其isLoggable方法来检查提供的日志记录Loggable。如果不是我们回来。否则，给定的记录被复制到一个内部循环缓冲区中。然后记录的属性与pushLevel相比。如果给定的水平大于或等于pushLevel然后push来写所有的缓冲记录目标输出Handler。

Specified by:

publish 方法重写，继承类 Handler

参数

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

push

public void push()

将任何缓冲输出到目标 Handler。

然后清除缓冲区。

flush

public void flush()

对目标造成 Handler冲洗。

需要注意的是，MemoryHandler缓冲区的当前内容不写出来。这就需要一个“推”。

Specified by:

flush 方法重写，继承类 Handler

close

public void close()
           throws SecurityException

关闭 Handler和释放所有相关资源。这也将接近目标 Handler。

Specified by:

close 方法重写，继承类 Handler

异常

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

setPushLevel

public void setPushLevel(Level newLevel)
                  throws SecurityException

设置 pushLevel。后一 LogRecord复制到内部缓冲区，如果它的水平大于或等于 pushLevel，然后 push将被称为。

参数

newLevel的 pushLevel新价值

异常

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

getPushLevel

public Level getPushLevel()

得到 pushLevel。

结果

pushLevel的价值

isLoggable

public boolean isLoggable(LogRecord record)

看看这 Handler实际上日志给 LogRecord进入其内部缓冲区。

该方法检查是否有一个适当的水平，LogRecord是否满足任何Filter。然而它不检查是否LogRecord将导致一个“推”的缓冲区的内容。如果是空的LogRecord返回false。

重写：

isLoggable 方法重写，继承类 Handler

参数

record - LogRecord

结果

如果 LogRecord会记录。