Package org.objectweb.asm.commons

Class AnalyzerAdapter

java.lang.Object

org.objectweb.asm.MethodVisitor

org.objectweb.asm.commons.AnalyzerAdapter

public class AnalyzerAdapter
extends MethodVisitor

A MethodVisitor that keeps track of stack map frame changes between visitFrame(int, int, Object[], int, Object[]) calls. This adapter must be used with the ClassReader.EXPAND_FRAMES option. Each visitX instruction delegates to the next visitor in the chain, if any, and then simulates the effect of this instruction on the stack map frame, represented by locals and stack. The next visitor in the chain can get the state of the stack map frame before each instruction by reading the value of these fields in its visitX methods (this requires a reference to the AnalyzerAdapter that is before it in the chain). If this adapter is used with a class that does not contain stack map table attributes (i.e., pre Java 6 classes) then this adapter may not be able to compute the stack map frame for each instruction. In this case no exception is thrown but the locals and stack fields will be null for these instructions.

Author:

Eric Bruneton

Field Summary

Fields

Modifier and Type	Field	Description
List<Object>	locals	The local variable slots for the current execution frame.
List<Object>	stack	The operand stack slots for the current execution frame.
Map<Object,Object>	uninitializedTypes	The uninitialized types in the current execution frame.

Fields inherited from class org.objectweb.asm.MethodVisitor

api, mv

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AnalyzerAdapter(int api, String owner, int access, String name, String descriptor, MethodVisitor methodVisitor)	Constructs a new AnalyzerAdapter.
	AnalyzerAdapter(String owner, int access, String name, String descriptor, MethodVisitor methodVisitor)	Constructs a new AnalyzerAdapter.

Method Summary

Modifier and Type	Method	Description
void	visitFieldInsn(int opcode, String owner, String name, String descriptor)
void	visitFrame(int type, int numLocal, Object[] local, int numStack, Object[] stack)
void	visitIincInsn(int varIndex, int increment)
void	visitInsn(int opcode)
void	visitIntInsn(int opcode, int operand)
void	visitInvokeDynamicInsn(String name, String descriptor, Handle bootstrapMethodHandle, Object... bootstrapMethodArguments)
void	visitJumpInsn(int opcode, Label label)
void	visitLabel(Label label)
void	visitLdcInsn(Object value)
void	visitLocalVariable(String name, String descriptor, String signature, Label start, Label end, int index)
void	visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels)
void	visitMaxs(int maxStack, int maxLocals)
void	visitMethodInsn(int opcodeAndSource, String owner, String name, String descriptor, boolean isInterface)
void	visitMultiANewArrayInsn(String descriptor, int numDimensions)
void	visitTableSwitchInsn(int min, int max, Label dflt, Label... labels)
void	visitTypeInsn(int opcode, String type)
void	visitVarInsn(int opcode, int varIndex)

Methods inherited from class org.objectweb.asm.MethodVisitor

visitAnnotableParameterCount, visitAnnotation, visitAnnotationDefault, visitAttribute, visitCode, visitEnd, visitInsnAnnotation, visitLineNumber, visitLocalVariableAnnotation, visitMethodInsn, visitParameter, visitParameterAnnotation, visitTryCatchAnnotation, visitTryCatchBlock, visitTypeAnnotation

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

locals

public List<Object> locals

The local variable slots for the current execution frame. Primitive types are represented by Opcodes.TOP, Opcodes.INTEGER, Opcodes.FLOAT, Opcodes.LONG, Opcodes.DOUBLE,Opcodes.NULL or Opcodes.UNINITIALIZED_THIS (long and double are represented by two elements, the second one being TOP). Reference types are represented by String objects (representing internal names), and uninitialized types by Label objects (this label designates the NEW instruction that created this uninitialized value). This field is null for unreachable instructions.

stack

public List<Object> stack

The operand stack slots for the current execution frame. Primitive types are represented by Opcodes.TOP, Opcodes.INTEGER, Opcodes.FLOAT, Opcodes.LONG, Opcodes.DOUBLE,Opcodes.NULL or Opcodes.UNINITIALIZED_THIS (long and double are represented by two elements, the second one being TOP). Reference types are represented by String objects (representing internal names), and uninitialized types by Label objects (this label designates the NEW instruction that created this uninitialized value). This field is null for unreachable instructions.

uninitializedTypes

