java.util.logging
インタフェース LoggingMXBean

public interface LoggingMXBean

ロギングファシリティの管理インタフェースです。

LoggingMXBean の単一のグローバルインスタンスがあります。このインスタンスは、LogManager.getLoggingMXBean() メソッドを呼び出して、または platform MBeanServer メソッドから取得できる MXBean です。

MBeanServer 内で LoggingMXBean を一意に識別する ObjectName は次のとおりです。

java.util.logging:type=Logging

導入されたバージョン:

1.5

関連項目:

ManagementFactory

メソッドの概要

String	getLoggerLevel(String loggerName) 指定したロガーに関連したログレベルの名前を取得します。
List<String>	getLoggerNames() 現在登録されているロガーのリストを返します。
String	getParentLoggerName(String loggerName) 指定したロガーの親の名前を返します。
void	setLoggerLevel(String loggerName, String levelName) 指定したロガーを指定した新規レベルに設定します。

メソッドの詳細

getLoggerNames

List<String> getLoggerNames()

現在登録されているロガーのリストを返します。このメソッドは LogManager.getLoggerNames() を呼び出してロガーの名前のリストを返します。

戻り値:

それぞれが現在登録されている Logger 名の String のリスト

getLoggerLevel

String getLoggerLevel(String loggerName)

指定したロガーに関連したログレベルの名前を取得します。指定したロガーが存在しない場合は、null が返されます。このメソッドは最初に指定された名前のロガーを検索し、その後次のように呼び出してログレベルの名前を返します。

Logger.getLevel().getName();

指定したロガーの Level が null の場合、このロガーの有効レベルが親から継承されていることを意味し、空の文字列が返されます。

パラメータ:

loggerName - 取り出される Logger の名前

戻り値:

指定したロガーのログレベルの名前、または指定したロガーのログレベルが null の場合は空の文字列。指定したロガーが存在しない場合は null が返される

関連項目:

Logger.getLevel()

setLoggerLevel

void setLoggerLevel(String loggerName,
                    String levelName)

指定したロガーを指定した新規レベルに設定します。levelName が null でない場合、指定したロガーのレベルは、levelName に一致する解析後の Level に設定されます。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 が返される