クラス AbstractGenericWebContextLoader

メソッドの詳細

• loadContext

  public final ApplicationContext loadContext(MergedContextConfiguration mergedConfig) throws ExceptionSE

  提供された MergedContextConfiguration の GenericWebApplicationContext をロードします。

  実装の詳細:

  • validateMergedContextConfiguration(WebMergedContextConfiguration) を呼び出して、サブクラスが続行する前に指定された構成を検証できるようにします。
  • GenericWebApplicationContext インスタンスを作成します。
  • 指定された MergedContextConfiguration が親構成を参照する場合、対応する ApplicationContext が取得され、このメソッドによって作成されたコンテキストの親として設定されます。
  • MockServletContext を作成して WebApplicationContext に設定するには、configureWebResources(GenericWebApplicationContext, WebMergedContextConfiguration) に委譲します。
  • AbstractContextLoader.prepareContext(ConfigurableApplicationContext, MergedContextConfiguration) を呼び出して、Bean 定義がロードされる前にコンテキストをカスタマイズできるようにします。
  • customizeBeanFactory(DefaultListableBeanFactory, WebMergedContextConfiguration) を呼び出して、コンテキストの DefaultListableBeanFactory をカスタマイズできるようにします。
  • loadBeanDefinitions(GenericWebApplicationContext, WebMergedContextConfiguration) にデリゲートして、提供された MergedContextConfiguration 内の場所またはクラスからコンテキストを設定します。
  • アノテーション構成プロセッサーを登録するための AnnotationConfigUtils へのデリゲート。
  • customizeContext(GenericWebApplicationContext, WebMergedContextConfiguration) を呼び出して、リフレッシュされる前にコンテキストをカスタマイズできるようにします。
  • Refreshes コンテキストとそのための JVM シャットダウンフックを登録します。

  次で指定:

  インターフェース SmartContextLoader の loadContext 

  パラメーター:

  mergedConfig - アプリケーションコンテキストをロードするために使用するマージされたコンテキスト構成

  戻り値:

  新しい Web アプリケーションコンテキスト

  例外:

  ExceptionSE

  関連事項:

  • SmartContextLoader.loadContext(MergedContextConfiguration)

• loadContextForAotProcessing

  @DeprecatedSE(since="6.2.4", forRemoval=true) public final GenericWebApplicationContext loadContextForAotProcessing(MergedContextConfiguration mergedConfig) throws ExceptionSE

  非推奨、削除予定: この API 要素は、将来のバージョンで削除される可能性があります。

  Spring Framework 6.2.4 時点では loadContextForAotProcessing(MergedContextConfiguration, RuntimeHints) に置き換えられ、Spring Framework 8.0 で削除される予定

  提供された MergedContextConfiguration に基づいて、AOT ビルド時の処理のために GenericWebApplicationContext をロードします。

  loadContext(MergedContextConfiguration) とは対照的に、このメソッドは ApplicationContext をリフレッシュしたり、JVM シャットダウンフックを登録したりしません。それ以外の場合、このメソッドは loadContext(MergedContextConfiguration) と同じ動作を実装します。

  次で指定:

  インターフェース AotContextLoader の loadContextForAotProcessing 

  パラメーター:

  mergedConfig - アプリケーションコンテキストをロードするために使用するマージされたコンテキスト構成

  戻り値:

  新しい Web アプリケーションコンテキスト

  例外:

  ExceptionSE - コンテキストの読み込みに失敗した場合

  導入:

  6.0

  関連事項:

  • AotContextLoader.loadContextForAotProcessing(MergedContextConfiguration)

