libcore.reflect

Class AnnotationFactory

java.lang.Object

libcore.reflect.AnnotationFactory

All Implemented Interfaces:

Serializable, InvocationHandler

public final class AnnotationFactory
extends Object
implements InvocationHandler, Serializable

The annotation implementation based on dynamically generated proxy instances. It conforms to all requirements stated in public APIs, see in particular java.lang.reflect.AnnotatedElement and java.lang.annotation.Annotation. Namely, annotation instances are immutable and serializable; they provide conforming access to annotation member values and required implementations of methods declared in Annotation interface.

See Also:

AnnotationMember, Annotation, Serialized Form

Method Summary

Modifier and Type	Method and Description
static <A extends Annotation> A	createAnnotation(Class<? extends Annotation> annotationType, AnnotationMember[] elements) Provides a new annotation instance.
boolean	equals(Object obj) Returns true if the specified object represents the same annotation instance.
static AnnotationMember[]	getElementsDescription(Class<? extends Annotation> annotationType) Reflects specified annotation type and returns an array of member element definitions with default values.
int	hashCode() Returns a hash code composed as a sum of hash codes of member elements, including elements with default values.
Object	invoke(Object proxy, Method method, Object[] args) Processes a method invocation request to this annotation instance.
String	toString() Provides detailed description of this annotation instance, including all member name-values pairs.

Methods inherited from class java.lang.Object

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

Method Detail

getElementsDescription

public static AnnotationMember[] getElementsDescription(Class<? extends Annotation> annotationType)

Reflects specified annotation type and returns an array of member element definitions with default values.

createAnnotation

public static <A extends Annotation> A createAnnotation(Class<? extends Annotation> annotationType,
                                                        AnnotationMember[] elements)

Provides a new annotation instance.

Parameters:

annotationType - the annotation type definition

elements - name-value pairs representing elements of the annotation

Returns:

a new annotation instance

equals

public boolean equals(Object obj)

Returns true if the specified object represents the same annotation instance. That is, if it implements the same annotation type and returns the same element values.
Note, actual underlying implementation mechanism does not matter - it may differ completely from this class.

Overrides:

equals in class Object

Parameters:

obj - the object to compare this instance with.

Returns:

true if the passed object is equivalent annotation instance, false otherwise.

See Also:

AnnotationMember.equals(Object)

hashCode

public int hashCode()

Returns a hash code composed as a sum of hash codes of member elements, including elements with default values.

Overrides:

hashCode in class Object

Returns:

this object's hash code.

See Also:

AnnotationMember.hashCode()

toString

public String toString()

Provides detailed description of this annotation instance, including all member name-values pairs.

Overrides:

toString in class Object

Returns:

string representation of this annotation

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable

Processes a method invocation request to this annotation instance. Recognizes the methods declared in the java.lang.annotation.Annotation interface, and member-defining methods of the implemented annotation type.

Specified by:

invoke in interface InvocationHandler

Parameters:

proxy - the proxy instance on which the method was invoked

method - the method invoked on the proxy instance

args - an array of objects containing the parameters passed to the method, or null if no arguments are expected. Primitive types are boxed.

Returns:

the invocation result

Throws:

IllegalArgumentException - If the specified method is none of the above

Throwable - the exception to throw from the invoked method on the proxy. The exception must match one of the declared exception types of the invoked method or any unchecked exception type. If not then an UndeclaredThrowableException is thrown