Module org.junit.jupiter.params
Interface ArgumentsAccessor
-
- All Known Implementing Classes:
DefaultArgumentsAccessor
@API(status=STABLE, since="5.7") public interface ArgumentsAccessor
ArgumentsAccessor
defines the public API for accessing arguments provided by anArgumentsProvider
for a single invocation of a@ParameterizedTest
method.Specifically, an
ArgumentsAccessor
aggregates a set of arguments for a given invocation of a parameterized test and provides convenience methods for accessing those arguments in a type-safe manner with support for automatic type conversion.An instance of
ArgumentsAccessor
will be automatically supplied for any parameter of typeArgumentsAccessor
in a parameterized test. In addition,ArgumentsAggregator
implementations are given access to anArgumentsAccessor
.This interface is not intended to be implemented by clients.
Additional Kotlin arguments accessors can be found as extension functions in the
org.junit.jupiter.params.aggregator
package.- Since:
- 5.2
- See Also:
ArgumentsAggregator
,ParameterizedTest
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Object
get(int index)
Get the value of the argument at the given index as anObject
.<T> T
get(int index, Class<T> requiredType)
Get the value of the argument at the given index as an instance of the required type.Boolean
getBoolean(int index)
Get the value of the argument at the given index as aBoolean
, performing automatic type conversion as necessary.Byte
getByte(int index)
Get the value of the argument at the given index as aByte
, performing automatic type conversion as necessary.Character
getCharacter(int index)
Get the value of the argument at the given index as aCharacter
, performing automatic type conversion as necessary.Double
getDouble(int index)
Get the value of the argument at the given index as aDouble
, performing automatic type conversion as necessary.Float
getFloat(int index)
Get the value of the argument at the given index as aFloat
, performing automatic type conversion as necessary.Integer
getInteger(int index)
Get the value of the argument at the given index as aInteger
, performing automatic type conversion as necessary.Long
getLong(int index)
Get the value of the argument at the given index as aLong
, performing automatic type conversion as necessary.Short
getShort(int index)
Get the value of the argument at the given index as aShort
, performing automatic type conversion as necessary.String
getString(int index)
Get the value of the argument at the given index as aString
, performing automatic type conversion as necessary.int
size()
Get the number of arguments in this accessor.Object[]
toArray()
Get all arguments in this accessor as an array.List<Object>
toList()
Get all arguments in this accessor as an immutable list.
-
-
-
Method Detail
-
get
Object get(int index) throws ArgumentAccessException
Get the value of the argument at the given index as anObject
.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
-
get
<T> T get(int index, Class<T> requiredType) throws ArgumentAccessException
Get the value of the argument at the given index as an instance of the required type.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
requiredType
- the required type of the value; nevernull
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
-
getCharacter
Character getCharacter(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aCharacter
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getBoolean
Boolean getBoolean(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aBoolean
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getByte
Byte getByte(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aByte
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getShort
Short getShort(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aShort
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getInteger
Integer getInteger(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aInteger
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getLong
Long getLong(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aLong
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getFloat
Float getFloat(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aFloat
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getDouble
Double getDouble(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aDouble
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
getString
String getString(int index) throws ArgumentAccessException
Get the value of the argument at the given index as aString
, performing automatic type conversion as necessary.- Parameters:
index
- the index of the argument to get; must be greater than or equal to zero and less thansize()
- Returns:
- the value at the given index, potentially
null
- Throws:
ArgumentAccessException
- if the value cannot be accessed or converted to the desired type
-
size
int size()
Get the number of arguments in this accessor.
-
toArray
Object[] toArray()
Get all arguments in this accessor as an array.
-
-