java.util.logging

Класс MemoryHandler

java.lang. Объект

java.util.logging. Обработчик

java.util.logging. MemoryHandler

public class MemoryHandler
extends Handler

Handler, который буферизует запросы в круговом буфере в памяти.

Обычно этот Handler просто хранит входящий LogRecords в свой буфер памяти и отбрасывает более ранние записи. Эта буферизация очень дешева и избегает форматировать затраты. На определенных триггерных условиях MemoryHandler выставит свое текущее буферное содержание к целевому Handler, который будет обычно публиковать их к внешнему миру.

Есть три основных модели для того, чтобы инициировать нажатие буфера:

• У входящего LogRecord есть тип, который больше чем предопределенный уровень, pushLevel.
• Внешний класс вызывает метод push явно.
• Подкласс переопределяет метод log и сканирует каждый входящий LogRecord и вызывает push, если запись соответствует некоторые требуемые критерии.

Конфигурация: По умолчанию каждый MemoryHandler инициализируется, используя следующие свойства конфигурации LogManager. Если свойства не определяются (или имейте недопустимые значения), тогда указанные значения по умолчанию используются. Если никакое значение по умолчанию не определяется тогда, RuntimeException бросается.

• java.util.logging. MemoryHandler.level определяет уровень для Handler (значения по умолчанию к Level.ALL).
• java.util.logging. MemoryHandler.filter определяет имя класса Filter использования (значения по умолчанию ни к какому Filter).
• java.util.logging. MemoryHandler.size определяет размер буфера (значения по умолчанию к 1000).
• java.util.logging. MemoryHandler.push определяет pushLevel (значения по умолчанию к level.SEVERE).
• java.util.logging. MemoryHandler.target определяет имя целевого класса Handler . (никакое значение по умолчанию).

С тех пор:

1.4

Сводка конструктора

Конструкторы

Конструктор и Описание
MemoryHandler() Создайте MemoryHandler и сконфигурируйте его основанный на свойствах конфигурации LogManager.
MemoryHandler(Handler target, int size, Level pushLevel) Создайте MemoryHandler.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	close() Закройте Handler и свободный все связанные ресурсы.
void	flush() Вызывает сброс на целевом Handler.
Уровень	getPushLevel() Получите pushLevel.
boolean	isLoggable(LogRecord record) Проверьте, зарегистрировал ли бы этот Handler фактически данный LogRecord в свой внутренний буфер.
void	publish(LogRecord record) Сохраните LogRecord во внутреннем буфере.
void	push() Продвиньте любой буферизованный вывод к целевому Handler.
void	setPushLevel(Level newLevel) Установите pushLevel.

Методы java.util.logging унаследованный от класса. Обработчик

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

Методы java.lang унаследованный от класса. Объект

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.

MemoryHandler конфигурируется основанный на свойствах LogManager (или их значения по умолчанию) за исключением того, что данный параметр pushLevel и параметр размера буфера используются.

Параметры:

target - Обработчик, к которому можно опубликовать вывод.

size - число записей журнала, чтобы буферизовать (должно быть больше чем нуль),

pushLevel - уровень сообщения, чтобы спешить

Броски:

IllegalArgumentException - если размер <= 0

Деталь метода

опубликовать

public void publish(LogRecord record)

Сохраните LogRecord во внутреннем буфере.

Если есть Filter, его метод isLoggable вызывают, чтобы проверить, является ли данная запись журнала loggable. Если не мы возвращаемся. Иначе данная запись копируется во внутренний круговой буфер. Затем свойство уровня записи по сравнению с pushLevel. Если данный уровень больше чем или равен pushLevel тогда, push вызывают, чтобы записать, что все буферизованные записи на цель выводят Handler.

Определенный:

publish в классе Handler

Параметры:

record - описание события журнала. Нулевая запись тихо игнорируется и не публикуется

продвинуть

public void push()

Продвиньте любой буферизованный вывод к целевому Handler.

Буфер тогда очищается.

сброс

public void flush()

Вызывает сброс на целевом Handler.

Отметьте, что текущее содержание буфера MemoryHandler не выписывается. Это требует "нажатия".

Определенный:

flush в классе Handler

близко

public void close()
           throws SecurityException

Закройте Handler и свободный все связанные ресурсы. Это также закроет целевой Handler.

Определенный:

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 к "нажатию" буферного содержания. Это возвратит false, если LogRecord будет нулем.

Переопределения:

isLoggable в классе Handler

Параметры:

record - LogRecord

Возвраты:

истина, если LogRecord был бы зарегистрирован.