Интерфейс 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`	Уровни логгеров системы loggers.

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

Модификатор и тип	Метод	Описание
`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.
Изначает исключения:: 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 - исключение, связанное с сообщением лога; может быть 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)

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

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

log

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

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

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

© 1993, 2023, 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/21/docs/api/java.base/java/lang/System.Logger.html