4

jsf-api.jarには、ローカライズされたさまざまなMessages.propertiesファイルが含まれています。これらのファイルには、一方ではjavax.faces.component.UIInput.CONVERSIONキーが含まれ、他方ではさまざまなjavax.faces.converter.*キーが含まれています。

私の質問は次のとおりです。

  • 最初のキーはいつ使用され、2番目のキーはいつ使用されますか?
  • これはどこに文書化されていますか?
4

1 に答える 1

5

この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コンバーターのリソースバンドルメッセージも参照してください。

于 2013-03-21T14:40:54.773 に答える