Package org.eclipse.sisu.space.asm
Class AnnotationWriter
java.lang.Object
org.eclipse.sisu.space.asm.AnnotationVisitor
org.eclipse.sisu.space.asm.AnnotationWriter
An
AnnotationVisitor
that generates annotations in bytecode form.-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate final ByteVector
The annotation values in bytecode form.private final ClassWriter
The class writer to which this annotation must be added.private final boolean
true if values are named, false otherwise.(package private) AnnotationWriter
Next annotation writer.private final int
Where the number of values of this annotation must be stored inparent
.private final ByteVector
The byte vector to be used to store the number of values of this annotation.(package private) AnnotationWriter
Previous annotation writer.private int
The number of values in this annotation.Fields inherited from class org.eclipse.sisu.space.asm.AnnotationVisitor
api, av
-
Constructor Summary
ConstructorsConstructorDescriptionAnnotationWriter
(ClassWriter cw, boolean named, ByteVector bv, ByteVector parent, int offset) Constructs a newAnnotationWriter
. -
Method Summary
Modifier and TypeMethodDescription(package private) int
getSize()
Returns the size of this annotation writer list.(package private) static void
put
(AnnotationWriter[] panns, int off, ByteVector out) Puts the given annotation lists into the given byte vector.(package private) void
put
(ByteVector out) Puts the annotations of this annotation writer list into the given byte vector.(package private) static void
putTarget
(int typeRef, TypePath typePath, ByteVector out) Puts the given type reference and type path into the given bytevector.void
Visits a primitive value of the annotation.visitAnnotation
(String name, String desc) Visits a nested annotation value of the annotation.visitArray
(String name) Visits an array value of the annotation.void
visitEnd()
Visits the end of the annotation.void
Visits an enumeration value of the annotation.
-
Field Details
-
cw
The class writer to which this annotation must be added. -
size
private int sizeThe number of values in this annotation. -
named
private final boolean namedtrue if values are named, false otherwise. Annotation writers used for annotation default and annotation arrays use unnamed values. -
bv
The annotation values in bytecode form. This byte vector only contains the values themselves, i.e. the number of values must be stored as a unsigned short just before these bytes. -
parent
The byte vector to be used to store the number of values of this annotation. Seebv
. -
offset
private final int offsetWhere the number of values of this annotation must be stored inparent
. -
next
AnnotationWriter nextNext annotation writer. This field is used to store annotation lists. -
prev
AnnotationWriter prevPrevious annotation writer. This field is used to store annotation lists.
-
-
Constructor Details
-
AnnotationWriter
AnnotationWriter(ClassWriter cw, boolean named, ByteVector bv, ByteVector parent, int offset) Constructs a newAnnotationWriter
.- Parameters:
cw
- the class writer to which this annotation must be added.named
- true if values are named, false otherwise.bv
- where the annotation values must be stored.parent
- where the number of annotation values must be stored.offset
- where in parent the number of annotation values must be stored.
-
-
Method Details
-
visit
Description copied from class:AnnotationVisitor
Visits a primitive value of the annotation.- Overrides:
visit
in classAnnotationVisitor
- Parameters:
name
- the value name.value
- the actual value, whose type must beByte
,Boolean
,Character
,Short
,Integer
,Long
,Float
,Double
,String
orType
or OBJECT or ARRAY sort. This value can also be an array of byte, boolean, short, char, int, long, float or double values (this is equivalent to usingvisitArray
and visiting each array element in turn, but is more convenient).
-
visitEnum
Description copied from class:AnnotationVisitor
Visits an enumeration value of the annotation.- Overrides:
visitEnum
in classAnnotationVisitor
- Parameters:
name
- the value name.desc
- the class descriptor of the enumeration class.value
- the actual enumeration value.
-
visitAnnotation
Description copied from class:AnnotationVisitor
Visits a nested annotation value of the annotation.- Overrides:
visitAnnotation
in classAnnotationVisitor
- Parameters:
name
- the value name.desc
- the class descriptor of the nested annotation class.- Returns:
- a visitor to visit the actual nested annotation value, or null if this visitor is not interested in visiting this nested annotation. The nested annotation value must be fully visited before calling other methods on this annotation visitor.
-
visitArray
Description copied from class:AnnotationVisitor
Visits an array value of the annotation. Note that arrays of primitive types (such as byte, boolean, short, char, int, long, float or double) can be passed as value tovisit
. This is whatClassReader
does.- Overrides:
visitArray
in classAnnotationVisitor
- Parameters:
name
- the value name.- Returns:
- a visitor to visit the actual array value elements, or null if this visitor is not interested in visiting these values. The 'name' parameters passed to the methods of this visitor are ignored. All the array values must be visited before calling other methods on this annotation visitor.
-
visitEnd
public void visitEnd()Description copied from class:AnnotationVisitor
Visits the end of the annotation.- Overrides:
visitEnd
in classAnnotationVisitor
-
getSize
int getSize()Returns the size of this annotation writer list.- Returns:
- the size of this annotation writer list.
-
put
Puts the annotations of this annotation writer list into the given byte vector.- Parameters:
out
- where the annotations must be put.
-
put
Puts the given annotation lists into the given byte vector.- Parameters:
panns
- an array of annotation writer lists.off
- index of the first annotation to be written.out
- where the annotations must be put.
-
putTarget
Puts the given type reference and type path into the given bytevector. LOCAL_VARIABLE and RESOURCE_VARIABLE target types are not supported.- Parameters:
typeRef
- a reference to the annotated type. SeeTypeReference
.typePath
- the path to the annotated type argument, wildcard bound, array element type, or static inner type within 'typeRef'. May be null if the annotation targets 'typeRef' as a whole.out
- where the type reference and type path must be put.
-