Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)

[目次][用語][索引][前へ][次へ]

5.15.3 実行環境での設定(J2EEサーバの設定)

エラーページのカスタマイズを実行する場合,J2EEサーバの設定が必要です。

ここでは,エラーページのカスタマイズの設定方法と設定例について説明します。

<この項の構成>
(1) 設定方法
(2) 設定例

(1) 設定方法

J2EEサーバの設定は,簡易構築定義ファイルで実施します。エラーページのカスタマイズの定義は,簡易構築定義ファイルの論理J2EEサーバ(j2ee-server)の<configuration>タグ内に指定します。

簡易構築定義ファイルでのエラーページのカスタマイズの定義について次の表に示します。

表5-22 簡易構築定義ファイルでのエラーページのカスタマイズの定義

指定するパラメタ 設定内容
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を指定します。

簡易構築定義ファイル,および指定するパラメタの詳細については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「4.6 簡易構築定義ファイル」を参照してください。

(2) 設定例

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

 
:
<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」にリダイレクトします。