java.util.logging
介面 LoggingMXBean

public interface LoggingMXBean

日誌記錄設施的管理介面。

存在單個 LoggingMXBean 的全體實例。此實例是一個 MXBean，可通過調用 LogManager.getLoggingMXBean() 得到，或者從 platform MBeanServer 方法得到。

在 MBeanServer 中唯一標識 LoggingMXBean 的 ObjectName 是：

java.util.logging:type=Logging

從以下版本開始：

1.5

另請參見：

ManagementFactory

方法摘要

String	getLoggerLevel(String loggerName) 獲取與指定 logger 相關的日誌級別名稱。
List<String>	getLoggerNames() 返回當前已註冊的 logger 列表。
String	getParentLoggerName(String loggerName) 返回指定 logger 的父 logger 名稱。
void	setLoggerLevel(String loggerName, String levelName) 將指定 logger 設置為指定的新級別。

方法詳細資訊

getLoggerNames

List<String> getLoggerNames()

返回當前已註冊的 logger 列表。此方法調用 LogManager.getLoggerNames()，並返回 logger 的名稱列表。

返回：

String 列表，其中每一項都是一個當前已註冊的 Logger 名稱。

getLoggerLevel

String getLoggerLevel(String loggerName)

獲取與指定 logger 相關的日誌級別名稱。如果指定 logger 不存在，則返回 null。此方法首先尋找給定名稱的 logger ，然後返回日誌級別的名稱，這通過調用以下方法來實作：

Logger.getLevel().getName();

如果指定 logger 的 Level 為 null（這意味著此 logger 的有效級別繼承自它的父 logger），則返回一個空字元串。

參數：

loggerName - 要獲取的 Logger 的名稱。

返回：

指定 logger 的日誌級別的名稱；如果指定 logger 的日誌級別為 null，則返回一個空字元串。如果指定 logger 不存在，則返回 null。

另請參見：

Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName,
                    String levelName)

將指定 logger 設置為指定的新級別。如果 levelName 不為 null，則將指定 logger 的級別設置為與 levelName 比對的、解析後的 Level。如果 levelName 為 null，則將指定 logger 的級別設置為 null，並且其有效級別繼承自最近的祖先（帶特定的非 null 級別值）。

參數：

loggerName - 要設置的 Logger 的名稱。必須為非 null。

levelName - 指定 logger 所要設置的級別名稱，如果設置該級別繼承其最近的祖先，則為 null。

拋出：

IllegalArgumentException - 如果指定 logger 不存在，或 levelName 不是一個有效的級別名稱。

SecurityException - 如果安全管理器存在並且調用者不具有 LoggingPermission("control")。

另請參見：

Logger.setLevel(java.util.logging.Level)

getParentLoggerName

String getParentLoggerName(String loggerName)

返回指定 logger 的父 logger 名稱。如果指定 logger 不存在，則返回 null。如果指定 logger 是名稱空間中的根 Logger，則結果是一個空字元串。

參數：

loggerName - Logger 的名稱。

返回：

最近的現有父 logger 的名稱；如果指定的 logger 是根 logger ，則返回一個空字元串。如果指定 logger 不存在，則返回 null。