ADF Facesのクライアント・コンバータおよびバリデータのAPIについて

ADF Facesでは、独自のコンバータおよびバリデータ実装のクライアント側バージョンが、インタフェースoracle.adf.view.faces.convert.ClientConverterおよびoracle.adf.view.faces.validator.ClientValidatorを介してそれぞれサポートされます。

ADF Facesのクライアント側の変換と検証は、JSF標準のサーバー側の変換と検証同様に機能します。ただし、クライアントではJavaScriptが使用される点が異なります。JavaScriptコンバータ・オブジェクトはConverterExceptionをスローでき、getAsString()およびgetAsObject()メソッドをサポートします。JavaScriptバリデータ・オブジェクトはValidatorExceptionをスローでき、validate()メソッドをサポートします。

既存のサーバー側コンバータ実装にクライアント側コンバータを追加する方法は、次のとおりです。

クライアント側の検証の追加は、次のものを使用する以外は、クライアント側の変換を追加する場合と同じです。

注意: JavaScriptのform.submit()関数がコールされた場合は、クライアント側の検証に対するADF Facesサポートがスキップされます。ADF Facesでは、かわりに、submitForm()メソッドを使用でき、ADF Faces入力コンポーネントではautoSubmit属性も使用できます。

clientValidationDisabled()メソッドは、クライアント側のコンバータとバリデータが実行されているかどうかを示します。クライアント側のコンバータとバリデータをオフに切り替えるには、adf-faces-config.xml<client-validation-disabled>要素を追加して、trueに設定します。

クライアントのコンバータとバリデータのAPIの詳細は、oracle.adf.view.faces.convert.ClientConverterおよびoracle.adf.view.faces.validator.ClientValidatorに関するJavadocを参照してください。

クライアント側の変換をConverter実装に追加する方法の例は、「Oracle ADF Facesアプリケーションの開発ガイドライン」のクライアント側のコンバータとバリデータに関する説明を参照してください。


自動発行およびADF Faces入力コンポーネントについて
ADF FacesのコンバータおよびバリデータAPIについて

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