• loadContextForAotProcessing

  public final GenericWebApplicationContext loadContextForAotProcessing(MergedContextConfiguration mergedConfig, RuntimeHints runtimeHints) throws ExceptionSE

  提供された MergedContextConfiguration に基づいて、AOT ビルド時の処理のために GenericWebApplicationContext をロードします。

  loadContext(MergedContextConfiguration) とは対照的に、このメソッドは ApplicationContext をリフレッシュしたり、JVM シャットダウンフックを登録したりしません。それ以外の場合、このメソッドは loadContext(MergedContextConfiguration) と同じ動作を実装します。

  次で指定:

  インターフェース AotContextLoader の loadContextForAotProcessing 

  パラメーター:

  mergedConfig - アプリケーションコンテキストをロードするために使用するマージされたコンテキスト構成

  runtimeHints - 実行時のヒント

  戻り値:

  新しい Web アプリケーションコンテキスト

  例外:

  ExceptionSE - コンテキストの読み込みに失敗した場合

  導入:

  6.2.4

  関連事項:

  • AotContextLoader.loadContextForAotProcessing(MergedContextConfiguration, RuntimeHints)

• loadContextForAotRuntime

  public final GenericWebApplicationContext loadContextForAotRuntime(MergedContextConfiguration mergedConfig, ApplicationContextInitializer<ConfigurableApplicationContext> initializer) throws ExceptionSE

  提供された MergedContextConfiguration および ApplicationContextInitializer に基づいて、AOT ランタイム実行用に GenericWebApplicationContext をロードします。

  次で指定:

  インターフェース AotContextLoader の loadContextForAotRuntime 

  パラメーター:

  mergedConfig - アプリケーションコンテキストをロードするために使用するマージされたコンテキスト構成

  initializer - Bean 定義を再作成するためにコンテキストに適用する必要がある ApplicationContextInitializer 

  戻り値:

  新しい Web アプリケーションコンテキスト

  例外:

  ExceptionSE - コンテキストの読み込みに失敗した場合

  導入:

  6.0

  関連事項:

  • AotContextLoader.loadContextForAotRuntime(MergedContextConfiguration, ApplicationContextInitializer)

• validateMergedContextConfiguration

  protected void validateMergedContextConfiguration(WebMergedContextConfiguration mergedConfig)

  このコンテキストローダーがサポートするものに関して、提供された WebMergedContextConfiguration を検証します。

  デフォルトの実装はノーオペレーションですが、必要に応じてサブクラスによってオーバーライドできます。

  パラメーター:

  mergedConfig - 検証するマージされた構成

  例外:

  IllegalStateExceptionSE - 指定された構成がこのコンテキストローダーに対して有効でない場合

  導入:

  4.0.4

• createContext

  protected GenericWebApplicationContext createContext()

  この ContextLoader で使用される GenericWebApplicationContext を作成するためのファクトリメソッド。

  デフォルトの実装では、デフォルトのコンストラクターを使用して GenericWebApplicationContext を作成します。このメソッドはオーバーライドされる可能性があります。— たとえば、カスタムコンテキストサブクラスを使用したり、カスタム DefaultListableBeanFactory 実装で GenericWebApplicationContext を作成したりします。

  戻り値:

  新しくインスタンス化された GenericWebApplicationContext

  導入:

  5.3.23

• configureWebResources

  protected void configureWebResources(GenericWebApplicationContext context, WebMergedContextConfiguration webMergedConfig)

  提供された Web アプリケーションコンテキスト（WAC）の Web リソースを構成します。

  Implementation Details

  提供された WAC に親がない場合、またはその親が WAC でない場合、提供された WAC はルート WAC として構成されます（以下の「ルート WAC 構成」を参照）。

  それ以外の場合は、指定された WAC のコンテキスト階層が走査され、最上位の WAC (つまり、ルート) が検索されます。そして、ルート WAC の ServletContext が、指定された WAC の ServletContext として設定されます。

  Root WAC Configuration

  • リソースのベースパスは、指定された WebMergedContextConfiguration から取得されます。
  • ResourceLoader は MockServletContext に対してインスタンス化されます。リソースのベースパスの先頭に "classpath:" が付いている場合、DefaultResourceLoader が使用されます。それ以外の場合は、FileSystemResourceLoader が使用されます。
  • MockServletContext は、リソースベースパスとリソースローダーを使用して作成されます。
  • 提供された GenericWebApplicationContext は、WebApplicationContext.ROOT_WEB_APPLICATION_CONTEXT_ATTRIBUTE キーの MockServletContext に格納されます。
  • 最後に、MockServletContext が WebApplicationContext に設定されます。

  パラメーター:

  context - Web リソースを構成する Web アプリケーションコンテキスト

  webMergedConfig - Web アプリケーションコンテキストの読み込みに使用するマージされたコンテキスト構成

