Formatter (Java Platform SE 6)

概要

パッケージ

クラス

使用

階層ツリー

非推奨 API

索引

ヘルプ

Java^TM Platform
Standard Ed. 6

前のクラス 次のクラス

フレームあり フレームなし

概要: 入れ子 | フィールド | コンストラクタ | メソッド

詳細: フィールド | コンストラクタ | メソッド

java.util.logging
クラス Formatter

java.lang.Object
  java.util.logging.Formatter

直系の既知のサブクラス:: SimpleFormatter, XMLFormatter

public abstract class Formatter
extends Object
extends Object

Formatter は LogRecord のフォーマット処理をサポートします。

通常、各ロギング Handler には Formatter が関連付けられます。Formatter は LogRecord を受け取り、それを文字列に変換します。

XMLFormatter などの一部のフォーマッタは、一連のフォーマット済みレコードの前後に先頭文字列と末尾文字列を付加する必要があります。getHeader および getTail メソッドを使えば、これらの文字列を取得できます。

導入されたバージョン:: 1.4

コンストラクタの概要
`protected`	`Formatter()` 新しいフォーマッタを構築します。

メソッドの概要
`abstract String`	`format(LogRecord record)` 指定されたログレコードをフォーマットし、フォーマットされた文字列を返します。
`String`	`formatMessage(LogRecord record)` ログレコードからのメッセージ文字列をローカライズするようにフォーマットします。
`String`	`getHead(Handler h)` フォーマットされたレコードのセットのヘッダー文字列を返します。
`String`	`getTail(Handler h)` フォーマットされたレコードセットの末尾の文字列を返します。

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

コンストラクタの詳細

Formatter

protected Formatter()

新しいフォーマッタを構築します。

メソッドの詳細

format

public abstract String format(LogRecord record)

指定されたログレコードをフォーマットし、フォーマットされた文字列を返します。

通常、フォーマットされた String の結果には、ローカライズしフォーマットされたバージョンの LogRecord のメッセージフィールドが含まれます。Formatter.formatMessage の簡易メソッド (省略可能)を使用して、メッセージフィールドをローカライズし、フォーマットすることができます。

パラメータ:: record - フォーマットされるログレコード
戻り値:: フォーマットされたログレコード

getHead

public String getHead(Handler h)

フォーマットされたレコードのセットのヘッダー文字列を返します。

この基底クラスは空の文字列を返しますが、この処理はサブクラスによってオーバーライドされる場合があります。

パラメータ:: h - ターゲットハンドラ (null も可能)
戻り値:: ヘッダー文字列

getTail

public String getTail(Handler h)

フォーマットされたレコードセットの末尾の文字列を返します。

この基底クラスは空の文字列を返しますが、この処理はサブクラスによってオーバーライドされる場合があります。

パラメータ:: h - ターゲットハンドラ (null も可能)
戻り値:: 末尾の文字列

formatMessage

public String formatMessage(LogRecord record)

ログレコードからのメッセージ文字列をローカライズするようにフォーマットします。このメソッドは、Formatter のサブクラスがフォーマット処理を実行する際に使用可能な簡易手段として提供されています。

メッセージ文字列は、レコードの ResourceBundle を使用して、まずフォーマット文字列にローカライズされます。(ResourceBundle が存在しない場合またはメッセージキーが見つからない場合は、そのキーがフォーマット文字列として使用されます。)フォーマット String は、java.text スタイルのフォーマット処理を使用します。