Интерфейс 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

Модификатор и тип	Метод	Описание
`ObjectName`	`getObjectName()`	Возвращает экземпляр `ObjectName`, представляющий имя объекта этого управляемого платформенного объекта.

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

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.