Class DefaultArgumentConverter

java.lang.Object

org.junit.jupiter.params.converter.DefaultArgumentConverter

All Implemented Interfaces:

ArgumentConverter

@API(status=INTERNAL,
     since="5.0")
public class DefaultArgumentConverter
extends Object
implements ArgumentConverter

DefaultArgumentConverter is the default implementation of the ArgumentConverter API.

The DefaultArgumentConverter is able to convert from strings to a number of primitive types and their corresponding wrapper types (Byte, Short, Integer, Long, Float, and Double), date and time types from the java.time package, and some additional common Java types such as File, BigDecimal, BigInteger, Currency, Locale, URI, URL, UUID, etc.

If the source and target types are identical the source object will not be modified.

Since:

5.0

See Also:

• ArgumentConverter
• ConversionSupport

Field Summary

Fields

Modifier and Type	Field	Description
static final DefaultArgumentConverter	INSTANCE

Method Summary

Modifier and Type	Method	Description
final @Nullable Object	convert(@Nullable Object source, Class<?> targetType, ClassLoader classLoader)
final @Nullable Object	convert(@Nullable Object source, ParameterContext context)	Convert the supplied source object according to the supplied context.
final @Nullable Object	convert(@Nullable Object source, FieldContext context)	Convert the supplied source object according to the supplied context.

Methods inherited from class java.lang.Object

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

Field Details

INSTANCE

public static final DefaultArgumentConverter INSTANCE

Method Details

convert

public final @Nullable Object convert(@Nullable Object source,
 ParameterContext context)

Description copied from interface: ArgumentConverter

Convert the supplied source object according to the supplied context.

Specified by:

convert in interface ArgumentConverter

Parameters:

source - the source object to convert; may be null

context - the parameter context where the converted object will be supplied; never null

Returns:

the converted object; may be null but only if the target type is a reference type

convert

public final @Nullable Object convert(@Nullable Object source,
 FieldContext context)
                               throws ArgumentConversionException

Description copied from interface: ArgumentConverter

Convert the supplied source object according to the supplied context.

Specified by:

convert in interface ArgumentConverter

Parameters:

source - the source object to convert; may be null

context - the field context where the converted object will be injected; never null

Returns:

the converted object; may be null but only if the target type is a reference type

Throws:

ArgumentConversionException - if an error occurs during the conversion

convert

public final @Nullable Object convert(@Nullable Object source,
 Class<?> targetType,
 ClassLoader classLoader)