モジュール java.logging
パッケージ java.util.logging

クラスConsoleHandler


  • public class ConsoleHandler
extends StreamHandler
    このHandlerは、ログ・レコードをSystem.errに発行します。 デフォルトでは、SimpleFormatterを使って簡単なサマリーが生成されます。

    構成: デフォルトで各ConsoleHandlerは次のLogManager構成プロパティを使用して初期化されます。ここで<handler-name>はハンドラの完全修飾クラス名を示します。 プロパティが未定義である場合(または無効な値を持つ場合)、指定されたデフォルト値が使用されます。

    • <handler-name>.levelはHandlerのデフォルト・レベルを指定します(デフォルトはLevel.INFO)。
    • <handler-name>.filterは使用するFilterクラスの名前を指定します(デフォルトはFilterなし)。
    • <handler-name>.formatterは使用するFormatterクラスの名前を指定します(デフォルトはjava.util.logging.SimpleFormatter)。
    • <handler-name>.encodingは使用する文字セット・エンコーディングの名前を指定します(デフォルトは、デフォルト・プラットフォームのエンコーディング)。

    たとえば、ConsoleHandlerのプロパティは次のようになります。

    • java.util.logging.ConsoleHandler.level=INFO
    • java.util.logging.ConsoleHandler.formatter=java.util.logging.SimpleFormatter

    カスタム・ハンドラ(例: com.foo.MyHandler)の場合、プロパティは次のようになります。

    • com.foo.MyHandler.level=INFO
    • com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter
    導入されたバージョン:
    1.4

    • コンストラクタの詳細

      • ConsoleHandler

        public ConsoleHandler​()
        System.errのConsoleHandlerを作成します。

        ConsoleHandlerはLogManagerのプロパティまたはそのデフォルト値に基づいて構成されます。

    • メソッドの詳細

      • publish

        public void publish​(LogRecord record)
        LogRecordを発行します。

        初期状態では、ロギングの要求はLoggerオブジェクトに対して行われ、このオブジェクトはLogRecordを初期化してここに転送しました。

        オーバーライド:
        publish、クラス: StreamHandler
        パラメータ:
        record - ログ・イベントの説明。 nullレコードは何の通知もなく無視され、発行されない

      • close

        public void close​()
        StreamHandler.closeをオーバーライドし、フラッシュは行うが出力ストリームのクローズは行わないようにします。 つまり、System.errをクローズしません。
        オーバーライド:
        close、クラス: StreamHandler