• customizeBeanFactory

  protected void customizeBeanFactory(DefaultListableBeanFactory beanFactory, WebMergedContextConfiguration webMergedConfig)

  このコンテキストローダーによって作成された WebApplicationContext の内部 Bean ファクトリをカスタマイズします。

  デフォルトの実装は空ですが、サブクラスでオーバーライドして、DefaultListableBeanFactory の標準設定をカスタマイズできます。

  パラメーター:

  beanFactory - このコンテキストローダーによって作成された Bean ファクトリ

  webMergedConfig - Web アプリケーションコンテキストの読み込みに使用するマージされたコンテキスト構成

  関連事項:

  • loadContext(MergedContextConfiguration)
  • DefaultListableBeanFactory.setAllowBeanDefinitionOverriding(boolean)
  • DefaultListableBeanFactory.setAllowEagerClassLoading(boolean)
  • AbstractAutowireCapableBeanFactory.setAllowCircularReferences(boolean)
  • AbstractAutowireCapableBeanFactory.setAllowRawInjectionDespiteWrapping(boolean)

• loadBeanDefinitions

  protected abstract void loadBeanDefinitions(GenericWebApplicationContext context, WebMergedContextConfiguration webMergedConfig)

  提供された WebMergedContextConfiguration の場所またはクラスから、提供された context に Bean 定義をロードします。

  具象サブクラスは適切な実装を提供する必要があります。

  パラメーター:

  context - Bean 定義をロードする必要があるコンテキスト

  webMergedConfig - Web アプリケーションコンテキストの読み込みに使用するマージされたコンテキスト構成

  関連事項:

  • loadContext(MergedContextConfiguration)

• customizeContext

  protected void customizeContext(GenericWebApplicationContext context, WebMergedContextConfiguration webMergedConfig)

  Bean 定義がコンテキストにロードされた後でコンテキストがリフレッシュされる前に、この文脈ローダーによって作成された GenericWebApplicationContext をカスタマイズします。

  デフォルトの実装は、単に AbstractContextLoader.customizeContext(ConfigurableApplicationContext, MergedContextConfiguration) に委譲するだけです。

  パラメーター:

  context - 新しく作成された Web アプリケーションコンテキスト

  webMergedConfig - Web アプリケーションコンテキストの読み込みに使用するマージされたコンテキスト構成

  関連事項:

  • loadContext(MergedContextConfiguration)
  • AbstractContextLoader.customizeContext(ConfigurableApplicationContext, MergedContextConfiguration)

• loadContext

  public final ApplicationContext loadContext(StringSE... locations) throws ExceptionSE

  AbstractGenericWebContextLoader は、レガシー ContextLoader ではなく、SmartContextLoader として使用する必要があります。このメソッドはサポートされていません。

  次で指定:

  インターフェース ContextLoader の loadContext 

  次で指定:

  インターフェース SmartContextLoader の loadContext 

  パラメーター:

  locations - アプリケーションコンテキストをロードするために使用するリソースの場所

  戻り値:

  新しいアプリケーションコンテキスト

  例外:

  UnsupportedOperationExceptionSE - この実装

  ExceptionSE - コンテキストの読み込みに失敗した場合

  関連事項:

  • ContextLoader.loadContext(java.lang.String[])