TestContextManager (Spring Framework API)

java.lang.ObjectSE
- org.springframework.test.context.TestContextManager

```
public class TestContextManager
extends ObjectSE
```
TestContextManager は、Spring TestContext フレームワークへのメインエントリポイントです。
具体的には、TestContextManager は、単一の TestContext を管理し、次のテスト実行ポイントで登録済みの各 TestExecutionListener にイベントを通知します。
- before test class execution : 特定のテストフレームワークの before before クラスコールバックの前 (例: JUnit 4 の @BeforeClass )
- test instance preparation : テストクラスのインスタンス化の直後
- before test setup : 特定のテストフレームワークの before メソッドコールバックの前 (例: JUnit 4 の @Before )
- before test execution : テストメソッドSEの実行直前、ただしテストセットアップ後
- after test execution : テストメソッドSEの実行直後、テストの破棄前
- after test tear down : 特定のテストフレームワークのメソッドコールバックの後 (例: JUnit 4 の @After )
- after test class execution : 特定のテストフレームワークのクラスコールバックの後 (例: JUnit 4 の @AfterClass )
アプリケーションコンテキストの読み込みとアクセス、テストインスタンスの依存性注入、テストメソッドのトランザクション実行などのサポートは、それぞれ @ContextConfiguration と @TestExecutionListeners を介して構成された ContextLoaders と TestExecutionListeners によって提供されます。
TestContext、デフォルトの ContextLoader、デフォルトの TestExecutionListeners、それらのコラボレーターのブートストラップは、@BootstrapWith を介して構成された TestContextBootstrapper によって実行されます。
導入:
2.5
作成者:
Sam Brannen, Juergen Hoeller
関連事項:
BootstrapWith, BootstrapContext, TestContextBootstrapper, TestContext, TestExecutionListener, TestExecutionListeners, ContextConfiguration, ContextHierarchy

コンストラクターの概要

コンストラクター
コンストラクターと説明
`TestContextManager(ClassSE<?> testClass)` 提供されたテストクラスSEの新しい `TestContextManager` を作成します。
`TestContextManager(TestContextBootstrapper testContextBootstrapper)` 提供された `TestContextBootstrapper` を使用して新しい `TestContextManager` を作成し、必要な `TestExecutionListeners` を登録します。

メソッドのサマリー

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`afterTestClass()` クラス内のすべてのテストの実行後にテストクラスを後処理するためのフック。
`void`	`afterTestExecution(ObjectSE testInstance, MethodSE testMethod, ThrowableSE exception)` 提供されたテストコンテキストでテストメソッドSEを実行した直後にテストを後処理するためのフック（タイミングやログ記録など）。
`void`	`afterTestMethod(ObjectSE testInstance, MethodSE testMethod, ThrowableSE exception)` 基本的なテストフレームワークのライフサイクルコールバック後の実行後にテストを後処理するためのフック - たとえば、テストフィクスチャを切断、トランザクションを終了する、など
`void`	`beforeTestClass()` クラス内でテストを実行する前に、テストクラスを前処理するためのフック。
`void`	`beforeTestExecution(ObjectSE testInstance, MethodSE testMethod)` 与えられたテストコンテキストSEでテストメソッドが実行される直前にテストを前処理するためのフックです ; たとえば、タイミングやロギングを目的とします。
`void`	`beforeTestMethod(ObjectSE testInstance, MethodSE testMethod)` 基になるテストフレームワークのライフサイクル前のコールバックを実行する前にテストを前処理するためのフック。たとえば、テストフィクスチャのセットアップ、トランザクションの開始など。
`TestContext`	`getTestContext()` この `TestContextManager` によって管理される `TestContext` を取得します。
`ListSE<TestExecutionListener>`	`getTestExecutionListeners()` この `TestContextManager` に登録されている現在の `TestExecutionListeners` を取得します。
`void`	`prepareTestInstance(ObjectSE testInstance)` 依存関係の注入など、個々のテストメソッドを実行する前にテストインスタンスを準備するためのフック。
`void`	`registerTestExecutionListeners(ListSE<TestExecutionListener> testExecutionListeners)` 提供された `TestExecutionListeners` のリストを、この `TestContextManager` が使用するリスナーのリストに追加して登録します。
`void`	`registerTestExecutionListeners(TestExecutionListener... testExecutionListeners)` この `TestContextManager` で使用されるリスナーのリストに追加された `TestExecutionListeners` の配列を登録します。

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

