すべてのADF Facesバリデータがjavax.faces.validator.Validator
インタフェースを実装します。ADF Facesバリデータは、oracle.adf.view.faces.validator
にパッケージ化されています。提供されているADF Facesバリデータ・クラスのセットには、次のリストに示すように、文字列バイト長、日付範囲および式に関する検証機能が備わっています。
ByteLengthValidator
: 文字列のバイト長に関する検証。有効なJavaエンコーディングに基づきます。
DateTimeRangeValidator
: 指定された日付が特定の範囲内であることの検証。
RegExpValidator
: Java正規表現構文を使用した式に関する検証。
ADF Facesバリデータの詳細は、oracle.adf.view.faces.validator.ByteLengthValidator
、oracle.adf.view.faces.validator.DateTimeRangeValidator
およびoracle.adf.view.faces.validator.RegExpValidator
に関するJavadocを参照してください。
注意: 必須値をチェックするには、コンポーネントでrequired
属性を使用してください。必須入力フィールドを検証するためのバリデータ・クラスはありません。
提供されているADF Facesバリデータ・クラスとそのタグのセットは、次のとおりです。
タグ | クラス | 登録済ID |
---|---|---|
af:validateByteLength
|
ByteLengthValidator
|
oracle.adf.ByteLength
|
af:validateDateTimeRage
|
DateTimeRangeValidator
|
oracle.adf.DateTimeRange
|
af:validateRegExp
|
RegExpValidator
|
oracle.adf.RegExp
|
サポートされているタグ属性のリストは、「リファレンス: ADF Facesコンバータおよびバリデータ」を参照してください。
タグを使用するには、提供されているタグをコンポーネント内にネストします。次に、タグの属性を使用して、コンポーネント・データに対して設定可能な値を構成します。次に例を示します。
<af:selectInputDate id="mdf3"
value="2004-11-25"
tip="min=2004-11-16 max=2004-12-16"
label="Submission period">
<af:convertDateTime pattern="yyyy-MM-dd"/>
<!-- Supports ISO date format strings of the form "yyyy-MM-dd" -->
<af:validateDateTimeRange minimum="2004-11-16"
maximum="2004-12-16"
notInRangeMessageDetail="Date "{0}" in "{1}" does not fall with in {2} : {3}"/>
</af:selectInputDate>
JSF標準バリデータとは異なり、ADF Facesバリデータでは、サーバー側の検証に加え、クライアント側の検証がサポートされます。ADF Facesのクライアント側の検証は、サーバー側の検証と同様に機能します。ただし、クライアントではJavaScriptが使用される点が異なります。
バイト長、日付範囲および正規表現に関するJavaScript対応のバリデータに加え、ADF Facesには、必須入力テキスト・フィールドに関するJavaScript対応バリデータも用意されています。
ADF FacesのJavaScript対応バリデータは、フォームの発行時にクライアントで実行されます。したがって、エラーはサーバーへのラウンドトリップなしに検出可能です。ただし、ADF Facesアプリケーションのクライアント側の変換と検証を無効にできます。「ADF Facesのクライアント側の変換および検証の無効化」を参照してください。
oracle.adf.view.faces.validator.ClientValidator
インタフェースを使用すると、javax.faces.validator.Validator
の実装である既存のバリデータに独自のクライアント側検証を追加できます。クライアント・バリデータのAPIの詳細は、「ADF Facesのクライアント・コンバータおよびバリデータのAPIについて」を参照してください。
ADF Facesバリデータは、タグの実行フェーズ中ではなく、実際の検証の発生時に値バインディングを評価します。これは、バリデータAPIのsetValueBinding(String name, ValueBinding)
およびgetValueBinding(String name)
メソッドによってサポートされます。
ADF Facesでは、検証エラーに関連付けられているFacesMessage
の要約および詳細をカスタマイズできます。
要約をカスタマイズするには、形式xxx_MESSAGE_ID
(xxx
は検証チェック・タイプ)のメッセージ識別子のテキストをオーバーライドします。たとえば、MAXIMUM_MESSAGE_ID
は、最大値チェックに失敗した場合のFacesMessage
に対するメッセージ識別子です。ADF Facesメッセージの識別子およびキーのリストは、「ADF Facesのメッセージおよびキーについて」を参照してください。
バリデータ・エラー・メッセージの詳細部分は、次のいずれかの方法でカスタマイズできます。
af:validatorとf:validatorの違いについて
JSF標準バリデータについて
ADF Facesコンバータについて
ADF Facesコンバータおよびバリデータの使用
カスタムJSFコンバータおよびバリデータの使用
Copyright © 1997, 2007, Oracle. All rights reserved.