compact1, compact2, compact3

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.
• Внешний class вызывает метод push явно.
• Подкласс переопределяет метод log и сканирует каждый входящий LogRecord и вызывает push, если запись соответствует некоторые требуемые критерии.

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

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

Например, свойства для 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

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

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

Конструктор и Описание
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.

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

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

Методы, наследованные от class 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 в class Handler

Параметры:

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

продвинуть

public void push()

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

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

сброс

public void flush()

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

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

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

flush в class Handler

близко

public void close()
           throws SecurityException

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

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

close в class 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 в class Handler

Параметры:

record - LogRecord

Возвраты:

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