Module java.management

Interface PlatformLoggingMXBean

所有超接口:
PlatformManagedObject

public interface PlatformLoggingMXBean extends PlatformManagedObject
日志 设施的管理接口。

PlatformLoggingMXBean 有一个全局实例。可以使用 ManagementFactory.getPlatformMXBean 方法获取 PlatformLoggingMXBean 对象,如下所示:

     PlatformLoggingMXBean logging = ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class);
 
PlatformLoggingMXBean 对象也注册到平台 MBeanServer。用于在 MBeanServer 中唯一标识 PlatformLoggingMXBeanObjectName 是:
      java.util.logging:type=Logging
 
自 JDK 版本:
1.7
  • Method Details

    • getLoggerNames

      List<String> getLoggerNames()
      返回当前注册的 记录器 名称的列表。此方法调用 LogManager.getLoggerNames() 并返回记录器名称列表。
      返回:
      一个 String 列表,每个都是当前注册的 Logger 名称。
    • getLoggerLevel

      String getLoggerLevel(String loggerName)
      获取与指定记录器关联的日志 级别 的名称。如果指定的记录器不存在,则返回 null。此方法首先找到给定名称的记录器,然后通过调用以下方法返回日志级别的名称:
      Logger.getLevel().getName();

      如果指定记录器的 Levelnull,表示此记录器的有效级别是从其父级继承的,则将返回一个空字符串。

      参数:
      loggerName - 要检索的 Logger 的名称。
      返回:
      指定记录器的日志级别的名称;如果指定记录器的日志级别为 null,则返回空字符串。如果指定的记录器不存在,则返回 null
      参见:
    • setLoggerLevel

      void setLoggerLevel(String loggerName, String levelName)
      将指定记录器设置为指定的新 级别。如果 levelName 不为 null,则将指定记录器的级别设置为与 levelName 匹配的解析后的 Level。如果 levelNamenull,则将指定记录器的级别设置为 null,并且记录器的有效级别将从具有特定(非空)级别值的最近祖先继承。
      参数:
      loggerName - 要设置的 Logger 的名称。必须为非空。
      levelName - 要在指定记录器上设置的级别的名称,如果要设置级别为从最近祖先继承,则为 null
      抛出:
      IllegalArgumentException - 如果指定的记录器不存在,或者 levelName 不是有效的级别名称。
      SecurityException - 如果存在安全管理器且调用者没有 LoggingPermission("control")。
      参见:
    • getParentLoggerName

      String getParentLoggerName(String loggerName)
      返回指定记录器的 父级 的名称。如果指定的记录器不存在,则返回 null。如果指定的记录器是命名空间中的根 Logger,则结果将是一个空字符串。
      参数:
      loggerName - Logger 的名称。
      返回:
      最近存在的父级记录器的名称;如果指定的记录器是根记录器,则为空字符串。如果指定的记录器不存在,则返回 null