JavaTM 2
Platform
Std. Ed. v1.4.0

java.util.logging
クラス Formatter

java.lang.Object
  |
  +--java.util.logging.Formatter
直系の既知のサブクラス:
SimpleFormatter, XMLFormatter

public abstract class Formatter
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 - ターゲットハンドラ
戻り値:
ヘッダ文字列

getTail

public String getTail(Handler h)
フォーマットされたレコードセットの末尾の文字列を返します。

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

パラメータ:
h - ターゲットハンドラ
戻り値:
末尾の文字列

formatMessage

public String formatMessage(LogRecord record)
ログレコードからのメッセージ文字列を地域対応するようにフォーマットします。このメソッドは Formatter のサブクラスがフォーマット処理を容易に実行できるように提供されます。

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

パラメータ:
record - raw メッセージを含むログレコード
戻り値:
地域対応するようにフォーマットされたメッセージ

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.