ADF Facesのメッセージおよびキーについて

ADF Facesには、次のエラーに対するデフォルトのコンポーネント・レベル・メッセージが用意されています。

各デフォルト・メッセージ(要約または詳細)は、メッセージ識別子とメッセージ・キーに関連付けられています。たとえば、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

oracle.adf.view.faces.UIXEditableValue.CONVERSION

oracle.adf.view.faces.UIXEditableValue.CONVERSION_detail

{0}?: コンポーネント・ラベル
{1}: 入力値
{2}: 戻されたメッセージ文字列

UIXEditableValue REQUIRED_MESSAGE_ID

oracle.adf.view.faces.UIXEditableValue.REQUIRED

oracle.adf.view.faces.UIXEditableValue.REQUIRED_detail

{0}: コンポーネント・ラベル

UIXTableSelectMany REQUIRED_MESSAGE_ID

oracle.adf.view.faces.UIXTableSelectMany.REQUIRED

oracle.adf.view.faces.UIXTableSelectMany.REQUIRED_detail

{0}: コンポーネント・ラベル

UIXTableSelectOne REQUIRED_MESSAGE_ID

oracle.adf.view.faces.UIXTableSelectOne.REQUIRED

oracle.adf.view.faces.UIXTableSelectOne.REQUIRED_detail

{0}: コンポーネント・ラベル

注意: UIXEditableValueコンポーネントには、InputSelectBooleanSelectInputSelectManyおよびSelectOneコンポーネントが含まれます。

ADF Facesのコンバータおよびバリデータ

次の表に、ADF Facesの提供済コンバータおよびバリデータに関連付けられたメッセージ識別子とキーを示します。エラー・タイプごとに固有のメッセージ識別子とキーがあります。

コンバータ/バリデータ メッセージ識別子 設定可能なメッセージ・キーとパラメータ
ColorConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.ColorConverter.CONVERT

oracle.adf.view.faces.convert.ColorConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定されたカラー・パターン

DateTimeConverter CONVERT_BOTH_MESSAGE_ID

oracle.adf.view.faces.convert.DateTimeConverter.CONVERT_BOTH

oracle.adf.view.faces.convert.DateTimeConverter.CONVERT_BOTH_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定されたdateStyleおよびtimeStyleに基づく日時の例

DateTimeConverter CONVERT_DATE_MESSAGE_ID

oracle.adf.view.faces.convert.DateTimeConverter.CONVERT_DATE

oracle.adf.view.faces.convert.DateTimeConverter.CONVERT_DATE_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: パターンまたはスタイル(typeがdateに設定されている場合)に基づく日付の例

DateTimeConverter CONVERT_TIME_MESSAGE_ID

oracle.adf.view.faces.convert.DateTimeConverter.CONVERT_TIME

oracle.adf.view.faces.convert.DateTimeConverter.CONVERT_TIME_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定されたtimeStyleに基づく時間の例

NumberConverter CONVERT_CURRENCY_MESSAGE_ID

oracle.adf.view.faces.convert.NumberConverter.CONVERT_CURRENCY

oracle.adf.view.faces.convert.NumberConverter.CONVERT_CURRENCY_detail

{0}: コンポーネント・ラベル
{1}: 入力値

NumberConverter CONVERT_NUMBER_MESSAGE_ID

oracle.adf.view.faces.convert.NumberConverter.CONVERT_NUMBER

oracle.adf.view.faces.convert.NumberConverter.CONVERT_NUMBER_detail

{0}: コンポーネント・ラベル
{1}: 入力値

NumberConverter CONVERT_PATTERN_MESSAGE_ID

oracle.adf.view.faces.convert.NumberConverter.CONVERT_PATTERN

oracle.adf.view.faces.convert.NumberConverter.CONVERT_PATTERN_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定されたパターン

NumberConverter CONVERT_PERCENT_MESSAGE_ID

oracle.adf.view.faces.convert.NumberConverter.CONVERT_PERCENT

oracle.adf.view.faces.convert.NumberConverter.CONVERT_PERCENT_detail

{0}: コンポーネント・ラベル
{1}: 入力値

ByteLengthValidator MAXIMUM_MESSAGE_ID

