カスタム・エラー・ページ・ポリシーは、プロキシー・サーバーが
アプリケーションを使用して HTTP エラー応答を生成できるようにする機能です。管理者は、この機能を使用して、
プロキシー・サーバーがエラーを生成したとき、またはコンテンツ・サーバーが失敗の応答を戻したときに、
polished エラー・ページを戻すことができます。
以下のアクションは、エラー・ページ・ポリシーが構成される場合に、どのように使用されるかについての
シナリオを説明します。
- 内部エラー
- クライアントは、以下の要求をプロキシー・サーバーに送信します: GET
/house/rooms/kitchen.jpg HTTP/1.1。
- 要求にマップするサーバーがないため、プロキシー・サーバーは内部エラーを生成します
(HTTP 404 - File not found)。
- エラー・ポリシーは、HTTP 404 応答を処理するように構成されるため、
エラー・ページ・アプリケーションに要求を送信して、クライアントに送信するエラー・コンテンツを検索します。
要求 URI および HTTP 応答コードは、エラー・ページ・アプリケーションに対する要求内に、
照会パラメーターとして含まれます。構成済みエラー・ページ・アプリケーション URI が /ErrorPageApp/ErrorPage である場合、
エラー・ページ・アプリケーションに対する要求 URI は /ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg となります。
照会パラメーター「responseCode」および「uri」は、デフォルトで、エラー・ページ・アプリケーションに送信されます。
- プロキシー・サーバーは、エラー・ページ・アプリケーションからのコンテンツが含まれる HTTP 404 応答を戻します。
- リモート・エラー
- クライアントは、以下の要求をプロキシー・サーバーに送信します: GET
/house/rooms/kitchen.jpg HTTP/1.1。
- プロキシー・サーバーは、この要求を homeserver.companyx.com コンテンツ・サーバーに転送します。
- homeserver.companyx.com コンテンツ・サーバーは、
/house/rooms/kitchen.jpg ファイルを見つけることができず、HTTP 404 応答
(File not found) をプロキシー・サーバーに送信します。
- エラー・ポリシーは、HTTP 404 応答を処理するように構成されるため、
エラー・ページ・アプリケーションに要求を送信して、クライアントに送信するエラー・コンテンツを検索します。
要求 URI および HTTP 応答コードは、エラー・ページ・アプリケーションに対する要求内に、
照会パラメーターとして含まれます。構成済みエラー・ページ・アプリケーション URI が /ErrorPageApp/ErrorPage である場合、
エラー・ページ・アプリケーションに対する要求 URI は /ErrorPageApp/ErrorPage?responseCode=404&uri=/house/rooms/kitchen.jpg となります。
照会パラメーター「responseCode」および「uri」は、デフォルトで、エラー・ページ・アプリケーションに送信されます。
- プロキシー・サーバーは、エラー・ページ・アプリケーションからのコンテンツが含まれる HTTP 404 応答を戻します。
サンプル・エラー・アプリケーションは、<WAS_INSTALL_ROOT>/installableApps/HttpErrorHandler.ear ファイルで使用可能です。