Интерфейс System.Logger

Внешний класс:: System

public static interface System.Logger

Экземпляры System.Logger записывают сообщения, которые направляются в используемую LoggerFinder базовую систему журналирования. Экземпляры System.Logger обычно получают из класса System, вызывая System.getLogger(loggerName) или System.getLogger(loggerName, bundle).

Начиная с:

См. также:

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static enum`	`System.Logger.Level`	Уровни журналирования системных логгеров.

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

Модификатор и тип	Метод	Описание
`String`	`getName()`	Возвращает имя этого логгера.
`boolean`	`isLoggable(System.Logger.Level level)`	Проверяет, будет ли этим логгером записано сообщение указанного уровня.
`default void`	`log(System.Logger.Level level, Object obj)`	Записывает сообщение, созданное из указанного объекта.
`default void`	`log(System.Logger.Level level, String msg)`	Записывает сообщение.
`default void`	`log(System.Logger.Level level, String format, Object... params)`	Записывает сообщение с необязательным списком параметров.
`default void`	`log(System.Logger.Level level, String msg, Throwable thrown)`	Записывает сообщение, связанное с указанным исключением.
`default void`	`log(System.Logger.Level level, Supplier<String> msgSupplier)`	Записывает сообщение, предоставляемое по требованию.
`default void`	`log(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown)`	Записывает сообщение, предоставляемое по требованию и связанное с указанным исключением.
`void`	`log(System.Logger.Level level, ResourceBundle bundle, String format, Object... params)`	Записывает сообщение с пакетом ресурсов и необязательным списком параметров.
`void`	`log(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown)`	Записывает локализованное сообщение, связанное с указанным исключением.

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

getName

String getName()

Возвращает имя этого логгера.

Возвращает:: имя логгера.

isLoggable

boolean isLoggable(System.Logger.Level level)

Проверяет, будет ли этим логгером записано сообщение указанного уровня.

Параметры:: level — уровень сообщения журнала.
Возвращает:: true, если сообщение журнала указанного уровня в данный момент записывается.
Вызывает исключение:: NullPointerException — если level равно null.

log

default void log(System.Logger.Level level, String msg)

Записывает сообщение.

Требования к реализации:: Реализация этого метода по умолчанию вызывает this.log(level, (ResourceBundle)null, msg, (Object[])null);
Параметры:: level — уровень сообщения журнала.; msg — строковое сообщение (или ключ в каталоге сообщений, если этот логгер является localized logger); может быть null.
Вызывает исключение:: NullPointerException — если level равно null.

log

default void log(System.Logger.Level level, Supplier<String> msgSupplier)

Записывает сообщение, предоставляемое по требованию. Если для логгера в данный момент включена запись сообщений указанного уровня, записывается сообщение, полученное в результате вызова указанной функции-поставщика. В противном случае функция-поставщик не вызывается.

Требования к реализации:: Если для указанного уровня включена запись сообщений, реализация этого метода по умолчанию вызывает this.log(level, (ResourceBundle)null, msgSupplier.get(), (Object[])null);
Параметры:: level — уровень сообщения журнала.; msgSupplier — функция-поставщик, создающая сообщение.
Вызывает исключение:: NullPointerException — если level равно null или msgSupplier равно null.

log

default void log(System.Logger.Level level, Object obj)

Записывает сообщение, созданное из указанного объекта. Если для логгера в данный момент включена запись сообщений указанного уровня, записывается сообщение, которое по умолчанию является результатом вызова toString для указанного объекта. В противном случае объект не обрабатывается.

Требования к реализации:: Если для указанного уровня включена запись сообщений, реализация этого метода по умолчанию вызывает this.log(level, (ResourceBundle)null, obj.toString(), (Object[])null);
Параметры:: level — уровень сообщения журнала.; obj — объект для записи в журнал.
Вызывает исключение:: NullPointerException — если level равно null или obj равно null.

log

default void log(System.Logger.Level level, String msg, Throwable thrown)

Записывает сообщение, связанное с указанным исключением.

Требования к реализации:: Реализация этого метода по умолчанию вызывает this.log(level, (ResourceBundle)null, msg, thrown);
Параметры:: level — уровень сообщения журнала.; msg — строковое сообщение (или ключ в каталоге сообщений, если этот логгер является localized logger); может быть null.; thrown — Throwable, связанное с сообщением журнала; может быть null.
Вызывает исключение:: NullPointerException — если level равно null.

log

default void log(System.Logger.Level level, Supplier<String> msgSupplier, Throwable thrown)

Записывает сообщение, предоставляемое по требованию и связанное с указанным исключением. Если для логгера в данный момент включена запись сообщений указанного уровня, записывается сообщение, полученное в результате вызова указанной функции-поставщика. В противном случае функция-поставщик не вызывается.

Требования к реализации:: Если для указанного уровня включена запись сообщений, реализация этого метода по умолчанию вызывает this.log(level, (ResourceBundle)null, msgSupplier.get(), thrown);
Параметры:: level — один из идентификаторов уровня сообщения журнала.; msgSupplier — функция-поставщик, создающая сообщение.; thrown — Throwable, связанное с сообщением журнала; может быть null.
Вызывает исключение:: NullPointerException — если level равно null или msgSupplier равно null.

log

default void log(System.Logger.Level level, String format, Object... params)

Записывает сообщение с необязательным списком параметров.

Требования к реализации:: Реализация этого метода по умолчанию вызывает this.log(level, (ResourceBundle)null, format, params);
Параметры:: level — один из идентификаторов уровня сообщения журнала.; format — строковый формат сообщения в формате MessageFormat (или ключ в каталоге сообщений, если этот логгер является localized logger); может быть null.; params — необязательный список параметров сообщения (может отсутствовать).
Вызывает исключение:: NullPointerException — если level равно null.

log

void log(System.Logger.Level level, ResourceBundle bundle, String msg, Throwable thrown)

Записывает локализованное сообщение, связанное с указанным исключением. Если указанный пакет ресурсов не равен null, строка msg локализуется с использованием указанного пакета ресурсов. В противном случае строка msg не локализуется.

Параметры:: level — уровень сообщения журнала.; bundle — пакет ресурсов для локализации msg; может быть null.; msg — строковое сообщение (или ключ в каталоге сообщений, если bundle не равно null); может быть null.; thrown — Throwable, связанное с сообщением журнала; может быть null.
Вызывает исключение:: NullPointerException — если level равно null.

log

void log(System.Logger.Level level, ResourceBundle bundle, String format, Object... params)

Записывает сообщение с пакетом ресурсов и необязательным списком параметров. Если указанный пакет ресурсов не равен null, строка format локализуется с использованием указанного пакета ресурсов. В противном случае строка format не локализуется.

Параметры:: level — уровень сообщения журнала.; bundle — пакет ресурсов для локализации format; может быть null.; format — строковый формат сообщения в формате MessageFormat (или ключ в каталоге сообщений, если bundle не равно null); может быть null.; params — необязательный список параметров сообщения (может отсутствовать).
Вызывает исключение:: NullPointerException — если level равно null.

© 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.base/java/lang/System.Logger.html