AbstractTestContextBootstrapper (Spring Framework 5.2.6.RELEASE API)

java.lang.ObjectSE
- org.springframework.test.context.support.AbstractTestContextBootstrapper

実装済みのインターフェース一覧:
TestContextBootstrapper
既知の直属サブクラス
DefaultTestContextBootstrapper
```
public abstract class AbstractTestContextBootstrapper
extends ObjectSE
implements TestContextBootstrapper
```
ブートストラップに必要なほとんどの動作を提供する TestContextBootstrapper インターフェースの抽象的な実装。
具象サブクラスは通常、次のメソッドの実装を提供するだけで済みます。
- getDefaultContextLoaderClass(java.lang.Class<?>)
- processMergedContextConfiguration(org.springframework.test.context.MergedContextConfiguration)
カスタム ContextCache サポートをプラグインするには、getCacheAwareContextLoaderDelegate() をオーバーライドします。
導入:
4.1
作成者:
Sam Brannen, Juergen Hoeller, Phillip Webb

コンストラクター概要
コンストラクター
コンストラクターと説明
AbstractTestContextBootstrapper()

コンストラクター
コンストラクターと説明
`AbstractTestContextBootstrapper()`

方法の概要

すべてのメソッドインスタンスメソッド抽象メソッド具象メソッド
修飾子と型	メソッドと説明
`MergedContextConfiguration`	`buildMergedContextConfiguration()` このブートストラップに関連付けられた `BootstrapContext` 内のテストクラスのマージされたコンテキスト構成を構築します。
`TestContext`	`buildTestContext()` このブートストラッパーに関連付けられた `BootstrapContext` のテストクラスSEを使用し、`buildMergedContextConfiguration()` および `getCacheAwareContextLoaderDelegate()` に委譲することにより、新しい `DefaultTestContext` をビルドします。
`BootstrapContext`	`getBootstrapContext()` このブートストラップに関連付けられている `BootstrapContext` を取得します。
`protected CacheAwareContextLoaderDelegate`	`getCacheAwareContextLoaderDelegate()` `ContextCache` との透過的な相互作用に使用する `CacheAwareContextLoaderDelegate` を取得します。
`protected ListSE<ContextCustomizerFactory>`	`getContextCustomizerFactories()` このブートストラップの `ContextCustomizerFactory` インスタンスを取得します。
`protected abstract ClassSE<? extends ContextLoader>`	`getDefaultContextLoaderClass(ClassSE<?> testClass)` 提供されたテストクラスに使用するデフォルトの `ContextLoader`クラスを決定SEします。
`protected SetSE<ClassSE<? extends TestExecutionListener>>`	`getDefaultTestExecutionListenerClasses()` このブートストラップのデフォルトの `TestExecutionListener` クラスを取得します。
`protected ListSE<StringSE>`	`getDefaultTestExecutionListenerClassNames()` このブートストラップのデフォルトの `TestExecutionListener` クラスの名前を取得します。
`ListSE<TestExecutionListener>`	`getTestExecutionListeners()` このブートストラップに関連付けられた `BootstrapContext` のテストクラス用に新しくインスタンス化された `TestExecutionListeners` のリストを取得します。
`protected MergedContextConfiguration`	`processMergedContextConfiguration(MergedContextConfiguration mergedConfig)` 提供され、新しくインスタンス化された `MergedContextConfiguration` インスタンスを処理します。
`protected ContextLoader`	`resolveContextLoader(ClassSE<?> testClass, ListSE<ContextConfigurationAttributes> configAttributesList)` `ContextConfigurationAttributes` の提供されたリストに使用する `ContextLoader`SE クラスを解決してから、その `ContextLoader` をインスタンス化して返します。
`protected ClassSE<? extends ContextLoader>`	`resolveExplicitContextLoaderClass(ListSE<ContextConfigurationAttributes> configAttributesList)` `ContextConfigurationAttributes` の提供されたリストに使用する `ContextLoader`クラスを解決SEします。
`void`	`setBootstrapContext(BootstrapContext bootstrapContext)` このブートストラップで使用する `BootstrapContext` を設定します。

クラス java.lang.ObjectSE から継承されたメソッド
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE

- コンストラクターの詳細
  - AbstractTestContextBootstrapper
```
public AbstractTestContextBootstrapper()
```
- メソッドの詳細
  - setBootstrapContext
```
public void setBootstrapContext(BootstrapContext bootstrapContext)
```
    インターフェースからコピーされた説明: TestContextBootstrapper
    このブートストラップで使用する BootstrapContext を設定します。
    次で指定:
    インターフェース TestContextBootstrapper 内の setBootstrapContext
  - getBootstrapContext
```
public BootstrapContext getBootstrapContext()
```
    インターフェースからコピーされた説明: TestContextBootstrapper
    このブートストラップに関連付けられている BootstrapContext を取得します。
    次で指定:
    インターフェース TestContextBootstrapper 内の getBootstrapContext
  - buildTestContext
