compact1、compact2、compact3

java.util.logging

クラスSimpleFormatter

java.lang.Object

java.util.logging.Formatter

java.util.logging.SimpleFormatter

public class SimpleFormatter
extends Formatter

LogRecordの簡単なサマリーを人が理解できる形式で出力します。このサマリーは通常、1行か2行になります。

構成:SimpleFormatterは、ログ・メッセージをフォーマットするために、java.util.logging.SimpleFormatter.formatプロパティで指定されたフォーマット文字列で初期化されます。このプロパティは、ロギング・プロパティの構成ファイルか、システム・プロパティとして定義されます。このプロパティがロギング・プロパティとシステム・プロパティの両方で設定されている場合は、システム・プロパティで指定されたフォーマット文字列が使用されます。このプロパティが定義されていないか、指定されたフォーマット文字列がillegalである場合、デフォルトのフォーマットは実装に固有となります。

導入されたバージョン:

1.4

関連項目:

Formatter

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

コンストラクタ

コンストラクタと説明
SimpleFormatter()

メソッドのサマリー

修飾子と型	メソッドと説明
String	format(LogRecord record) 指定されたLogRecordをフォーマットします。

クラス java.util.logging.Formatterから継承されたメソッド

formatMessage, getHead, getTail

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

SimpleFormatter

public SimpleFormatter()

メソッドの詳細

format

public String format(LogRecord record)

指定されたLogRecordをフォーマットします。

フォーマットは、java.util.logging.SimpleFormatter.formatプロパティでフォーマット文字列を指定することでカスタマイズできます。指定されたLogRecordは、次を呼び出すようにフォーマットされます。

    String.format(format, date, source, logger, level, message, thrown);
 

ここで、引数は次のとおりです。

1. format - java.util.logging.SimpleFormatter.formatプロパティまたはデフォルトのフォーマットで指定されたjava.util.Formatterのフォーマット文字列。
2. date - ログ・レコードのイベントの時間を表すDateオブジェクト。
3. source - 使用可能な場合は、呼出し元を表す文字列。使用できない場合は、ロガーの名前。
4. logger - ロガーの名前。
5. level - ログ・レベル。
6. message - Formatter.formatMessage(LogRecord)メソッドから返された、フォーマットされたログ・メッセージ。java.textのフォーマットを使用し、java.util.Formatter format引数は使用しません。
7. thrown - ログ・レコードおよび改行文字で始まるそのバックトレースに関連付けられたthrowableを表現する文字列(存在する場合)。バックトレースがない場合は、空の文字列。

フォーマット例を示します。

• java.util.logging.SimpleFormatter.format="%4$s: %5$s [%1$tc]%n"

  この例では、ログ・レベル(4$)、ログ・メッセージ(5$)、およびタイムスタンプ(1$)を角括弧に囲んで1行で出力します。

       WARNING: warning message [Tue Mar 22 13:11:31 PDT 2011]
       

• java.util.logging.SimpleFormatter.format="%1$tc %2$s%n%4$s: %5$s%6$s%n"

  この例は、1行目にはタイムスタンプ(1$)とソース(2$)、2行目にはログ・レベル(4$)とログ・メッセージ(5$)、使用可能な場合は、その後にスロー可能オブジェクトとそのバックトレース(6$)を含む、2行を出力します。

       Tue Mar 22 13:11:31 PDT 2011 MyClass fatal
       SEVERE: several message with an exception
       java.lang.IllegalArgumentException: invalid argument
               at MyClass.mash(MyClass.java:9)
               at MyClass.crunch(MyClass.java:6)
               at MyClass.main(MyClass.java:3)
       

• java.util.logging.SimpleFormatter.format="%1$tb %1$td, %1$tY %1$tl:%1$tM:%1$tS %1$Tp %2$s%n%4$s: %5$s%n"

  次の例は、前の例と同じように2行を出力しますが、異なる日付/時間のフォーマットを使用し、スロー可能オブジェクトとそのバックトレースは出力しません。

       Mar 22, 2011 1:11:31 PM MyClass fatal
       SEVERE: several message with an exception
       

このメソッドは、サブクラスでオーバーライドすることもできます。メッセージ・フィールドをローカライズし、フォーマットするには、Formatter.formatMessage(java.util.logging.LogRecord)簡易メソッドを使用することをお薦めします。

定義:

format、クラス: Formatter

パラメータ:

record - フォーマットされるログ・レコード。

戻り値:

フォーマットされたログ・レコード