jsf-api.jarには、ローカライズされたさまざまなMessages.propertiesファイルが含まれています。これらのファイルには、一方ではjavax.faces.component.UIInput.CONVERSION
キーが含まれ、他方ではさまざまなjavax.faces.converter.*
キーが含まれています。
私の質問は次のとおりです。
- 最初のキーはいつ使用され、2番目のキーはいつ使用されますか?
- これはどこに文書化されていますか?
jsf-api.jarには、ローカライズされたさまざまなMessages.propertiesファイルが含まれています。これらのファイルには、一方ではjavax.faces.component.UIInput.CONVERSION
キーが含まれ、他方ではさまざまなjavax.faces.converter.*
キーが含まれています。
私の質問は次のとおりです。
このjavax.faces.component.UIInput.CONVERSION
メッセージはConverterException
、にfacesメッセージが含まれておらず、コンポーネントがconverterMessage
属性を指定していない場合に使用されます。つまり、これはデフォルト/フォールバックメッセージです。メッセージ識別子は、次のように文書化UIInput#CONVERSION_MESSAGE_ID
されている定数によって指定されます。
CONVERSION_MESSAGE_ID
public static final java.lang.String CONVERSION_MESSAGE_ID
FacesMessage
変換エラーが発生し、ページ作成者もがメッセージも提供しない場合に作成されるのメッセージ識別子ConverterException
。関連項目:
メッセージは、javax.faces.converter.*
メッセージIDで指定された標準JSFコンバーターが特定の変換タスクに失敗した場合に使用されます。標準のJSFコンバーターは、javax.faces.convert
パッケージの要約のクラスの要約にリストされています。たとえば、メッセージ識別子は、その定数値が次のように文書化されているように、フィールドの概要にリストされているいくつかのメッセージ識別子定数を持つものjava.faces.converter.DateTimeConverter.*
によって使用されます。DateTimeConverter
DateTimeConverter#DATE_ID
"javax.faces.converter.DateTimeConverter.DATE"
DATE_ID
public static final java.lang.String DATE_ID
FacesMessage
への変換がDate
失敗した場合に作成されるのメッセージ識別子。このメッセージのメッセージフォーマット文字列には、オプションで次のプレースホルダーを含めることができます。
{0}
変換されていない値に置き換えられます。{1}
値の例に置き換えられました。{2}
String
このメッセージを生成した入力コンポーネントのラベルが値であるaに置き換えられます。関連項目:
すべてのメッセージ識別子は、 JSF仕様の2.5.2.4章にリストされていることに注意してください。コピーについては、JSFコンバーターのリソースバンドルメッセージも参照してください。