SpringJUnit4ClassRunner (Spring Framework 5.1.1.RELEASE API)

java.lang.Object
- org.junit.runner.Runner
- - org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod>
  - - org.junit.runners.BlockJUnit4ClassRunner
    - - org.springframework.test.context.junit4.SpringJUnit4ClassRunner

実装済みのインターフェース一覧:
org.junit.runner.Describable, org.junit.runner.manipulation.Filterable, org.junit.runner.manipulation.Sortable
既知の直属サブクラス
SpringRunner
```
public class SpringJUnit4ClassRunner
extends org.junit.runners.BlockJUnit4ClassRunner
```
SpringJUnit4ClassRunner は、JUnit の BlockJUnit4ClassRunner のカスタム拡張であり、TestContextManager および関連するサポートクラスとアノテーションを使用して、Spring TestContext フレームワークの機能を標準の JUnit テストに提供します。
このクラスを使用するには、@RunWith(SpringJUnit4ClassRunner.class) または @RunWith(SpringRunner.class) で JUnit 4 ベースのテストクラスにアノテーションを付けます。
以下のリストは、現在 SpringJUnit4ClassRunner によって直接または間接的にサポートされているすべてのアノテーションを構成しています。（追加のアノテーションは、さまざまな TestExecutionListener または TestContextBootstrapper 実装によってサポートされる場合があることに注意してください）
- @Test(expected=...)
- @Test(timeout=...)
- @Timed
- @Repeat
- @Ignore
- @ProfileValueSourceConfiguration
- @IfProfileValue
Spring TestContext フレームワークをこのランナー以外のランナーで使用する場合は、SpringClassRule および SpringMethodRule を使用します。
注意 : Spring Framework 4.3 以降、このクラスには JUnit 4.12 以上が必要です。
導入:
2.5
作成者:
Sam Brannen, Juergen Hoeller
関連事項:
SpringRunner, TestContextManager, AbstractJUnit4SpringContextTests, AbstractTransactionalJUnit4SpringContextTests, SpringClassRule, SpringMethodRule

コンストラクター概要

コンストラクター
コンストラクターと説明
`SpringJUnit4ClassRunner(java.lang.Class<?> clazz)` 新しい `SpringJUnit4ClassRunner` を作成し、`TestContextManager` を初期化して、Spring Test 機能を標準の JUnit テストに提供します。

方法の概要

すべてのメソッドインスタンスメソッド具象メソッド
修飾子と型	メソッドと説明
`protected java.lang.Object`	`createTest()` テストインスタンスを作成するために親実装に委譲し、`TestContextManager` がテストインスタンスを準備してから返すようにします。
`protected TestContextManager`	`createTestContextManager(java.lang.Class<?> clazz)` 提供されたテストクラスの新しい `TestContextManager` を作成します。
`org.junit.runner.Description`	`getDescription()` テストがクラスレベルで `@IfProfileValue` を介して無効になっている場合、無視されたテストクラスに適した説明を返します。それ以外の場合は、親実装に委譲します。
`protected java.lang.Class<? extends java.lang.Throwable>`	`getExpectedException(org.junit.runners.model.FrameworkMethod frameworkMethod)` 提供されたテストメソッドがスローすると予想される `exception` を取得します。
`protected long`	`getJUnitTimeout(org.junit.runners.model.FrameworkMethod frameworkMethod)` 提供されたテストメソッドの `@Test` アノテーションから構成済みの JUnit `timeout` を取得します。
`protected long`	`getSpringTimeout(org.junit.runners.model.FrameworkMethod frameworkMethod)` 提供されたテストメソッドの `@Timed` アノテーションから、構成済みの Spring 固有の `timeout` を取得します。
`protected TestContextManager`	`getTestContextManager()` このランナーに関連付けられている `TestContextManager` を取得します。
`protected boolean`	`isTestMethodIgnored(org.junit.runners.model.FrameworkMethod frameworkMethod)` 提供されたテストメソッドに `@Ignore` が存在する場合、または `@IfProfileValue` を介してテストメソッドが無効になっている場合は、`true` を返します。
`protected org.junit.runners.model.Statement`	`methodBlock(org.junit.runners.model.FrameworkMethod frameworkMethod)` 実行チェーン全体の潜在的な繰り返しで、デフォルトの JUnit 動作を強化します。
`protected org.junit.runners.model.Statement`	`possiblyExpectingExceptions(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement next)` 予想される例外が `getExpectedException(FrameworkMethod)` を使用して取得されることを除いて、`BlockJUnit4ClassRunner.possiblyExpectingExceptions(FrameworkMethod, Object, Statement)` と同じロジックを実行します。
`void`	`run(org.junit.runner.notification.RunNotifier notifier)` 現在の実行環境でテストが有効になっているかどうかを確認します。
`protected void`	`runChild(org.junit.runners.model.FrameworkMethod frameworkMethod, org.junit.runner.notification.RunNotifier notifier)` テストが `isTestMethodIgnored(FrameworkMethod)` によって無視されると決定されることを除いて、`BlockJUnit4ClassRunner.runChild(FrameworkMethod, RunNotifier)` と同じロジックを実行します。
`protected org.junit.runners.model.Statement`	`withAfterClasses(org.junit.runners.model.Statement statement)` 親実装から返された `Statement` を `RunAfterTestClassCallbacks` ステートメントでラップし、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの JUnit 機能を保持します。
`protected org.junit.runners.model.Statement`	`withAfters(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement)` 親実装から返された `Statement` を `RunAfterTestMethodCallbacks` ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を保持します。
`protected org.junit.runners.model.Statement`	`withAfterTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement)` 提供された `Statement` を `RunAfterTestExecutionCallbacks` ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を維持します。
`protected org.junit.runners.model.Statement`	`withBeforeClasses(org.junit.runners.model.Statement statement)` 親実装から返された `Statement` を `RunBeforeTestClassCallbacks` ステートメントでラップし、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの JUnit 機能を保持します。
`protected org.junit.runners.model.Statement`	`withBefores(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement)` 親実装から返された `Statement` を `RunBeforeTestMethodCallbacks` ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を保持します。
`protected org.junit.runners.model.Statement`	`withBeforeTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement statement)` 提供された `Statement` を `RunBeforeTestExecutionCallbacks` ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を維持します。
`protected org.junit.runners.model.Statement`	`withPotentialRepeat(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement next)` 提供された `Statement` を `SpringRepeat` ステートメントでラップします。
`protected org.junit.runners.model.Statement`	`withPotentialTimeout(org.junit.runners.model.FrameworkMethod frameworkMethod, java.lang.Object testInstance, org.junit.runners.model.Statement next)` `BlockJUnit4ClassRunner.withPotentialTimeout(FrameworkMethod, Object, Statement)` と同じロジックを実行しますが、Spring の `@Timed` アノテーションのサポートが追加されています。

