Обработчик (Платформа Java SE 7)

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.

С тех пор:

1.4

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

Конструкторы
Модификатор Конструктор и Описание

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

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

Методы 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 был бы зарегистрирован.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

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

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

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

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

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

Обработчик

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

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

сброс

близко

setFormatter

getFormatter

setEncoding

getEncoding

setFilter

getFilter

setErrorManager

getErrorManager

reportError

setLevel

getLevel

isLoggable