Package io.micronaut.core.annotation

Class AnnotationValue<A extends Annotation>

java.lang.Object

io.micronaut.core.annotation.AnnotationValue<A>

Type Parameters:

A - The annotation type

All Implemented Interfaces:

AnnotationValueResolver, ValueResolver<CharSequence>

Direct Known Subclasses:

EvaluatedAnnotationValue

public class AnnotationValue<A extends Annotation>
extends Object
implements AnnotationValueResolver

A runtime representation of the annotation and its values.

This class implements the AnnotationValueResolver interface and methods such as ValueResolver.get(CharSequence, Class) can be used to retrieve the values of annotation members.

If a member is not present then the methods of the class will attempt to resolve the default value for a given annotation member. In this sense the behaviour of this class is similar to how a implementation of Annotation behaves.

NOTE: During the mapping or remapping, nullable stereotypes value means that the stereotypes will be filled from the annotation definition, when empty collection will skip it.

Since:

1.0

Author:

Graeme Rocher

Constructor Summary

Constructors

Constructor	Description
AnnotationValue(AnnotationValue<A> target, Map<CharSequence,Object> defaultValues, ConvertibleValues<Object> convertibleValues, Function<Object,Object> valueMapper)
AnnotationValue(String annotationName)
AnnotationValue(String annotationName, ConvertibleValues<Object> convertibleValues)
AnnotationValue(String annotationName, Map<CharSequence,Object> values)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, AnnotationDefaultValuesProvider defaultValuesProvider)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, RetentionPolicy retentionPolicy)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, RetentionPolicy retentionPolicy, List<AnnotationValue<?>> stereotypes)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, Map<CharSequence,Object> defaultValues)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, Map<CharSequence,Object> defaultValues, RetentionPolicy retentionPolicy)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, Map<CharSequence,Object> defaultValues, RetentionPolicy retentionPolicy, List<AnnotationValue<?>> stereotypes)
AnnotationValue(String annotationName, Map<CharSequence,Object> values, Map<CharSequence,Object> defaultValues, RetentionPolicy retentionPolicy, List<AnnotationValue<?>> stereotypes, AnnotationDefaultValuesProvider defaultValuesProvider)

Method Summary

