package jakarta.enterprise.lang.model; import jakarta.enterprise.lang.model.declarations.ClassInfo; import jakarta.enterprise.lang.model.types.Type; import java.util.List; /** * The value of an annotation member. Annotation member values are of several kinds: *
* Note that the {@code as*} methods do not perform type conversion, so if this annotation member value * is an {@code int}, calling {@code asLong()} will throw an exception. *
* Implementations of this interface are required to define the {@code equals} and {@code hashCode} methods. * Implementations of this interface are encouraged to define the {@code toString} method such that * it returns a text resembling the corresponding Java™ syntax. *
* There is no guarantee that any particular annotation member, represented by an implementation of this interface,
* will always be represented by the same object. This includes natural singletons such as {@code boolean} values.
* Instances should always be compared using {@code equals}.
*
* @since 4.0
*/
public interface AnnotationMember {
/**
* Name of the commonly used {@code value()} annotation member.
*/
String VALUE = "value";
/**
* The kind of the annotation member value.
*/
enum Kind {
/**
* A primitive {@code boolean} value.
*/
BOOLEAN,
/**
* A primitive {@code byte} value.
*/
BYTE,
/**
* A primitive {@code short} value.
*/
SHORT,
/**
* A primitive {@code int} value.
*/
INT,
/**
* A primitive {@code long} value.
*/
LONG,
/**
* A primitive {@code float} value.
*/
FLOAT,
/**
* A primitive {@code double} value.
*/
DOUBLE,
/**
* A primitive {@code char} value.
*/
CHAR,
/**
* A {@link String} value.
*/
STRING,
/**
* An {@link Enum} value.
*/
ENUM,
/**
* A {@link Class} value. Represented as {@link Type}.
*/
CLASS,
/**
* A nested {@link java.lang.annotation.Annotation Annotation} value.
* Represented as {@link AnnotationInfo}.
*/
NESTED_ANNOTATION,
/**
* An array value.
*/
ARRAY,
}
/**
* Returns the kind of this annotation member value.
*
* @return the kind of this annotation member value, never {@code null}
*/
Kind kind();
/**
* @return {@code true} if the kind is a {@code boolean}, {@code false} otherwise
*/
default boolean isBoolean() {
return kind() == Kind.BOOLEAN;
}
/**
* @return {@code true} if the kind is a {@code byte}, {@code false} otherwise
*/
default boolean isByte() {
return kind() == Kind.BYTE;
}
/**
* @return {@code true} if the kind is a {@code short}, {@code false} otherwise
*/
default boolean isShort() {
return kind() == Kind.SHORT;
}
/**
* @return {@code true} if the kind is an {@code int}, {@code false} otherwise
*/
default boolean isInt() {
return kind() == Kind.INT;
}
/**
* @return {@code true} if the kind is a {@code long}, {@code false} otherwise
*/
default boolean isLong() {
return kind() == Kind.LONG;
}
/**
* @return {@code true} if the kind is a {@code float}, {@code false} otherwise
*/
default boolean isFloat() {
return kind() == Kind.FLOAT;
}
/**
* @return {@code true} if the kind is a {@code double}, {@code false} otherwise
*/
default boolean isDouble() {
return kind() == Kind.DOUBLE;
}
/**
* @return {@code true} if the kind is a {@code char}, {@code false} otherwise
*/
default boolean isChar() {
return kind() == Kind.CHAR;
}
/**
* @return {@code true} if the kind is a {@link String}, {@code false} otherwise
*/
default boolean isString() {
return kind() == Kind.STRING;
}
/**
* @return {@code true} if the kind is an {@link Enum}, {@code false} otherwise
*/
default boolean isEnum() {
return kind() == Kind.ENUM;
}
/**
* @return {@code true} if the kind is a {@link Class}, {@code false} otherwise
*/
default boolean isClass() {
return kind() == Kind.CLASS;
}
/**
* @return {@code true} if the kind is a nested {@link java.lang.annotation.Annotation Annotation}, {@code false} otherwise
*/
default boolean isNestedAnnotation() {
return kind() == Kind.NESTED_ANNOTATION;
}
/**
* @return {@code true} if the kind is an array, {@code false} otherwise
*/
default boolean isArray() {
return kind() == Kind.ARRAY;
}
/**
* Returns this value as a {@code boolean}.
*
* @return the boolean value
* @throws IllegalStateException if this annotation member value is not a {@code boolean}
*/
boolean asBoolean();
/**
* Returns this value as a {@code byte}.
*
* @return the byte value
* @throws IllegalStateException if this annotation member value is not a {@code byte}
*/
byte asByte();
/**
* Returns this value as a {@code short}.
*
* @return the short value
* @throws IllegalStateException if this annotation member value is not a {@code short}
*/
short asShort();
/**
* Returns this value as an {@code int}.
*
* @return the int value
* @throws IllegalStateException if this annotation member value is not an {@code int}
*/
int asInt();
/**
* Returns this value as a {@code long}.
*
* @return the long value
* @throws IllegalStateException if this annotation member value is not a {@code long}
*/
long asLong();
/**
* Returns this value as a {@code float}.
*
* @return the float value
* @throws IllegalStateException if this annotation member value is not a {@code float}
*/
float asFloat();
/**
* Returns this value as a {@code double}.
*
* @return the double value
* @throws IllegalStateException if this annotation member value is not a {@code double}
*/
double asDouble();
/**
* Returns this value as a {@code char}.
*
* @return the char value
* @throws IllegalStateException if this annotation member value is not a {@code char}
*/
char asChar();
/**
* Returns this value as a {@code String}.
*
* @return the String value
* @throws IllegalStateException if this annotation member value is not a {@code String}
*/
String asString();
/**
* Returns this enum value as an instance of the enum type.
*
* @param enumType the enum type
* @param
*
*
* @return the class value, as a {@link Type}
* @throws IllegalStateException if this annotation member value is not a class value
*/
Type asType();
/**
* Returns this nested annotation value as an {@link AnnotationInfo}.
*
* @return an {@link AnnotationInfo} instance
* @throws IllegalStateException if this annotation member value is not a nested annotation
*/
AnnotationInfo asNestedAnnotation();
/**
* Returns this array value as an immutable {@link List} of {@link AnnotationMember}s.
* Returns an empty list if the array is empty.
*
* @return an immutable list of {@link AnnotationMember}s
* @throws IllegalStateException if this annotation member value is not an array
*/
List