- コンストラクターの詳細
  - TestContextManager
```
public TestContextManager(ClassSE<?> testClass)
```
    提供されたテストクラスSEの新しい TestContextManager を作成します。
    TestContextBootstrapper がテストクラス用に構成された TestContextManager(TestContextBootstrapper) へのデリゲート。@BootstrapWith アノテーションが直接またはメタアノテーションとしてテストクラスに存在する場合、その value がブートストラップ型として使用されます。それ以外の場合は、DefaultTestContextBootstrapper が使用されます。
    パラメーター:
    testClass - 管理するテストクラス
    関連事項:
    TestContextManager(TestContextBootstrapper)
  - TestContextManager
```
public TestContextManager(TestContextBootstrapper testContextBootstrapper)
```
    提供された TestContextBootstrapper を使用して新しい TestContextManager を作成し、必要な TestExecutionListeners を登録します。
    TestContext を構築して TestExecutionListeners を取得するために、提供された TestContextBootstrapper にデリゲートします。
    パラメーター:
    testContextBootstrapper - 使用するブートストラップ
    関連事項:
    TestContextBootstrapper.buildTestContext(), TestContextBootstrapper.getTestExecutionListeners(), registerTestExecutionListeners(java.util.List<org.springframework.test.context.TestExecutionListener>)
- メソッドの詳細
  - getTestContext
```
public final TestContext getTestContext()
```
    この TestContextManager によって管理される TestContext を取得します。
  - registerTestExecutionListeners
```
public void registerTestExecutionListeners(ListSE<TestExecutionListener> testExecutionListeners)
```
    提供された TestExecutionListeners のリストを、この TestContextManager が使用するリスナーのリストに追加して登録します。
    関連事項:
    registerTestExecutionListeners(TestExecutionListener...)
  - registerTestExecutionListeners
```
public void registerTestExecutionListeners(TestExecutionListener... testExecutionListeners)
```
    この TestContextManager で使用されるリスナーのリストに追加された TestExecutionListeners の配列を登録します。
  - getTestExecutionListeners
```
public final ListSE<TestExecutionListener> getTestExecutionListeners()
```
    この TestContextManager に登録されている現在の TestExecutionListeners を取得します。
    変更が可能です。リストの最初にリスナーを追加します。ただし、実際にテストを実行している間は、リストを安定させておいてください。
  - beforeTestClass
```
public void beforeTestClass()
                     throws ExceptionSE
```
    クラス内でテストを実行する前に、テストクラスを前処理するためのフック。フレームワーク固有の before クラスメソッド（たとえば、JUnit 4 の @BeforeClass アノテーションが付けられたメソッド）の前に呼び出す必要があります。
    登録された各 TestExecutionListener にテストクラスの実行を前処理する機会を与える試みが行われます。ただし、リスナーが例外をスローした場合、登録されている残りのリスナーは呼び出されません。
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    導入:
    3.0
    関連事項:
    getTestExecutionListeners()
  - prepareTestInstance
