Package org.junit.jupiter.migrationsupport.rules

Class TestRuleSupport

java.lang.Object

org.junit.jupiter.migrationsupport.rules.TestRuleSupport

All Implemented Interfaces:

AfterEachCallback, BeforeEachCallback, Extension, TestExecutionExceptionHandler

class TestRuleSupport
extends java.lang.Object
implements BeforeEachCallback, TestExecutionExceptionHandler, AfterEachCallback

Since:

5.0

Field Summary

Fields

Modifier and Type	Field	Description
private java.util.function.Function<TestRuleAnnotatedMember,AbstractTestRuleAdapter>	adapterGenerator
private static java.util.function.Consumer<java.util.List<TestRuleAnnotatedMember>>	NO_OP
private java.lang.Class<? extends org.junit.rules.TestRule>	ruleType

Constructor Summary

Constructors

Constructor	Description
TestRuleSupport(java.util.function.Function<TestRuleAnnotatedMember,AbstractTestRuleAdapter> adapterGenerator, java.lang.Class<? extends org.junit.rules.TestRule> ruleType)

Method Summary

Modifier and Type	Method	Description
void	afterEach(ExtensionContext context)	Callback that is invoked after an individual test and any user-defined teardown methods for that test have been executed.
void	beforeEach(ExtensionContext context)	Callback that is invoked before an individual test and any user-defined setup methods for that test have been executed.
private java.util.List<java.lang.reflect.Field>	findAnnotatedFields(java.lang.Object testInstance)
private java.util.List<java.lang.reflect.Method>	findAnnotatedMethods(java.lang.Object testInstance)
private java.util.List<TestRuleAnnotatedMember>	findRuleAnnotatedMembers(java.lang.Object testInstance)
private java.util.List<TestRuleAnnotatedMember>	getRuleAnnotatedMembers(ExtensionContext context)
void	handleTestExecutionException(ExtensionContext context, java.lang.Throwable throwable)	Handle the supplied throwable.
private long	invokeAppropriateMethodOnRuleAnnotatedMembers(ExtensionContext context, java.util.function.Consumer<java.util.List<TestRuleAnnotatedMember>> ordering, java.util.function.Consumer<GenericBeforeAndAfterAdvice> methodCaller)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NO_OP

private static final java.util.function.Consumer<java.util.List<TestRuleAnnotatedMember>> NO_OP

ruleType

private final java.lang.Class<? extends org.junit.rules.TestRule> ruleType

adapterGenerator

private final java.util.function.Function<TestRuleAnnotatedMember,AbstractTestRuleAdapter> adapterGenerator

Constructor Detail

TestRuleSupport

TestRuleSupport(java.util.function.Function<TestRuleAnnotatedMember,AbstractTestRuleAdapter> adapterGenerator,
                java.lang.Class<? extends org.junit.rules.TestRule> ruleType)

Method Detail

findRuleAnnotatedMembers

private java.util.List<TestRuleAnnotatedMember> findRuleAnnotatedMembers(java.lang.Object testInstance)

See Also:

BlockJUnit4ClassRunner.withRules(org.junit.runners.model.FrameworkMethod, java.lang.Object, org.junit.runners.model.Statement), RunRules

findAnnotatedMethods

private java.util.List<java.lang.reflect.Method> findAnnotatedMethods(java.lang.Object testInstance)

findAnnotatedFields

private java.util.List<java.lang.reflect.Field> findAnnotatedFields(java.lang.Object testInstance)

beforeEach

public void beforeEach(ExtensionContext context)

Description copied from interface: BeforeEachCallback

Callback that is invoked before an individual test and any user-defined setup methods for that test have been executed.

Specified by:

beforeEach in interface BeforeEachCallback

Parameters:

context - the current extension context; never null

handleTestExecutionException

public void handleTestExecutionException(ExtensionContext context,
                                         java.lang.Throwable throwable)
                                  throws java.lang.Throwable

Description copied from interface: TestExecutionExceptionHandler

Handle the supplied throwable.

Implementors must perform one of the following.

1. Swallow the supplied throwable, thereby preventing propagation.
2. Rethrow the supplied throwable as is.
3. Throw a new exception, potentially wrapping the supplied throwable.

If the supplied throwable is swallowed, subsequent TestExecutionExceptionHandlers will not be invoked; otherwise, the next registered TestExecutionExceptionHandler (if there is one) will be invoked with any Throwable thrown by this handler.

Note that the execution exception in the supplied ExtensionContext will not contain the Throwable thrown during invocation of the corresponding @Test method.

Specified by:

handleTestExecutionException in interface TestExecutionExceptionHandler

Parameters:

context - the current extension context; never null

throwable - the Throwable to handle; never null

Throws:

java.lang.Throwable

afterEach

public void afterEach(ExtensionContext context)

Description copied from interface: AfterEachCallback

Callback that is invoked after an individual test and any user-defined teardown methods for that test have been executed.

Specified by:

afterEach in interface AfterEachCallback

Parameters:

context - the current extension context; never null

invokeAppropriateMethodOnRuleAnnotatedMembers

private long invokeAppropriateMethodOnRuleAnnotatedMembers(ExtensionContext context,
                                                           java.util.function.Consumer<java.util.List<TestRuleAnnotatedMember>> ordering,
                                                           java.util.function.Consumer<GenericBeforeAndAfterAdvice> methodCaller)

Returns:

the number of appropriate rule-annotated members that were discovered

getRuleAnnotatedMembers

private java.util.List<TestRuleAnnotatedMember> getRuleAnnotatedMembers(ExtensionContext context)