```
public TestContext buildTestContext()
```
    このブートストラッパーに関連付けられた BootstrapContext のテストクラスSEを使用し、buildMergedContextConfiguration() および getCacheAwareContextLoaderDelegate() に委譲することにより、新しい DefaultTestContext をビルドします。
    具象サブクラスは、このメソッドをオーバーライドしてカスタム TestContext 実装を返すことを選択できます。
    次で指定:
    インターフェース TestContextBootstrapper 内の buildTestContext
    戻り値:
    新しい TestContext、決して null
    導入:
    4.2
    関連事項:
    TestContextBootstrapper.buildMergedContextConfiguration()
  - getTestExecutionListeners
```
public final ListSE<TestExecutionListener> getTestExecutionListeners()
```
    インターフェースからコピーされた説明: TestContextBootstrapper
    このブートストラップに関連付けられた BootstrapContext のテストクラス用に新しくインスタンス化された TestExecutionListeners のリストを取得します。
    @TestExecutionListeners が BootstrapContext のテストクラスに存在しない場合、デフォルトのリスナーが返されます。さらに、デフォルトのリスナーは AnnotationAwareOrderComparator を使用してソートする必要があります。
    具体的な実装は、デフォルトのリスナーのセットを構成するものを自由に決定できます。ただし、デフォルトでは、Spring TestContext フレームワークは SpringFactoriesLoader メカニズムを使用して、クラスパス上のすべての META-INF/spring.factories ファイルで構成されているすべての TestExecutionListener クラス名を検索します。
    @TestExecutionListeners の inheritListeners フラグを考慮する必要があります。具体的には、inheritListeners フラグが true に設定されている場合、特定のテストクラスに対して宣言されたリスナーは、スーパークラスで宣言されたリスナーのリストの最後に追加する必要があります。
    次で指定:
    インターフェース TestContextBootstrapper 内の getTestExecutionListeners
    戻り値:
    TestExecutionListener インスタンスのリスト
  - getDefaultTestExecutionListenerClasses
```
protected SetSE<ClassSE<? extends TestExecutionListener>> getDefaultTestExecutionListenerClasses()
```
    このブートストラップのデフォルトの TestExecutionListener クラスを取得します。
    このメソッドは getTestExecutionListeners() によって呼び出され、クラス名を取得するために getDefaultTestExecutionListenerClassNames() に委譲します。
    特定のクラスをロードできない場合、DEBUG メッセージがログに記録されますが、関連する例外は再スローされません。
  - getDefaultTestExecutionListenerClassNames
```
protected ListSE<StringSE> getDefaultTestExecutionListenerClassNames()
```
    このブートストラップのデフォルトの TestExecutionListener クラスの名前を取得します。
    デフォルトの実装では、クラスパス上のすべての META-INF/spring.factories ファイルで構成されているすべての org.springframework.test.context.TestExecutionListener エントリを検索します。
    このメソッドは getDefaultTestExecutionListenerClasses() によって呼び出されます。
    戻り値:
    デフォルトの TestExecutionListener クラスの名前の変更不可能なリスト
    関連事項:
    SpringFactoriesLoader.loadFactoryNames(java.lang.Class<?>, java.lang.ClassLoader)
  - buildMergedContextConfiguration
```
public final MergedContextConfiguration buildMergedContextConfiguration()
```
    このブートストラップに関連付けられた BootstrapContext 内のテストクラスのマージされたコンテキスト構成を構築します。
    マージされた構成を構築する場合、実装では次のことを考慮する必要があります。
    - @ContextHierarchy および @ContextConfiguration を介して宣言されたコンテキスト階層
    - @ActiveProfiles を介して宣言されたアクティブな Bean 定義プロファイル
    - ContextConfiguration.initializers() を介して宣言されたコンテキスト初期化子
    - @TestPropertySource を介して宣言されたプロパティソースのテスト
    必要なセマンティクスの詳細については、前述のアノテーションについて Javadoc を参照してください。
    TestContextBootstrapper.buildTestContext() の実装は、通常、TestContext を構築するときにこのメソッドに委譲する必要があることに注意してください。
    特定のテストクラスに使用する ContextLoader を決定するときは、次のアルゴリズムを使用する必要があります。
    1. ContextLoader クラスが ContextConfiguration.loader() を介して明示的に宣言されている場合は、それを使用してください。
    2. それ以外の場合、具体的な実装は、デフォルトとして使用する ContextLoader クラスを自由に決定できます。
    次で指定:
    インターフェース TestContextBootstrapper 内の buildMergedContextConfiguration
    戻り値:
    マージされたコンテキスト構成、決して null
    関連事項:
    TestContextBootstrapper.buildTestContext()
  - getContextCustomizerFactories
```
protected ListSE<ContextCustomizerFactory> getContextCustomizerFactories()
```
    このブートストラップの ContextCustomizerFactory インスタンスを取得します。
    デフォルトの実装では、SpringFactoriesLoader メカニズムを使用して、クラスパス上のすべての META-INF/spring.factories ファイルで構成されたファクトリをロードします。
    導入:
    4.3
    関連事項:
    SpringFactoriesLoader.loadFactories(java.lang.Class<T>, java.lang.ClassLoader)
  - resolveContextLoader
