Package org.objectweb.asm.commons
Class AnnotationRemapper
- java.lang.Object
-
- org.objectweb.asm.AnnotationVisitor
-
- org.objectweb.asm.commons.AnnotationRemapper
-
public class AnnotationRemapper extends AnnotationVisitor
AnAnnotationVisitorthat remaps types with aRemapper.
-
-
Field Summary
Fields Modifier and Type Field Description protected java.lang.StringdescriptorThe descriptor of the visited annotation.protected RemapperremapperThe remapper used to remap the types in the visited annotation.-
Fields inherited from class org.objectweb.asm.AnnotationVisitor
api, av
-
-
Constructor Summary
Constructors Modifier Constructor Description protectedAnnotationRemapper(int api, java.lang.String descriptor, AnnotationVisitor annotationVisitor, Remapper remapper)Constructs a newAnnotationRemapper.protectedAnnotationRemapper(int api, AnnotationVisitor annotationVisitor, Remapper remapper)Deprecated.AnnotationRemapper(java.lang.String descriptor, AnnotationVisitor annotationVisitor, Remapper remapper)Constructs a newAnnotationRemapper.AnnotationRemapper(AnnotationVisitor annotationVisitor, Remapper remapper)Deprecated.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected AnnotationVisitorcreateAnnotationRemapper(java.lang.String descriptor, AnnotationVisitor annotationVisitor)Constructs a new remapper for annotations.protected AnnotationVisitorcreateAnnotationRemapper(AnnotationVisitor annotationVisitor)Deprecated.usecreateAnnotationRemapper(String, AnnotationVisitor)instead.private java.lang.StringmapAnnotationAttributeName(java.lang.String name)Maps an annotation attribute name with the remapper.(package private) AnnotationVisitororDeprecatedValue(AnnotationVisitor deprecatedAnnotationVisitor)Returns either this object, or the given one.voidvisit(java.lang.String name, java.lang.Object value)Visits a primitive value of the annotation.AnnotationVisitorvisitAnnotation(java.lang.String name, java.lang.String descriptor)Visits a nested annotation value of the annotation.AnnotationVisitorvisitArray(java.lang.String name)Visits an array value of the annotation.voidvisitEnum(java.lang.String name, java.lang.String descriptor, java.lang.String value)Visits an enumeration value of the annotation.-
Methods inherited from class org.objectweb.asm.AnnotationVisitor
visitEnd
-
-
-
-
Field Detail
-
descriptor
protected final java.lang.String descriptor
The descriptor of the visited annotation. May be null, for instance for AnnotationDefault.
-
remapper
protected final Remapper remapper
The remapper used to remap the types in the visited annotation.
-
-
Constructor Detail
-
AnnotationRemapper
@Deprecated public AnnotationRemapper(AnnotationVisitor annotationVisitor, Remapper remapper)
Deprecated.Constructs a newAnnotationRemapper. Subclasses must not use this constructor. Instead, they must use theAnnotationRemapper(int,AnnotationVisitor,Remapper)version.- Parameters:
annotationVisitor- the annotation visitor this remapper must delegate to.remapper- the remapper to use to remap the types in the visited annotation.
-
AnnotationRemapper
public AnnotationRemapper(java.lang.String descriptor, AnnotationVisitor annotationVisitor, Remapper remapper)Constructs a newAnnotationRemapper. Subclasses must not use this constructor. Instead, they must use theAnnotationRemapper(int,String,AnnotationVisitor,Remapper)version.- Parameters:
descriptor- the descriptor of the visited annotation. May be null.annotationVisitor- the annotation visitor this remapper must delegate to.remapper- the remapper to use to remap the types in the visited annotation.
-
AnnotationRemapper
@Deprecated protected AnnotationRemapper(int api, AnnotationVisitor annotationVisitor, Remapper remapper)Deprecated.Constructs a newAnnotationRemapper.- Parameters:
api- the ASM API version supported by this remapper. Must be one ofOpcodes.ASM4,Opcodes.ASM5,Opcodes.ASM6,Opcodes.ASM7,Opcodes.ASM8orOpcodes.ASM9.annotationVisitor- the annotation visitor this remapper must delegate to.remapper- the remapper to use to remap the types in the visited annotation.
-
AnnotationRemapper
protected AnnotationRemapper(int api, java.lang.String descriptor, AnnotationVisitor annotationVisitor, Remapper remapper)Constructs a newAnnotationRemapper.- Parameters:
api- the ASM API version supported by this remapper. Must be one ofOpcodes.ASM4,Opcodes.ASM5,Opcodes.ASM6,Opcodes.ASM7,Opcodes.ASM8orOpcodes.ASM9.descriptor- the descriptor of the visited annotation. May be null.annotationVisitor- the annotation visitor this remapper must delegate to.remapper- the remapper to use to remap the types in the visited annotation.
-
-
Method Detail
-
visit
public void visit(java.lang.String name, java.lang.Object value)Description copied from class:AnnotationVisitorVisits a primitive value of the annotation.- Overrides:
visitin classAnnotationVisitor- Parameters:
name- the value name.value- the actual value, whose type must beByte,Boolean,Character,Short,Integer,Long,Float,Double,StringorTypeofType.OBJECTorType.ARRAYsort. This value can also be an array of byte, boolean, short, char, int, long, float or double values (this is equivalent to usingAnnotationVisitor.visitArray(java.lang.String)and visiting each array element in turn, but is more convenient).
-
visitEnum
public void visitEnum(java.lang.String name, java.lang.String descriptor, java.lang.String value)Description copied from class:AnnotationVisitorVisits an enumeration value of the annotation.- Overrides:
visitEnumin classAnnotationVisitor- Parameters:
name- the value name.descriptor- the class descriptor of the enumeration class.value- the actual enumeration value.
-
visitAnnotation
public AnnotationVisitor visitAnnotation(java.lang.String name, java.lang.String descriptor)
Description copied from class:AnnotationVisitorVisits a nested annotation value of the annotation.- Overrides:
visitAnnotationin classAnnotationVisitor- Parameters:
name- the value name.descriptor- 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
public AnnotationVisitor visitArray(java.lang.String name)
Description copied from class:AnnotationVisitorVisits an array value of the annotation. Note that arrays of primitive values (such as byte, boolean, short, char, int, long, float or double) can be passed as value tovisit. This is whatClassReaderdoes for non empty arrays of primitive values.- Overrides:
visitArrayin 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.
-
createAnnotationRemapper
@Deprecated protected AnnotationVisitor createAnnotationRemapper(AnnotationVisitor annotationVisitor)
Deprecated.usecreateAnnotationRemapper(String, AnnotationVisitor)instead.Constructs a new remapper for annotations. The default implementation of this method returns a newAnnotationRemapper.- Parameters:
annotationVisitor- the AnnotationVisitor the remapper must delegate to.- Returns:
- the newly created remapper.
-
createAnnotationRemapper
protected AnnotationVisitor createAnnotationRemapper(java.lang.String descriptor, AnnotationVisitor annotationVisitor)
Constructs a new remapper for annotations. The default implementation of this method returns a newAnnotationRemapper.- Parameters:
descriptor- the descriptor of the visited annotation.annotationVisitor- the AnnotationVisitor the remapper must delegate to.- Returns:
- the newly created remapper.
-
orDeprecatedValue
final AnnotationVisitor orDeprecatedValue(AnnotationVisitor deprecatedAnnotationVisitor)
Returns either this object, or the given one. If the given object is equal to the object returned by the default implementation of the deprecated createAnnotationRemapper method, meaning that this method has not been overridden (or only in minor ways, for instance to add logging), then we can return this object instead, supposed to have been created by the new createAnnotationRemapper method. Otherwise we must return the given object.- Parameters:
deprecatedAnnotationVisitor- the result of a call to the deprecated createAnnotationRemapper method.- Returns:
- either this object, or the given one.
-
mapAnnotationAttributeName
private java.lang.String mapAnnotationAttributeName(java.lang.String name)
Maps an annotation attribute name with the remapper. Returns the original name unchanged if the internal name of the annotation is null.- Parameters:
name- the name of the annotation attribute.- Returns:
- the new name of the annotation attribute.
-
-