Interface Argument<T>

Type Parameters:

T - The argument type

All Superinterfaces:

AnnotatedElement, AnnotationMetadataProvider, AnnotationSource, Named, Type, TypeInformation<T>, TypeVariableResolver

All Known Subinterfaces:

ArgumentValue<V>, GenericPlaceholder<T>, MutableArgumentValue<V>

All Known Implementing Classes:

ArgumentBeanType, DefaultArgument, GenericArgument

public interface Argument<T>
extends TypeInformation<T>, AnnotatedElement, Type

Represents an argument to a method or constructor or type.

Since:

1.0

Author:

Graeme Rocher

Nested Class Summary

Nested classes/interfaces inherited from interface TypeInformation

TypeInformation.TypeFormat

Field Summary

Fields

Modifier and Type	Field	Description
static final Argument<Boolean>	BOOLEAN	Constant for boolean argument.
static final Argument<Byte>	BYTE	Constant for byte argument.
static final Argument<Character>	CHAR	Constant char argument.
static final Argument<Double>	DOUBLE	Constant for double argument.
static final Argument<Float>	FLOAT	Constant for float argument.
static final Argument<Integer>	INT	Constant for int argument.
static final Argument<List<String>>	LIST_OF_STRING	Constant for List<String> argument.
static final Argument<Long>	LONG	Constant for long argument.
static final Argument<Object>	OBJECT_ARGUMENT	Default Object argument.
static final Argument<Short>	SHORT	Constant short argument.
static final Argument<String>	STRING	Constant for string argument.
static final Argument<Void>	VOID	Constant for void argument.
static final Argument<Void>	VOID_OBJECT	Constant for Void object argument.
static final Argument[]	ZERO_ARGUMENTS	Constant representing zero arguments.

Fields inherited from interface AnnotationSource

EMPTY

Method Summary

Modifier and Type	Method	Description
boolean	equalsType(@Nullable Argument<?> other)	Whether the types are equivalent.
String	getName()
default boolean	isAssignableFrom(Argument<?> candidateArgument)	Checks if the argument can be assigned to this argument.
default boolean	isAssignableFrom(Class<?> candidateType)	Delegates to Class.isAssignableFrom(Class) for this argument.
default boolean	isInstance(@Nullable Object o)	Whether the given argument is an instance.
default boolean	isTypeVariable()	Whether this argument is a type variable used in generics.
static <T> Argument<List<T>>	listOf(Argument<T> type)	Creates a new argument representing a generic list.
static <T> Argument<List<T>>	listOf(Class<T> type)	Creates a new argument representing a generic list.
static <K,V> Argument<Map<K,V>>	mapOf(Argument<K> keyType, Argument<V> valueType)	Creates a new argument representing a generic map.
static <K,V> Argument<Map<K,V>>	mapOf(Class<K> keyType, Class<V> valueType)	Creates a new argument representing a generic map.
static <T> Argument<T>	of(Class<T> type)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable AnnotationMetadata annotationMetadata, @Nullable Argument<?>... typeParameters)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable AnnotationMetadata annotationMetadata, Class<?> @Nullable [] typeParameters)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable Argument<?>... typeParameters)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable Class<?>... typeParameters)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable String name)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable String name, @Nullable AnnotationMetadata annotationMetadata, @Nullable Argument<?>... typeParameters)	Creates a new argument for the given type and name.
static <T> Argument<T>	of(Class<T> type, @Nullable String name, Argument<?> @Nullable ... typeParameters)	Creates a new argument for the given type and name.
static Argument<?>	of(Type type)	Allows coercing a Type instance to an Argument.
static <T> Argument<T>	ofInstance(T instance)	Creates a new argument for the type of the given instance.
static <T> Argument<T>	ofTypeVariable(Class<T> type, @Nullable String name)	Creates a new argument for the given type and name that is a type variable.
static <T> Argument<T>	ofTypeVariable(Class<T> type, @Nullable String name, @Nullable AnnotationMetadata annotationMetadata, @Nullable Argument<?>... typeParameters)	Creates a new argument for the given type and name that is a type variable.
static <T> Argument<T>	ofTypeVariable(Class<T> type, @Nullable String argumentName, String variableName)	Creates a new argument for the given type and name that is a type variable.
static <T> Argument<T>	ofTypeVariable(Class<T> type, @Nullable String argumentName, String variableName, @Nullable AnnotationMetadata annotationMetadata, @Nullable Argument<?>... typeParameters)	Creates a new argument for the given type and name that is a type variable.
static <T> Argument<Optional<T>>	optionalOf(Argument<T> optionalValueArgument)	Creates a new argument representing an optional.
static <T> Argument<Optional<T>>	optionalOf(Class<T> optionalValueClass)	Creates a new argument representing an optional.
static <T> Argument<Set<T>>	setOf(Argument<T> type)	Creates a new argument representing a generic set.
static <T> Argument<Set<T>>	setOf(Class<T> type)	Creates a new argument representing a generic set.
static Class<?>[]	toClassArray(Argument<?> @Nullable ... arguments)	Convert an argument array to a class array.
static String	toString(Argument<?> @Nullable ... arguments)	Convert the arguments to a string representation.
int	typeHashCode()	The hash code including only the types.
default Argument<T>	withAnnotationMetadata(AnnotationMetadata annotationMetadata)	Creates a copy of this argument with a different annotation metadata.
default Argument<T>	withName(@Nullable String name)	Creates a copy of this argument with a different name.

