Интерфейс PlatformLoggingMXBean

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

public interface PlatformLoggingMXBean extends PlatformManagedObject

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

Существует единственный глобальный экземпляр 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)`	Устанавливает для указанного регистратора новый заданный уровень.

Методы, объявленные в интерфейсе 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.

См. также:

setLoggerLevel

void setLoggerLevel(String loggerName, String levelName)

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

Параметры:

loggerName — имя Logger, для которого задается уровень. Не должно быть null.

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

Исключения:

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

См. также:

getParentLoggerName

String getParentLoggerName(String loggerName)

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

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