クラス org.junit.runners.BlockJUnit4ClassRunner から継承されたメソッド
collectInitializationErrors, computeTestMethods, describeChild, getChildren, getTestRules, isIgnored, methodInvoker, rules, testName, validateConstructor, validateFields, validateInstanceMethods, validateNoNonStaticInnerClass, validateOnlyOneConstructor, validateTestMethods, validateZeroArgConstructor

クラス org.junit.runners.ParentRunner から継承されたメソッド
childrenInvoker, classBlock, classRules, createTestClass, filter, getName, getRunnerAnnotations, getTestClass, runLeaf, setScheduler, sort, validatePublicVoidNoArgMethods

クラス org.junit.runner.Runner から継承されたメソッド
testCount

クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクターの詳細
  - SpringJUnit4ClassRunner
```
public SpringJUnit4ClassRunner(java.lang.Class<?> clazz)
                        throws org.junit.runners.model.InitializationError
```
    新しい SpringJUnit4ClassRunner を作成し、TestContextManager を初期化して、Spring Test 機能を標準の JUnit テストに提供します。
    パラメーター:
    clazz - 実行するテストクラス
    例外:
    org.junit.runners.model.InitializationError
    関連事項:
    createTestContextManager(Class)
- メソッドの詳細
  - createTestContextManager
```
protected TestContextManager createTestContextManager(java.lang.Class<?> clazz)
```
    提供されたテストクラスの新しい TestContextManager を作成します。
    サブクラスでオーバーライドできます。
    パラメーター:
    clazz - 管理するテストクラス
  - getTestContextManager
```
protected final TestContextManager getTestContextManager()
```
    このランナーに関連付けられている TestContextManager を取得します。
  - getDescription
```
public org.junit.runner.Description getDescription()
```
    テストがクラスレベルで @IfProfileValue を介して無効になっている場合、無視されたテストクラスに適した説明を返します。それ以外の場合は、親実装に委譲します。
    次で指定:
    インターフェース org.junit.runner.Describable 内の getDescription
    オーバーライド:
    クラス org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod> の getDescription
    関連事項:
    ProfileValueUtils.isTestEnabledInThisEnvironment(Class)
  - run
