Package org.junit.jupiter.api.extension

Interface InvocationInterceptor

All Superinterfaces:

Extension

@API(status=EXPERIMENTAL,
     since="5.5")
public interface InvocationInterceptor
extends Extension

InvocationInterceptor defines the API for Extensions that wish to intercept calls to test code.

Invocation Contract

Each method in this class must call InvocationInterceptor.Invocation.proceed() or InvocationInterceptor.Invocation.skip() exactly once on the supplied invocation. Otherwise, the enclosing test or container will be reported as failed.

The default implementation simply calls proceed() on the supplied invocation.

Constructor Requirements

Consult the documentation in Extension for details on constructor requirements.

Since:

5.5

See Also:

InvocationInterceptor.Invocation, ReflectiveInvocationContext, ExtensionContext

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	InvocationInterceptor.Invocation<T>	An invocation that returns a result and may throw a Throwable.

Method Summary

Modifier and Type	Method	Description
default void	interceptAfterAllMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of an @AfterAll method.
default void	interceptAfterEachMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of an @AfterEach method.
default void	interceptBeforeAllMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of a @BeforeAll method.
default void	interceptBeforeEachMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of a @BeforeEach method.
default void	interceptDynamicTest(InvocationInterceptor.Invocation<java.lang.Void> invocation, ExtensionContext extensionContext)	Intercept the invocation of a DynamicTest.
default <T> T	interceptTestClassConstructor(InvocationInterceptor.Invocation<T> invocation, ReflectiveInvocationContext<java.lang.reflect.Constructor<T>> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of a test class constructor.
default <T> T	interceptTestFactoryMethod(InvocationInterceptor.Invocation<T> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of a @TestFactory method.
default void	interceptTestMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of a @Test method.
default void	interceptTestTemplateMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation, ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext, ExtensionContext extensionContext)	Intercept the invocation of a @TestTemplate method.

Method Detail

interceptTestClassConstructor

default <T> T interceptTestClassConstructor(InvocationInterceptor.Invocation<T> invocation,
                                            ReflectiveInvocationContext<java.lang.reflect.Constructor<T>> invocationContext,
                                            ExtensionContext extensionContext)
                                     throws java.lang.Throwable

Intercept the invocation of a test class constructor.

Note that the test class may not have been initialized (static initialization) when this method is invoked.

Type Parameters:

T - the result type

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Returns:

the result of the invocation; never null

Throws:

java.lang.Throwable - in case of failure

interceptBeforeAllMethod

default void interceptBeforeAllMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                      ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                      ExtensionContext extensionContext)
                               throws java.lang.Throwable

Intercept the invocation of a @BeforeAll method.

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures

interceptBeforeEachMethod

default void interceptBeforeEachMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                       ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                       ExtensionContext extensionContext)
                                throws java.lang.Throwable

Intercept the invocation of a @BeforeEach method.

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures

interceptTestMethod

default void interceptTestMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                 ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                 ExtensionContext extensionContext)
                          throws java.lang.Throwable

Intercept the invocation of a @Test method.

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures

interceptTestFactoryMethod

default <T> T interceptTestFactoryMethod(InvocationInterceptor.Invocation<T> invocation,
                                         ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                         ExtensionContext extensionContext)
                                  throws java.lang.Throwable

Intercept the invocation of a @TestFactory method.

Type Parameters:

T - the result type

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Returns:

the result of the invocation; potentially null

Throws:

java.lang.Throwable - in case of failures

interceptTestTemplateMethod

default void interceptTestTemplateMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                         ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                         ExtensionContext extensionContext)
                                  throws java.lang.Throwable

Intercept the invocation of a @TestTemplate method.

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures

interceptDynamicTest

default void interceptDynamicTest(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                  ExtensionContext extensionContext)
                           throws java.lang.Throwable

Intercept the invocation of a DynamicTest.

Parameters:

invocation - the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures

interceptAfterEachMethod

default void interceptAfterEachMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                      ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                      ExtensionContext extensionContext)
                               throws java.lang.Throwable

Intercept the invocation of an @AfterEach method.

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures

interceptAfterAllMethod

default void interceptAfterAllMethod(InvocationInterceptor.Invocation<java.lang.Void> invocation,
                                     ReflectiveInvocationContext<java.lang.reflect.Method> invocationContext,
                                     ExtensionContext extensionContext)
                              throws java.lang.Throwable

Intercept the invocation of an @AfterAll method.

Parameters:

invocation - the invocation that is being intercepted; never null

invocationContext - the context of the invocation that is being intercepted; never null

extensionContext - the current extension context; never null

Throws:

java.lang.Throwable - in case of failures