クラス DefaultTestContext

メソッドの詳細

• hasApplicationContext

  public boolean hasApplicationContext()

  このテストコンテキストのアプリケーションコンテキストがコンテキストキャッシュに存在するかどうかを確認します。

  次で指定:

  インターフェース TestContext の hasApplicationContext 

  戻り値:

  true （アプリケーションコンテキストがすでにロードされ、コンテキストキャッシュに格納されている場合）

  導入:

  5.2

  関連事項:

  • getApplicationContext()
  • CacheAwareContextLoaderDelegate.isContextLoaded(MergedContextConfiguration)

• getApplicationContext

  public ApplicationContext getApplicationContext()

  このテストコンテキストのアプリケーションコンテキストを取得します。

  デフォルトの実装は、この TestContext の構築時に提供された CacheAwareContextLoaderDelegate に委譲します。

  次で指定:

  インターフェース TestContext の getApplicationContext 

  戻り値:

  アプリケーションコンテキスト (非 null)

  例外:

  IllegalStateExceptionSE - コンテキストローダーデリゲートによって返されたコンテキストがアクティブでない場合 (つまり、閉鎖されています)

  関連事項:

  • CacheAwareContextLoaderDelegate.loadContext(MergedContextConfiguration)

• markApplicationContextUnused

  public void markApplicationContextUnused()

  このテストコンテキストに関連付けられたアプリケーションコンテキストを未使用としてマークし、他のテストクラスが同じアプリケーションコンテキストをアクティブに使用していない場合に安全に一時停止できるようにします。

  デフォルトの実装は、この TestContext の構築時に提供された CacheAwareContextLoaderDelegate に委譲します。

  次で指定:

  インターフェース TestContext の markApplicationContextUnused 

  導入:

  7.0

  関連事項:

  • CacheAwareContextLoaderDelegate.unregisterContextUsage(MergedContextConfiguration, Class)

• markApplicationContextDirty

  public void markApplicationContextDirty(@Nullable DirtiesContext.HierarchyMode hierarchyMode)

  このテストコンテキストに関連付けられたアプリケーションコンテキストをダーティとしてマークします （つまり、コンテキストキャッシュから削除し、閉じます）。

  デフォルトの実装は、この TestContext の構築時に提供された CacheAwareContextLoaderDelegate に委譲します。

  次で指定:

  インターフェース TestContext の markApplicationContextDirty 

  パラメーター:

  hierarchyMode - コンテキストが階層の一部である場合に適用されるコンテキストキャッシュのクリアモード (null の場合があります)

  関連事項:

  • CacheAwareContextLoaderDelegate.closeContext(MergedContextConfiguration, DirtiesContext.HierarchyMode)

• getTestClass

  public final ClassSE<?> getTestClass()

  インターフェースからコピーされた説明: TestContext

  このテストコンテキストのテストクラスSEを取得します。

  JUnit Jupiter 5.12 以降、SpringExtension をテストメソッドスコープの ExtensionContext と組み合わせて使用する場合、このメソッドから返される Class は、現在のテストメソッドのテストクラスを参照する可能性があります。このテストクラスは、テストインスタンスのクラス内の @Nested テストクラスである可能性があります。TestExecutionListener.prepareTestInstance(TestContext) の実装内で現在のテストインスタンスのクラスへの一貫したアクセスが必要な場合は、testContext.getTestClass() ではなく testContext.getTestInstance().getClass() を呼び出す必要があります。

  次で指定:

  インターフェース TestContext の getTestClass 

  戻り値:

  テストクラス (非 null)

  関連事項:

  • @SpringExtensionConfig

• getTestInstance

  public final ObjectSE getTestInstance()

  インターフェースからコピーされた説明: TestContext

  このテストコンテキストの現在のテストインスタンスを取得SEします。

  メモ: これは変更可能なプロパティです。

  次で指定:

  インターフェース TestContext の getTestInstance 

  戻り値:

  現在のテストインスタンス (非 null)

  関連事項:

  • TestContext.updateState(Object, Method, Throwable)

• getTestMethod

  public final MethodSE getTestMethod()

  インターフェースからコピーされた説明: TestContext

  このテストコンテキストの現在のテストメソッドを取得SEします。

  メモ: これは変更可能なプロパティです。

  次で指定:

  インターフェース TestContext の getTestMethod 

  戻り値:

  現在のテストメソッド (非 null)

  関連事項:

  • TestContext.updateState(Object, Method, Throwable)

• getTestException

  public final @Nullable ThrowableSE getTestException()

  インターフェースからコピーされた説明: TestContext

  テストメソッドの実行中にスローされた例外SEを取得します。

  メモ: これは変更可能なプロパティです。

  次で指定:

  インターフェース TestContext の getTestException 

  戻り値:

  スローされた例外、または例外がスローされなかった場合は null 

  関連事項:

  • TestContext.updateState(Object, Method, Throwable)

