アノテーションインターフェース DirtiesContext

テストでコンテキストが変更された場合は、このアノテーションを使用します。— たとえば、シングルトン Bean の状態の変更、組み込みデータベースの状態の変更など。同じコンテキストをリクエストする後続のテストには、新しいコンテキストが提供されます。

@DirtiesContext は、同じクラスまたはクラス階層内のクラスレベルおよびメソッドレベルのアノテーションとして使用できます。このようなシナリオでは、構成された methodMode() および classMode() に応じて、そのようなアノテーション付きメソッドの前後、および現在のテストクラスの前後で、ApplicationContext がダーティとしてマークされます。@DirtiesContext がクラスレベルとメソッドレベルの両方で宣言されている場合、両方のアノテーションから構成されたテストフェーズが尊重されます。例: クラスモードが BEFORE_EACH_TEST_METHOD に設定され、メソッドモードが AFTER_METHOD に設定されている場合、コンテキストは、指定されたテストメソッドの前後の両方でダーティとしてマークされます。

サポートされているテストフェーズ

• 現在のテストクラスの前 : クラスモードを BEFORE_CLASS に設定してクラスレベルで宣言した場合
• 現在のテストクラスの各テストメソッドの前 : クラスモードを BEFORE_EACH_TEST_METHOD に設定してクラスレベルで宣言した場合
• 現在のテストメソッドの前 : メソッドモードを BEFORE_METHOD に設定してメソッドレベルで宣言した場合
• 現在のテストメソッドの後 : メソッドモードを AFTER_METHOD に設定してメソッドレベルで宣言した場合
• 現在のテストクラスの各テストメソッドの後 : クラスモードを AFTER_EACH_TEST_METHOD に設定してクラスレベルで宣言した場合
• 現在のテストクラスの後 : クラスモードを AFTER_CLASS に設定してクラスレベルで宣言した場合

BEFORE_* モードは DirtiesContextBeforeModesTestExecutionListener でサポートされています。AFTER_* モードは DirtiesContextTestExecutionListener でサポートされています。

このアノテーションは、カスタム構成アノテーションを作成するためのメタアノテーションとして使用することができます。

Spring Framework 5.3 以降、このアノテーションはデフォルトでそれを囲むテストクラスから継承されます。詳細については、@NestedTestConfiguration を参照してください。