インターフェース SmartContextLoader

メソッドの詳細

• processContextConfiguration

  void processContextConfiguration(ContextConfigurationAttributes configAttributes)

  特定のテストクラスの ContextConfigurationAttributes を処理します。

  具体的な実装では、提供された ContextConfigurationAttributes の locations または classes を変更したり、デフォルトの構成場所を生成したり、提供された値が null または空の場合にデフォルトの構成クラスを検出したりすることを選択できます。

  注 : SmartContextLoader は、提供された ContextConfigurationAttributes で対応する locations または classes プロパティを設定する前に、生成または検出されたデフォルトが実際に存在することをプリエンプティブに検証する必要があります。locations または classes プロパティを空のままにしておくと、この SmartContextLoader がデフォルトを生成または検出できなかったことを示します。

  パラメーター:

  configAttributes - 処理するコンテキスト構成属性

• loadContext

  ApplicationContext loadContext(MergedContextConfiguration mergedConfig) throws ExceptionSE

  提供された MergedContextConfiguration に基づいて新しい ApplicationContext をロードし、コンテキストを構成して、完全にリフレッシュされた状態でコンテキストを返します。

  具体的な実装では、この SmartContextLoader によってロードされた application contexts の Bean ファクトリにアノテーション構成プロセッサーを登録する必要があります。Bean は自動的に @Autowired、@ResourceEE、@InjectEE を使用したアノテーションベースの依存性注入の候補になります。さらに、具体的な実装では、次のアクションを実行する必要があります。

  • 必要に応じて、親 ApplicationContext を設定します ( MergedContextConfiguration.getParent() を参照)。
  • アクティブな Bean 定義プロファイルをコンテキストの Environment に設定します ( MergedContextConfiguration.getActiveProfiles() を参照)。
  • テスト PropertySources を Environment に追加します ( MergedContextConfiguration.getPropertySourceLocations()、MergedContextConfiguration.getPropertySourceProperties()、TestPropertySourceUtils を参照)。
  • ApplicationContextInitializers を呼び出します ( MergedContextConfiguration.getContextInitializerClasses() を参照)。
  • ContextCustomizers を呼び出します ( MergedContextConfiguration.getContextCustomizers() を参照)。
  • ApplicationContext の JVM シャットダウンフックを登録します。コンテキストが早期に閉じられない限り、JVM のシャットダウン時にすべてのコンテキストインスタンスが自動的に閉じられます。これにより、コンテキスト内で Bean が保持する外部リソースを解放できます。— たとえば、一時ファイルです。

  Spring Framework 6.0 の時点で、ApplicationContext をロードしようとしたときにスローされた例外はすべて ContextLoadException でラップする必要があります。具体的な実装には、次のような try-catch ブロックを含める必要があります。

   ApplicationContext context = // create context
   try {
       // configure and refresh context
   }
   catch (Exception ex) {
       throw new ContextLoadException(context, ex);
   }
   

  パラメーター:

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

  戻り値:

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

  例外:

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

  ExceptionSE

  関連事項:

  • processContextConfiguration(ContextConfigurationAttributes)
  • AnnotationConfigUtils.registerAnnotationConfigProcessors(org.springframework.beans.factory.support.BeanDefinitionRegistry)
  • ConfigurableApplicationContext.getEnvironment()

• processLocations

  default StringSE[] processLocations(ClassSE<?> clazz, @Nullable StringSE... locations)

  SmartContextLoader は非推奨の ContextLoader メソッドをサポートしていません。代わりに processContextConfiguration(ContextConfigurationAttributes) を呼び出してください。

  次で指定:

  インターフェース ContextLoader の processLocations 

  パラメーター:

  clazz - ロケーションが関連付けられているクラス: 指定されたロケーションの処理方法を決定するために使用されます

  locations - アプリケーションコンテキストのロードに使用する未変更の場所 (null または空にすることができます)

  戻り値:

  アプリケーションコンテキストリソースの場所の配列

  例外:

  UnsupportedOperationExceptionSE - この実装

  導入:

  6.0

• loadContext

  default ApplicationContext loadContext(StringSE... locations) throws ExceptionSE

  SmartContextLoader は非推奨の ContextLoader メソッドをサポートしていません。

  代わりに loadContext(MergedContextConfiguration) を呼び出してください。

  次で指定:

  インターフェース ContextLoader の loadContext 

  パラメーター:

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

  戻り値:

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

  例外:

  UnsupportedOperationExceptionSE - この実装

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

  導入:

  6.0