Класс ConsoleHandler

java.util.logging.ConsoleHandler

public class ConsoleHandler extends StreamHandler

Этот Handler публикует записи журнала в System.err. По умолчанию для создания кратких сводок используется SimpleFormatter.

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

<handler-name>.level задает уровень по умолчанию для Handler (по умолчанию — Level.INFO).
<handler-name>.filter задает имя класса Filter, который следует использовать (по умолчанию Filter не используется).
<handler-name>.formatter задает имя класса Formatter, который следует использовать (по умолчанию — java.util.logging.SimpleFormatter).
<handler-name>.encoding задает имя используемой кодировки символов (по умолчанию используется кодировка платформы).

Например, свойства для ConsoleHandler будут следующими:

java.util.logging.ConsoleHandler.level=INFO
java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter

Для пользовательского обработчика, например com.foo.MyHandler, свойства будут следующими:

com.foo.MyHandler.level=INFO
com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter

Начиная с:: 1.4

Краткое описание конструкторов

Конструктор	Описание
`ConsoleHandler()`	Создает `ConsoleHandler` для `System.err`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`close()`	Переопределяет `StreamHandler.close` для выполнения очистки, но не закрывает выходной поток.
`void`	`publish(LogRecord record)`	Публикует `LogRecord`.

Методы, объявленные в классе StreamHandler

flush, isLoggable, setEncoding, setOutputStream

Модификатор и тип	Метод	Описание
`void`	`flush()`	Сбрасывает все буферизованные сообщения.
`boolean`	`isLoggable(LogRecord record)`	Проверяет, будет ли этот `Handler` действительно записывать заданное `LogRecord` в журнал.
`void`	`setEncoding(String encoding)`	Задает (или изменяет) кодировку символов, используемую этим `Handler`.
`protected void`	`setOutputStream(OutputStream out)`	Изменяет выходной поток.

Методы, объявленные в классе Handler

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

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

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Показывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

ConsoleHandler

public ConsoleHandler()

Создает ConsoleHandler для System.err.

ConsoleHandler настраивается на основе свойств LogManager (или их значений по умолчанию).

Подробное описание методов

publish

public void publish(LogRecord record)

Публикует LogRecord.

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

Переопределяет:: publish в классе StreamHandler
Требования к реализации:: Этот метод не синхронизирован. Подклассы не должны объявлять переопределенные методы publish() как synchronized, если они вызывают super.publish() или форматируют пользовательские аргументы. Дополнительные сведения см. в обсуждении в java.util.logging.Handler.
Параметры:: record — описание события журнала. Запись со значением null молча игнорируется и не публикуется

close

public void close()

Переопределяет StreamHandler.close для выполнения очистки, но не для закрытия выходного потока. То есть мы не закрываем System.err.

Переопределяет:: close в классе StreamHandler

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.