compact3

java.lang.management

インタフェースPlatformLoggingMXBean

すべてのスーパー・インタフェース:

PlatformManagedObject

public interface PlatformLoggingMXBean
extends PlatformManagedObject

ロギング機能の管理インタフェースです。

PlatformLoggingMXBeanにはグローバル・インスタンスが1つ存在します。PlatformLoggingMXBeanオブジェクトは、次のようにManagementFactory.getPlatformMXBeanメソッドを使用して取得できます。

     PlatformLoggingMXBean logging = ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class);
 

PlatformLoggingMXBeanオブジェクトは、プラットフォームMBeanServerにも登録されます。MBeanServer内でPlatformLoggingMXBeanを一意に識別するためのObjectNameは、次のとおりです。

      java.util.logging:type=Logging
 

このObjectNameを使ってプラットフォームMBeanServerに登録されたインスタンスは、LoggingMXBeanで定義されているすべての属性を実装します。

導入されたバージョン:

1.7

メソッドのサマリー

修飾子と型	メソッドと説明
String	getLoggerLevel(String loggerName) 指定されたロガーに関連付けられているログ・レベルの名前を取得します。
List<String>	getLoggerNames() 現在登録されているロガーの名前のリストを返します。
String	getParentLoggerName(String loggerName) 指定されたロガーの親の名前を返します。
void	setLoggerLevel(String loggerName, String levelName) 指定されたロガーを指定された新しいレベルに設定します。

インタフェース java.lang.management.PlatformManagedObjectから継承されたメソッド

getObjectName

メソッドの詳細

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が返されます。