クラス ServletTestExecutionListener
java.lang.ObjectSE
org.springframework.test.context.support.AbstractTestExecutionListener
org.springframework.test.context.web.ServletTestExecutionListener
- 実装されているすべてのインターフェース:
Ordered, TestExecutionListener
Spring TestContext フレームワークによってロードされた
WebApplicationContexts にモックサーブレット API サポートを提供する TestExecutionListener 具体的には、ServletTestExecutionListener は、テストインスタンスの準備中および各テストメソッドの前に、 Spring Web の RequestContextHolder を介してスレッドローカル状態を設定し、WebApplicationContext に存在する MockServletContext に基づいて MockHttpServletRequest、MockHttpServletResponse、ServletWebRequest を作成します。このリスナーは、MockHttpServletResponse および ServletWebRequest がテストインスタンスに挿入できることも保証し、テストが完了すると、このリスナーはスレッドローカル状態をクリーンアップします。
ServletTestExecutionListener はデフォルトで有効になっていますが、テストクラスに @WebAppConfiguration アノテーションが付けられていない場合、通常は何もしません。詳細については、このクラスの個々のメソッドの javadoc を参照してください。
- 導入:
- 3.2
- 作成者:
- Sam Brannen, Phillip Webb
フィールドのサマリー
フィールド修飾子と型フィールド説明static final StringSEServletTestExecutionListenerをアクティブ化する必要があることを示すTestContext属性の属性名。static final StringSESpring Web のRequestContextHolderのRequestAttributesに格納されているMockHttpServletRequestが TestContext フレームワークによって作成されたことを示すリクエスト属性の属性名。static final intこのリスナーのorder値: 1000。static final StringSEServletTestExecutionListenerが Spring Web のRequestContextHolderにすでに入力されていることを示すTestContext属性の属性名。static final StringSEServletTestExecutionListenerがafterTestMethod(TestContext)で Spring Web のRequestContextHolderをリセットする必要があるかどうかを示すTestContext属性の属性名。インターフェース Ordered から継承されたフィールド
HIGHEST_PRECEDENCE, LOWEST_PRECEDENCEコンストラクターの概要
コンストラクター方法の概要
修飾子と型メソッド説明voidafterTestMethod(TestContext testContext) 提供されたTestContextのRESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTEの値がBoolean.TRUESE である場合、このメソッドは、(1)Spring Web のRequestContextHolderをリセットして各テストメソッドの後にスレッドローカル状態をクリーンアップし、(2) 新しいモックが後続のテストインスタンスに確実に挿入されるようにします。テストコンテキストのDependencyInjectionTestExecutionListener.REINJECT_DEPENDENCIES_ATTRIBUTEをtrueに設定してテストします。voidbeforeTestMethod(TestContext testContext) Spring Web のRequestContextHolderを介して各テストメソッドの前にスレッドローカル状態を設定します。ただし、テストクラスに@WebAppConfigurationアノテーションが付けられている場合のみです。final intgetOrder()1000 を返します。これにより、ServletTestExecutionListenerがDirtiesContextBeforeModesTestExecutionListenerの前に順序付けられることが保証されます。voidprepareTestInstance(TestContext testContext) Spring Web のRequestContextHolderを介したテストインスタンス準備コールバックフェーズ中にスレッドローカル状態をセットアップしますが、テストクラスに@WebAppConfigurationアノテーションが付けられている場合のみです。
フィールドの詳細
ORDER
RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTE
ServletTestExecutionListenerがafterTestMethod(TestContext)で Spring Web のRequestContextHolderをリセットする必要があるかどうかを示すTestContext属性の属性名。許容値には、
Boolean.TRUESE およびBoolean.FALSESE が含まれます。POPULATED_REQUEST_CONTEXT_HOLDER_ATTRIBUTE
ServletTestExecutionListenerが Spring Web のRequestContextHolderにすでに入力されていることを示すTestContext属性の属性名。許容値には、
Boolean.TRUESE およびBoolean.FALSESE が含まれます。CREATED_BY_THE_TESTCONTEXT_FRAMEWORK
Spring Web のRequestContextHolderのRequestAttributesに格納されているMockHttpServletRequestが TestContext フレームワークによって作成されたことを示すリクエスト属性の属性名。許容値には、
Boolean.TRUESE およびBoolean.FALSESE が含まれます。- 導入:
- 4.2
ACTIVATE_LISTENER
ServletTestExecutionListenerをアクティブ化する必要があることを示すTestContext属性の属性名。trueに設定されていない場合、テストクラスに@WebAppConfigurationアノテーションが付けられるとアクティブ化が行われます。許容値には、
Boolean.TRUESE およびBoolean.FALSESE が含まれます。- 導入:
- 4.3
コンストラクターの詳細
ServletTestExecutionListener
public ServletTestExecutionListener()
メソッドの詳細
getOrder
public final int getOrder()1000 を返します。これにより、ServletTestExecutionListenerがDirtiesContextBeforeModesTestExecutionListenerの前に順序付けられることが保証されます。- 次で指定:
- インターフェース
OrderedのgetOrder - オーバーライド:
- クラス
AbstractTestExecutionListenerのgetOrder - 戻り値:
- オーダー額
- 関連事項:
prepareTestInstance
Spring Web のRequestContextHolderを介したテストインスタンス準備コールバックフェーズ中にスレッドローカル状態をセットアップしますが、テストクラスに@WebAppConfigurationアノテーションが付けられている場合のみです。- 次で指定:
- インターフェース
TestExecutionListenerのprepareTestInstance - オーバーライド:
- クラス
AbstractTestExecutionListenerのprepareTestInstance - パラメーター:
testContext- テストのテストコンテキスト。null- 例外:
ExceptionSE- 例外の伝播を許可します- 関連事項:
beforeTestMethod
Spring Web のRequestContextHolderを介して各テストメソッドの前にスレッドローカル状態を設定します。ただし、テストクラスに@WebAppConfigurationアノテーションが付けられている場合のみです。- 次で指定:
- インターフェース
TestExecutionListenerのbeforeTestMethod - オーバーライド:
- クラス
AbstractTestExecutionListenerのbeforeTestMethod - パラメーター:
testContext- テストメソッドが実行されるテストコンテキスト。非null- 例外:
ExceptionSE- 例外の伝播を許可します- 関連事項:
afterTestMethod
提供されたTestContextのRESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTEの値がBoolean.TRUESE である場合、このメソッドは、(1)Spring Web のRequestContextHolderをリセットして各テストメソッドの後にスレッドローカル状態をクリーンアップし、(2) 新しいモックが後続のテストインスタンスに確実に挿入されるようにします。テストコンテキストのDependencyInjectionTestExecutionListener.REINJECT_DEPENDENCIES_ATTRIBUTEをtrueに設定してテストします。RESET_REQUEST_CONTEXT_HOLDER_ATTRIBUTEおよびPOPULATED_REQUEST_CONTEXT_HOLDER_ATTRIBUTEは、それらの値に関係なく、その後テストコンテキストから削除されます。- 次で指定:
- インターフェース
TestExecutionListenerのafterTestMethod - オーバーライド:
- クラス
AbstractTestExecutionListenerのafterTestMethod - パラメーター:
testContext- テストメソッドが実行されたテストコンテキスト ; 決してnull- 例外:
ExceptionSE- 例外の伝播を許可します- 関連事項: