LogManager (Java Platform SE 8)

java.lang.Object
- java.util.logging.LogManager

```
public class LogManager
extends Object
```
Loggerとログ・サービスの共有状態のセットを管理するために使用される単一のグローバルLogManagerオブジェクトがあります。
このLogManagerには次の機能があります。
- Loggerオブジェクトの階層化された名前空間を管理する。名前付きLoggerはすべて、この名前空間内に格納される。
- ログ制御のプロパティのセットを管理する。これらは単にキーと値のペアである。Handlerやその他のロギング・オブジェクトはこれらを使ってそれ自体を構成できる。
グローバルLogManagerオブジェクトは、LogManager.getLogManager()を使って取得できます。このLogManagerオブジェクトはクラスの初期化中に作成され、その後は変更できません。
LogManagerクラスは、起動時にjava.util.logging.managerシステム・プロパティを使用して配置されます。
LogManagerは初期構成を制御できる、次の2つのオプションのシステム・プロパティを定義します。
- java.util.logging.config.class
- java.util.logging.config.file
これらの2つのプロパティは、javaコマンドへのコマンド行で、またはJNI_CreateJavaVMに渡されるシステム・プロパティの定義として指定することができます。
java.util.logging.config.classプロパティが設定されている場合、そのプロパティ値はクラス名とみなされます。指定されたクラスがロードされ、オブジェクトが1つインスタンス化されますが、そのオブジェクトのコンストラクタが初期構成を読込みを行います。このオブジェクトは、構成を制御するためにほかのシステム・プロパティを使用する場合があります。代替構成クラスは、readConfiguration(InputStream)を使ってLogManager内のプロパティを定義できます。
「java.util.logging.config.class」プロパティが設定されていない場合、java.util.logging.config.fileシステム・プロパティを使えば、java.util.Properties形式のプロパティ・ファイルを指定できます。このファイルから初期ロギング構成が読み取られます。
これらのどちらのプロパティも定義されていない場合、LogManagerはデフォルトの構成を使用します。デフォルトの構成は一般に、Javaインストール・ディレクトリのプロパティ・ファイルlib/logging.propertiesからロードされます。
ロガーとHandlerのプロパティは、ハンドラやロガーに関してドットで区切られた名前から始まる名前を持ちます。
グローバル・ログのプロパティには次のものがあります。
- handlersプロパティこれは、空白で区切られたハンドラ・クラスのクラス名のリストを定義して、ルートLogger (""という名前のLogger)のハンドラとしてロードし登録する。各クラス名は、デフォルト・コンストラクタを持つHandlerクラスのものでなければいけません。これらのHandlerは初回使用時に遅延作成されるので注意してください。
- <ロガー>.handlersプロパティ。これは、ロードし、指定されたロガーのハンドラとして登録すべきハンドラ・クラスのクラス名の、空白またはカンマで区切られたリストを定義します。各クラス名は、デフォルト・コンストラクタを持つHandlerクラスのものでなければいけません。これらのHandlerは初回使用時に遅延作成されるので注意してください。
- <logger>.useParentHandlersプロパティ。これはboolean値を定義します。すべてのロガーはデフォルトで、ロギング・メッセージをそれ自体で処理するだけでなく、その親の呼び出しも行います。その結果、メッセージがルート・ロガーによっても処理されることがよくあります。このプロパティをfalseに設定した場合、このロガーのHandlerを構成する必要があります。そうしないと、ロギング・メッセージが配信されません。
- configプロパティこのプロパティは、任意の構成コードを実行できるようにすることを目的とする。このプロパティは、空白またはカンマで区切られたクラス名リストを定義します。各名前付きクラスに対して新しいインスタンスが作成される。各クラスのデフォルト・コンストラクタは、ロガー・レベルの設定、ハンドラの追加、フィルタの追加など、任意のコードを実行することでロギング構成を更新できます。
LogManagerの構成中にロードされるクラスはすべて、ユーザー・クラス・パス上で検索される前にまずシステム・クラス・パス上で検索されることに注意してください。これにはLogManagerクラス、すべてのconfigクラス、すべてのhandlerクラスが含まれます。
Loggerは、そのドットで区切られた名前に基づいて、ネーミング階層へと構造化されます。その結果、「a.b.c」は「a.b」の子になりますが、「a.b1」および「a.b2」はピアになります。
名前が「.level」で終わるプロパティはすべて、Loggerのログ・レベルを定義しているとみなされます。したがって、「foo.level」は「foo」と呼ばれるロガー、およびネーミング階層にあるその子のログ・レベルを再帰的に定義します。ログ・レベルは、プロパティ・ファイルで定義した順に適用されます。したがって、ツリー内の子ノードに対するレベルの設定は親に対する設定のあとに行う必要があります。プロパティ名「.level」を使えば、ツリーのルートのレベルを設定できます。
LogManagerオブジェクトのすべてのメソッドはマルチ・スレッドに対して安全です。
導入されたバージョン:

1.4

フィールドのサマリー

フィールド
修飾子と型フィールドと説明

static String LOGGING_MXBEAN_NAME
ロギング機能の管理インタフェースのObjectNameの文字列表現。

フィールド
修飾子と型	フィールドと説明
`static String`	`LOGGING_MXBEAN_NAME` ロギング機能の管理インタフェースの`ObjectName`の文字列表現。

コンストラクタのサマリー

コンストラクタ
修飾子コンストラクタと説明

protected LogManager()
protectedコンストラクタです。

コンストラクタ
修飾子	コンストラクタと説明
`protected`	`LogManager()` protectedコンストラクタです。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`boolean`	`addLogger(Logger logger)` 名前付きロガーを追加します。
`void`	`addPropertyChangeListener(PropertyChangeListener l)` 非推奨。 `PropertyChangeListener`への依存は、Javaプラットフォームの将来のモジュール化に対する大きな障害になります。このメソッドは今後のリリースで削除される予定です。グローバルな`LogManager`は、`readConfiguration`メソッドをオーバーライドすることでロギング構成の変更を検出できます。
`void`	`checkAccess()` 現在のコンテキストが信頼されていてロギング構成を変更できるかどうかをチェックします。
`Logger`	`getLogger(String name)` 名前付きロガーを検出するメソッドです。
`Enumeration<String>`	`getLoggerNames()` 既知のロガーの名前の列挙を返します。
`static LoggingMXBean`	`getLoggingMXBean()` ロガーを管理するための`LoggingMXBean`を返します。
`static LogManager`	`getLogManager()` グローバルなLogManagerオブジェクトを返します。
`String`	`getProperty(String name)` ログのプロパティの値を返します。
`void`	`readConfiguration()` ログのプロパティを再度初期化してログ構成を再度読み込みます。
`void`	`readConfiguration(InputStream ins)` ロギング・プロパティを再度初期化し、指定されたストリームからログ構成を再度読み込みます。これはjava.util.Properties形式であるべきです。
`void`	`removePropertyChangeListener(PropertyChangeListener l)` 非推奨。 `PropertyChangeListener`への依存は、Javaプラットフォームの将来のモジュール化に対する大きな障害になります。このメソッドは今後のリリースで削除される予定です。グローバルな`LogManager`は、`readConfiguration`メソッドをオーバーライドすることでロギング構成の変更を検出できます。
`void`	`reset()` ログの構成をリセットします。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - LOGGING_MXBEAN_NAME
```
public static final String LOGGING_MXBEAN_NAME
```
    ロギング機能の管理インタフェースのObjectNameの文字列表現。
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    
    PlatformLoggingMXBean、LoggingMXBean、定数フィールド値
- コンストラクタの詳細
  - LogManager
```
protected LogManager()
```
    protectedコンストラクタです。これがprotectedになっているのは、J2EEコンテナなどのコンテナ・アプリケーションが、このオブジェクトのサブクラスを作成できるようにするためです。これがpublicでないのは、LogManagerオブジェクトが1つしか存在しない状況が想定されているからです。その値を取得するには、Logmanager.getLogManagerを呼び出します。