```
public void run(org.junit.runner.notification.RunNotifier notifier)
```
    現在の実行環境でテストが有効になっているかどうかを確認します。
    これにより、一致しない @IfProfileValue アノテーションを持つクラスが完全に実行されなくなり、TestExecutionListeners の prepareTestInstance() メソッドの実行がスキップされます。
    オーバーライド:
    クラス org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod> の run
    関連事項:
    ProfileValueUtils.isTestEnabledInThisEnvironment(Class), IfProfileValue, TestExecutionListener
  - withBeforeClasses
```
protected org.junit.runners.model.Statement withBeforeClasses(org.junit.runners.model.Statement statement)
```
    親実装から返された Statement を RunBeforeTestClassCallbacks ステートメントでラップし、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの JUnit 機能を保持します。
    オーバーライド:
    クラス org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod> の withBeforeClasses
    関連事項:
    RunBeforeTestClassCallbacks
  - withAfterClasses
```
protected org.junit.runners.model.Statement withAfterClasses(org.junit.runners.model.Statement statement)
```
    親実装から返された Statement を RunAfterTestClassCallbacks ステートメントでラップし、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの JUnit 機能を保持します。
    オーバーライド:
    クラス org.junit.runners.ParentRunner<org.junit.runners.model.FrameworkMethod> の withAfterClasses
    関連事項:
    RunAfterTestClassCallbacks
  - createTest
```
protected java.lang.Object createTest()
                               throws java.lang.Exception
```
    テストインスタンスを作成するために親実装に委譲し、TestContextManager がテストインスタンスを準備してから返すようにします。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の createTest
    例外:
    java.lang.Exception
    関連事項:
    TestContextManager.prepareTestInstance(java.lang.Object)
  - runChild
```
protected void runChild(org.junit.runners.model.FrameworkMethod frameworkMethod,
                        org.junit.runner.notification.RunNotifier notifier)
```
    テストが isTestMethodIgnored(FrameworkMethod) によって無視されると決定されることを除いて、BlockJUnit4ClassRunner.runChild(FrameworkMethod, RunNotifier) と同じロジックを実行します。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の runChild
  - methodBlock
```
protected org.junit.runners.model.Statement methodBlock(org.junit.runners.model.FrameworkMethod frameworkMethod)
```
    実行チェーン全体の潜在的な繰り返しで、デフォルトの JUnit 動作を強化します。
    さらに、タイムアウトのサポートは、時間指定された実行内に @Before および @After メソッドの実行を含めるために、実行チェーンに移動されました。これは、メインスレッドで @Before メソッドと @After メソッドを実行し、別のスレッドで実際のテストメソッドを実行するデフォルトの JUnit の動作とは異なることに注意してください。最終的な効果は、@Before メソッドと @After メソッドがテストメソッドと同じスレッドで実行されることです。結果として、JUnit 指定のタイムアウトは Spring トランザクションと組み合わせて正常に機能します。ただし、JUnit 固有のタイムアウトは Spring 固有のタイムアウトとは異なり、前者は別のスレッドで実行され、後者は単純にメインスレッドで実行されます（通常のテストのように）。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の methodBlock
    関連事項:
    BlockJUnit4ClassRunner.methodInvoker(FrameworkMethod, Object), withBeforeTestExecutionCallbacks(FrameworkMethod, Object, Statement), withAfterTestExecutionCallbacks(FrameworkMethod, Object, Statement), possiblyExpectingExceptions(FrameworkMethod, Object, Statement), withBefores(FrameworkMethod, Object, Statement), withAfters(FrameworkMethod, Object, Statement), withRulesReflectively(FrameworkMethod, Object, Statement), withPotentialRepeat(FrameworkMethod, Object, Statement), withPotentialTimeout(FrameworkMethod, Object, Statement)
  - isTestMethodIgnored
```
protected boolean isTestMethodIgnored(org.junit.runners.model.FrameworkMethod frameworkMethod)
```
    提供されたテストメソッドに @Ignore が存在する場合、または @IfProfileValue を介してテストメソッドが無効になっている場合は、true を返します。
    関連事項:
    ProfileValueUtils.isTestEnabledInThisEnvironment(Method, Class)
  - possiblyExpectingExceptions
```
protected org.junit.runners.model.Statement possiblyExpectingExceptions(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                        java.lang.Object testInstance,
                                                                        org.junit.runners.model.Statement next)
```
    予想される例外が getExpectedException(FrameworkMethod) を使用して取得されることを除いて、BlockJUnit4ClassRunner.possiblyExpectingExceptions(FrameworkMethod, Object, Statement) と同じロジックを実行します。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の possiblyExpectingExceptions
  - getExpectedException
