Cosminexus V9 アプリケーションサーバ 機能解説 基本・開発編(Webコンテナ)
エラーページのカスタマイズを実行する場合,J2EEサーバの設定が必要です。
ここでは,エラーページのカスタマイズの設定方法と設定例について説明します。
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 簡易構築定義ファイル」を参照してください。
エラーページのカスタマイズの設定例を次に示します。
: <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」にリダイレクトします。
All Rights Reserved. Copyright (C) 2012, 2015, Hitachi, Ltd.