```
protected ContextLoader resolveContextLoader(ClassSE<?> testClass,
                                             ListSE<ContextConfigurationAttributes> configAttributesList)
```
    ContextConfigurationAttributes の提供されたリストに使用する ContextLoaderSE クラスを解決してから、その ContextLoader をインスタンス化して返します。
    ユーザーが使用するローダーを明示的に宣言していない場合は、getDefaultContextLoaderClass(java.lang.Class<?>) から返された値がデフォルトのコンテキストローダークラスとして使用されます。クラス解決プロセスの詳細については、resolveExplicitContextLoaderClass(java.util.List<org.springframework.test.context.ContextConfigurationAttributes>) および getDefaultContextLoaderClass(java.lang.Class<?>) を参照してください。
    パラメーター:
    testClass - ContextLoader を解決する必要があるテストクラス。null であってはならない
    configAttributesList - 処理する構成属性のリスト。null であってはなりません。ボトムアップで並べ替える必要があります (つまり、クラス階層を上に向かっているかのように)
    戻り値:
    提供された testClass の解決された ContextLoader (非 null)
    例外:
    IllegalStateExceptionSE - getDefaultContextLoaderClass(Class) が null を返す場合
  - resolveExplicitContextLoaderClass
```
@Nullable
protected ClassSE<? extends ContextLoader> resolveExplicitContextLoaderClass(ListSE<ContextConfigurationAttributes> configAttributesList)
```
    ContextConfigurationAttributes の提供されたリストに使用する ContextLoaderクラスを解決SEします。
    コンテキスト構成属性階層の最初のレベルから始めます。
    1. ContextConfigurationAttributes の contextLoaderClass プロパティが明示的なクラスで構成されている場合、そのクラスが返されます。
    2. 明示的な ContextLoader クラスが階層の現在のレベルで指定されていない場合は、階層の次のレベルに移動して、ステップ #1 に戻ります。
    パラメーター:
    configAttributesList - 処理する構成属性のリスト。null であってはなりません。ボトムアップで並べ替える必要があります (つまり、クラス階層を上に向かっているかのように)
    戻り値:
    指定された構成属性に使用する ContextLoader クラス、または明示的なローダーが見つからない場合は null
    例外:
    IllegalArgumentExceptionSE - 指定された構成属性が null または空の場合
  - getCacheAwareContextLoaderDelegate
```
protected CacheAwareContextLoaderDelegate getCacheAwareContextLoaderDelegate()
```
    ContextCache との透過的な相互作用に使用する CacheAwareContextLoaderDelegate を取得します。
    デフォルトの実装では、単に getBootstrapContext().getCacheAwareContextLoaderDelegate() に委譲します。
    具象サブクラスは、このメソッドをオーバーライドして、カスタム ContextCache サポートを備えたカスタム CacheAwareContextLoaderDelegate 実装を返すことを選択できます。
    戻り値:
    コンテキストローダーデリゲート (決して null ではない)
  - getDefaultContextLoaderClass
```
protected abstract ClassSE<? extends ContextLoader> getDefaultContextLoaderClass(ClassSE<?> testClass)
```
    提供されたテストクラスに使用するデフォルトの ContextLoaderクラスを決定SEします。
    このメソッドによって返されるクラスは、ContextLoader クラスが ContextConfiguration.loader() を介して明示的に宣言されていない場合にのみ使用されます。
    パラメーター:
    testClass - デフォルトの ContextLoader クラスを取得するテストクラス
    戻り値:
    指定されたテストクラスのデフォルト ContextLoader クラス (非 null)
  - processMergedContextConfiguration
```
protected MergedContextConfiguration processMergedContextConfiguration(MergedContextConfiguration mergedConfig)
```
    提供され、新しくインスタンス化された MergedContextConfiguration インスタンスを処理します。
    返される MergedContextConfiguration インスタンスは、元のラッパーまたはその代わりになる可能性があります。
    デフォルトの実装は、指定されたインスタンスを変更せずに返すだけです。
    具象サブクラスは、提供されたインスタンスのプロパティに基づいて、MergedContextConfiguration の特殊なサブクラスを返すことを選択できます。
    パラメーター:
    mergedConfig - 処理する MergedContextConfiguration。null
    戻り値:
    完全に初期化された MergedContextConfiguration; null

クラス AbstractTestContextBootstrapper

コンストラクター概要

方法の概要

クラス java.lang.ObjectSE から継承されたメソッド

コンストラクターの詳細

AbstractTestContextBootstrapper

メソッドの詳細

setBootstrapContext

getBootstrapContext

buildTestContext

getTestExecutionListeners

getDefaultTestExecutionListenerClasses

getDefaultTestExecutionListenerClassNames

buildMergedContextConfiguration

getContextCustomizerFactories

resolveContextLoader

resolveExplicitContextLoaderClass

getCacheAwareContextLoaderDelegate

getDefaultContextLoaderClass

processMergedContextConfiguration