- メソッドの詳細
  - getLogManager
```
public static LogManager getLogManager()
```
    グローバルなLogManagerオブジェクトを返します。
    
    戻り値:
    
    グローバルなLogManagerオブジェクト
  - addPropertyChangeListener
```
@Deprecated
public void addPropertyChangeListener(PropertyChangeListener l)
                                           throws SecurityException
```
    非推奨。PropertyChangeListenerへの依存は、Javaプラットフォームの将来のモジュール化に対する大きな障害になります。このメソッドは今後のリリースで削除される予定です。グローバルなLogManagerは、readConfigurationメソッドをオーバーライドすることでロギング構成の変更を検出できます。
    
    ログのプロパティが再読み込みされたときに呼び出されるイベント・リスナーを追加します。同じイベントListenerの複数のインスタンスを追加すると、プロパティ・イベント・リスナー・テーブル内に複数のエントリが格納されます。
    警告: このメソッドは、java.beansパッケージを含まないJava SEのすべてのサブセットプロファイルのこのクラスから省略されています。
    
    パラメータ:
    
    l - event listener
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。
    
    NullPointerException - PropertyChangeListenerがnullの場合。
  - removePropertyChangeListener
```
@Deprecated
public void removePropertyChangeListener(PropertyChangeListener l)
                                              throws SecurityException
```
    非推奨。PropertyChangeListenerへの依存は、Javaプラットフォームの将来のモジュール化に対する大きな障害になります。このメソッドは今後のリリースで削除される予定です。グローバルなLogManagerは、readConfigurationメソッドをオーバーライドすることでロギング構成の変更を検出できます。
    
    プロパティ変更イベントのイベント・リスナーを削除します。addPropertyChangeListenerを複数回呼び出すことで同じリスナーの複数のインスタンスがリスナー・テーブルに追加されていた場合、そのリスナーのすべてのインスタンスをリスナー・テーブルから削除するには、removePropertyChangeListenerをそれと同じ回数だけ呼び出す必要があります。
    指定されたリスナーが見つからない場合は何も行わずに復帰します。
    警告: このメソッドは、java.beansパッケージを含まないJava SEのすべてのサブセットプロファイルのこのクラスから省略されています。
    
    パラメータ:
    
    l - イベント・リスナー(nullも可)
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。
  - addLogger
```
public boolean addLogger(Logger logger)
```
    名前付きロガーを追加します。これは、同じ名前のロガーがすでに登録されている場合、何もせずにfalseを返します。
    Loggerのファクトリ・メソッドは、このメソッドを呼び出して、新規に作成された各Loggerを登録します。
    アプリケーションは、このLoggerオブジェクトへの独自の参照を保持すべきです。それにより、このオブジェクトがガベージ・コレクトされるのを防げます。LogManagerは弱参照しか保持できません。
    
    パラメータ:
    
    logger - 新しいロガー。
    
    戻り値:
    
    引数loggerが正常に登録された場合はtrue、その名前のロガーがすでに存在する場合はfalse
    
    例外:
    
    NullPointerException - ロガーの名前がnullの場合。
  - getLogger
```
public Logger getLogger(String name)
```
    名前付きロガーを検出するメソッドです。
    信頼できないコードが任意の名前のロガーを作成する場合があるので、このメソッドはセキュリティ上重要なロギング用のLoggerの検出には使用しないでください。文字列nameに関連付けられたLoggerは、Loggerへの強い参照がない場合に、いつでもガベージ・コレクトされる可能性があることを理解することも重要です。このメソッドの呼出し元は、Loggerがガベージ・コレクトされた場合に適切に対処するため、nullの戻り値を確認する必要があります。
    
    パラメータ:
    
    name - ロガーの名前
    
    戻り値:
    
    一致するロガー、または見つからない場合はnull
  - getLoggerNames
