9.11.1 J2EEアプリケーションのコンテキストルート定義
J2EEアプリケーションのコンテキストルートを定義します。
コンテキストルートには,ルートコンテキストも定義できます。ルートコンテキストとは,コンテキストルートが空文字""のコンテキストです。ルートコンテキストにwelcomeファイルを作成すると,「http://www.xxx.com/」のようなドメイン名だけのURLからJ2EEアプリケーションのトップページを表示できるようになります。
(1) 編集する属性ファイル
WAR属性ファイル
(2) 編集する属性ファイルの取得と属性の設定
-
属性ファイルの取得
次に示すコマンドを実行してWAR属性ファイルを取得します。
- 実行形式
cjgetappprop [<サーバ名称>] [-nameserver <プロバイダURL>] -name <J2EEアプリケーション名> -type war -resname <WAR表示名> -c <WAR属性ファイルパス>
- 実行例
cjgetappprop MyServer -name adder -type war -resname adder_war -c C:\home\adder_war.xml
-
属性の設定
次に示すコマンドを実行して,WAR属性ファイルの値を反映します。
- 実行形式
cjsetappprop [<サーバ名称>] [-nameserver <プロバイダURL>] -name <J2EEアプリケーション名> -type war -resname <WAR表示名> -c <WAR属性ファイルパス>
- 実行例
cjsetappprop MyServer -name adder -type war -resname adder_war -c C:\home\adder_war.xml
(3) 編集する属性設定項目
J2EEアプリケーションのコンテキストルート定義(<runtime>)のプロパティ設定項目を,次に示します。
項目 |
必須 |
対応するタグ名 |
---|---|---|
コンテキストルート |
○ |
<context-root> |
プロパティの設定項目については,マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション/リソース定義)」の「3.7.1 WAR属性ファイルの指定内容」を参照してください。
(4) 注意事項
-
コンテキストルートには,"ejb/",または"web/"から始まる文字列を指定しないでください。
複数のJ2EEアプリケーションでコンテキストルートのパスの構成要素が包含関係(例:"test"と"test/jsp")にある場合で,包含する方のパスを含むURL(例:"/test/jsp/test.jsp")を指定してアクセスしたときは,包含する方のアプリケーション(例では,"test/jsp"をコンテキストルートに持つ方)が有効になり,包含される方のアプリケーション(例では,"test"をコンテキストルートに持つ方)にはアクセスできません。
-
コンテキストルートは,作業ディレクトリ中のディレクトリ名として用いられます。作業ディレクトリのパス長がプラットフォームの上限に達しないようにコンテキストルートを指定してください。作業ディレクトリのパス長の見積もりについては,マニュアル「アプリケーションサーバ システム構築・運用ガイド」の「付録C.1 J2EEサーバの作業ディレクトリ」を参照してください。
-
ルートコンテキストを使用して開始するWebアプリケーションでは,URLが"ejb"または"web"で始まる構成にしないでください。
-
コンソールおよびログファイルに出力されるメッセージでは,ルートコンテキストのコンテキストルートは,空文字「""」で表示されます。