インターフェース CacheAwareContextLoaderDelegate

メソッドの詳細

• isContextLoaded

  default boolean isContextLoaded(MergedContextConfiguration mergedConfig)

  提供された MergedContextConfiguration のアプリケーションコンテキストがロードされている（つまり、ContextCache に存在する）かどうかを判別します。

  このメソッドの実装は、副作用としてアプリケーションコンテキストをロードしてはなりません。さらに、このメソッドの実装は ContextCache.logStatistics() を介してキャッシュ統計を記録するべきではありません。

  このメソッドのデフォルト実装は、常に false を返します。カスタム CacheAwareContextLoaderDelegate 実装では、このメソッドをより意味のある実装でオーバーライドすることを強くお勧めします。Spring の標準 CacheAwareContextLoaderDelegate 実装がこのメソッドを適切にオーバーライドすることに注意してください。

  パラメーター:

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

  戻り値:

  true （アプリケーションコンテキストがロードされている場合）

  導入:

  5.2

  関連事項:

  • loadContext(MergedContextConfiguration)
  • closeContext(MergedContextConfiguration, DirtiesContext.HierarchyMode)

• loadContext

  ApplicationContext loadContext(MergedContextConfiguration mergedConfig)

  指定された MergedContextConfiguration で構成された ContextLoader に委譲することにより、提供された MergedContextConfiguration のアプリケーションコンテキストをロードします。

  ContextCache にコンテキストが存在する場合は、単に返されます。それ以外の場合は、ロードされてキャッシュに保存され、返されます。

  Spring Framework 6.0 の時点で、このメソッドの実装は SpringFactoriesLoader メカニズムを介して ApplicationContextFailureProcessor 実装をロードし、ContextLoader によってスローされた例外をキャッチし、例外が ContextLoadException のインスタンスである場合、コンテキストのロードの失敗を処理するために構成された各失敗プロセッサーに委譲する必要があります。

  Spring Framework 6.1 以降、このメソッドの実装では障害しきい値機能をサポートすることが推奨されています。具体的には、アプリケーションコンテキストのロードが繰り返し試行され、そのアプリケーションコンテキストのロードが常に失敗する場合 (たとえば、コンテキストの正常なロードを妨げる構成エラーが原因)、構成された失敗しきい値が以下の場合、このメソッドはプリエンプティブに IllegalStateExceptionSE をスローする必要があります。超えてしまった。ContextCache は、特定のコンテキストキャッシュキーの失敗カウントの追跡と増分をサポートしていることに注意してください。

  キャッシュ統計は、ContextCache.logStatistics() を呼び出して記録する必要があります。

  パラメーター:

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

  戻り値:

  アプリケーションコンテキスト (非 null)

  例外:

  IllegalStateExceptionSE - アプリケーションコンテキストの取得中または読み込み中にエラーが発生した場合

  関連事項:

  • isContextLoaded(MergedContextConfiguration)
  • closeContext(MergedContextConfiguration, DirtiesContext.HierarchyMode)
  • CONTEXT_FAILURE_THRESHOLD_PROPERTY_NAME

• closeContext

  void closeContext(MergedContextConfiguration mergedConfig, @Nullable DirtiesContext.HierarchyMode hierarchyMode)

  提供された MergedContextConfiguration のアプリケーションコンテキストを ContextCache から削除し、それが ConfigurableApplicationContext のインスタンスである場合は閉じます。

  コンテキストをキャッシュから削除するときは、提供された HierarchyMode のセマンティクスを順守する必要があります。詳細については、DirtiesContext.HierarchyMode の Javadoc を参照してください。

  一般的に、このメソッドはシングルトン Bean の状態が変更された場合（コンテキストとの将来の対話に影響する可能性がある場合）、またはコンテキストをキャッシュから時期尚早に削除する必要がある場合にのみ呼び出す必要があります。

  パラメーター:

  mergedConfig - クローズするアプリケーションコンテキストのマージされたコンテキスト構成。非 null

  hierarchyMode - 階層モード。コンテキストが階層の一部ではない場合、null である可能性があります

  導入:

  4.1

  関連事項:

  • isContextLoaded(MergedContextConfiguration)
  • loadContext(MergedContextConfiguration)

• registerContextUsage

  default void registerContextUsage(MergedContextConfiguration key, ClassSE<?> testClass)

  指定された MergedContextConfiguration のアプリケーションコンテキストの使用と、その親のアプリケーションコンテキストの使用を再帰的に登録します。

  これは、提供されたテストクラスに代わって TestExecutionListener がアプリケーションコンテキストと対話するたびに呼び出されることを目的としています。

  パラメーター:

  key - コンテキストキー。null

  testClass - アプリケーションコンテキストを使用しているテストクラス

  導入:

  7.0

  関連事項:

  • unregisterContextUsage(MergedContextConfiguration, Class)

• unregisterContextUsage

  default void unregisterContextUsage(MergedContextConfiguration key, ClassSE<?> testClass)

  指定された MergedContextConfiguration のアプリケーションコンテキストの使用と、その親のアプリケーションコンテキストの使用を再帰的に登録解除します。

  これは、他のテストクラスが同じアプリケーションコンテキストをアクティブに使用していない場合、アプリケーションコンテキストを安全に一時停止できることを ContextCache に通知します。

  パラメーター:

  key - コンテキストキー。null

  testClass - アプリケーションコンテキストを使用しなくなったテストクラス

  導入:

  7.0

  関連事項:

  • registerContextUsage(MergedContextConfiguration, Class)