クラス ContextLoaderListener
- 実装されているすべてのインターフェース:
jakarta.servlet.ServletContextListener, EventListenerSE
WebApplicationContext を起動およびシャットダウンするためのブートストラップリスナー。ContextLoader および ContextCleanupListener に単純に委譲します。ContextLoaderListener は、ContextLoaderListener(WebApplicationContext) コンストラクターを介したルート Web アプリケーションコンテキストの注入をサポートし、サーブレット初期化子でのプログラムによる構成を可能にします。使用例については、WebApplicationInitializer を参照してください。
- 導入:
- 17.02.2003
- 作成者:
- Juergen Hoeller, Chris Beams
- 関連事項:
フィールドのサマリー
コンストラクターの概要
コンストラクターコンストラクター説明"contextClass" および "contextConfigLocation" サーブレットコンテキストパラメーターに基づいて Web アプリケーションコンテキストを作成する新しいContextLoaderListenerを作成します。ContextLoaderListener(WebApplicationContext rootContext) 指定されたアプリケーションコンテキストで新しいContextLoaderListenerを作成し、機能に関して仕様制限されているServletContextEvent-providedServletContext参照で初期化します。ContextLoaderListener(WebApplicationContext rootContext, jakarta.servlet.ServletContext servletContext) 指定されたアプリケーションコンテキストで新しいContextLoaderListenerを作成します。メソッドのサマリー
修飾子と型メソッド説明voidcontextDestroyed(jakarta.servlet.ServletContextEvent event) ルート Web アプリケーションコンテキストを閉じます。voidcontextInitialized(jakarta.servlet.ServletContextEvent event) ルート Web アプリケーションコンテキストを初期化します。クラス ContextLoader から継承されたメソッド
closeWebApplicationContext, configureAndRefreshWebApplicationContext, createWebApplicationContext, customizeContext, determineContextClass, determineContextInitializerClasses, getCurrentWebApplicationContext, initWebApplicationContext, loadParentContext, setContextInitializers
コンストラクターの詳細
ContextLoaderListener
public ContextLoaderListener()"contextClass" および "contextConfigLocation" サーブレットコンテキストパラメーターに基づいて Web アプリケーションコンテキストを作成する新しいContextLoaderListenerを作成します。それぞれのデフォルト値の詳細については、ContextLoaderスーパークラスのドキュメントを参照してください。通常、このコンストラクターは、引数なしのコンストラクターが必要な
web.xml内でContextLoaderListenerを<listener>として宣言するときに使用されます。作成されたアプリケーションコンテキストは、属性名
WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTEで ServletContext に登録され、contextDestroyed(ServletContextEvent)ライフサイクルメソッドがこのリスナーで呼び出されると、Spring アプリケーションコンテキストが閉じられます。- 関連事項:
ContextLoaderListener
指定されたアプリケーションコンテキストで新しいContextLoaderListenerを作成し、機能に関して仕様制限されているServletContextEvent-providedServletContext参照で初期化します。一般的には、完全に機能する
WebApplicationInitializer.onStartup(ServletContext)-given 参照を使用してアプリケーションコンテキストを初期化することが望ましいです。- 関連事項:
ContextLoaderListener
public ContextLoaderListener(WebApplicationContext rootContext, jakarta.servlet.ServletContext servletContext) 指定されたアプリケーションコンテキストで新しいContextLoaderListenerを作成します。このコンストラクターは、ServletContext.addListener(String)API を介してインスタンスベースのリスナー登録が可能なサーブレット初期化子で役立ちます。コンテキストはまだリフレッシュされている場合とされていない場合があります。(a)
ConfigurableWebApplicationContextの実装であり、(b)がまだリフレッシュされていない場合(推奨されるアプローチ)、次のことが発生します。- 指定されたコンテキストにまだ id が割り当てられていない場合、1 つが割り当てられます
ServletContextおよびServletConfigオブジェクトは、アプリケーションコンテキストに委譲されます。ContextLoader.customizeContext(ServletContext, ConfigurableWebApplicationContext)が呼び出されます- "contextInitializerClasses" 初期化パラメーターで指定された
ApplicationContextInitializersが適用されます。 refresh()が呼び出されます
ConfigurableWebApplicationContextを実装していない場合、ユーザーが特定のニーズに応じてこれらのアクションを実行した(または実行しない)という仮定では、上記のいずれも発生しません。使用例については、
WebApplicationInitializerを参照してください。いずれの場合でも、指定されたアプリケーションコンテキストは、
WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE属性名で ServletContext に登録され、contextDestroyed(ServletContextEvent)ライフサイクルメソッドがこのリスナーで呼び出されると、Spring アプリケーションコンテキストが閉じられます。- パラメーター:
rootContext- 管理するアプリケーションコンテキストservletContext- ServletContext を初期化する- 導入:
- 6.2
- 関連事項:
メソッドの詳細
contextInitialized
public void contextInitialized(jakarta.servlet.ServletContextEvent event) ルート Web アプリケーションコンテキストを初期化します。- 次で指定:
- インターフェース
jakarta.servlet.ServletContextListenerのcontextInitialized
contextDestroyed
public void contextDestroyed(jakarta.servlet.ServletContextEvent event) ルート Web アプリケーションコンテキストを閉じます。- 次で指定:
- インターフェース
jakarta.servlet.ServletContextListenerのcontextDestroyed