Modifier and Type	Method	Description
Optional<AnnotationClassValue<?>>	annotationClassValue(@NonNull String member)	The AnnotationClassValue instance for the given member.
@NonNull AnnotationClassValue<?>[]	annotationClassValues(@NonNull String member)	The AnnotationClassValue instances for the given member.
Optional<Boolean>	booleanValue(@NonNull String member)	The boolean value of the given member.
Optional<Boolean>	booleanValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The boolean value of the given member.
boolean[]	booleanValues(String member)	The boolean[] value for the given member.
static <T extends Annotation> AnnotationValueBuilder<T>	builder(@NonNull AnnotationValue<T> annotation)	Start building a new annotation existing value.
static <T extends Annotation> AnnotationValueBuilder<T>	builder(@NonNull AnnotationValue<T> annotation, @Nullable RetentionPolicy retentionPolicy)	Start building a new annotation existing value and retention policy.
static <T extends Annotation> AnnotationValueBuilder<T>	builder(Class<T> annotation)	Start building a new annotation for the given name.
static <T extends Annotation> AnnotationValueBuilder<T>	builder(String annotationName)	Start building a new annotation for the given name.
static <T extends Annotation> AnnotationValueBuilder<T>	builder(String annotationName, RetentionPolicy retentionPolicy)	Start building a new annotation for the given name.
Optional<Byte>	byteValue(String member)	The byte value of the given member.
byte[]	byteValues(String member)	The byte[] value for the given member.
Optional<Character>	charValue(String member)	The char value of the given member.
char[]	charValues(String member)	The char[] value for the given member.
@NonNull Optional<Class<?>>	classValue()	The value of the annotation as a Class.
Optional<Class<?>>	classValue(@NonNull String member)	The value of the given annotation member as a Class.
<T> Optional<Class<? extends T>>	classValue(@NonNull String member, @NonNull Class<T> requiredType)	The value of the given annotation member as a Class.
Optional<Class<?>>	classValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The value of the given annotation member as a Class.
Class<?>[]	classValues(@NonNull String member)	The value of the given annotation member as a Class.
final boolean	contains(String member)	Whether a particular member is present.
OptionalDouble	doubleValue()	The double value of the given member.
OptionalDouble	doubleValue(@NonNull String member)	The double value of the given member.
OptionalDouble	doubleValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The double value of the given member.
double[]	doubleValues(String member)	The double[] value for the given member.
<E extends Enum> Optional<E>	enumValue(@NonNull String member, @NonNull Class<E> enumType)	Return the enum value of the given member of the given enum type.
<E extends Enum> Optional<E>	enumValue(@NonNull String member, @NonNull Class<E> enumType, Function<Object,Object> valueMapper)	Return the enum value of the given member of the given enum type.
<E extends Enum> E[]	enumValues(@NonNull String member, @NonNull Class<E> enumType)	Return the enum values of the given member of the given enum type.
boolean	equals(Object obj)
Optional<Float>	floatValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The double value of the given member.
Optional<Float>	floatValue(String member)	The double value of the given member.
float[]	floatValues(String member)	The float[] value for the given member.
<T> Optional<T>	get(CharSequence member, ArgumentConversionContext<T> conversionContext)	Resolve the given property for the given name.
<T extends Annotation> @NonNull Optional<AnnotationValue<T>>	getAnnotation(@NonNull String member)	Gets a list of AnnotationValue for the given member.
<T extends Annotation> @NonNull Optional<AnnotationValue<T>>	getAnnotation(String member, Class<T> type)	Gets a list of AnnotationValue for the given member.
final @NonNull String	getAnnotationName()	The annotation name.
<T extends Annotation> @NonNull List<AnnotationValue<T>>	getAnnotations(String member)	Gets a list of AnnotationValue for the given member.
<T extends Annotation> @NonNull List<AnnotationValue<T>>	getAnnotations(String member, Class<T> type)	Gets a list of AnnotationValue for the given member.
@NonNull ConvertibleValues<Object>	getConvertibleValues()
@Nullable Map<CharSequence,Object>	getDefaultValues()	The default values.
final @NonNull Set<CharSequence>	getMemberNames()	Resolves the names of all the present annotation members.
@NonNull Map<String,String>	getProperties(@NonNull String member)	Resolves a map of properties for a member that is an array of annotations that have members called "name" or "key" to represent the key and "value" to represent the value.
Map<String,String>	getProperties(@NonNull String member, String keyMember)	Resolve properties with a custom key member.
final <T> T	getRequiredValue(Class<T> type)	Get the value of the value member of the annotation.
final <T> T	getRequiredValue(String member, Class<T> type)	Get the value of the value member of the annotation.
final @NonNull RetentionPolicy	getRetentionPolicy()
@Nullable List<AnnotationValue<?>>	getStereotypes()
<T> Optional<T>	getValue(ArgumentConversionContext<T> conversionContext)	Get the value of the value member of the annotation.
final <T> Optional<T>	getValue(Argument<T> argument)	Get the value of the value member of the annotation.
final <T> Optional<T>	getValue(Class<T> type)	Get the value of the value member of the annotation.
protected @Nullable Function<Object,Object>	getValueMapper()
@NonNull Map<CharSequence,Object>	getValues()
boolean	hasEvaluatedExpressions()	If this AnnotationValue contains Evaluated Expressions.
int	hashCode()
OptionalInt	intValue()	The integer value of the given member.
OptionalInt	intValue(@NonNull String member)	The integer value of the given member.
OptionalInt	intValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The integer value of the given member.
int[]	intValues(String member)	The int[] value for the given member.
boolean	isFalse()
boolean	isFalse(String member)
final boolean	isPresent(CharSequence member)	Is the given member present.
boolean	isTrue()
boolean	isTrue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)
boolean	isTrue(String member)
OptionalLong	longValue(@NonNull String member)	The long value of the given member.
OptionalLong	longValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The long value of the given member.
long[]	longValues(String member)	The long[] value for the given member.
AnnotationValueBuilder<A>	mutate()	Creates a builder with the initial value of this annotation.
static @Nullable Class<?>[]	resolveClassValues(@Nullable Object value)	The class values for the given value.
static <E extends Enum> @NonNull E[]	resolveEnumValues(@NonNull Class<E> enumType, @Nullable Object rawValue)	The enum values for the given enum type and raw value.
static String[]	resolveStringArray(String[] strs, @Nullable Function<Object,Object> valueMapper)	The string[] values for the given value.
static @Nullable String[]	resolveStringValues(@Nullable Object value, @Nullable Function<Object,Object> valueMapper)	The string values for the given value.
Optional<Short>	shortValue(@NonNull String member)	The short value of the given member.
Optional<Short>	shortValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The short value of the given member.
short[]	shortValues(String member)	The short[] value for the given member.
Optional<String>	stringValue()	The double value of the given member.
Optional<String>	stringValue(@NonNull String member)	The string value of the given member.
Optional<String>	stringValue(@NonNull String member, @Nullable Function<Object,Object> valueMapper)	The string value of the given member.
@NonNull String[]	stringValues(@NonNull String member)	The string values for the given member.
String[]	stringValues(@NonNull String member, Function<Object,Object> valueMapper)	The string values for the given member and mapper.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.micronaut.core.annotation.AnnotationValueResolver

