JavaTM Platform
Standard Ed. 6

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 - ターゲットハンドラ (null も可能)
戻り値:
ヘッダー文字列

getTail

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

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

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

formatMessage

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

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

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

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。