```
public void prepareTestInstance(ObjectSE testInstance)
                         throws ExceptionSE
```
    依存関係の注入など、個々のテストメソッドの実行前にテストインスタンスを準備するためのフック。テストインスタンスのインスタンス化の直後に呼び出す必要があります。
    管理対象の TestContext は、提供された testInstance で更新されます。
    登録された各 TestExecutionListener にテストインスタンスを準備する機会を与える試みが行われます。ただし、リスナーが例外をスローした場合、登録されている残りのリスナーは呼び出されません。
    パラメーター:
    testInstance - 準備するテストインスタンス (非 null)
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    関連事項:
    getTestExecutionListeners()
  - beforeTestMethod
```
public void beforeTestMethod(ObjectSE testInstance,
                             MethodSE testMethod)
                      throws ExceptionSE
```
    基になるテストフレームワークのライフサイクル前のコールバックを実行する前にテストを前処理するためのフック。たとえば、テストフィクスチャのセットアップ、トランザクションの開始など。
    このメソッドは、ライフサイクルコールバック前のフレームワーク固有の直前に呼び出す必要があります（たとえば、JUnit 4 の @Before アノテーションが付けられたメソッド）。歴史的な理由により、このメソッドは beforeTestMethod と呼ばれています。beforeTestExecution(java.lang.Object, java.lang.reflect.Method) の導入以来、このメソッドのより適切な名前は、beforeTestSetUp または beforeEach のようなものになります。ただし、下位互換性の問題により、残念ながらこのメソッドの名前を変更することはできません。
    管理対象の TestContext は、提供されている testInstance および testMethod で更新されます。
    登録された各 TestExecutionListener にその前処理を実行する機会を与える試みが行われます。ただし、リスナーが例外をスローした場合、登録されている残りのリスナーは呼び出されません。
    パラメーター:
    testInstance - 現在のテストインスタンス (非 null)
    testMethod - テストインスタンスで実行されようとしているテストメソッド
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    関連事項:
    afterTestMethod(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), beforeTestExecution(java.lang.Object, java.lang.reflect.Method), afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), getTestExecutionListeners()
  - beforeTestExecution
```
public void beforeTestExecution(ObjectSE testInstance,
                                MethodSE testMethod)
                         throws ExceptionSE
```
    与えられたテストコンテキストSEでテストメソッドが実行される直前にテストを前処理するためのフックです ; たとえば、タイミングやロギングを目的とします。
    このメソッドは、ライフサイクルコールバックの前にフレームワーク固有の後に呼び出す必要があります（たとえば、JUnit 4 の @Before アノテーションが付けられたメソッド）。
    管理対象の TestContext は、提供されている testInstance および testMethod で更新されます。
    登録された各 TestExecutionListener にその前処理を実行する機会を与える試みが行われます。ただし、リスナーが例外をスローした場合、登録されている残りのリスナーは呼び出されません。
    パラメーター:
    testInstance - 現在のテストインスタンス (非 null)
    testMethod - テストインスタンスで実行されようとしているテストメソッド
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    導入:
    5.0
    関連事項:
    beforeTestMethod(java.lang.Object, java.lang.reflect.Method), afterTestMethod(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), beforeTestExecution(java.lang.Object, java.lang.reflect.Method), afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), getTestExecutionListeners()
  - afterTestExecution
```
public void afterTestExecution(ObjectSE testInstance,
                               MethodSE testMethod,
                               @Nullable
                               ThrowableSE exception)
                        throws ExceptionSE
```
    提供されたテストコンテキストでテストメソッドSEを実行した直後にテストを後処理するためのフック（タイミングやログ記録など）。
    このメソッドは、ライフサイクルコールバック後のフレームワーク固有の前に呼び出す必要があります（たとえば、JUnit 4 の @After アノテーションが付けられたメソッド）。
    管理対象の TestContext は、付属の testInstance、testMethod、exception で更新されます。
    登録された各 TestExecutionListener には、後処理を実行する機会が与えられます。リスナーが例外をスローした場合でも、残りの登録済みリスナーが呼び出されます。すべてのリスナーが実行された後、最初にキャッチされた例外が再スローされ、後続の例外は最初の例外で抑制SEされます。
    登録されたリスナーは、登録された順序とは逆の順序で実行されることに注意してください。
    パラメーター:
    testInstance - 現在のテストインスタンス (非 null)
    testMethod - テストインスタンスで実行されたばかりのテストメソッド
    exception - テストメソッドの実行中に、または TestExecutionListener によってスローされた例外、または何もスローされなかった場合は null
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    導入:
    5.0
    関連事項:
    beforeTestMethod(java.lang.Object, java.lang.reflect.Method), afterTestMethod(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), beforeTestExecution(java.lang.Object, java.lang.reflect.Method), getTestExecutionListeners(), Throwable.addSuppressed(Throwable)SE
  - afterTestMethod