```
public Enumeration<String> getLoggerNames()
```
    既知のロガーの名前の列挙を返します。
    注: Loggerは新しいクラスがロードされると動的に追加されます。このメソッドは現在登録されているロガーのみについて通知します。このメソッドは、Loggerそのものへの強い参照ではなく、Loggerの名前だけを返すことを理解しておくことも重要です。返された文字列は、Loggerのガベージ・コレクションを防ぐことについては、何も行いません。特に、返された名前がLogManager.getLogger()に渡された場合は、このメソッドによって名前が返された時点以降にLoggerがガベージ・コレクトされる場合に適切に対処するため、呼出し元はLogManager.getLogger()からのnullの戻り値を確認する必要があります。
    
    戻り値:
    
    ロガー名の文字列の列挙
  - readConfiguration
```
public void readConfiguration()
                       throws IOException,
                              SecurityException
```
    ログのプロパティを再度初期化してログ構成を再度読み込みます。
    起動時に使用されるのと同じ構成プロパティ検索ルールが使用されます。このため、ロギング・プロパティの再読込みは通常、起動時に使用されたのと同じファイルから行われます。
    新しい構成ファイルのすべてのログ・レベルの定義は、ターゲットのLoggerがある場合はLogger.setLevel()を使って適用されます。
    PropertyChangeEventはプロパティが読み込まれてからトリガーされます。
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。
    
    IOException - 構成を読み込むときに入出力の問題が発生した場合。
  - reset
```
public void reset()
           throws SecurityException
```
    ログの構成をリセットします。
    すべての名前付きロガーについて、resetオペレーションはすべてのHandler (ルート・ロガーのものは除く)を削除して閉じ、レベルをnullに設定します。ルート・ロガーのレベルはLevel.INFOに設定されます。
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。
  - readConfiguration
```
public void readConfiguration(InputStream ins)
                       throws IOException,
                              SecurityException
```
    ロギング・プロパティを再度初期化し、指定されたストリームからログ構成を再度読み込みます。これはjava.util.Properties形式であるべきです。PropertyChangeEventはプロパティが読み込まれてからトリガーされます。
    新しい構成ファイルのすべてのログ・レベルの定義は、ターゲットのLoggerがある場合はLogger.setLevel()を使って適用されます。
    
    パラメータ:
    
    ins - プロパティを読み込むストリーム
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。
    
    IOException - ストリームからの読込みに問題がある場合。
  - getProperty
```
public String getProperty(String name)
```
    ログのプロパティの値を返します。そのプロパティが見つからない場合は、nullが返されます。
    
    パラメータ:
    
    name - プロパティ名
    
    戻り値:
    
    プロパティの値
  - checkAccess
```
public void checkAccess()
                 throws SecurityException
```
    現在のコンテキストが信頼されていてロギング構成を変更できるかどうかをチェックします。これにはLoggingPermission("control")が必要となります。
    このチェックに失敗した場合はSecurityExceptionをスローします。そうでない場合は正常に復帰します。
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在する場合で、呼出し元がLoggingPermission("control")を持っていない場合。
  - getLoggingMXBean
```
public static LoggingMXBean getLoggingMXBean()
```
    ロガーを管理するためのLoggingMXBeanを返します。ロガーは、次を呼び出すことで取得されるPlatformLoggingMXBeanインタフェースを通じて管理することもできます。
```
     PlatformLoggingMXBean logging = ManagementFactory.getPlatformMXBean(PlatformLoggingMXBean.class);
 
```
    戻り値:
    
    LoggingMXBeanオブジェクト。
    
    導入されたバージョン:
    
    1.5
    
    関連項目:
    
    PlatformLoggingMXBean

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスLogManager

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

LOGGING_MXBEAN_NAME

コンストラクタの詳細

LogManager

メソッドの詳細

getLogManager

addPropertyChangeListener

removePropertyChangeListener

addLogger

getLogger

getLoggerNames

readConfiguration

reset

readConfiguration

getProperty

checkAccess

getLoggingMXBean