Интерфейс PlatformLoggingMXBean

Все суперинтерфейсы:: PlatformManagedObject

public interface PlatformLoggingMXBean extends PlatformManagedObject

Интерфейс управления средствами ведения журнала (logging).

Существует единственный глобальный экземпляр PlatformLoggingMXBean. Метод ManagementFactory.getPlatformMXBean может быть использован для получения объекта PlatformLoggingMXBean следующим образом:

     PlatformLoggingMXBean logging = ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class);

Объект PlatformLoggingMXBean также зарегистрирован в платформенном сервере MBeanServer. Имя объекта ObjectName для уникальной идентификации PlatformLoggingMXBean в MBeanServer:

      java.util.logging:type=Logging

С:: 1.7

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

Модификатор и тип	Метод	Описание
`String`	`getLoggerLevel(String loggerName)`	Получает имя уровня ведения журнала (уровень) для указанного регистратора.
`List<String>`	`getLoggerNames()`	Возвращает список имен текущих зарегистрированных регистраторов.
`String`	`getParentLoggerName(String loggerName)`	Возвращает имя родительского родителя для указанного регистратора.
`void`	`setLoggerLevel(String loggerName, String levelName)`	Устанавливает указанный регистратор на указанный новый уровень.

Методы, объявленные в интерфейсе java.lang.management.PlatformManagedObject

getObjectName

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

getLoggerNames

List<String> getLoggerNames()

Возвращает список имен текущих зарегистрированных регистраторов. Этот метод вызывает LogManager.getLoggerNames() и возвращает список имён регистраторов.

Возвращает:: Список String, каждый из которых является именем текущего зарегистрированного Logger.

getLoggerLevel

String getLoggerLevel(String loggerName)

Получает имя уровня ведения журнала (уровень) для указанного регистратора. Если указанный регистратор не существует, возвращается null. Этот метод сначала находит регистратор с данным именем, а затем возвращает имя уровня журнала, вызывая:

Logger.getLevel().getName();

Если Level указанного регистратора является null, что означает, что эффективный уровень этого регистратора наследуется от родительского, будет возвращена пустая строка.

Параметры:

loggerName - Имя Logger для извлечения.

Возвращает:

Имя уровня журнала указанного регистратора; или пустая строка, если уровень журнала указанного регистратора null. Если указанный регистратор не существует, возвращается null.

См. также:

Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName, String levelName)

Устанавливает указанный регистратор на указанный новый уровень. Если levelName не является null, уровень указанного регистратора устанавливается на разобранный Level, соответствующий levelName. Если levelName является null, уровень указанного регистратора устанавливается на null и эффективный уровень регистратора наследуется от ближайшего предка со специфическим (не null) значением уровня.

Параметры:

loggerName - Имя Logger для установки. Должно быть не null.

levelName - Имя уровня для установки на указанный регистратор, или null для установки уровня на наследование от ближайшего предка.

Исключения:

IllegalArgumentException - если указанный регистратор не существует, или levelName не является допустимым именем уровня.

SecurityException - если менеджер безопасности существует и вызывающий не имеет разрешения LoggingPermission("control").

См. также:

Logger.setLevel(java.util.logging.Level)

getParentLoggerName

String getParentLoggerName(String loggerName)

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

Параметры:: loggerName - Имя Logger.
Возвращает:: имя ближайшего существующего родительского регистратора; пустая строка, если указанный регистратор является корневым. Если указанный регистратор не существует, возвращается 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.management/java/lang/management/PlatformLoggingMXBean.html