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。

• <处理程序名> .LEVEL指定了Handler（默认为Level.ALL）的水平。
• <handler-name> .filter指定要使用的Filter类的名称（默认为Filter ）。
• <handler-name> .size定义缓冲区大小（默认为1000）。
• <handler-name> .push定义了pushLevel （默认为level.SEVERE ）。
• <handler-name> .target指定目标Handler类的名称。 （无默认）。

例如，MemoryHandler的MemoryHandler将是：

• java.util.logging.MemoryHandler.level = INFO
• java.util.logging.MemoryHandler.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
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

构造方法详细信息

MemoryHandler

public MemoryHandler()

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

MemoryHandler

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

创建一个MemoryHandler 。

除了使用给定的pushLevel参数和缓冲区大小参数之外， MemoryHandler是基于LogManager属性（或其默认值） 配置的 。

参数

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

size - 要缓冲的日志记录数（必须大于0）

pushLevel - 要推送的消息级别

异常

IllegalArgumentException - 如果 size is <= 0

方法详细信息

publish

public void publish(LogRecord record)

将LogRecord存储在内部缓冲区中。

如果有Filter ，则调用其isLoggable方法来检查给定的日志记录是否可记录。 如果不是我们回来 否则给定的记录被复制到一个内部循环缓冲区。 然后将记录的等级属性与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 - a LogRecord

结果

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