```
public void afterTestMethod(ObjectSE testInstance,
                            MethodSE testMethod,
                            @Nullable
                            ThrowableSE exception)
                     throws ExceptionSE
```
    基本的なテストフレームワークのライフサイクルコールバック後の実行後にテストを後処理するためのフック - たとえば、テストフィクスチャを切断、トランザクションを終了する、など
    このメソッドは、ライフサイクルコールバック後のフレームワーク固有の直後に呼び出す必要があります（たとえば、JUnit 4 の @After アノテーションが付けられたメソッド）。歴史的な理由により、このメソッドは afterTestMethod と呼ばれています。afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable) の導入以来、このメソッドのより適切な名前は、afterTestTearDown または afterEach のようなものになります。ただし、下位互換性の問題により、残念ながらこのメソッドの名前を変更することはできません。
    管理対象の TestContext は、付属の testInstance、testMethod、exception で更新されます。
    登録された各 TestExecutionListener には、後処理を実行する機会が与えられます。リスナーが例外をスローした場合でも、残りの登録済みリスナーが呼び出されます。すべてのリスナーが実行された後、最初にキャッチされた例外が再スローされ、後続の例外は最初の例外で抑制SEされます。
    登録されたリスナーは逆に実行されることに注意してください
    パラメーター:
    testInstance - 現在のテストインスタンス (非 null)
    testMethod - テストインスタンスで実行されたばかりのテストメソッド
    exception - テストメソッドの実行中に、または TestExecutionListener によってスローされた例外、または何もスローされなかった場合は null
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    関連事項:
    beforeTestMethod(java.lang.Object, java.lang.reflect.Method), beforeTestExecution(java.lang.Object, java.lang.reflect.Method), afterTestExecution(java.lang.Object, java.lang.reflect.Method, java.lang.Throwable), getTestExecutionListeners(), Throwable.addSuppressed(Throwable)SE
  - afterTestClass
```
public void afterTestClass()
                    throws ExceptionSE
```
    クラス内のすべてのテストの実行後にテストクラスを後処理するためのフック。フレームワーク固有の after クラスメソッド（JUnit 4 の @AfterClass でアノテーションが付けられたメソッドなど）の後に呼び出す必要があります。
    登録された各 TestExecutionListener には、後処理を実行する機会が与えられます。リスナーが例外をスローした場合でも、残りの登録済みリスナーが呼び出されます。すべてのリスナーが実行された後、最初にキャッチされた例外が再スローされ、後続の例外は最初の例外で抑制SEされます。
    登録されたリスナーは逆に実行されることに注意してください
    例外:
    ExceptionSE - 登録された TestExecutionListener が例外をスローした場合
    導入:
    3.0
    関連事項:
    getTestExecutionListeners(), Throwable.addSuppressed(Throwable)SE

クラス TestContextManager

コンストラクターの概要

メソッドのサマリー

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

コンストラクターの詳細

TestContextManager

TestContextManager

メソッドの詳細

getTestContext

registerTestExecutionListeners

registerTestExecutionListeners

getTestExecutionListeners

beforeTestClass

prepareTestInstance

beforeTestMethod

beforeTestExecution

afterTestExecution

afterTestMethod

afterTestClass