JSFには、次のエラーに対する事前定義のメッセージが用意されています。
selectOneMenu
およびselectManyListbox
)
JSFでは、標準のJavaリソース・バンドルを使用して、メッセージ、および個々のメッセージを識別するキーと値のペアが定義されます。たとえば、デフォルトの変換エラー・メッセージは、「変換エラーが発生しました。」で、変換エラー・メッセージのキーはjavax.faces.component.UIInput.CONVERSION
です。
各標準メッセージには要約説明と詳細説明があります。詳細メッセージ説明のキーは、標準キーの後に文字列_detail
を付加したものです(例: javax.faces.component.UIInput.CONVERSION_detail
)。
JSF標準メッセージのキーのリストは、次のURLのConstant Field Valuesページを参照してください。
http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/constant-values.html
MESSAGE_ID
が含まれている定数フィールド名(例: CONVERSION_MESSAGE_ID
)を検索します。これらの定数名の横がJSF標準メッセージのキー(例: javax.faces.component.UIInput.CONVERSION
)です。
注意: Constant Field Valuesページへの前述のリンクは、このトピックが作成された時点の正確なURLです。リンクが機能しない場合は、URLアドレスのバージョン番号を変更するか、またはJSFに関するjava.sun.comのWebページ http://java.sun.com/j2ee/javaserverfaces/にアクセスして正しいページを探す必要があります。
JSF標準メッセージは汎用的であり、ローカライズされていません。つまり、英語のみで提供されています。しかし、JSFの標準バリデータおよびコンバータでは、メッセージ・テキストの取得にロケール固有のResourceBundle
インスタンスが使用されるため、ローカライズ・メッセージを提供できます。したがって、JSFで標準メッセージをローカライズするには、メッセージ・リソース・バンドルを作成して、英語のテキストをローカライズ・テキストで置換するだけです。JSF標準メッセージをオーバーライドするには、バンドルをfaces-config.xml
に宣言する必要があります。詳細は、「JSF標準メッセージに対するカスタム・メッセージ・テキストについて」および「JSFでのローカライズ・データおよびメッセージの使用について」を参照してください。
標準JSFメッセージ・タグについて
変換および検証エラーについて
Copyright © 1997, 2007, Oracle. All rights reserved.