Интерфейс 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 - исключение, связанное с сообщением журнала; может быть 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 - исключение, связанное с сообщением журнала; может быть 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.; 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.; params - необязательный список параметров для сообщения (может быть пустым).
Исключение:: NullPointerException - если level равен null.

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