oracle.adf.view.faces.validator.ByteLengthValidator.MAXIMUM

oracle.adf.view.faces.validator.ByteLengthValidator.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大バイト

DateTimeRangeValidator MAXIMUM_MESSAGE_ID

oracle.adf.view.faces.validator.DateTimeRangeValidator.MAXIMUM

oracle.adf.view.faces.validator.DateTimeRangeValidator.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大値

DateTimeRangeValidator MINIMUM_MESSAGE_ID

oracle.adf.view.faces.validator.DateTimeRangeValidator.MINIMUM

oracle.adf.view.faces.validator.DateTimeRangeValidator.MINIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値

DateTimeRangeValidator NOT_IN_RANGE_MESSAGE_ID

oracle.adf.view.faces.validator.DateTimeRangeValidator.NOT_IN_RANGE

oracle.adf.view.faces.validator.DateTimeRangeValidator.NOT_IN_RANGE_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値
{3}: 設定された最大値

RegExpValidator NO_MATCH_MESSAGE_ID

oracle.adf.view.faces.validator.RegExpValidator.NO_MATCH

oracle.adf.view.faces.validator.RegExpValidator.NO_MATCH_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定されたパターン

ADF Facesのクライアント側のコンバータおよびバリデータ

次の表に、JSF標準コンバータおよびバリデータのADF Facesのクライアント側バージョンに関連付けられたメッセージ・キーを示します。

コンバータ/バリデータ メッセージ識別子 設定可能なメッセージ・キーとパラメータ
LongRange VALIDATOR_ID

javax.faces.LongRange

javax.faces.LongRange_detail

{0}: コンポーネント・ラベル
{1}: 入力値

LongRangeValidator MINIMUM_MESSAGE_ID

javax.faces.validator.LongRangeValidator.MINIMUM

javax.faces.validator.LongRangeValidator.MINIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値

LongRangeValidator MAXIMUM_MESSAGE_ID

javax.faces.validator.LongRangeValidator.MAXIMUM

javax.faces.validator.LongRangeValidator.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大値

ByteConverter MINIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.ByteConverter.MINIMUM

oracle.adf.view.faces.convert.ByteConverter.MINIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値

ByteConverter MAXIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.ByteConverter.MAXIMUM

oracle.adf.view.faces.convert.ByteConverter.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大値

ByteConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.ByteConverter.CONVERT

oracle.adf.view.faces.convert.ByteConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値

DoubleConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.DoubleConverter.CONVERT

oracle.adf.view.faces.convert.DoubleConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値

FloatConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.FloatConverter.CONVERT

oracle.adf.view.faces.convert.FloatConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値

IntegerConverter MINIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.IntegerConverter.MINIMUM

oracle.adf.view.faces.convert.IntegerConverter.MINIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値

IntegerConverter MAXIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.IntegerConverter.MAXIMUM

oracle.adf.view.faces.convert.IntegerConverter.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大値

IntegerConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.IntegerConverter.CONVERT

oracle.adf.view.faces.convert.IntegerConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値

LongConverter MINIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.LongConverter.MINIMUM

oracle.adf.view.faces.convert.LongConverter.MINIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値

LongConverter MAXIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.LongConverter.MAXIMUM

oracle.adf.view.faces.convert.LongConverter.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大値

LongConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.LongConverter.CONVERT

oracle.adf.view.faces.convert.LongConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値

ShortConverter MINIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.ShortConverter.MINIMUM

oracle.adf.view.faces.convert.ShortConverter.MINIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最小値

ShortConverter MAXIMUM_MESSAGE_ID

oracle.adf.view.faces.convert.ShortConverter.MAXIMUM

oracle.adf.view.faces.convert.ShortConverter.MAXIMUM_detail

{0}: コンポーネント・ラベル
{1}: 入力値
{2}: 設定された最大値

ShortConverter CONVERT_MESSAGE_ID

oracle.adf.view.faces.convert.ShortConverter.CONVERT

oracle.adf.view.faces.convert.ShortConverter.CONVERT_detail

{0}: コンポーネント・ラベル
{1}: 入力値


ADF Facesの変換および検証エラーについて