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.*によって使用されます。DateTimeConverterDateTimeConverter#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コンバーターのリソースバンドルメッセージも参照してください。