booleanValue, booleanValues, byteValue, byteValues, charValue, charValues, classValues, doubleValues, enumValue, enumValues, enumValuesSet, floatValue, floatValues, intValues, longValue, longValues, shortValue, shortValues, stringValues

Methods inherited from interface io.micronaut.core.value.ValueResolver

get, get, get

Constructor Details

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values)

Parameters:

annotationName - The annotation name

values - The values

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 RetentionPolicy retentionPolicy)

Parameters:

annotationName - The annotation name

values - The values

retentionPolicy - The retention policy

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 RetentionPolicy retentionPolicy,
 List<AnnotationValue<?>> stereotypes)

Parameters:

annotationName - The annotation name

values - The values

retentionPolicy - The retention policy

stereotypes - The stereotypes of the annotation

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 Map<CharSequence,Object> defaultValues)

Parameters:

annotationName - The annotation name

values - The values

defaultValues - The default values

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 AnnotationDefaultValuesProvider defaultValuesProvider)

Parameters:

annotationName - The annotation name

values - The values

defaultValuesProvider - The default values provider

Since:

4.2.0

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 Map<CharSequence,Object> defaultValues,
 RetentionPolicy retentionPolicy)

Parameters:

annotationName - The annotation name

values - The values

defaultValues - The default values

retentionPolicy - The retention policy

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 Map<CharSequence,Object> defaultValues,
 RetentionPolicy retentionPolicy,
 List<AnnotationValue<?>> stereotypes)

Parameters:

annotationName - The annotation name

values - The values

defaultValues - The default values

retentionPolicy - The retention policy

stereotypes - The stereotypes of the annotation

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 Map<CharSequence,Object> values,
 Map<CharSequence,Object> defaultValues,
 RetentionPolicy retentionPolicy,
 List<AnnotationValue<?>> stereotypes,
 AnnotationDefaultValuesProvider defaultValuesProvider)

Parameters:

annotationName - The annotation name

values - The values

defaultValues - The default values

retentionPolicy - The retention policy

stereotypes - The stereotypes of the annotation

defaultValuesProvider - The defaults values provider

AnnotationValue

@Internal
public AnnotationValue(String annotationName)

Parameters:

annotationName - The annotation name

AnnotationValue

@Internal
public AnnotationValue(String annotationName,
 ConvertibleValues<Object> convertibleValues)

Parameters:

annotationName - The annotation name

convertibleValues - The convertible values

AnnotationValue

@Internal
public AnnotationValue(AnnotationValue<A> target,
 Map<CharSequence,Object> defaultValues,
 ConvertibleValues<Object> convertibleValues,
 Function<Object,Object> valueMapper)

Parameters:

target - The target

defaultValues - The default values

convertibleValues - The convertible values

valueMapper - The value mapper

Method Details

getValueMapper

@Nullable
protected @Nullable Function<Object,Object> getValueMapper()

Returns:

The value mapper.

Since:

4.0.2

mutate

public AnnotationValueBuilder<A> mutate()

