Cosminexus V9 アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)

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

3.9.1 サーブレット属性ファイルの指定内容

サーブレット属性ファイルは,次に示すDOCTYPE宣言を持ちます。

<!DOCTYPE hitachi-servlet-property PUBLIC '-//Hitachi, Ltd.//DTD Servlet Property 7.0//EN' 'file:///<Application Serverのインストールディレクトリ>/CC/admin/dtds/hitachi-servlet-property_7_0.dtd'>

サーブレット属性ファイルは,次に示すタグを持つxmlファイルです。また,属性ファイルのバージョンは,以前のバージョンのものでも使用できます。

タグ名 出現パターン 説明
<hitachi-servlet-property> 1回 ルートタグ。

<description>※1 0回以上※2 サーブレット/JSPの説明。





<display-name>※1 1回以上※2 サーブレット/JSPの表示名。
xml:lang属性が"en"のdisplay-nameを必ず指定します。該当するリソースの表示名をコマンドの引数で指定する場合も,xml:lang属性が"en"のdisplay-nameを指定します。
1≦文字列長
文字の制限はありません。
<icon>※1 0回以上※2 Deployツール上に表示されるServletのアイコンの定義。
<small-icon> 0または1回 スモールアイコン(16×16)のファイル名。
<large-icon> 0または1回 ラージアイコン(32×32)のファイル名。
<init-param> 0回以上 初期化パラメタについての定義。
<description>※1 0回以上※2 init-paramの説明。
<param-name> 1回 初期化パラメタの名称。
<param-value> 1回 初期化パラメタの値。












<load-on-startup> 0または1回 スタートアップ時のロード指定。
指定できる整数値を次に示します。

-2147483648≦load-on-startup≦-1
必要になった時点でロードされます。
-1以外を指定しても-1として扱われます。

0
スタートアップ時にロードします。
ロードする順番は,Containerが決定します。

1≦load-on-startup≦2147483647
スタートアップ時にロードします。
ロードする順番は,小さな値から大きな値の順となります。
なお,Servlet2.5以降より,空文字も指定できます。
<run-as> 0または1回 実行時アイデンティティについての定義。※3
<description>※1 0回以上※2 run-asの説明。※3
<role-name> 1回 セキュリティロール名。※3
<user-name> 1回 ユーザ名を指定します。
<security-role-ref> 0回以上 セキュリティロールについての定義。
<description>※1 0回以上※2 security-role-refの説明。
<role-name> 1回 security-role-refの名称。
<role-link> 0または1回 リンク先のロール名。





<url-pattern>※4 0回以上 サーブレットのURL。
アプリケーション統合属性ファイルで,このタグの情報を別のサーブレットの情報と入れ替える場合は,登録されているアプリケーション内のすべてのサーブレットの<url-pattern>の情報をcjsetapppropコマンドで削除したあと,正しい情報を設定してください。
<method-observation-timeout> 0または1回 サーブレット内のメソッド共通の仕掛かり中メソッド監視用タイムアウト時間。
指定できる値は,0〜86400(単位:秒)です。0を指定した場合,タイムアウトしません。デフォルト値は0です。

注※1
xml:lang属性を指定できます。xml:lang属性を指定しない場合は,「en(英語)」が仮定されます。なお,xml:lang属性が同じタグを複数指定できません。

注※2
Servlet2.3以前のWARに対して,このタグを複数指定できません。

注※3
アノテーションの設定値だった場合,値の変更は無視されます。

注※4
アプリケーション統合属性ファイルをcjsetapppropコマンドで設定すると,サーブレット単位(<hitachi-servlet-property>タグ単位)に設定値の反映処理を実施します。ただし,<hitachi-servlet-property>−<url-pattern>タグについては,すべてのサーブレットで重複がないかどうかのチェックを実施しています。