compact1, compact2, compact3

java.util.logging

Обработчик класса

java.lang. Объект

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

Прямые Известные Подклассы:

MemoryHandler, StreamHandler

public abstract class Handler
extends Object

Объект Handler берет сообщения журнала от Logger и экспортирует их. Это могло бы например, писать им в консоль или писать им в файл, или передаваться им к службе журналирования сети, или передавать им журналу ОС, или что бы то ни было.

Handler может быть отключен, делая setLevel(Level.OFF) и может быть повторно включен, делая setLevel с соответствующим уровнем.

Классы Handler обычно используют свойства LogManager, чтобы установить значения по умолчанию для Filter Handler, Formatter, и Level. См. определенную документацию для каждого конкретного Handler class.

С тех пор:

1.4

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

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

Модификатор	Конструктор и Описание
protected	Handler() Конструктор по умолчанию.

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

Модификатор и Тип	Метод и Описание
abstract void	close() Закройте Handler и свободный все связанные ресурсы.
abstract void	flush() Сбросьте любой буферизованный вывод.
Строка	getEncoding() Возвратите кодировку символов для этого Handler.
ErrorManager	getErrorManager() Получает ErrorManager для этого Обработчика.
Фильтр	getFilter() Получите текущий Filter для этого Handler.
Средство форматирования	getFormatter() Возвратите Formatter для этого Handler.
Уровень	getLevel() Получите уровень журнала, определяющий, какие сообщения будут зарегистрированы этим Handler.
boolean	isLoggable(LogRecord record) Проверьте, зарегистрировал ли бы этот Handler фактически данный LogRecord.
abstract void	publish(LogRecord record) Опубликуйте LogRecord.
protected void	reportError(String msg, Exception ex, int code) Защищенный метод удобства, чтобы сообщить об ошибке ErrorManager этого Обработчика.
void	setEncoding(String encoding) Установите кодировку символов, используемую этим Handler.
void	setErrorManager(ErrorManager em) Определите ErrorManager для этого Обработчика.
void	setFilter(Filter newFilter) Установите Filter, чтобы управлять выводом на этом Handler.
void	setFormatter(Formatter newFormatter) Установите Formatter.
void	setLevel(Level newLevel) Установите уровень журнала, определяющий, какие уровни сообщения будут зарегистрированы этим Handler.

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

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

Деталь конструктора

Обработчик

protected Handler()

Конструктор по умолчанию. У получающегося Handler есть уровень журнала Level.ALL, никакого Formatter, и никакого Filter. Значение по умолчанию экземпляр ErrorManager устанавливается как ErrorManager.

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

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

public abstract void publish(LogRecord record)

Опубликуйте LogRecord.

С просьбой журналирования обратились первоначально к объекту Logger, который инициализировал LogRecord и передал его здесь.

Handler ответственен за форматирование сообщения, когда и в случае необходимости. Форматирование должно включать локализацию.

Параметры:

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

сброс

public abstract void flush()

Сбросьте любой буферизованный вывод.

близко

public abstract void close()
                    throws SecurityException

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

Близкий метод выполнит flush и затем закроет Handler. После близко был вызван, этот Handler больше не должен использоваться. Вызовы метода могут или быть тихо проигнорированы или могут бросить исключения на этапе выполнения.

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

setFormatter

public void setFormatter(Formatter newFormatter)
                  throws SecurityException

Установите Formatter. Этот Formatter будет использоваться, чтобы отформатировать LogRecords для этого Handler.

Некоторый Handlers, возможно, не использует Formatters, когда Formatter будут помнить, но не использоваться.

Параметры:

newFormatter - Formatter, чтобы использовать (возможно, не нуль),

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

getFormatter

public Formatter getFormatter()

Возвратите Formatter для этого Handler.

Возвраты:

Formatter (может быть нуль).

setEncoding

public void setEncoding(String encoding)
                 throws SecurityException,
                        UnsupportedEncodingException

Установите кодировку символов, используемую этим Handler.

Кодирование должно быть установлено перед любым LogRecords пишутся Handler.

Параметры:

encoding - Имя поддерживаемой кодировки символов. Может быть нуль, чтобы указать на кодирование платформы значения по умолчанию.

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

UnsupportedEncodingException - если именованное кодирование не поддерживается.

getEncoding

public String getEncoding()

Возвратите кодировку символов для этого Handler.

Возвраты:

Имя кодирования. Может быть нуль, который указывает, что кодировка по умолчанию должна использоваться.

setFilter

public void setFilter(Filter newFilter)
               throws SecurityException

Установите Filter, чтобы управлять выводом на этом Handler.

Для каждого вызова publish Handler вызовет этот Filter (если это будет ненуль) проверять, должен ли LogRecord быть опубликован или отброшен.

Параметры:

newFilter - объект Filter (может быть нуль),

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

getFilter

public Filter getFilter()

Получите текущий Filter для этого Handler.

Возвраты:

объект Filter (может быть нуль),

setErrorManager

public void setErrorManager(ErrorManager em)

Определите ErrorManager для этого Обработчика.

"Ошибочный" метод ErrorManager будет вызван, если какие-либо ошибки произойдут, используя этот Обработчик.

Параметры:

em - новый ErrorManager

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

getErrorManager

public ErrorManager getErrorManager()

Получает ErrorManager для этого Обработчика.

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

reportError

protected void reportError(String msg,
                           Exception ex,
                           int code)

Защищенный метод удобства, чтобы сообщить об ошибке ErrorManager этого Обработчика. Отметьте, что этот метод получает и использует ErrorManager, не делая проверку защиты. Это может поэтому использоваться в средах, где вызывающая сторона может быть непривилегированной.

Параметры:

msg - дескриптивная строка (может быть нуль),

ex - исключение (может быть нуль),

code - код ошибки определяется в ErrorManager

setLevel

public void setLevel(Level newLevel)
              throws SecurityException

Установите уровень журнала, определяющий, какие уровни сообщения будут зарегистрированы этим Handler. Уровни сообщения ниже чем это значение будут отброшены.

Намерение состоит в том, чтобы позволить разработчикам включать пространное журналирование, но ограничивать сообщения, которые отправляются определенному Handlers.

Параметры:

newLevel - новое значение для уровня журнала

Броски:

SecurityException - если менеджер безопасности существует и если у вызывающей стороны нет LoggingPermission("control").

getLevel

public Level getLevel()

Получите уровень журнала, определяющий, какие сообщения будут зарегистрированы этим Handler. Уровни сообщения ниже чем этот уровень будут отброшены.

Возвраты:

уровень зарегистрированных сообщений.

isLoggable

public boolean isLoggable(LogRecord record)

Проверьте, зарегистрировал ли бы этот Handler фактически данный LogRecord.

Этот метод проверяет, есть ли у LogRecord соответствующий Level и удовлетворяет ли это любой Filter. Это также может сделать другой Handler определенными проверками, которые могли бы препятствовать тому, чтобы обработчик регистрировал LogRecord. Это возвратит false, если LogRecord будет нулем.

Параметры:

record - LogRecord

Возвраты:

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