Methods inherited from interface AnnotatedElement

isDeclaredNonNull, isDeclaredNullable, isNonNull, isNullable

Methods inherited from interface AnnotationMetadataProvider

findAnnotation, findAnnotation, findDeclaredAnnotation, findDeclaredAnnotation, getAnnotationMetadata, getTargetAnnotationMetadata, isAnnotationPresent, isDeclaredAnnotationPresent, synthesize, synthesizeAll, synthesizeAnnotationsByType, synthesizeDeclared, synthesizeDeclared, synthesizeDeclaredAnnotationsByType

Methods inherited from interface AnnotationSource

getAnnotation, getAnnotation, getDeclaredAnnotation, getDeclaredAnnotation, isAnnotationPresent, isDeclaredAnnotationPresent, synthesize, synthesizeDeclared

Methods inherited from interface TypeInformation

asParameterizedType, asType, getBeanTypeString, getSimpleName, getType, getTypeName, getTypeString, getTypeString, getWrappedType, getWrapperType, hasTypeVariables, isArray, isAsync, isAsyncOrReactive, isCompletable, isContainerType, isOptional, isPrimitive, isProvider, isReactive, isSpecifiedSingle, isVoid, isWrapperType

Methods inherited from interface TypeVariableResolver

getFirstTypeVariable, getTypeParameters, getTypeVariable, getTypeVariables

Field Details

STRING

static final Argument<String> STRING

Constant for string argument.

INT

static final Argument<Integer> INT

Constant for int argument. Used by generated code, do not remove.

LONG

static final Argument<Long> LONG

Constant for long argument. Used by generated code, do not remove.

FLOAT

static final Argument<Float> FLOAT

Constant for float argument. Used by generated code, do not remove.

DOUBLE

static final Argument<Double> DOUBLE

Constant for double argument. Used by generated code, do not remove.

VOID

static final Argument<Void> VOID

Constant for void argument. Used by generated code, do not remove.

BYTE

static final Argument<Byte> BYTE

Constant for byte argument. Used by generated code, do not remove.

BOOLEAN

static final Argument<Boolean> BOOLEAN

Constant for boolean argument. Used by generated code, do not remove.

CHAR

static final Argument<Character> CHAR

Constant char argument. Used by generated code, do not remove.

SHORT

static final Argument<Short> SHORT

Constant short argument. Used by generated code, do not remove.

ZERO_ARGUMENTS

static final Argument[] ZERO_ARGUMENTS

Constant representing zero arguments. Used by generated code, do not remove.

OBJECT_ARGUMENT

static final Argument<Object> OBJECT_ARGUMENT

Default Object argument. Used by generated code, do not remove.

LIST_OF_STRING

static final Argument<List<String>> LIST_OF_STRING

Constant for List<String> argument.

VOID_OBJECT

static final Argument<Void> VOID_OBJECT

