public class TestContextManager extends ObjectSE
TestContextManager は、Spring TestContext フレームワークへのメインエントリポイントです。 具体的には、TestContextManager は、単一の TestContext を管理し、次のテスト実行ポイントですべての登録済み TestExecutionListeners にイベントを通知します。
before test class execution : 特定のテストフレームワークの before before クラスコールバックの前 (例: JUnit 4 の @BeforeClass )test instance preparation : テストインスタンスのインスタンス化直後 before test method execution : 特定のテストフレームワークの before メソッドコールバックの前 (例: JUnit 4 の @Before )after test method execution : 特定のテストフレームワークのメソッドコールバックの後 (例: JUnit 4 の @After )after test class execution : 特定のテストフレームワークのクラスコールバックの後 (例: JUnit 4 の @AfterClass )application contexts の読み込みとアクセス、テストインスタンスの依存性注入、テストメソッドの transactional 実行などのサポートは、@ContextConfiguration と @TestExecutionListeners を介して構成される ContextLoaders と TestExecutionListeners によって提供されます。
TestContext、デフォルトの ContextLoader、デフォルトの TestExecutionListeners、それらのコラボレーターのブートストラップは、@BootstrapWith を介して構成された TestContextBootstrapper によって実行されます。
BootstrapWith, BootstrapContext, TestContextBootstrapper, TestContext, TestExecutionListener, TestExecutionListeners, ContextConfiguration, ContextHierarchy| コンストラクターと説明 |
|---|
TestContextManager(ClassSE<?> testClass)提供されたテストクラスSEの新しい TestContextManager を作成します。 |
TestContextManager(TestContextBootstrapper testContextBootstrapper) |
| 修飾子と型 | メソッドと説明 |
|---|---|
void | afterTestClass() クラス内のすべてのテストの実行後にテストクラスを後処理するためのフック。 |
void | afterTestMethod(ObjectSE testInstance, MethodSE testMethod, ThrowableSE exception) 提供された test methodSE の実行後にテストを後処理するためのフック。たとえば、テストフィクスチャの破棄、トランザクションの終了など。 |
void | beforeTestClass() クラス内でテストを実行する前に、テストクラスを前処理するためのフック。 |
void | beforeTestMethod(ObjectSE testInstance, MethodSE testMethod) 提供された test methodSE の実行前にテストを前処理するためのフック。たとえば、テストフィクスチャの設定、トランザクションの開始など。 |
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 の配列を登録します。 |
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic TestContextManager(ClassSE<?> testClass)
TestContextManager を作成します。TestContextBootstrapper がテストクラス用に構成された TestContextManager(TestContextBootstrapper) へのデリゲート。@BootstrapWith アノテーションが直接またはメタアノテーションとしてテストクラスに存在する場合、その value がブートストラップ型として使用されます。それ以外の場合は、DefaultTestContextBootstrapper が使用されます。
testClass - 管理するテストクラス TestContextManager(TestContextBootstrapper)public TestContextManager(TestContextBootstrapper testContextBootstrapper)
TestContextBootstrapper を使用して新しい TestContextManager を作成し、必要な TestExecutionListeners を登録します。TestContext を構築して TestExecutionListeners を取得するために、提供された TestContextBootstrapper にデリゲートします。
testContextBootstrapper - 使用するブートストラップ TestContextBootstrapper.buildTestContext(), TestContextBootstrapper.getTestExecutionListeners(), registerTestExecutionListeners(java.util.List<org.springframework.test.context.TestExecutionListener>)public final TestContext getTestContext()
TestContextManager によって管理される TestContext を取得します。public void registerTestExecutionListeners(ListSE<TestExecutionListener> testExecutionListeners)
TestExecutionListeners のリストを、この TestContextManager が使用するリスナーのリストに追加して登録します。public void registerTestExecutionListeners(TestExecutionListener... testExecutionListeners)
TestContextManager で使用されるリスナーのリストに追加された TestExecutionListeners の配列を登録します。public final ListSE<TestExecutionListener> getTestExecutionListeners()
TestContextManager に登録されている現在の TestExecutionListeners を取得します。変更が可能です。リストの最初にリスナーを追加します。ただし、実際にテストを実行している間は、リストを安定させておいてください。
public void beforeTestClass()
throws ExceptionSE@BeforeClass でアノテーションが付けられたメソッド) の前に呼び出す必要があります。 登録された各 TestExecutionListener にテストクラスの実行を前処理する機会を与える試みが行われます。ただし、リスナーが例外をスローした場合、登録されている残りのリスナーは呼び出されません。
ExceptionSE - 登録された TestExecutionListener が例外をスローした場合 getTestExecutionListeners()public void prepareTestInstance(ObjectSE testInstance) throws ExceptionSE
管理対象の TestContext は、提供された testInstance で更新されます。
登録された各 TestExecutionListener にテストインスタンスを準備する機会を与える試みが行われます。ただし、リスナーが例外をスローした場合、登録されている残りのリスナーは呼び出されません。
testInstance - 準備するテストインスタンス (非 null)ExceptionSE - 登録された TestExecutionListener が例外をスローした場合 getTestExecutionListeners()public void beforeTestMethod(ObjectSE testInstance, MethodSE testMethod) throws ExceptionSE
test methodSE の実行前にテストを前処理するためのフック。たとえば、テストフィクスチャの設定、トランザクションの開始など。フレームワーク固有の before メソッド (たとえば、JUnit の @Before でアノテーションが付けられたメソッド) の前に呼び出す必要があります。 管理対象の TestContext は、提供されている testInstance および testMethod で更新されます。
登録された各 TestExecutionListener にテストメソッド実行を前処理する機会を与えるように試みられます。ただし、リスナーが例外をスローした場合、残りの登録済みリスナーは呼び出されません。
testInstance - 現在のテストインスタンス (非 null)testMethod - テストインスタンスで実行されようとしているテストメソッド ExceptionSE - 登録された TestExecutionListener が例外をスローした場合 getTestExecutionListeners()public void afterTestMethod(ObjectSE testInstance, MethodSE testMethod, ThrowableSE exception) throws ExceptionSE
test methodSE の実行後にテストを後処理するためのフック。たとえば、テストフィクスチャの破棄、トランザクションの終了など。フレームワーク固有の after メソッド (たとえば、JUnit の @After でアノテーションが付けられたメソッド) の後に呼び出す必要があります。 管理対象の TestContext は、付属の testInstance、testMethod、exception で更新されます。
登録された各 TestExecutionListener には、テストメソッド実行のリアクティブ処理を行う機会が与えられます。リスナーが例外をスローした場合、登録されている残りのリスナーは引き続き呼び出されますが、スローされた最初の例外は追跡され、すべてのリスナーの実行後に再スローされます。登録されたリスナーは、登録された順序と逆の順序で実行されることに注意してください。
testInstance - 現在のテストインスタンス (非 null)testMethod - テストインスタンスで実行されたばかりのテストメソッド exception - テストメソッドの実行中に、または TestExecutionListener によってスローされた例外、または何もスローされなかった場合は null ExceptionSE - 登録された TestExecutionListener が例外をスローした場合 getTestExecutionListeners()public void afterTestClass()
throws ExceptionSE@AfterClass でアノテーションが付けられたメソッド) の後に呼び出す必要があります。 登録された各 TestExecutionListener には、テストクラスを後処理する機会が与えられます。リスナーが例外をスローした場合、登録されている残りのリスナーは引き続き呼び出されますが、スローされた最初の例外は追跡され、すべてのリスナーの実行後に再スローされます。登録されたリスナーは、登録された順序と逆の順序で実行されることに注意してください。
ExceptionSE - 登録された TestExecutionListener が例外をスローした場合 getTestExecutionListeners()