public class WebAppRootListener
extends ObjectSE
implements ServletContextListenerEE

システムプロパティを Web アプリケーションのルートディレクトリに設定するリスナー。システムプロパティのキーは、サーブレットコンテキストレベルの "webAppRootKey" init パラメーター（つまり、web.xml の context-param）で定義できます。デフォルトのキーは "webapp.root" です。

ログファイルの場所内の log4j の "${key}" 構文など、システムプロパティ（つまり、System.getProperty 値）による置換をサポートするツールキットに使用できます。

メモ: このリスナーは、少なくとも log4j に使用する場合は、web.xml の ContextLoaderListener の前に配置する必要があります。Log4jConfigListener はシステムプロパティを暗黙的に設定するため、それに加えてこのリスナーは必要ありません。

警告 : 一部のコンテナー、例: Tomcat、システムプロパティを Web アプリごとに個別に保持しないでください。衝突を避けるために、Web アプリごとに一意の "webAppRootKey" context-params を使用する必要があります。Resin のような他のコンテナーは、各 Web アプリのシステムプロパティを分離します: ここでは、心配することなくデフォルトのキーを使用できます（つまり、"webAppRootKey" context-param はまったくありません）。

警告 : Web アプリケーションを含む WAR ファイルは、Web アプリのルートシステムプロパティを設定できるように拡張する必要があります。これは、デフォルトでは、たとえば WAR ファイルが WebLogic にデプロイされる場合には当てはまりません。このような環境では、このリスナーを使用しないでください。