Creates a builder with the initial value of this annotation.

Returns:

The builder with this annotation value

Since:

4.0.0

getRetentionPolicy

@NonNull
public final @NonNull RetentionPolicy getRetentionPolicy()

Returns:

The retention policy.

getStereotypes

@Nullable
public @Nullable List<AnnotationValue<?>> getStereotypes()

Returns:

The stereotypes of the annotation

getDefaultValues

@Nullable
public @Nullable Map<CharSequence,Object> getDefaultValues()

The default values.

Returns:

The default of the annotation or null if not specified.

Since:

4.0.0

getProperties

@NonNull
public @NonNull Map<String,String> getProperties(@NonNull
 @NonNull String member)

Resolves a map of properties for a member that is an array of annotations that have members called "name" or "key" to represent the key and "value" to represent the value.

For example consider the following annotation definition:

 @PropertySource({ @Property(name = "one", value = "1"), @Property(name = "two", value = "2")})
 public class MyBean {
        ...
 }

You can use this method to resolve the values of the PropertySource annotation such that the following assertion is true:

 annotationValue.getProperties("value") == [one:1, two:2]
 

Parameters:

member - The member

Returns:

The properties as an immutable map.

getProperties

public Map<String,String> getProperties(@NonNull
 @NonNull String member,
 String keyMember)

Resolve properties with a custom key member.

Parameters:

member - The member to resolve the properties from

keyMember - The member of the sub annotation that represents the key.

Returns:

The properties.

See Also:

• getProperties(String)

enumValue

public <E extends Enum> Optional<E> enumValue(@NonNull
 @NonNull String member,
 @NonNull
 @NonNull Class<E> enumType)

Return the enum value of the given member of the given enum type.

Specified by:

enumValue in interface AnnotationValueResolver

Type Parameters:

E - The enum type

Parameters:

member - The annotation member

enumType - The required type

Returns:

An Optional of the enum value

enumValue

public <E extends Enum> Optional<E> enumValue(@NonNull
 @NonNull String member,
 @NonNull
 @NonNull Class<E> enumType,
 Function<Object,Object> valueMapper)

Return the enum value of the given member of the given enum type.

Type Parameters:

E - The enum type

Parameters:

member - The annotation member

enumType - The required type

valueMapper - The value mapper

Returns:

An Optional of the enum value

enumValues

public <E extends Enum> E[] enumValues(@NonNull
 @NonNull String member,
 @NonNull
 @NonNull Class<E> enumType)

Return the enum values of the given member of the given enum type.

Specified by:

enumValues in interface AnnotationValueResolver

Type Parameters:

E - The enum type

Parameters:

member - The annotation member

enumType - The required type

Returns:

An array of enum values

classValue

@NonNull
public @NonNull Optional<Class<?>> classValue()

The value of the annotation as a Class.

Specified by:

classValue in interface AnnotationValueResolver

Returns:

An Optional class

classValue

public Optional<Class<?>> classValue(@NonNull
 @NonNull String member)

The value of the given annotation member as a Class.

Specified by:

classValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An Optional class

classValue

public <T> Optional<Class<? extends T>> classValue(@NonNull
 @NonNull String member,
 @NonNull
 @NonNull Class<T> requiredType)

The value of the given annotation member as a Class.

Specified by:

classValue in interface AnnotationValueResolver

Type Parameters:

T - The required type

Parameters:

member - The annotation member

requiredType - The required type

Returns:

An Optional class

classValue

public Optional<Class<?>> classValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The value of the given annotation member as a Class.

Parameters:

member - The annotation member

valueMapper - The raw value mapper

Returns:

An Optional class

stringValues

