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 java.lang.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

Field Summary

Fields

Modifier and Type	Field and Description
private static Logger	logger

Constructor Summary

Constructors

Constructor and Description
ExecutableInvoker()

Method Summary

Modifier and Type	Method and Description
<T> T	invoke(java.lang.reflect.Constructor<T> constructor, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry) Invoke the supplied constructor with dynamic parameter resolution.
<T> T	invoke(java.lang.reflect.Constructor<T> constructor, java.lang.Object outerInstance, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry) Invoke the supplied constructor with the supplied outer instance and dynamic parameter resolution.
java.lang.Object	invoke(java.lang.reflect.Method method, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry) Invoke the supplied static method with dynamic parameter resolution.
java.lang.Object	invoke(java.lang.reflect.Method method, java.lang.Object target, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry) Invoke the supplied method on the supplied target object with dynamic parameter resolution.
private java.lang.Object	resolveParameter(ParameterContext parameterContext, java.lang.reflect.Executable executable, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry)
private java.lang.Object[]	resolveParameters(java.lang.reflect.Executable executable, java.util.Optional<java.lang.Object> target, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry) Resolve the array of parameters for the supplied executable and target.
private java.lang.Object[]	resolveParameters(java.lang.reflect.Executable executable, java.util.Optional<java.lang.Object> target, java.lang.Object outerInstance, ExtensionContext extensionContext, ExtensionRegistry extensionRegistry) Resolve the array of parameters for the supplied executable, target, and outer instance.
private void	validateResolvedType(java.lang.reflect.Parameter parameter, java.lang.Object value, java.lang.reflect.Executable executable, ParameterResolver resolver)

Methods inherited from class java.lang.Object

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

Field Detail

logger

private static final Logger logger

Constructor Detail

ExecutableInvoker

public ExecutableInvoker()

Method Detail

invoke

public <T> T invoke(java.lang.reflect.Constructor<T> constructor,
                    ExtensionContext extensionContext,
                    ExtensionRegistry extensionRegistry)

Invoke the supplied constructor with dynamic parameter resolution.

Parameters:

constructor - the constructor to invoke and resolve parameters for

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

invoke

public <T> T invoke(java.lang.reflect.Constructor<T> constructor,
                    java.lang.Object outerInstance,
                    ExtensionContext extensionContext,
                    ExtensionRegistry extensionRegistry)

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

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

invoke

public java.lang.Object invoke(java.lang.reflect.Method method,
                               ExtensionContext extensionContext,
                               ExtensionRegistry extensionRegistry)

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

invoke

public java.lang.Object invoke(java.lang.reflect.Method method,
                               java.lang.Object target,
                               ExtensionContext extensionContext,
                               ExtensionRegistry extensionRegistry)

Invoke the supplied method on the supplied target object with dynamic parameter resolution.

Parameters:

method - the method to invoke and resolve parameters for

target - the object on which the method will be invoked; should be null for static methods

extensionContext - the current ExtensionContext

extensionRegistry - the ExtensionRegistry to retrieve ParameterResolvers from

resolveParameters

private java.lang.Object[] resolveParameters(java.lang.reflect.Executable executable,
                                             java.util.Optional<java.lang.Object> target,
                                             ExtensionContext extensionContext,
                                             ExtensionRegistry extensionRegistry)

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

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

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 java.lang.Object[] resolveParameters(java.lang.reflect.Executable executable,
                                             java.util.Optional<java.lang.Object> target,
                                             java.lang.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 java.lang.Object resolveParameter(ParameterContext parameterContext,
                                          java.lang.reflect.Executable executable,
                                          ExtensionContext extensionContext,
                                          ExtensionRegistry extensionRegistry)

validateResolvedType

private void validateResolvedType(java.lang.reflect.Parameter parameter,
                                  java.lang.Object value,
                                  java.lang.reflect.Executable executable,
                                  ParameterResolver resolver)