Constant for Void object argument.

Method Details

getName

String getName()

Specified by:

getName in interface Named

Returns:

The name of argument

equalsType

boolean equalsType(@Nullable Argument<?> other)

Whether the types are equivalent. The regular Object.equals(Object) implementation includes the argument name within the comparison so this method offers a variation that just compares types.

Parameters:

other - The type

Returns:

True if they are equal

typeHashCode

int typeHashCode()

The hash code including only the types. The regular Object.hashCode() implementation includes the argument name within the comparison so this method offers a variation that just compares types.

Returns:

The type hash code

isTypeVariable

default boolean isTypeVariable()

Whether this argument is a type variable used in generics.

Returns:

True if it is a variable

Since:

3.0.0

isInstance

default boolean isInstance(@Nullable Object o)

Whether the given argument is an instance.

Parameters:

o - The object

Returns:

True if it is an instance of this type

isAssignableFrom

default boolean isAssignableFrom(Class<?> candidateType)

Delegates to Class.isAssignableFrom(Class) for this argument.

Parameters:

candidateType - The candidate type

Returns:

True if it is assignable from.

Since:

3.0.0

isAssignableFrom

default boolean isAssignableFrom(Argument<?> candidateArgument)

Checks if the argument can be assigned to this argument.

Parameters:

candidateArgument - The candidate argument

Returns:

True if it is assignable from.

Since:

3.0.0

withName

default Argument<T> withName(@Nullable String name)

Creates a copy of this argument with a different name.

Parameters:

name - The new name

Returns:

A new argument

Since:

4.6

withAnnotationMetadata

default Argument<T> withAnnotationMetadata(AnnotationMetadata annotationMetadata)

Creates a copy of this argument with a different annotation metadata.

Parameters:

annotationMetadata - The annotation metadata

Returns:

A new argument

Since:

4.6

toClassArray

static Class<?>[] toClassArray(Argument<?> @Nullable ... arguments)

Convert an argument array to a class array.

Parameters:

arguments - The arguments

Returns:

The class array

toString

static String toString(Argument<?> @Nullable ... arguments)

Convert the arguments to a string representation.

Parameters:

arguments - The arguments

Returns:

The String representation

of

static <T> Argument<T> of(Class<T> type,
 @Nullable String name,
 Argument<?> @Nullable ... typeParameters)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

name - The name

typeParameters - the type parameters

Returns:

The argument instance

ofTypeVariable

static <T> Argument<T> ofTypeVariable(Class<T> type,
 @Nullable String name,
 @Nullable AnnotationMetadata annotationMetadata,
 @Nullable Argument<?>... typeParameters)

Creates a new argument for the given type and name that is a type variable.

Type Parameters:

T - The generic type

Parameters:

type - The type

name - The name

annotationMetadata - The annotation metadata

typeParameters - the type parameters

Returns:

The argument instance

Since:

3.0.0

ofTypeVariable

static <T> Argument<T> ofTypeVariable(Class<T> type,
 @Nullable String argumentName,
 String variableName,
 @Nullable AnnotationMetadata annotationMetadata,
 @Nullable Argument<?>... typeParameters)

Creates a new argument for the given type and name that is a type variable.

Type Parameters:

T - The generic type

Parameters:

type - The type

argumentName - The name of the argumennt

variableName - The variable name

annotationMetadata - The annotation metadata

typeParameters - the type parameters

Returns:

The argument instance

Since:

3.2.0

ofTypeVariable

static <T> Argument<T> ofTypeVariable(Class<T> type,
 @Nullable String name)

Creates a new argument for the given type and name that is a type variable.

Type Parameters:

T - The generic type

Parameters:

type - The type

name - The name

Returns:

The argument instance

Since:

3.0.0

ofTypeVariable

static <T> Argument<T> ofTypeVariable(Class<T> type,
 @Nullable String argumentName,
 String variableName)

Creates a new argument for the given type and name that is a type variable.

Type Parameters:

T - The generic type

Parameters:

type - The type

argumentName - The name of the argument

variableName - The variable name

Returns:

The argument instance

Since:

3.2.0

of

