Интерфейс 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 - исключение, связанное с сообщением журнала; может быть 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/System.Logger.html