@NonNull
public @NonNull String[] stringValues(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The string values for the given member.

Specified by:

stringValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of String

booleanValues

public boolean[] booleanValues(String member)

Description copied from interface: AnnotationValueResolver

The boolean[] value for the given member.

Specified by:

booleanValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of boolean

byteValues

public byte[] byteValues(String member)

Description copied from interface: AnnotationValueResolver

The byte[] value for the given member.

Specified by:

byteValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of byte

charValues

public char[] charValues(String member)

Description copied from interface: AnnotationValueResolver

The char[] value for the given member.

Specified by:

charValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of char

intValues

public int[] intValues(String member)

Description copied from interface: AnnotationValueResolver

The int[] value for the given member.

Specified by:

intValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of int

doubleValues

public double[] doubleValues(String member)

Description copied from interface: AnnotationValueResolver

The double[] value for the given member.

Specified by:

doubleValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of double

longValues

public long[] longValues(String member)

Description copied from interface: AnnotationValueResolver

The long[] value for the given member.

Specified by:

longValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of long

floatValues

public float[] floatValues(String member)

Description copied from interface: AnnotationValueResolver

The float[] value for the given member.

Specified by:

floatValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of float

shortValues

public short[] shortValues(String member)

Description copied from interface: AnnotationValueResolver

The short[] value for the given member.

Specified by:

shortValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of short

stringValues

public String[] stringValues(@NonNull
 @NonNull String member,
 Function<Object,Object> valueMapper)

The string values for the given member and mapper.

Parameters:

member - The member

valueMapper - The mapper

Returns:

The string values

classValues

public Class<?>[] classValues(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The value of the given annotation member as a Class.

Specified by:

classValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of classes

annotationClassValues

@NonNull
public @NonNull AnnotationClassValue<?>[] annotationClassValues(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The AnnotationClassValue instances for the given member. Unlike AnnotationValueResolver.classValues(String) this may include classes that are no the classpath.

Specified by:

annotationClassValues in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An array of class values

annotationClassValue

public Optional<AnnotationClassValue<?>> annotationClassValue(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The AnnotationClassValue instance for the given member.

Specified by:

annotationClassValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An annotation class value

intValue

public OptionalInt intValue(@NonNull
 @NonNull String member)

The integer value of the given member.

Specified by:

intValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An OptionalInt

intValue

public OptionalInt intValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The integer value of the given member.

Parameters:

member - The annotation member

valueMapper - The value mapper

Returns:

An OptionalInt

byteValue

public Optional<Byte> byteValue(String member)

Description copied from interface: AnnotationValueResolver

The byte value of the given member.

Specified by:

byteValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An Optional of Byte

charValue

public Optional<Character> charValue(String member)

Description copied from interface: AnnotationValueResolver

The char value of the given member.

Specified by:

charValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An Optional of Character

intValue

public OptionalInt intValue()

The integer value of the given member.

Specified by:

intValue in interface AnnotationValueResolver

Returns:

An OptionalInt

longValue

public OptionalLong longValue(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The long value of the given member.

Specified by:

longValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An OptionalLong

longValue

public OptionalLong longValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The long value of the given member.

Parameters:

member - The annotation member

valueMapper - The value mapper

Returns:

An OptionalLong

shortValue

public Optional<Short> shortValue(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The short value of the given member.

Specified by:

shortValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An Optional of Short

shortValue

public Optional<Short> shortValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The short value of the given member.

Parameters:

member - The annotation member

valueMapper - The value mapper

Returns:

An Optional of Short

booleanValue

public Optional<Boolean> booleanValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The boolean value of the given member.

Parameters:

member - The annotation member

valueMapper - The value mapper

Returns:

An Optional boolean

doubleValue

public OptionalDouble doubleValue(@NonNull
 @NonNull String member)

The double value of the given member.

Specified by:

doubleValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An OptionalDouble

doubleValue

public OptionalDouble doubleValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The double value of the given member.

Parameters:

member - The annotation member

valueMapper - The value mapper

Returns:

An OptionalDouble

floatValue

public Optional<Float> floatValue(String member)

Description copied from interface: AnnotationValueResolver

The double value of the given member.

Specified by:

floatValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An OptionalDouble

floatValue

public Optional<Float> floatValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The double value of the given member.

Parameters:

member - The annotation member

valueMapper - The value mapper

Returns:

An OptionalDouble

doubleValue

public OptionalDouble doubleValue()

The double value of the given member.

Specified by:

doubleValue in interface AnnotationValueResolver

Returns:

An OptionalDouble

stringValue

public Optional<String> stringValue(@NonNull
 @NonNull String member)

The string value of the given member.

Specified by:

stringValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An OptionalInt

stringValue

public Optional<String> stringValue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The string value of the given member.

Parameters:

member - The annotation member

valueMapper - An optional raw value mapper

Returns:

An OptionalInt

stringValue

public Optional<String> stringValue()

The double value of the given member.

Specified by:

stringValue in interface AnnotationValueResolver

Returns:

An OptionalInt

booleanValue

public Optional<Boolean> booleanValue(@NonNull
 @NonNull String member)

Description copied from interface: AnnotationValueResolver

The boolean value of the given member.

Specified by:

booleanValue in interface AnnotationValueResolver

Parameters:

member - The annotation member

Returns:

An Optional boolean

isPresent

public final boolean isPresent(CharSequence member)

Is the given member present.

Specified by:

isPresent in interface AnnotationValueResolver

Parameters:

member - The member

Returns:

True if it is

isTrue

public boolean isTrue()

Specified by:

isTrue in interface AnnotationValueResolver

Returns:

Is the value of the annotation true.

isTrue

public boolean isTrue(String member)

Specified by:

isTrue in interface AnnotationValueResolver

Parameters:

member - The member

Returns:

Is the value of the annotation true.

isTrue

public boolean isTrue(@NonNull
 @NonNull String member,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

Parameters:

member - The member

valueMapper - The value mapper

Returns:

Is the value of the annotation true.

isFalse

public boolean isFalse()

Specified by:

isFalse in interface AnnotationValueResolver

Returns:

Is the value of the annotation true.

isFalse

public boolean isFalse(String member)

Specified by:

isFalse in interface AnnotationValueResolver

Parameters:

member - The member

Returns:

Is the value of the annotation true.

getAnnotationName

@NonNull
public final @NonNull String getAnnotationName()

The annotation name.

Returns:

The annotation name

contains

public final boolean contains(String member)

Whether a particular member is present.

Parameters:

member - The member

Returns:

True if it is

getMemberNames

@NonNull
public final @NonNull Set<CharSequence> getMemberNames()

Resolves the names of all the present annotation members.

Returns:

The names of the members

getValues

@NonNull
public @NonNull Map<CharSequence,Object> getValues()

Specified by:

getValues in interface AnnotationValueResolver

Returns:

The attribute values

getConvertibleValues

@NonNull
public @NonNull ConvertibleValues<Object> getConvertibleValues()

Returns:

The convertible values

get

public <T> Optional<T> get(CharSequence member,
 ArgumentConversionContext<T> conversionContext)

Description copied from interface: ValueResolver

Resolve the given property for the given name.

Specified by:

get in interface ValueResolver<A extends Annotation>

Type Parameters:

T - The concrete type

Parameters:

member - The name

conversionContext - The conversion context

Returns:

An optional containing the property value if it exists and is able to be converted

getValue

public <T> Optional<T> getValue(ArgumentConversionContext<T> conversionContext)

Get the value of the value member of the annotation.

Type Parameters:

T - The type

Parameters:

conversionContext - The conversion context

Returns:

The result

getValue

public final <T> Optional<T> getValue(Argument<T> argument)

Get the value of the value member of the annotation.

Type Parameters:

T - The type

Parameters:

argument - The argument

Returns:

The result

getValue

public final <T> Optional<T> getValue(Class<T> type)

Get the value of the value member of the annotation.

Type Parameters:

T - The type

Parameters:

type - The type

Returns:

The result

getRequiredValue

@NonNull
public final <T> T getRequiredValue(Class<T> type)

Get the value of the value member of the annotation.

Type Parameters:

T - The type

Parameters:

type - The type

Returns:

The result

Throws:

IllegalStateException - If no member is available that conforms to the given type

getRequiredValue

@NonNull
public final <T> T getRequiredValue(String member,
 Class<T> type)

Get the value of the value member of the annotation.

Type Parameters:

T - The type

Parameters:

member - The member

type - The type

Returns:

The result

Throws:

IllegalStateException - If no member is available that conforms to the given name and type

getAnnotations

@NonNull
public <T extends Annotation>
@NonNull List<AnnotationValue<T>> getAnnotations(String member,
 Class<T> type)

Gets a list of AnnotationValue for the given member.

Type Parameters:

T - The type

Parameters:

member - The member

type - The type

Returns:

The result

Throws:

IllegalStateException - If no member is available that conforms to the given name and type

getAnnotations

@NonNull
public <T extends Annotation>
@NonNull List<AnnotationValue<T>> getAnnotations(String member)

Gets a list of AnnotationValue for the given member.

Type Parameters:

T - The type

Parameters:

member - The member

Returns:

The result

Throws:

IllegalStateException - If no member is available that conforms to the given name and type

getAnnotation

@NonNull
public <T extends Annotation>
@NonNull Optional<AnnotationValue<T>> getAnnotation(String member,
 Class<T> type)

Gets a list of AnnotationValue for the given member.

Type Parameters:

T - The type

Parameters:

member - The member

type - The type

Returns:

The result

Throws:

IllegalStateException - If no member is available that conforms to the given name and type

getAnnotation

@NonNull
public <T extends Annotation>
@NonNull Optional<AnnotationValue<T>> getAnnotation(@NonNull
 @NonNull String member)

Gets a list of AnnotationValue for the given member.

Type Parameters:

T - The type

Parameters:

member - The member

Returns:

The result

Throws:

IllegalStateException - If no member is available that conforms to the given name and type

Since:

3.3.0

hasEvaluatedExpressions

public boolean hasEvaluatedExpressions()

If this AnnotationValue contains Evaluated Expressions.

Returns:

true if it is

Since:

4.0.0

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

builder

public static <T extends Annotation>
AnnotationValueBuilder<T> builder(String annotationName)

Start building a new annotation for the given name.

Type Parameters:

T - The annotation type

Parameters:

annotationName - The annotation name

Returns:

The builder

builder

public static <T extends Annotation>
AnnotationValueBuilder<T> builder(String annotationName,
 RetentionPolicy retentionPolicy)

Start building a new annotation for the given name.

Type Parameters:

T - The annotation type

Parameters:

annotationName - The annotation name

retentionPolicy - The retention policy

Returns:

The builder

Since:

2.4.0

builder

public static <T extends Annotation>
AnnotationValueBuilder<T> builder(Class<T> annotation)

Start building a new annotation for the given name.

Type Parameters:

T - The annotation type

Parameters:

annotation - The annotation name

Returns:

The builder

builder

public static <T extends Annotation>
AnnotationValueBuilder<T> builder(@NonNull
 @NonNull AnnotationValue<T> annotation)

Start building a new annotation existing value.

Type Parameters:

T - The annotation type

Parameters:

annotation - The annotation name

Returns:

The builder

Since:

4.0.0

builder

public static <T extends Annotation>
AnnotationValueBuilder<T> builder(@NonNull
 @NonNull AnnotationValue<T> annotation,
 @Nullable
 @Nullable RetentionPolicy retentionPolicy)

Start building a new annotation existing value and retention policy.

Type Parameters:

T - The annotation type

Parameters:

annotation - The annotation name

retentionPolicy - The retention policy. Defaults to runtime.

Returns:

The builder

resolveStringValues

@Internal
@Nullable
public static @Nullable String[] resolveStringValues(@Nullable
 @Nullable Object value,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The string values for the given value.

Parameters:

value - The value

valueMapper - The value mapper

Returns:

The string[] or null

resolveEnumValues

@Internal
@NonNull
public static <E extends Enum> @NonNull E[] resolveEnumValues(@NonNull
 @NonNull Class<E> enumType,
 @Nullable
 @Nullable Object rawValue)

The enum values for the given enum type and raw value.

Type Parameters:

E - The enum generic type

Parameters:

enumType - The enum type

rawValue - The raw value

Returns:

An array of enum values

resolveStringArray

@Internal
public static String[] resolveStringArray(String[] strs,
 @Nullable
 @Nullable Function<Object,Object> valueMapper)

The string[] values for the given value.

Parameters:

strs - The strings

valueMapper - The value mapper

Returns:

The string[] or the original string

resolveClassValues

@Internal
@Nullable
public static @Nullable Class<?>[] resolveClassValues(@Nullable
 @Nullable Object value)

The class values for the given value.

Parameters:

value - The value

Returns:

The class values or null