static <T> Argument<T> of(Class<T> type,
 @Nullable String name,
 @Nullable AnnotationMetadata annotationMetadata,
 @Nullable Argument<?>... typeParameters)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

name - The name

annotationMetadata - the annotation metadata

typeParameters - the type parameters

Returns:

The argument instance

of

static <T> Argument<T> of(Class<T> type,
 @Nullable AnnotationMetadata annotationMetadata,
 @Nullable Argument<?>... typeParameters)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

annotationMetadata - the annotation metadata

typeParameters - the type parameters

Returns:

The argument instance

of

static <T> Argument<T> of(Class<T> type,
 @Nullable String name)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

name - The name

Returns:

The argument instance

of

static <T> Argument<T> of(Class<T> type,
 @Nullable Argument<?>... typeParameters)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

typeParameters - The parameters type

Returns:

The argument instance

of

static Argument<?> of(Type type)

Allows coercing a Type instance to an Argument.

Parameters:

type - The type

Returns:

The argument

Throws:

IllegalArgumentException - If the type cannot be coerced

Since:

3.0.0

of

static <T> Argument<T> of(Class<T> type)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

Returns:

The argument instance

ofInstance

static <T> Argument<T> ofInstance(T instance)

Creates a new argument for the type of the given instance.

Type Parameters:

T - The generic type

Parameters:

instance - The argument instance

Returns:

The argument instance

Since:

4.6

of

static <T> Argument<T> of(Class<T> type,
 @Nullable Class<?>... typeParameters)

Creates a new argument for the given type and name.

Type Parameters:

T - The generic type

Parameters:

type - The type

typeParameters - the parameters type

Returns:

The argument instance

of

static <T> Argument<T> of(Class<T> type,
 @Nullable AnnotationMetadata annotationMetadata,
 Class<?> @Nullable [] typeParameters)

Creates a new argument for the given type and name. NOTE: This method should be avoided as it does use the reflection to retrieve the type parameter names.

Type Parameters:

T - The generic type

Parameters:

type - The type

annotationMetadata - The annotation metadata

typeParameters - The parameters type

Returns:

The argument instance

Since:

3.0.0

listOf

static <T> Argument<List<T>> listOf(Class<T> type)

Creates a new argument representing a generic list.

Type Parameters:

T - list element type

Parameters:

type - list element type

Returns:

The argument instance

listOf

static <T> Argument<List<T>> listOf(Argument<T> type)

Creates a new argument representing a generic list.

Type Parameters:

T - list element type

Parameters:

type - list element type

Returns:

The argument instance

Since:

2.0.1

setOf

static <T> Argument<Set<T>> setOf(Class<T> type)

Creates a new argument representing a generic set.

Type Parameters:

T - set element type

Parameters:

type - set element type

Returns:

The argument instance

setOf

static <T> Argument<Set<T>> setOf(Argument<T> type)

Creates a new argument representing a generic set.

Type Parameters:

T - set element type

Parameters:

type - set element type

Returns:

The argument instance

Since:

2.0.1

mapOf

static <K,V> Argument<Map<K,V>> mapOf(Class<K> keyType,
 Class<V> valueType)

Creates a new argument representing a generic map.

Type Parameters:

K - The map key type

V - The map value type

Parameters:

keyType - The key type

valueType - The value type

Returns:

The argument instance

mapOf

static <K,V> Argument<Map<K,V>> mapOf(Argument<K> keyType,
 Argument<V> valueType)

Creates a new argument representing a generic map.

Type Parameters:

K - The map key type

V - The map value type

Parameters:

keyType - The key type

valueType - The value type

Returns:

The argument instance

Since:

2.0.1

optionalOf

static <T> Argument<Optional<T>> optionalOf(Class<T> optionalValueClass)

Creates a new argument representing an optional.

Type Parameters:

T - The optional type

Parameters:

optionalValueClass - The optional type

Returns:

The argument instance

Since:

4.0.0

optionalOf

static <T> Argument<Optional<T>> optionalOf(Argument<T> optionalValueArgument)

Creates a new argument representing an optional.

Type Parameters:

T - The optional type

Parameters:

optionalValueArgument - The optional type

Returns:

The argument instance

Since:

4.0.0