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

Вложенный класс:: System

public static interface System.Logger

System.Logger экземпляры регистрируют сообщения, которые будут маршрутизированы к базовой системе регистрации LoggerFinder. System.Logger экземпляры обычно получаются из класса System, вызывая System.getLogger(loggerName) или System.getLogger(loggerName, bundle).

С момента:: 9
См. также:: System.getLogger(java.lang.String), System.getLogger(java.lang.String, java.util.ResourceBundle), System.LoggerFinder

Вложенные классы

Модификатор и тип	Интерфейс	Описание
`static class`	`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)

Записывает локализованное сообщение, связанное с указанным исключением. Если переданный набор ресурсов не 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, 2020, 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/11/docs/api/java.base/java/lang/System.Logger.html