存在しないリソースへのアクセスなどのエラーが発生したときに，エラーステータスコードが表示されたエラーページの代わりにユーザが作成したエラーページをクライアントに表示させることができます。インプロセスHTTPサーバによるエラーページのカスタマイズを利用することで，特定のステータスコードに対応するエラーページのカスタマイズや，リクエストURLに対応するエラーページのカスタマイズをWebコンテナ単位にまとめて制御できます。また，次に示すようなWebアプリケーションによるエラーページのカスタマイズが実行できない場合でも，エラーページをカスタマイズできます。

• リクエストに対応するコンテキストがない場合（ステータスコード404）
• 停止処理中のコンテキストでリクエスト処理を実行しようとした場合（ステータスコード503）
• インプロセスHTTPサーバがエラーステータスコードを返す場合

インプロセスHTTPサーバが返すエラーステータスコードを次の表に示します。

表8-1　インプロセスHTTPサーバが返すエラーステータスコード

インプロセスHTTPサーバによるエラーページのカスタマイズを実行する場合，javax.servlet.http.HttpServletResponseインタフェースのsendErrorメソッドを使用してレスポンスのステータスコードを設定する必要があります。なお，setStatusメソッドを使用した場合（JSPでsetStatusメソッドを使用した場合など），インプロセスHTTPサーバによるカスタマイズが実行されないことがあります。ただし，sendErrorメソッドを使用しても，Webアプリケーションが次に示すどちらかの条件に該当する場合，インプロセスHTTPサーバによるエラーページのカスタマイズは実行されません。

• sendErrorメソッドの実行時に例外が発生した場合
• Webアプリケーションでエラーページのカスタマイズの設定をしていて，エラー発生時にその設定によるエラーページの実行が正常終了した場合（エラーページでcatchされない例外が発生しないで，ステータスコードが400〜599以外で終了した場合）

エラーページのカスタマイズは，簡易構築定義ファイルで設定します。論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを設定してください。

• webserver.connector.inprocess_http.error_custom.list
  エラーページのカスタマイズ定義名を指定します。
  
• webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.status
  エラーステータスコードに対応づけるエラーページのカスタマイズをする場合に，エラーページをカスタマイズするエラーステータスコードを指定します。
  
• webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.file
  エラーステータスコードに対応するファイルを送信する場合に，レスポンスボディとしてクライアントに返すファイルを指定します。
  
• webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.file.content_type
  webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.fileパラメタに指定したファイルをレスポンスボディとしてクライアントに送信する際のContent-Typeヘッダの値を指定します。
  
• webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.redirect_url
  エラーステータスコードに対応するリダイレクトをする場合に，リダイレクト先のURLを指定します。
  
• webserver.connector.inprocess_http.error_custom.＜エラーページカスタマイズ定義名＞.request_url
  リクエストURLに対応づけるエラーページのカスタマイズをする場合に，エラーページのカスタマイズを適用するリクエストURLを指定します。
  

  注意

  • HTTPレスポンスがHTMLファイルの場合，そのHTMLからほかのファイル（画像ファイルなど）を参照していると，エラーページが正しく表示されないことがあります。
  • ブラウザの設定によっては，ステータスコードがエラーを示し，レスポンスボディのサイズが小さい場合に，レスポンスボディをブラウザ固定のメッセージに置き換えて表示することがあるので注意してください。特にエラーページをカスタマイズしなかった場合に表示されるデフォルトのエラーページは，レスポンスボディのサイズが小さいため注意してください。
  • リダイレクトURLの指定値とリクエストURLの指定値が一致して，リダイレクト後に同じエラーステータスが発生すると，クライアントによってはリダイレクトを実行し続けることがあるため注意してください。
  • ステータスコードに対応するリダイレクトを実施する場合，エラー発生時にリクエストURLに付加されていたクエリー文字列はリダイレクトURLに付加されません。また，URLの書き換えによるセッション管理をしている場合，エラーの発生したページと同じWebアプリケーション内へのリダイレクトを実施してもセッションを引き継ぐことはできません。

エラーページのカスタマイズの設定例を次に示します。

 
：
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.list</param-name>
  <param-value>ERR_CUSTOM_1,ERR_CUSTOM_2</param-value>
</param>
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_1.status</param-name>
  <param-value>404</param-value>
</param>
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_1.file</param-name>
  <param-value>C:/data/404.html</param-value>
</param>
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_1.file.content_type</param-name>
  <param-value>text/html; charset=ISO-8859-1</param-value>
</param>
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_2.status</param-name>
  <param-value>503</param-value>
</param>
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_2.redirect_url</param-name>
  <param-value>http://host1/503.html</param-value>
</param>
<param>
  <param-name>webserver.connector.inprocess_http.error_custom.ERR_CUSTOM_2.request_url</param-name>
  <param-value>/dir1/*</param-value>
</param>
：
 

この設定例では，エラーページのカスタマイズ定義名として，「ERR_CUSTOM_1」と「ERR_CUSTOM_2」を使用しています。「ERR_CUSTOM_1」では，レスポンスのステータスコードが「404」の場合には，「C:/data/404.html」をクライアントに返します。Content-Typeヘッダの値は，「text/html; charset=ISO-8859-1」を使用します。また，「ERR_CUSTOM_2」では，リクエストが「/dir1/」から始まるURLで，レスポンスのステータスコードが「503」の場合に，「http://host1/503.html」にリダイレクトします。