ADF Facesには、次のエラーに対するデフォルトのコンポーネント・レベル・メッセージが用意されています。
UIXEditableValue
コンポーネントに関連付けられた変換エラー
UIXEditableValue
コンポーネントに関連付けられた必須入力検証エラー
UIXTableSelectMany
およびUIXTableSelectOne
コンポーネントに関連付けられた必須入力検証エラー
各デフォルト・メッセージ(要約または詳細)は、メッセージ識別子とメッセージ・キーに関連付けられています。たとえば、UIXEditableValue
インタフェース(oracle.adf.view.faces.component.UIXEditableValue
)を実装するすべてのADF Faces入力コンポーネントに対するデフォルトの変換エラー・メッセージの場合、メッセージ識別子はCONVERSION_MESSAGE_ID
、メッセージ・キーはoracle.adf.view.faces.UIXEditableValue.CONVERSION
およびoracle.adf.view.faces.UIXEditableValue.CONVERSION_detail
です。
ADF Facesメッセージには、{0}
、{1}
など、オプションのパラメータ・プレースホルダが含まれています。プレースホルダは、実行時に適切なパラメータ値で置換されます。パラメータの順序は、次のとおりです。
たとえば、UIXEditableValue
コンポーネントのデフォルトの変換エラー・メッセージには、プレースホルダ{0}、{1}および{2}が含まれています。{0}はコンポーネントを識別するラベル、{1}はユーザーが入力した値、{2}はConverterException
から戻されたメッセージ文字列で、デフォルトの変換エラー詳細メッセージは、次のようになります。
値"{1}"は理解されませんでした: {2}
ADF Facesには、ほとんどのメッセージの詳細部分を特別なタグ属性を使用してカスタマイズする簡単な方法が用意されています。これらのメッセージ詳細属性の詳細は、「ADF Facesのエラー・メッセージのカスタマイズについて」を参照してください。
このトピックの後半では、次の機能に対するメッセージ識別子、メッセージ・キーおよびメッセージ書式パラメータについて説明します。
ADF Facesの編集可能な入力コンポーネントおよび表選択コンポーネントに関連付けられているメッセージ識別子とキーは、次のとおりです。
コンポーネント・タイプ | メッセージ識別子 | 設定可能なメッセージ・キーとパラメータ |
---|---|---|
UIXEditableValue
|
CONVERSION_MESSAGE_ID
|
|
UIXEditableValue
|
REQUIRED_MESSAGE_ID
|
|
UIXTableSelectMany
|
REQUIRED_MESSAGE_ID
|
|
UIXTableSelectOne
|
REQUIRED_MESSAGE_ID
|
|
注意: UIXEditableValueコンポーネントには、Input
、SelectBoolean
、SelectInput
、SelectMany
およびSelectOne
コンポーネントが含まれます。
次の表に、ADF Facesの提供済コンバータおよびバリデータに関連付けられたメッセージ識別子とキーを示します。エラー・タイプごとに固有のメッセージ識別子とキーがあります。
コンバータ/バリデータ | メッセージ識別子 | 設定可能なメッセージ・キーとパラメータ |
---|---|---|
ColorConverter
|
CONVERT_MESSAGE_ID
|
|
DateTimeConverter
|
CONVERT_BOTH_MESSAGE_ID
|
|
DateTimeConverter
|
CONVERT_DATE_MESSAGE_ID
|
|
DateTimeConverter
|
CONVERT_TIME_MESSAGE_ID
|
|
NumberConverter
|
CONVERT_CURRENCY_MESSAGE_ID
|
|
NumberConverter
|
CONVERT_NUMBER_MESSAGE_ID
|
|
NumberConverter
|
CONVERT_PATTERN_MESSAGE_ID
|
|
NumberConverter
|
CONVERT_PERCENT_MESSAGE_ID
|
|
ByteLengthValidator
|
MAXIMUM_MESSAGE_ID
|
|
DateTimeRangeValidator
|
MAXIMUM_MESSAGE_ID
|
|
DateTimeRangeValidator
|
MINIMUM_MESSAGE_ID
|
|
DateTimeRangeValidator
|
NOT_IN_RANGE_MESSAGE_ID
|
|
RegExpValidator
|
NO_MATCH_MESSAGE_ID
|
|
次の表に、JSF標準コンバータおよびバリデータのADF Facesのクライアント側バージョンに関連付けられたメッセージ・キーを示します。
コンバータ/バリデータ | メッセージ識別子 | 設定可能なメッセージ・キーとパラメータ |
---|---|---|
LongRange
|
VALIDATOR_ID
|
|
LongRangeValidator
|
MINIMUM_MESSAGE_ID
|
|
LongRangeValidator
|
MAXIMUM_MESSAGE_ID
|
|
ByteConverter
|
MINIMUM_MESSAGE_ID
|
|
ByteConverter
|
MAXIMUM_MESSAGE_ID
|
|
ByteConverter
|
CONVERT_MESSAGE_ID
|
|
DoubleConverter
|
CONVERT_MESSAGE_ID
|
|
FloatConverter
|
CONVERT_MESSAGE_ID
|
|
IntegerConverter
|
MINIMUM_MESSAGE_ID
|
|
IntegerConverter
|
MAXIMUM_MESSAGE_ID
|
|
IntegerConverter
|
CONVERT_MESSAGE_ID
|
|
LongConverter
|
MINIMUM_MESSAGE_ID
|
|
LongConverter
|
MAXIMUM_MESSAGE_ID
|
|
LongConverter
|
CONVERT_MESSAGE_ID
|
|
ShortConverter
|
MINIMUM_MESSAGE_ID
|
|
ShortConverter
|
MAXIMUM_MESSAGE_ID
|
|
ShortConverter
|
CONVERT_MESSAGE_ID
|
|
Copyright © 1997, 2006, Oracle. All rights reserved.