org.junit.jupiter.params.ParameterizedTestMethodContext Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of junit-jupiter-params Show documentation
Show all versions of junit-jupiter-params Show documentation
Module "junit-jupiter-params" of JUnit 5.
/*
* Copyright 2015-2024 the original author or authors.
*
* All rights reserved. This program and the accompanying materials are
* made available under the terms of the Eclipse Public License v2.0 which
* accompanies this distribution and is available at
*
* https://www.eclipse.org/legal/epl-v20.html
*/
package org.junit.jupiter.params;
import static org.junit.jupiter.params.ParameterizedTestMethodContext.ResolverType.AGGREGATOR;
import static org.junit.jupiter.params.ParameterizedTestMethodContext.ResolverType.CONVERTER;
import static org.junit.platform.commons.util.AnnotationUtils.isAnnotated;
import java.lang.reflect.Method;
import java.lang.reflect.Parameter;
import java.util.ArrayList;
import java.util.List;
import java.util.Optional;
import org.junit.jupiter.api.extension.ParameterContext;
import org.junit.jupiter.api.extension.ParameterResolutionException;
import org.junit.jupiter.params.aggregator.AggregateWith;
import org.junit.jupiter.params.aggregator.ArgumentsAccessor;
import org.junit.jupiter.params.aggregator.ArgumentsAggregator;
import org.junit.jupiter.params.aggregator.DefaultArgumentsAccessor;
import org.junit.jupiter.params.converter.ArgumentConverter;
import org.junit.jupiter.params.converter.ConvertWith;
import org.junit.jupiter.params.converter.DefaultArgumentConverter;
import org.junit.jupiter.params.support.AnnotationConsumerInitializer;
import org.junit.platform.commons.support.ReflectionSupport;
import org.junit.platform.commons.util.AnnotationUtils;
import org.junit.platform.commons.util.ReflectionUtils;
import org.junit.platform.commons.util.StringUtils;
/**
* Encapsulates access to the parameters of a parameterized test method and
* caches the converters and aggregators used to resolve them.
*
* @since 5.3
*/
class ParameterizedTestMethodContext {
private final Parameter[] parameters;
private final Resolver[] resolvers;
private final List resolverTypes;
ParameterizedTestMethodContext(Method testMethod) {
this.parameters = testMethod.getParameters();
this.resolvers = new Resolver[this.parameters.length];
this.resolverTypes = new ArrayList<>(this.parameters.length);
for (Parameter parameter : this.parameters) {
this.resolverTypes.add(isAggregator(parameter) ? AGGREGATOR : CONVERTER);
}
}
/**
* Determine if the supplied {@link Parameter} is an aggregator (i.e., of
* type {@link ArgumentsAccessor} or annotated with {@link AggregateWith}).
*
* @return {@code true} if the parameter is an aggregator
*/
private static boolean isAggregator(Parameter parameter) {
return ArgumentsAccessor.class.isAssignableFrom(parameter.getType())
|| isAnnotated(parameter, AggregateWith.class);
}
/**
* Determine if the {@link Method} represented by this context has a
* potentially valid signature (i.e., formal parameter
* declarations) with regard to aggregators.
*
* This method takes a best-effort approach at enforcing the following
* policy for parameterized test methods that accept aggregators as arguments.
*
*
* - zero or more indexed arguments come first.
* - zero or more aggregators come next.
* - zero or more arguments supplied by other {@code ParameterResolver}
* implementations come last.
*
*
* @return {@code true} if the method has a potentially valid signature
*/
boolean hasPotentiallyValidSignature() {
int indexOfPreviousAggregator = -1;
for (int i = 0; i < getParameterCount(); i++) {
if (isAggregator(i)) {
if ((indexOfPreviousAggregator != -1) && (i != indexOfPreviousAggregator + 1)) {
return false;
}
indexOfPreviousAggregator = i;
}
}
return true;
}
/**
* Get the number of parameters of the {@link Method} represented by this
* context.
*/
int getParameterCount() {
return parameters.length;
}
/**
* Get the name of the {@link Parameter} with the supplied index, if
* it is present and declared before the aggregators.
*
* @return an {@code Optional} containing the name of the parameter
*/
Optional getParameterName(int parameterIndex) {
if (parameterIndex >= getParameterCount()) {
return Optional.empty();
}
Parameter parameter = this.parameters[parameterIndex];
if (!parameter.isNamePresent()) {
return Optional.empty();
}
if (hasAggregator() && parameterIndex >= indexOfFirstAggregator()) {
return Optional.empty();
}
return Optional.of(parameter.getName());
}
/**
* Determine if the {@link Method} represented by this context declares at
* least one {@link Parameter} that is an
* {@linkplain #isAggregator aggregator}.
*
* @return {@code true} if the method has an aggregator
*/
boolean hasAggregator() {
return resolverTypes.contains(AGGREGATOR);
}
/**
* Determine if the {@link Parameter} with the supplied index is an
* aggregator (i.e., of type {@link ArgumentsAccessor} or annotated with
* {@link AggregateWith}).
*
* @return {@code true} if the parameter is an aggregator
*/
boolean isAggregator(int parameterIndex) {
return resolverTypes.get(parameterIndex) == AGGREGATOR;
}
/**
* Find the index of the first {@linkplain #isAggregator aggregator}
* {@link Parameter} in the {@link Method} represented by this context.
*
* @return the index of the first aggregator, or {@code -1} if not found
*/
int indexOfFirstAggregator() {
return resolverTypes.indexOf(AGGREGATOR);
}
/**
* Resolve the parameter for the supplied context using the supplied
* arguments.
*/
Object resolve(ParameterContext parameterContext, Object[] arguments, int invocationIndex) {
return getResolver(parameterContext).resolve(parameterContext, arguments, invocationIndex);
}
private Resolver getResolver(ParameterContext parameterContext) {
int index = parameterContext.getIndex();
if (resolvers[index] == null) {
resolvers[index] = resolverTypes.get(index).createResolver(parameterContext);
}
return resolvers[index];
}
enum ResolverType {
CONVERTER {
@Override
Resolver createResolver(ParameterContext parameterContext) {
try { // @formatter:off
return AnnotationUtils.findAnnotation(parameterContext.getParameter(), ConvertWith.class)
.map(ConvertWith::value)
.map(clazz -> (ArgumentConverter) ReflectionUtils.newInstance(clazz))
.map(converter -> AnnotationConsumerInitializer.initialize(parameterContext.getParameter(), converter))
.map(Converter::new)
.orElse(Converter.DEFAULT);
} // @formatter:on
catch (Exception ex) {
throw parameterResolutionException("Error creating ArgumentConverter", ex, parameterContext);
}
}
},
AGGREGATOR {
@Override
Resolver createResolver(ParameterContext parameterContext) {
try { // @formatter:off
return AnnotationUtils.findAnnotation(parameterContext.getParameter(), AggregateWith.class)
.map(AggregateWith::value)
.map(clazz -> (ArgumentsAggregator) ReflectionSupport.newInstance(clazz))
.map(Aggregator::new)
.orElse(Aggregator.DEFAULT);
} // @formatter:on
catch (Exception ex) {
throw parameterResolutionException("Error creating ArgumentsAggregator", ex, parameterContext);
}
}
};
abstract Resolver createResolver(ParameterContext parameterContext);
}
interface Resolver {
Object resolve(ParameterContext parameterContext, Object[] arguments, int invocationIndex);
}
static class Converter implements Resolver {
private static final Converter DEFAULT = new Converter(DefaultArgumentConverter.INSTANCE);
private final ArgumentConverter argumentConverter;
Converter(ArgumentConverter argumentConverter) {
this.argumentConverter = argumentConverter;
}
@Override
public Object resolve(ParameterContext parameterContext, Object[] arguments, int invocationIndex) {
Object argument = arguments[parameterContext.getIndex()];
try {
return this.argumentConverter.convert(argument, parameterContext);
}
catch (Exception ex) {
throw parameterResolutionException("Error converting parameter", ex, parameterContext);
}
}
}
static class Aggregator implements Resolver {
private static final Aggregator DEFAULT = new Aggregator((accessor, context) -> accessor);
private final ArgumentsAggregator argumentsAggregator;
Aggregator(ArgumentsAggregator argumentsAggregator) {
this.argumentsAggregator = argumentsAggregator;
}
@Override
public Object resolve(ParameterContext parameterContext, Object[] arguments, int invocationIndex) {
ArgumentsAccessor accessor = new DefaultArgumentsAccessor(parameterContext, invocationIndex, arguments);
try {
return this.argumentsAggregator.aggregateArguments(accessor, parameterContext);
}
catch (Exception ex) {
throw parameterResolutionException("Error aggregating arguments for parameter", ex, parameterContext);
}
}
}
private static ParameterResolutionException parameterResolutionException(String message, Exception cause,
ParameterContext parameterContext) {
String fullMessage = message + " at index " + parameterContext.getIndex();
if (StringUtils.isNotBlank(cause.getMessage())) {
fullMessage += ": " + cause.getMessage();
}
return new ParameterResolutionException(fullMessage, cause);
}
}