io.github.classgraph

Class AnnotationInfo

java.lang.Object

io.github.classgraph.AnnotationInfo

All Implemented Interfaces:

HasName, Comparable<AnnotationInfo>

public class AnnotationInfo
extends Object
implements Comparable<AnnotationInfo>, HasName

Holds metadata about a specific annotation instance on a class, method, method parameter or field.

Method Summary

Modifier and Type	Method and Description
int	compareTo(AnnotationInfo o)
boolean	equals(Object obj)
ClassInfo	getClassInfo() Return the ClassInfo object for the annotation class.
AnnotationParameterValueList	getDefaultParameterValues() Get the default parameter values.
String	getName() Get the name.
AnnotationParameterValueList	getParameterValues() Get the parameter values.
AnnotationParameterValueList	getParameterValues(boolean includeDefaultValues) Get the parameter values.
int	hashCode()
boolean	isInherited() Checks if the annotation is inherited.
Annotation	loadClassAndInstantiate() Load the Annotation class corresponding to this AnnotationInfo object, by calling getClassInfo().loadClass(), then create a new instance of the annotation, with the annotation parameter values obtained from this AnnotationInfo object, possibly overriding default annotation parameter values obtained from calling getClassInfo() then ClassInfo.getAnnotationDefaultParameterValues().
String	toString() Render to string.
String	toStringWithSimpleNames() Render to string, using only simple names for classes.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Detail

getName

public String getName()

Get the name.

Specified by:

getName in interface HasName

Returns:

The name of the annotation class.

isInherited

public boolean isInherited()

Checks if the annotation is inherited.

Returns:

true if this annotation is meta-annotated with Inherited.

getDefaultParameterValues

public AnnotationParameterValueList getDefaultParameterValues()

Get the default parameter values.

Returns:

the list of default parameter values for this annotation, or the empty list if none.

getParameterValues

public AnnotationParameterValueList getParameterValues(boolean includeDefaultValues)

Get the parameter values.

Parameters:

includeDefaultValues - if true, include default values for any annotation parameter value that is missing.

Returns:

The parameter values of this annotation, including any default parameter values inherited from the annotation class definition (if requested), or the empty list if none.

getParameterValues

public AnnotationParameterValueList getParameterValues()

Get the parameter values.

Returns:

The parameter values of this annotation, including any default parameter values inherited from the annotation class definition, or the empty list if none.

getClassInfo

public ClassInfo getClassInfo()

Return the ClassInfo object for the annotation class.

Returns:

The ClassInfo object for the referenced class.

loadClassAndInstantiate

public Annotation loadClassAndInstantiate()

Load the Annotation class corresponding to this AnnotationInfo object, by calling getClassInfo().loadClass(), then create a new instance of the annotation, with the annotation parameter values obtained from this AnnotationInfo object, possibly overriding default annotation parameter values obtained from calling getClassInfo() then ClassInfo.getAnnotationDefaultParameterValues().

Note that the returned Annotation will have some sort of InvocationHandler proxy type, such as io.github.classgraph.features.$Proxy4 or com.sun.proxy.$Proxy6. This is an unavoidable side effect of the fact that concrete Annotation instances cannot be instantiated directly. (ClassGraph uses the same approach that the JDK uses to instantiate annotations from a map.) However, proxy instances are handled specially when it comes to casting and instanceof: you are able to cast the returned proxy instance to the annotation type, and instanceof checks against the annotation class will succeed.

Of course another option you have for getting the concrete annotations, rather than instantiating the annotations on a ClassInfo object via this method, is to call ClassInfo.loadClass(), and read the annotations directly from the returned Class object.

Returns:

The new Annotation instance, as a dynamic proxy object that can be cast to the expected annotation type.

compareTo

public int compareTo(AnnotationInfo o)

Specified by:

compareTo in interface Comparable<AnnotationInfo>

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toStringWithSimpleNames

public String toStringWithSimpleNames()

Render to string, using only simple names for classes.

Returns:

the string representation, using simple names for classes.

toString

public String toString()

Render to string.

Overrides:

toString in class Object

Returns:

the string representation.