public Map<Object,Object> uninitializedTypes

The uninitialized types in the current execution frame. This map associates internal names to Label objects. Each label designates a NEW instruction that created the currently uninitialized types, and the associated internal name represents the NEW operand, i.e. the final, initialized type value.

Constructor Detail

AnalyzerAdapter

public AnalyzerAdapter(String owner,
                       int access,
                       String name,
                       String descriptor,
                       MethodVisitor methodVisitor)

Constructs a new AnalyzerAdapter. Subclasses must not use this constructor. Instead, they must use the AnalyzerAdapter(int, String, int, String, String, MethodVisitor) version.

Parameters:

owner - the owner's class name.

access - the method's access flags (see Opcodes).

name - the method's name.

descriptor - the method's descriptor (see Type).

methodVisitor - the method visitor to which this adapter delegates calls. May be null.

Throws:

IllegalStateException - If a subclass calls this constructor.

AnalyzerAdapter

protected AnalyzerAdapter(int api,
                          String owner,
                          int access,
                          String name,
                          String descriptor,
                          MethodVisitor methodVisitor)

Constructs a new AnalyzerAdapter.

Parameters:

api - the ASM API version implemented by this visitor. Must be one of the ASMx values in Opcodes.

owner - the owner's class name.

access - the method's access flags (see Opcodes).

name - the method's name.

descriptor - the method's descriptor (see Type).

methodVisitor - the method visitor to which this adapter delegates calls. May be null.

Method Detail

visitFrame

public void visitFrame(int type,
                       int numLocal,
                       Object[] local,
                       int numStack,
                       Object[] stack)

Overrides:

visitFrame in class MethodVisitor

visitInsn

public void visitInsn(int opcode)

Overrides:

visitInsn in class MethodVisitor

visitIntInsn

public void visitIntInsn(int opcode,
                         int operand)

Overrides:

visitIntInsn in class MethodVisitor

visitVarInsn

public void visitVarInsn(int opcode,
                         int varIndex)

Overrides:

visitVarInsn in class MethodVisitor

visitTypeInsn

public void visitTypeInsn(int opcode,
                          String type)

Overrides:

visitTypeInsn in class MethodVisitor

visitFieldInsn

public void visitFieldInsn(int opcode,
                           String owner,
                           String name,
                           String descriptor)

Overrides:

visitFieldInsn in class MethodVisitor

visitMethodInsn

public void visitMethodInsn(int opcodeAndSource,
                            String owner,
                            String name,
                            String descriptor,
                            boolean isInterface)

Overrides:

visitMethodInsn in class MethodVisitor

visitInvokeDynamicInsn

public void visitInvokeDynamicInsn(String name,
                                   String descriptor,
                                   Handle bootstrapMethodHandle,
                                   Object... bootstrapMethodArguments)

Overrides:

visitInvokeDynamicInsn in class MethodVisitor

visitJumpInsn

public void visitJumpInsn(int opcode,
                          Label label)

Overrides:

visitJumpInsn in class MethodVisitor

visitLabel

public void visitLabel(Label label)

Overrides:

visitLabel in class MethodVisitor

visitLdcInsn

public void visitLdcInsn(Object value)

Overrides:

visitLdcInsn in class MethodVisitor

visitIincInsn

public void visitIincInsn(int varIndex,
                          int increment)

Overrides:

visitIincInsn in class MethodVisitor

visitTableSwitchInsn

public void visitTableSwitchInsn(int min,
                                 int max,
                                 Label dflt,
                                 Label... labels)

Overrides:

visitTableSwitchInsn in class MethodVisitor

visitLookupSwitchInsn

public void visitLookupSwitchInsn(Label dflt,
                                  int[] keys,
                                  Label[] labels)

Overrides:

visitLookupSwitchInsn in class MethodVisitor

visitMultiANewArrayInsn

public void visitMultiANewArrayInsn(String descriptor,
                                    int numDimensions)

Overrides:

visitMultiANewArrayInsn in class MethodVisitor

visitLocalVariable

public void visitLocalVariable(String name,
                               String descriptor,
                               String signature,
                               Label start,
                               Label end,
                               int index)

Overrides:

visitLocalVariable in class MethodVisitor

visitMaxs

public void visitMaxs(int maxStack,
                      int maxLocals)

Overrides:

visitMaxs in class MethodVisitor