• updateState

  public void updateState(@Nullable ObjectSE testInstance, @Nullable MethodSE testMethod, @Nullable ThrowableSE testException)

  インターフェースからコピーされた説明: TestContext

  このテストコンテキストを更新して、現在実行中のテストの状態を反映させます。

  警告 : このメソッドは TestContextManager によってのみ呼び出されます。

  注意: このメソッドの同時呼び出しは、基盤となる実装によっては、スレッドセーフではない場合があります。

  次で指定:

  インターフェース TestContext の updateState 

  パラメーター:

  testInstance - 現在のテストインスタンス (null の場合があります)

  testMethod - 現在のテストメソッド (null の場合があります)

  testException - テストメソッドでスローされた例外、または例外がスローされなかった場合は null 

• setMethodInvoker

  public final void setMethodInvoker(MethodInvoker methodInvoker)

  インターフェースからコピーされた説明: TestContext

  使用する MethodInvoker を設定します。

  デフォルトでは、このメソッドは何も行いません。

  具体的な実装では、提供された MethodInvoker を追跡し、TestContext.getMethodInvoker() からそれを返す必要があります。Spring の標準 TestContext 実装は、このメソッドを適切にオーバーライドすることに注意してください。

  次で指定:

  インターフェース TestContext の setMethodInvoker 

• getMethodInvoker

  public final MethodInvoker getMethodInvoker()

  インターフェースからコピーされた説明: TestContext

  使用する MethodInvoker を取得します。

  デフォルトでは、このメソッドは MethodInvoker.DEFAULT_INVOKER を返します。

  具体的な実装では、TestContext.setMethodInvoker(MethodInvoker) に提供された MethodInvoker を返す必要があります。Spring の標準 TestContext 実装は、このメソッドを適切にオーバーライドすることに注意してください。

  次で指定:

  インターフェース TestContext の getMethodInvoker 

• setAttribute

  public void setAttribute(StringSE name, @Nullable ObjectSE value)

  インターフェースからコピーされた説明: AttributeAccessor

  name で定義された属性を、指定された value に設定します。

  value が null の場合、属性は removed です。

  一般に、ユーザーは、クラスまたはパッケージ名を接頭辞として使用するなど、完全修飾名を使用して、他のメタデータ属性との重複を防ぐように注意する必要があります。

  次で指定:

  インターフェース AttributeAccessor の setAttribute 

  パラメーター:

  name - 一意の属性キー

  value - 添付する属性値

• getAttribute

  public @Nullable ObjectSE getAttribute(StringSE name)

  インターフェースからコピーされた説明: AttributeAccessor

  name で識別される属性の値を取得します。

  属性が存在しない場合は null を返します。

  次で指定:

  インターフェース AttributeAccessor の getAttribute 

  パラメーター:

  name - 一意の属性キー

  戻り値:

  属性の現在の値（存在する場合）

• computeAttribute

  public <T> T computeAttribute(StringSE name, FunctionSE<StringSE,T> computeFunction)

  インターフェースからコピーされた説明: AttributeAccessor

  必要に応じて、name で識別される属性の新しい値を計算し、この AttributeAccessor に新しい値を設定します。

  name で識別される属性の値がこの AttributeAccessor にすでに存在する場合、提供された計算関数を適用せずに既存の値が返されます。

  このメソッドのデフォルトの実装はスレッドセーフではありませんが、このインターフェースの具体的な実装によってオーバーライドできます。

  次で指定:

  インターフェース AttributeAccessor の computeAttribute 

  型パラメーター:

  T - 属性値の型

  パラメーター:

  name - 一意の属性キー

  computeFunction - 属性名の新しい値を計算する関数。関数は null 値を返してはなりません

  戻り値:

  名前付き属性の既存の値または新しく計算された値

  関連事項:

  • AttributeAccessor.getAttribute(String)
  • AttributeAccessor.setAttribute(String, Object)

• removeAttribute

  public @Nullable ObjectSE removeAttribute(StringSE name)

  インターフェースからコピーされた説明: AttributeAccessor

  name で識別される属性を削除し、その値を返します。

  name に属性が見つからない場合は、null を返します。

  次で指定:

  インターフェース AttributeAccessor の removeAttribute 

  パラメーター:

  name - 一意の属性キー

  戻り値:

  属性の最後の値（存在する場合）

• hasAttribute

  public boolean hasAttribute(StringSE name)

  インターフェースからコピーされた説明: AttributeAccessor

  name で識別される属性が存在する場合は、true を返します。

  それ以外の場合は false を返します。

  次で指定:

  インターフェース AttributeAccessor の hasAttribute 

  パラメーター:

  name - 一意の属性キー

• attributeNames

  public StringSE[] attributeNames()

  インターフェースからコピーされた説明: AttributeAccessor

  すべての属性の名前を返します。

  次で指定:

  インターフェース AttributeAccessor の attributeNames 

• toString

  public StringSE toString()

  このテストコンテキストの状態の文字列表現を提供します。

  オーバーライド:

  クラス ObjectSE の toString