```
@Nullable
protected java.lang.Class<? extends java.lang.Throwable> getExpectedException(org.junit.runners.model.FrameworkMethod frameworkMethod)
```
    提供されたテストメソッドがスローすると予想される exception を取得します。
    JUnit の @Test(expected=...) アノテーションをサポートします。
    サブクラスでオーバーライドできます。
    戻り値:
    予期される例外、または何も指定されていない場合は null
  - withPotentialTimeout
```
protected org.junit.runners.model.Statement withPotentialTimeout(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                 java.lang.Object testInstance,
                                                                 org.junit.runners.model.Statement next)
```
    BlockJUnit4ClassRunner.withPotentialTimeout(FrameworkMethod, Object, Statement) と同じロジックを実行しますが、Spring の @Timed アノテーションのサポートが追加されています。
    Spring の @Timed アノテーションと JUnit の @Test(timeout=...) アノテーションの両方をサポートしますが、両方を同時にサポートすることはできません。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の withPotentialTimeout
    戻り値:
    必要に応じて、SpringFailOnTimeout、FailOnTimeout、付属の Statement のいずれか
    関連事項:
    getSpringTimeout(FrameworkMethod), getJUnitTimeout(FrameworkMethod)
  - getJUnitTimeout
```
protected long getJUnitTimeout(org.junit.runners.model.FrameworkMethod frameworkMethod)
```
    提供されたテストメソッドの @Test アノテーションから構成済みの JUnit timeout を取得します。
    戻り値:
    タイムアウト、または何も指定されなかった場合は 0
  - getSpringTimeout
```
protected long getSpringTimeout(org.junit.runners.model.FrameworkMethod frameworkMethod)
```
    提供されたテストメソッドの @Timed アノテーションから、構成済みの Spring 固有の timeout を取得します。
    戻り値:
    タイムアウト、または何も指定されなかった場合は 0
    関連事項:
    TestAnnotationUtils.getTimeout(Method)
  - withBeforeTestExecutionCallbacks
```
protected org.junit.runners.model.Statement withBeforeTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                             java.lang.Object testInstance,
                                                                             org.junit.runners.model.Statement statement)
```
    提供された Statement を RunBeforeTestExecutionCallbacks ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を維持します。
    関連事項:
    RunBeforeTestExecutionCallbacks
  - withAfterTestExecutionCallbacks
```
protected org.junit.runners.model.Statement withAfterTestExecutionCallbacks(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                            java.lang.Object testInstance,
                                                                            org.junit.runners.model.Statement statement)
```
    提供された Statement を RunAfterTestExecutionCallbacks ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を維持します。
    関連事項:
    RunAfterTestExecutionCallbacks
  - withBefores
```
protected org.junit.runners.model.Statement withBefores(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                        java.lang.Object testInstance,
                                                        org.junit.runners.model.Statement statement)
```
    親実装から返された Statement を RunBeforeTestMethodCallbacks ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を保持します。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の withBefores
    関連事項:
    RunBeforeTestMethodCallbacks
  - withAfters
```
protected org.junit.runners.model.Statement withAfters(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                       java.lang.Object testInstance,
                                                       org.junit.runners.model.Statement statement)
```
    親実装から返された Statement を RunAfterTestMethodCallbacks ステートメントでラップします。これにより、Spring TestContext フレームワークのサポートを追加しながら、デフォルトの機能を保持します。
    オーバーライド:
    クラス org.junit.runners.BlockJUnit4ClassRunner の withAfters
    関連事項:
    RunAfterTestMethodCallbacks
  - withPotentialRepeat
```
protected org.junit.runners.model.Statement withPotentialRepeat(org.junit.runners.model.FrameworkMethod frameworkMethod,
                                                                java.lang.Object testInstance,
                                                                org.junit.runners.model.Statement next)
```
    提供された Statement を SpringRepeat ステートメントでラップします。
    Spring の @Repeat アノテーションをサポートします。
    関連事項:
    TestAnnotationUtils.getRepeatCount(Method), SpringRepeat

クラス SpringJUnit4ClassRunner

コンストラクター概要

方法の概要

クラス org.junit.runners.BlockJUnit4ClassRunner から継承されたメソッド

クラス org.junit.runners.ParentRunner から継承されたメソッド

クラス org.junit.runner.Runner から継承されたメソッド

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

コンストラクターの詳細

SpringJUnit4ClassRunner

メソッドの詳細

createTestContextManager

getTestContextManager

getDescription

run

withBeforeClasses

withAfterClasses

createTest

runChild

methodBlock

isTestMethodIgnored

possiblyExpectingExceptions

getExpectedException

withPotentialTimeout

getJUnitTimeout

getSpringTimeout

withBeforeTestExecutionCallbacks

withAfterTestExecutionCallbacks

withBefores

withAfters

withPotentialRepeat