Интерфейс PlatformLoggingMXBean

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

Экземпляр, зарегистрированный в платформенном MBeanServer с этим ObjectName, реализует все атрибуты, определённые в LoggingMXBean.

Методы

getLoggerNames

List<String> getLoggerNames()

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

Возвращает:

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

getLoggerLevel

String getLoggerLevel(String loggerName)

Параметры:

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.