クラス ContextLoaderListener

java.lang.ObjectSE
org.springframework.web.context.ContextLoader
org.springframework.web.context.ContextLoaderListener
実装されているすべてのインターフェース:
jakarta.servlet.ServletContextListener, EventListenerSE

public class ContextLoaderListener extends ContextLoader implements jakarta.servlet.ServletContextListener
Spring のルート WebApplicationContext を起動およびシャットダウンするためのブートストラップリスナー。ContextLoader および ContextCleanupListener に単純に委譲します。

ContextLoaderListener は、ContextLoaderListener(WebApplicationContext) コンストラクターを介したルート Web アプリケーションコンテキストの注入をサポートし、サーブレット初期化子でのプログラムによる構成を可能にします。使用例については、WebApplicationInitializer を参照してください。

導入:
17.02.2003
作成者:
Juergen Hoeller, Chris Beams
関連事項:
  • コンストラクターの詳細

    • ContextLoaderListener

      public ContextLoaderListener()
      "contextClass" および "contextConfigLocation" サーブレットコンテキストパラメーターに基づいて Web アプリケーションコンテキストを作成する新しい ContextLoaderListener を作成します。それぞれのデフォルト値の詳細については、ContextLoader スーパークラスのドキュメントを参照してください。

      通常、このコンストラクターは、引数なしのコンストラクターが必要な web.xml 内で ContextLoaderListener を <listener> として宣言するときに使用されます。

      作成されたアプリケーションコンテキストは、属性名 WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE で ServletContext に登録され、contextDestroyed(ServletContextEvent) ライフサイクルメソッドがこのリスナーで呼び出されると、Spring アプリケーションコンテキストが閉じられます。

      関連事項:
    • ContextLoaderListener

      public ContextLoaderListener(WebApplicationContext rootContext)
      指定されたアプリケーションコンテキストで新しい ContextLoaderListener を作成し、機能に関して仕様制限されている ServletContextEvent -provided ServletContext 参照で初期化します。

      一般的には、完全に機能する WebApplicationInitializer.onStartup(ServletContext) -given 参照を使用してアプリケーションコンテキストを初期化することが望ましいです。

      関連事項:
    • ContextLoaderListener

      public ContextLoaderListener(WebApplicationContext rootContext, jakarta.servlet.ServletContext servletContext)
      指定されたアプリケーションコンテキストで新しい ContextLoaderListener を作成します。このコンストラクターは、ServletContext.addListener(String) API を介してインスタンスベースのリスナー登録が可能なサーブレット初期化子で役立ちます。

      コンテキストはまだリフレッシュされている場合とされていない場合があります。(a)ConfigurableWebApplicationContext の実装であり、(b)がまだリフレッシュされていない場合(推奨されるアプローチ)、次のことが発生します。

      コンテキストがすでにリフレッシュされているか、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.ServletContextListenercontextInitialized 
    • contextDestroyed

      public void contextDestroyed(jakarta.servlet.ServletContextEvent event)
      ルート Web アプリケーションコンテキストを閉じます。
      次で指定:
      インターフェース jakarta.servlet.ServletContextListenercontextDestroyed