Spec-Zone.ru › OpenJDK 25

Класс ConsoleHandler

java.lang.Object
java.util.logging.Handler
java.util.logging.StreamHandler
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

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

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

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

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

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

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

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, содержащем более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.logging/java/util/logging/ConsoleHandler.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API