「環境エントリ」セクションを使用して、Web アプリケーションの環境変数の追加、削除、表示ができます。アプリケーションの環境エントリは、Web アプリケーション全体で使用できる初期化用変数です。たとえば、これらの変数を使用して、オブジェクトの型の妥当性を検査できます。
ServletContext オブジェクトを使用してアクセスするコンテキストパラメータと異なり、java:comp/env コンテキスト内のアプリケーションの環境変数には、JNDI ルックアップを使用してアクセスします。このため、アプリケーションの環境変数の値は、次のようにして抽出します。
InitialContext context = new InitialContext(); String header = (String) context.lookup("java:comp/env/headerPage");
JNDI ルックアップは、env-entry-type 要素で指定された型を予想し、戻り値がその予想した型と異なる場合は、例外をスローします。
アプリケーションの環境変数を宣言するには、web.xml ファイルに登録する必要があります。このときに、サーバーがパラメータを使用するために必要な情報を指定します。Web アプリケーションで環境エントリが参照されたときに返されるべき値をサーバーに指示します。
「プロジェクト」ウィンドウから web.xml ビジュアルエディタを開くには、「Web ページ」ノード、「WEB-INF」ノードの順に展開し、web.xml ファイルをダブルクリックします。エディタの最上部で「参照」をクリックし、「参照」セクションを開きます。次に「環境エントリ」ヘッダーをクリックして、「環境エントリ」セクションを開きます。
「追加」をクリックし、次のプロパティーを持つ環境エントリを定義します。