org.objectweb.asm.tree
Class FrameNode

java.lang.Object
  extended by org.objectweb.asm.tree.AbstractInsnNode
      extended by org.objectweb.asm.tree.FrameNode

public class FrameNode
extends AbstractInsnNode

A node that represents a stack map frame. These nodes are pseudo instruction nodes in order to be inserted in an instruction list. In fact these nodes must(*) be inserted just before any instruction node i that follows an unconditionnal branch instruction such as GOTO or THROW, that is the target of a jump instruction, or that starts an exception handler block. The stack map frame types must describe the values of the local variables and of the operand stack elements just before i is executed.

(*) this is mandatory only for classes whose version is greater than or equal to V1_6.

Author:
Eric Bruneton

Field Summary
 List local
          The types of the local variables of this stack map frame.
 List stack
          The types of the operand stack elements of this stack map frame.
 int type
          The type of this frame.
 
Fields inherited from class org.objectweb.asm.tree.AbstractInsnNode
FIELD_INSN, FRAME, IINC_INSN, INSN, INT_INSN, JUMP_INSN, LABEL, LDC_INSN, LINE, LOOKUPSWITCH_INSN, METHOD_INSN, MULTIANEWARRAY_INSN, opcode, TABLESWITCH_INSN, TYPE_INSN, VAR_INSN
 
Constructor Summary
FrameNode(int type, int nLocal, Object[] local, int nStack, Object[] stack)
          Constructs a new FrameNode.
 
Method Summary
 void accept(MethodVisitor mv)
          Makes the given visitor visit this stack map frame.
 AbstractInsnNode clone(Map labels)
          Returns a copy of this instruction.
 int getType()
          Returns the type of this instruction.
 
Methods inherited from class org.objectweb.asm.tree.AbstractInsnNode
getNext, getOpcode, getPrevious
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

type

public int type
The type of this frame. Must be Opcodes.F_NEW for expanded frames, or Opcodes.F_FULL, Opcodes.F_APPEND, Opcodes.F_CHOP, Opcodes.F_SAME or Opcodes.F_APPEND, Opcodes.F_SAME1 for compressed frames.


local

public List local
The types of the local variables of this stack map frame. Elements of this list can be Integer, String or LabelNode objects (for primitive, reference and uninitialized types respectively - see MethodVisitor).


stack

public List stack
The types of the operand stack elements of this stack map frame. Elements of this list can be Integer, String or LabelNode objects (for primitive, reference and uninitialized types respectively - see MethodVisitor).

Constructor Detail

FrameNode

public FrameNode(int type,
                 int nLocal,
                 Object[] local,
                 int nStack,
                 Object[] stack)
Constructs a new FrameNode.

Parameters:
type - the type of this frame. Must be Opcodes.F_NEW for expanded frames, or Opcodes.F_FULL, Opcodes.F_APPEND, Opcodes.F_CHOP, Opcodes.F_SAME or Opcodes.F_APPEND, Opcodes.F_SAME1 for compressed frames.
nLocal - number of local variables of this stack map frame.
local - the types of the local variables of this stack map frame. Elements of this list can be Integer, String or LabelNode objects (for primitive, reference and uninitialized types respectively - see MethodVisitor).
nStack - number of operand stack elements of this stack map frame.
stack - the types of the operand stack elements of this stack map frame. Elements of this list can be Integer, String or LabelNode objects (for primitive, reference and uninitialized types respectively - see MethodVisitor).
Method Detail

getType

public int getType()
Description copied from class: AbstractInsnNode
Returns the type of this instruction.

Specified by:
getType in class AbstractInsnNode
Returns:
the type of this instruction, i.e. one the constants defined in this class.

accept

public void accept(MethodVisitor mv)
Makes the given visitor visit this stack map frame.

Specified by:
accept in class AbstractInsnNode
Parameters:
mv - a method visitor.

clone

public AbstractInsnNode clone(Map labels)
Description copied from class: AbstractInsnNode
Returns a copy of this instruction.

Specified by:
clone in class AbstractInsnNode
Parameters:
labels - a map from LabelNodes to cloned LabelNodes.
Returns:
a copy of this instruction. The returned instruction does not belong to any InsnList.