Интерфейс LoggingMXBean

public interface LoggingMXBean

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

Существует единственный глобальный экземпляр LoggingMXBean. Этот экземпляр является MXBean, который можно получить, вызвав метод LogManager.getLoggingMXBean() или из платформенного MBeanServer.

Уникальный ObjectName, идентифицирующий управляющий интерфейс для ведения журналов в MBeanServer, это:

java.util.logging:type=Logging

Экземпляр, зарегистрированный в платформенном MBeanServer, также является PlatformLoggingMXBean.

Методы

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, и эффективный уровень логгера наследуется от ближайшего предка с определённым (не нулевым) значением уровня.

Параметры:

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.