Package org.junit.jupiter.engine.execution

Class ExecutableInvoker

java.lang.Object

org.junit.jupiter.engine.execution.ExecutableInvoker

@API(status=INTERNAL,
     since="5.0")
public class ExecutableInvoker
extends Object

ExecutableInvoker encapsulates the invocation of a Executable (i.e., method or constructor), including support for dynamic resolution of method parameters via ParameterResolvers.

Since:

5.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ExecutableInvoker.ReflectiveInterceptorCall<E extends Executable,T>

Field Summary

Fields

Modifier and Type	Field	Description
private static final InvocationInterceptorChain	interceptorChain
private static final Logger	logger

Constructor Summary

Constructors

Constructor	Description
ExecutableInvoker()

Method Summary

Modifier and Type	Method	Description
private static String	asLabel(Executable executable)
<T> T	invoke(Constructor<T> constructor, Optional<Object> outerInstance, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry, ExecutableInvoker.ReflectiveInterceptorCall<Constructor<T>,T> interceptorCall)	Invoke the supplied constructor with the supplied outer instance and dynamic parameter resolution.
<T> T	invoke(Method method, Object target, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry, ExecutableInvoker.ReflectiveInterceptorCall<Method,T> interceptorCall)	Invoke the supplied static method with dynamic parameter resolution.
private <E extends Executable, T> T	invoke(InvocationInterceptor.Invocation<T> originalInvocation, ReflectiveInvocationContext<E> invocationContext, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry, ExecutableInvoker.ReflectiveInterceptorCall<E,T> call)
private Object	resolveParameter(ParameterContext parameterContext, Executable executable, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry)
private Object[]	resolveParameters(Executable executable, Optional<Object> target, Optional<Object> outerInstance, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry)	Resolve the array of parameters for the supplied executable, target, and outer instance.
private Object[]	resolveParameters(Method method, Optional<Object> target, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry)	Resolve the array of parameters for the supplied method and target.
private void	validateResolvedType(Parameter parameter, Object value, Executable executable, ParameterResolver resolver)

Methods inherited from class java.lang.Object

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

Field Details

logger

private static final Logger logger

interceptorChain

private static final InvocationInterceptorChain interceptorChain

Constructor Details

ExecutableInvoker

public ExecutableInvoker()

Method Details

invoke

public <T> T invoke(Constructor<T> constructor,
 Optional<Object> outerInstance,
 ExtensionContext extensionContext,
 ExtensionRegistry extensionRegistry,
 ExecutableInvoker.ReflectiveInterceptorCall<Constructor<T>,T> interceptorCall)

Invoke the supplied constructor with the supplied outer instance and dynamic parameter resolution.

This method should only be used to invoke the constructor for an inner class.

Parameters:

constructor - the constructor to invoke and resolve parameters for

outerInstance - the outer instance to supply as the first argument to the constructor; empty, for top-level classes

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

interceptorCall - the call for intercepting this constructor invocation via all registered interceptors

invoke

public <T> T invoke(Method method,
 Object target,
 ExtensionContext extensionContext,
 ExtensionRegistry extensionRegistry,
 ExecutableInvoker.ReflectiveInterceptorCall<Method,T> interceptorCall)

Invoke the supplied static method with dynamic parameter resolution.

Parameters:

method - the method to invoke and resolve parameters for

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

interceptorCall - the call for intercepting this method invocation via all registered interceptors

invoke

private <E extends Executable,
T> T invoke(InvocationInterceptor.Invocation<T> originalInvocation,
 ReflectiveInvocationContext<E> invocationContext,
 ExtensionContext extensionContext,
 ExtensionRegistry extensionRegistry,
 ExecutableInvoker.ReflectiveInterceptorCall<E,T> call)

resolveParameters

private Object[] resolveParameters(Method method,
 Optional<Object> target,
 ExtensionContext extensionContext,
 ExtensionRegistry extensionRegistry)

Resolve the array of parameters for the supplied method and target.

Parameters:

method - the method for which to resolve parameters

target - an Optional containing the target on which the executable will be invoked; never null but should be empty for static methods and constructors

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

Returns:

the array of Objects to be used as parameters in the executable invocation; never null though potentially empty

resolveParameters

private Object[] resolveParameters(Executable executable,
 Optional<Object> target,
 Optional<Object> outerInstance,
 ExtensionContext extensionContext,
 ExtensionRegistry extensionRegistry)

Resolve the array of parameters for the supplied executable, target, and outer instance.

Parameters:

executable - the executable for which to resolve parameters

target - an Optional containing the target on which the executable will be invoked; never null but should be empty for static methods and constructors

outerInstance - the outer instance that will be supplied as the first argument to a constructor for an inner class; should be null for methods and constructors for top-level or static classes

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

Returns:

the array of Objects to be used as parameters in the executable invocation; never null though potentially empty

resolveParameter

private Object resolveParameter(ParameterContext parameterContext,
 Executable executable,
 ExtensionContext extensionContext,
 ExtensionRegistry extensionRegistry)

validateResolvedType

private void validateResolvedType(Parameter parameter,
 Object value,
 Executable executable,
 ParameterResolver resolver)

asLabel

private static String asLabel(Executable executable)