org.jikesrvm.classloader

Class RVMAnnotation

java.lang.Object

org.jikesrvm.classloader.RVMAnnotation

public final class RVMAnnotation
extends Object

Internal representation of an annotation. We use a proxy class to implement actual annotations RVMClass.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	RVMAnnotation.AnnotationFactory Class used to implement annotations as proxies
private static class	RVMAnnotation.AnnotationMember A class to decode and hold the name and its associated value for an annotation member

Field Summary

Fields

Modifier and Type	Field and Description
private RVMAnnotation.AnnotationMember[]	elementValuePairs Members of this annotation
private static Object	NO_VALUE Encoding of when a result cannot be returned
private TypeReference	type The type of the annotation.
private static ImmutableEntryHashMapRVM<RVMAnnotation,RVMAnnotation>	uniqueMap Remembered unique annotations
private Annotation	value The concrete annotation represented by this RVMAnnotation

Constructor Summary

Constructors

Modifier	Constructor and Description
private	RVMAnnotation(TypeReference type, RVMAnnotation.AnnotationMember[] elementValuePairs) Construct a read annotation

Method Summary

Modifier and Type	Method and Description
private boolean	annotationEquals(Annotation a, Annotation b)
private int	annotationHashCode()
(package private) TypeReference	annotationType() Return the TypeReference of the declared annotation, ie an interface and not the class object of this instance
private Annotation	createValue() Create an instance of this type of annotation with the values given in the members
private String	elementString(String name, Object value)
boolean	equals(Object o)
(package private) static Object	firstUse(Object value)
private Object	getElementValue(String name, Class<?> valueType)
(package private) Annotation	getValue() Return the annotation represented by this RVMAnnotation.
int	hashCode()
(package private) static RVMAnnotation	readAnnotation(int[] constantPool, DataInputStream input, ClassLoader classLoader)
(package private) static <T> Object	readValue(TypeReference type, int[] constantPool, DataInputStream input, ClassLoader classLoader)
private static <T> Object	readValue(TypeReference type, int[] constantPool, DataInputStream input, ClassLoader classLoader, byte elementValue_tag)
String	toString()
private static String	toStringHelper(Object value)

Methods inherited from class java.lang.Object

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

Field Detail

type

private final TypeReference type

The type of the annotation. This is an interface name that the annotation value will implement

elementValuePairs

private final RVMAnnotation.AnnotationMember[] elementValuePairs

Members of this annotation

uniqueMap

private static final ImmutableEntryHashMapRVM<RVMAnnotation,RVMAnnotation> uniqueMap

Remembered unique annotations

value

private Annotation value

The concrete annotation represented by this RVMAnnotation

NO_VALUE

private static final Object NO_VALUE

Encoding of when a result cannot be returned

Constructor Detail

RVMAnnotation

private RVMAnnotation(TypeReference type,
                      RVMAnnotation.AnnotationMember[] elementValuePairs)

Construct a read annotation

Parameters:

type - the name of the type this annotation's value will implement

elementValuePairs - values for the fields in the annotation that override the defaults

Method Detail

readAnnotation

static RVMAnnotation readAnnotation(int[] constantPool,
                                    DataInputStream input,
                                    ClassLoader classLoader)
                             throws IOException,
                                    ClassNotFoundException

Throws:

IOException

ClassNotFoundException

getValue

Annotation getValue()

Return the annotation represented by this RVMAnnotation. If this is the first time this annotation has been accessed the subclass of annotation this class represents needs creating.

Returns:

the annotation represented

createValue

private Annotation createValue()

Create an instance of this type of annotation with the values given in the members

Returns:

the created annotation

readValue

static <T> Object readValue(TypeReference type,
                            int[] constantPool,
                            DataInputStream input,
                            ClassLoader classLoader)
                     throws IOException,
                            ClassNotFoundException

Throws:

IOException

ClassNotFoundException

readValue

private static <T> Object readValue(TypeReference type,
                                    int[] constantPool,
                                    DataInputStream input,
                                    ClassLoader classLoader,
                                    byte elementValue_tag)
                             throws IOException,
                                    ClassNotFoundException

Throws:

IOException

ClassNotFoundException

firstUse

static Object firstUse(Object value)

annotationType

TypeReference annotationType()

Return the TypeReference of the declared annotation, ie an interface and not the class object of this instance

Returns:

TypeReferernce of interface annotation object implements

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

Returns:

a string representation of the annotation of the form "@type(name1=val1, ...nameN=valN)"

elementString

private String elementString(String name,
                             Object value)

Parameters:

name - the name

value - the value

Returns:

string representation of the value pair of the form "name=value"

toStringHelper

private static String toStringHelper(Object value)

getElementValue

private Object getElementValue(String name,
                               Class<?> valueType)

annotationHashCode

private int annotationHashCode()

annotationEquals

private boolean annotationEquals(Annotation a,
                                 Annotation b)