javassist.bytecode
Class AnnotationsAttribute

java.lang.Object
  javassist.bytecode.AttributeInfo
      javassist.bytecode.AnnotationsAttribute

public class AnnotationsAttribute

extends AttributeInfo

A class representing RuntimeVisibleAnnotations_attribute and RuntimeInvisibleAnnotations_attribute.

To obtain an AnnotationAttribute object, invoke getAttribute(AnnotationsAttribute.invisibleTag) in ClassFile, MethodInfo, or FieldInfo. The obtained attribute is a runtime invisible annotations attribute. If the parameter is AnnotationAttribute.visibleTag, then the obtained attribute is a runtime visible one.

If you want to record a new AnnotationAttribute object, execute the following snippet:

 ClassFile cf = ... ;
 ConstPool cp = cf.getConstPool();
 AnnotationsAttribute attr
     = new AnnotationsAttribute(cp, AnnotationsAttribute.invisibleTag);
 Annotation a = new Annotation("Author", cp);
 a.addMemberValue("name", new StringMemberValue("Chiba", cp));
 attr.setAnnotation(a);
 cf.addAttribute(attr);
 

Field Summary

static java.lang.String	invisibleTag The name of the RuntimeInvisibleAnnotations attribute.
static java.lang.String	visibleTag The name of the RuntimeVisibleAnnotations attribute.

Constructor Summary

AnnotationsAttribute(ConstPool cp, java.lang.String attrname)
Constructs an empty Runtime(In)VisisbleAnnotations_attribute.

AnnotationsAttribute(ConstPool cp, java.lang.String attrname, byte[] info)
Constructs a Runtime(In)VisisbleAnnotations_attribute.

Method Summary

void	addAnnotation(Annotation annotation) Adds an annotation.
AttributeInfo	copy(ConstPool newCp, java.util.Map classnames) Copies this attribute and returns a new copy.
Annotation	getAnnotation(java.lang.String type) Parses the annotations and returns a data structure representing the annotation with the specified type.
Annotation[]	getAnnotations() Parses the annotations and returns a data structure representing that parsed annotations.
int	numAnnotations() Returns num_annotations.
void	setAnnotation(Annotation annotation) Changes the annotations.
void	setAnnotations(Annotation[] annotations) Changes the annotations represented by this object according to the given array of Annotation objects.
java.lang.String	toString() Returns a string representation of this object.

Methods inherited from class javassist.bytecode.AttributeInfo

get, getConstPool, getName, length, set

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

visibleTag

public static final java.lang.String visibleTag

The name of the RuntimeVisibleAnnotations attribute.

See Also:

Constant Field Values

invisibleTag

public static final java.lang.String invisibleTag

The name of the RuntimeInvisibleAnnotations attribute.

See Also:

Constant Field Values

Constructor Detail

AnnotationsAttribute

public AnnotationsAttribute(ConstPool cp,
                            java.lang.String attrname,
                            byte[] info)

Constructs a Runtime(In)VisisbleAnnotations_attribute.

Parameters:

cp - constant pool

attrname - attribute name (visibleTag or invisibleTag).

info - the contents of this attribute. It does not include attribute_name_index or attribute_length.

AnnotationsAttribute

public AnnotationsAttribute(ConstPool cp,
                            java.lang.String attrname)

Constructs an empty Runtime(In)VisisbleAnnotations_attribute. A new annotation can be later added to the created attribute by setAnnotations().

Parameters:

cp - constant pool

attrname - attribute name (visibleTag or invisibleTag).

See Also:

setAnnotations(Annotation[])

Method Detail

numAnnotations

public int numAnnotations()

Returns num_annotations.

copy

public AttributeInfo copy(ConstPool newCp,
                          java.util.Map classnames)

Copies this attribute and returns a new copy.

Overrides:

copy in class AttributeInfo

Parameters:

newCp - the constant pool table used by the new copy.

classnames - pairs of replaced and substituted class names.

getAnnotation

public Annotation getAnnotation(java.lang.String type)

Parses the annotations and returns a data structure representing the annotation with the specified type. See also getAnnotations() as to the returned data structure.

Parameters:

type - the annotation type.

See Also:

getAnnotations()

addAnnotation

public void addAnnotation(Annotation annotation)

Adds an annotation. If there is an annotation with the same type, it is removed before the new annotation is added.

Parameters:

annotation - the added annotation.

getAnnotations

public Annotation[] getAnnotations()

Parses the annotations and returns a data structure representing that parsed annotations. Note that changes of the node values of the returned tree are not reflected on the annotations represented by this object unless the tree is copied back to this object by setAnnotations().

See Also:

setAnnotations(Annotation[])

setAnnotations

public void setAnnotations(Annotation[] annotations)

Changes the annotations represented by this object according to the given array of Annotation objects.

Parameters:

annotations - the data structure representing the new annotations.

setAnnotation

public void setAnnotation(Annotation annotation)

Changes the annotations. A call to this method is equivalent to:

setAnnotations(new Annotation[] { annotation })

Parameters:

annotation - the data structure representing the new annotation.

toString

public java.lang.String toString()

Returns a string representation of this object.