JavaServer Faces アプリケーションでエラー管理を取り扱うには幾つかの方法があります。以下の手法を使用して、ご使用の Web サイト全体を通じて、エラーと正常処理の報告を統一することができます。
1 つの方法は汎用の成功処理と失敗処理用の JSP ファイルの作成です。例えば、
ok.jsp と error.jsp です。一般に、エラー・メッセージと要求範囲でのその説明が含まれている Faces JSP ページを作成することができます。
要求範囲は、失敗処理または正常処理の報告を行うページによって指定できます。
エラー管理を取り扱うもう 1 つの方法は、
「入力コンポーネント・エラーの表示」および「フォーム内エラーの表示」のコンポーネントを使用することです。「入力コンポーネント・エラーの表示」コンポーネントは、バインドされているフィールドに表示されるエラー・メッセージを挿入します。このエラー・メッセージは、指定したフィールドに問題が発生した場合だけ表示されます。「フォーム内エラーの表示」コンポーネントは、フォームのすべてのフィールドに表示されるエラー・メッセージを挿入します。このエラー・メッセージはページ上に問題があるときはいつでも表示されます。
「入力コンポーネント・エラーの表示」コンポーネントを
Faces JSP ページに追加し、別のコンポーネントにバインドするには以下を実行します。
- Faces JSP ページを開きます。
- 「入力コンポーネント・エラーの表示」コンポーネントをページにドラッグします。
- 「コンポーネントのエラー・メッセージを表示」の隣の、「入力コンポーネント・エラーの表示」コンポーネントのプロパティー・ビューで、「入力コンポーネント・エラーの表示」コンポーネントをバインドしたいコンポーネントの ID を選択します。
- 「プロパティー」フィールドを使用し、エラ
ー・メッセージのスタイル・プロパティー (カラーやフォントなど) を指定あるいは参照します。「クラス・メッセージ」フィールドを使用して、エラー・メッセージのスタイル・シートを指定または参照します。
幾つかの Faces コンポーネントには、そのコンポーネントにバインドされる「入力コンポーネント・エラーの表示」コンポーネントを自動的に作成するオプションがあります。例えば、
入力コンポーネントを作成する場合、入力コンポーネントのプロパティー・ビューの
「検証」タブで、
「エラー・メッセージ・コントロールで検証エラー・メッセージを表示する (Display validation error messages in an error message control)」をチェックすることで、「入力コンポーネント・エラーの表示」コンポーネントを自動的に作成することができます。新しい「入力コンポーネント・エラーの表示」コンポーネントが自動的に入力コンポーネントにバインドされます。