JavaServer Faces アプリケーションのエラーの管理

JavaServer Faces アプリケーションでエラー管理を取り扱うには幾つかの方法があります。以下の手法を使用して、ご使用の Web サイト全体を通じて、エラーと正常処理の報告を統一することができます。

1 つの方法は汎用の成功処理と失敗処理用の JSP ファイルの作成です。例えば、 ok.jsp と error.jsp です。一般に、エラー・メッセージと要求範囲でのその説明が含まれている Faces JSP ページを作成することができます。 要求範囲は、失敗処理または正常処理の報告を行うページによって指定できます。

エラー管理を取り扱うもう 1 つの方法は、 「入力コンポーネント・エラーの表示」および「フォーム内エラーの表示」のコンポーネントを使用することです。「入力コンポーネント・エラーの表示」コンポーネントは、バインドされているフィールドに表示されるエラー・メッセージを挿入します。このエラー・メッセージは、指定したフィールドに問題が発生した場合だけ表示されます。「フォーム内エラーの表示」コンポーネントは、フォームのすべてのフィールドに表示されるエラー・メッセージを挿入します。このエラー・メッセージはページ上に問題があるときはいつでも表示されます。

「入力コンポーネント・エラーの表示」コンポーネントを Faces JSP ページに追加し、別のコンポーネントにバインドするには以下を実行します。
  1. Faces JSP ページを開きます。
  2. 「入力コンポーネント・エラーの表示」コンポーネントをページにドラッグします。
  3. 「コンポーネントのエラー・メッセージを表示」の隣の、「入力コンポーネント・エラーの表示」コンポーネントのプロパティー・ビューで、「入力コンポーネント・エラーの表示」コンポーネントをバインドしたいコンポーネントの ID を選択します。
  4. 「プロパティー」フィールドを使用し、エラ ー・メッセージのスタイル・プロパティー (カラーやフォントなど) を指定あるいは参照します。「クラス・メッセージ」フィールドを使用して、エラー・メッセージのスタイル・シートを指定または参照します。
幾つかの Faces コンポーネントには、そのコンポーネントにバインドされる「入力コンポーネント・エラーの表示」コンポーネントを自動的に作成するオプションがあります。例えば、 入力コンポーネントを作成する場合、入力コンポーネントのプロパティー・ビューの「検証」タブで、 「エラー・メッセージ・コントロールで検証エラー・メッセージを表示する (Display validation error messages in an error message control)」をチェックすることで、「入力コンポーネント・エラーの表示」コンポーネントを自動的に作成することができます。新しい「入力コンポーネント・エラーの表示」コンポーネントが自動的に入力コンポーネントにバインドされます。
関連概念
JavaServer Faces
関連タスク
Faces アプリケーションの作成 : 概要
Faces JSP の作成
Faces 入力コンポーネントへの検証の追加
関連資料
入力コンポーネント・エラーの表示
フォーム内エラーの表示
Faces コンポーネント参照
Faces コンポーネントの属性
フィードバック
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.
(C) Copyright IBM Japan 2005