クラス AbstractGenericContextLoader

メソッドの詳細

• loadContext

  public final ApplicationContext loadContext(MergedContextConfiguration mergedConfig) throws ExceptionSE

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

  実装の詳細:

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

  次で指定:

  インターフェース SmartContextLoader の loadContext 

  パラメーター:

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

  戻り値:

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

  例外:

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

  ExceptionSE

  関連事項:

  • SmartContextLoader.loadContext(MergedContextConfiguration)

• loadContextForAotProcessing

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

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

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

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

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

  次で指定:

  インターフェース AotContextLoader の loadContextForAotProcessing 

  パラメーター:

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

  戻り値:

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

  例外:

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

  導入:

  6.0

  関連事項:

  • AotContextLoader.loadContextForAotProcessing(MergedContextConfiguration)

• loadContextForAotProcessing

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

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

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

  次で指定:

  インターフェース AotContextLoader の loadContextForAotProcessing 

  パラメーター:

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

  runtimeHints - 実行時のヒント

  戻り値:

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

  例外:

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

  導入:

  6.2.4

  関連事項:

  • AotContextLoader.loadContextForAotProcessing(MergedContextConfiguration, RuntimeHints)

• loadContextForAotRuntime

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

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

  次で指定:

  インターフェース AotContextLoader の loadContextForAotRuntime 

  パラメーター:

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

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

  戻り値:

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

  例外:

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

  導入:

  6.0

  関連事項:

  • AotContextLoader.loadContextForAotRuntime(MergedContextConfiguration, ApplicationContextInitializer)

• validateMergedContextConfiguration

  protected void validateMergedContextConfiguration(MergedContextConfiguration mergedConfig)

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

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

  パラメーター:

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

  例外:

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

  導入:

  4.0.4

• loadContext

  @DeprecatedSE(since="6.0") public final ConfigurableApplicationContext loadContext(StringSE... locations) throws ExceptionSE

  使用すべきではありません。

  Spring Framework 6.0 現在、loadContext(MergedContextConfiguration) を推奨

  提供されている locations から Spring ApplicationContext をロードします。

  実装の詳細:

  • createContext() を呼び出して、GenericApplicationContext インスタンスを作成します。
  • prepareContext(GenericApplicationContext) を呼び出して、Bean 定義がロードされる前にコンテキストをカスタマイズできるようにします。
  • customizeBeanFactory(DefaultListableBeanFactory) を呼び出して、コンテキストの DefaultListableBeanFactory をカスタマイズできるようにします。
  • createBeanDefinitionReader(GenericApplicationContext) にデリゲートして BeanDefinitionReader を作成し、それを使用して、指定された場所からコンテキストを設定します。
  • registering アノテーション構成プロセッサーの AnnotationConfigUtils へのデリゲート。
  • customizeContext(GenericApplicationContext) を呼び出して、リフレッシュされる前にコンテキストをカスタマイズできるようにします。
  • Refreshes コンテキストとそのための JVM シャットダウンフックを登録します。

  注意 : このメソッドは、ロードされたコンテキストに対してアクティブな Bean 定義プロファイルを設定する手段を提供しません。代替方法については、loadContext(MergedContextConfiguration) および AbstractContextLoader.prepareContext(ConfigurableApplicationContext, MergedContextConfiguration) を参照してください。

  次で指定:

  インターフェース ContextLoader の loadContext 

  次で指定:

  インターフェース SmartContextLoader の loadContext 

  パラメーター:

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

  戻り値:

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

  例外:

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

  導入:

  2.5

  関連事項:

  • ContextLoader.loadContext(java.lang.String...)
  • GenericApplicationContext
  • loadContext(MergedContextConfiguration)

• createContext

  protected GenericApplicationContext createContext()

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

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

  戻り値:

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

  導入:

  5.2.9

• prepareContext

  protected void prepareContext(GenericApplicationContext context)

  この ContextLoader によって作成された GenericApplicationContext を準備します。Bean 定義が読み取られる前に呼び出されます。

  デフォルトの実装は空です。GenericApplicationContext の標準設定をカスタマイズするためにサブクラスでオーバーライドできます。

  パラメーター:

  context - 準備すべきコンテキスト

  導入:

  2.5

  関連事項:

  • loadContext(MergedContextConfiguration)
  • GenericApplicationContext.setAllowBeanDefinitionOverriding(boolean)
  • GenericApplicationContext.setResourceLoader(org.springframework.core.io.ResourceLoader)
  • AbstractApplicationContext.setId(java.lang.String)
  • AbstractContextLoader.prepareContext(ConfigurableApplicationContext, MergedContextConfiguration)

• customizeBeanFactory

  protected void customizeBeanFactory(DefaultListableBeanFactory beanFactory)

  この ContextLoader によって作成された ApplicationContext の内部 Bean ファクトリをカスタマイズします。

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

  パラメーター:

  beanFactory - この ContextLoader によって作成された Bean ファクトリ

  導入:

  2.5

  関連事項:

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

• loadBeanDefinitions

  protected void loadBeanDefinitions(GenericApplicationContext context, MergedContextConfiguration mergedConfig)

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

  デフォルトの実装は、createBeanDefinitionReader(GenericApplicationContext) から返された BeanDefinitionReader を Bean 定義の load に委譲します。

  サブクラスは createBeanDefinitionReader(GenericApplicationContext) の適切な実装を提供する必要があります。あるいは、サブクラスは createBeanDefinitionReader() の no-op 実装を提供し、このメソッドをオーバーライドして、Bean 定義をロードまたは登録するためのカスタム戦略を提供できます。

  パラメーター:

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

  mergedConfig - マージされたコンテキスト構成

  導入:

  3.1

  関連事項:

  • loadContext(MergedContextConfiguration)

• createBeanDefinitionReader

  protected abstract BeanDefinitionReader createBeanDefinitionReader(GenericApplicationContext context)

  提供された context に Bean 定義をロードするための新しい BeanDefinitionReader を作成するためのファクトリメソッド。

  パラメーター:

  context - BeanDefinitionReader を作成する必要があるコンテキスト

  戻り値:

  指定されたコンテキストの BeanDefinitionReader 

  導入:

  2.5

  関連事項:

  • loadContext(MergedContextConfiguration)
  • loadBeanDefinitions(org.springframework.context.support.GenericApplicationContext, org.springframework.test.context.MergedContextConfiguration)
  • BeanDefinitionReader

• customizeContext

  protected void customizeContext(GenericApplicationContext context)

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

  デフォルトの実装は空ですが、サブクラスでオーバーライドして、アプリケーションコンテキストをカスタマイズできます。

  パラメーター:

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

  導入:

  2.5

  関連事項:

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