Package org.objectweb.asm.commons

Class InstructionAdapter

java.lang.Object

org.objectweb.asm.MethodVisitor

org.objectweb.asm.commons.InstructionAdapter

public class InstructionAdapter
extends MethodVisitor

A MethodVisitor providing a more detailed API to generate and transform instructions.

Author:

Eric Bruneton

Field Summary

Fields

Modifier and Type	Field	Description
static Type	OBJECT_TYPE	The type of the java.lang.Object class.

Fields inherited from class org.objectweb.asm.MethodVisitor

api, mv

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	InstructionAdapter(int api, MethodVisitor methodVisitor)	Constructs a new InstructionAdapter.
	InstructionAdapter(MethodVisitor methodVisitor)	Constructs a new InstructionAdapter.

Method Summary

Modifier and Type	Method	Description
void	aconst(Object value)	Generates the instruction to push the given value on the stack.
void	add(Type type)
void	aload(Type type)
void	and(Type type)
void	anew(Type type)
void	areturn(Type type)
void	arraylength()
void	astore(Type type)
void	athrow()
void	cast(Type from, Type to)	Generates the instruction to cast from the first given type to the other.
void	cconst(ConstantDynamic constantDynamic)	Generates the instruction to push the given constant dynamic on the stack.
void	checkcast(Type type)
void	cmpg(Type type)
void	cmpl(Type type)
void	dconst(double doubleValue)	Generates the instruction to push the given value on the stack.
void	div(Type type)
void	dup()
void	dup2()
void	dup2X1()
void	dup2X2()
void	dupX1()
void	dupX2()
void	fconst(float floatValue)	Generates the instruction to push the given value on the stack.
void	getfield(String owner, String name, String descriptor)
void	getstatic(String owner, String name, String descriptor)
void	goTo(Label label)
void	hconst(Handle handle)	Generates the instruction to push the given handle on the stack.
void	iconst(int intValue)	Generates the instruction to push the given value on the stack.
void	ifacmpeq(Label label)
void	ifacmpne(Label label)
void	ifeq(Label label)
void	ifge(Label label)
void	ifgt(Label label)
void	ificmpeq(Label label)
void	ificmpge(Label label)
void	ificmpgt(Label label)
void	ificmple(Label label)
void	ificmplt(Label label)
void	ificmpne(Label label)
void	ifle(Label label)
void	iflt(Label label)
void	ifne(Label label)
void	ifnonnull(Label label)
void	ifnull(Label label)
void	iinc(int varIndex, int increment)
void	instanceOf(Type type)
void	invokedynamic(String name, String descriptor, Handle bootstrapMethodHandle, Object[] bootstrapMethodArguments)	Generates the instruction to call the given dynamic method.
void	invokeinterface(String owner, String name, String descriptor)	Generates the instruction to call the given interface method.
void	invokespecial(String owner, String name, String descriptor)	Deprecated. use invokespecial(String, String, String, boolean) instead.
void	invokespecial(String owner, String name, String descriptor, boolean isInterface)	Generates the instruction to call the given special method.
void	invokestatic(String owner, String name, String descriptor)	Deprecated. use invokestatic(String, String, String, boolean) instead.
void	invokestatic(String owner, String name, String descriptor, boolean isInterface)	Generates the instruction to call the given static method.
void	invokevirtual(String owner, String name, String descriptor)	Deprecated. use invokevirtual(String, String, String, boolean) instead.
void	invokevirtual(String owner, String name, String descriptor, boolean isInterface)	Generates the instruction to call the given virtual method.
void	jsr(Label label)
void	lcmp()
void	lconst(long longValue)	Generates the instruction to push the given value on the stack.
void	load(int varIndex, Type type)
void	lookupswitch(Label dflt, int[] keys, Label[] labels)
void	mark(Label label)
void	monitorenter()
void	monitorexit()
void	mul(Type type)
void	multianewarray(String descriptor, int numDimensions)
void	neg(Type type)
void	newarray(Type type)	Generates the instruction to create and push on the stack an array of the given type.
void	nop()	Generates a nop instruction.
void	or(Type type)
void	pop()
void	pop2()
void	putfield(String owner, String name, String descriptor)
void	putstatic(String owner, String name, String descriptor)
void	rem(Type type)
void	ret(int varIndex)
void	shl(Type type)
void	shr(Type type)
void	store(int varIndex, Type type)
void	sub(Type type)
void	swap()
void	tableswitch(int min, int max, Label dflt, Label... labels)
void	tconst(Type type)	Generates the instruction to push the given type on the stack.
void	ushr(Type type)
void	visitFieldInsn(int opcode, String owner, String name, String descriptor)
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	visitLookupSwitchInsn(Label dflt, int[] keys, Label[] labels)
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)
void	xor(Type type)

Methods inherited from class org.objectweb.asm.MethodVisitor

visitAnnotableParameterCount, visitAnnotation, visitAnnotationDefault, visitAttribute, visitCode, visitEnd, visitFrame, visitInsnAnnotation, visitLineNumber, visitLocalVariable, visitLocalVariableAnnotation, visitMaxs, 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

OBJECT_TYPE

public static final Type OBJECT_TYPE

The type of the java.lang.Object class.

Constructor Detail

InstructionAdapter

public InstructionAdapter(MethodVisitor methodVisitor)

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

Parameters:

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

Throws:

IllegalStateException - If a subclass calls this constructor.

InstructionAdapter

protected InstructionAdapter(int api,
                             MethodVisitor methodVisitor)

Constructs a new InstructionAdapter.

Parameters:

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

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

Method Detail

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

nop

public void nop()

Generates a nop instruction.

aconst

public void aconst(Object value)

Generates the instruction to push the given value on the stack.

Parameters:

value - the constant to be pushed on the stack. This parameter must be an Integer, a Float, a Long, a Double, a String, a Type of OBJECT or ARRAY sort for .class constants, for classes whose version is 49, a Type of METHOD sort for MethodType, a Handle for MethodHandle constants, for classes whose version is 51 or a ConstantDynamic for a constant dynamic for classes whose version is 55.

iconst

public void iconst(int intValue)

Generates the instruction to push the given value on the stack.

Parameters:

intValue - the constant to be pushed on the stack.

lconst

public void lconst(long longValue)

Generates the instruction to push the given value on the stack.

Parameters:

longValue - the constant to be pushed on the stack.

fconst

public void fconst(float floatValue)

Generates the instruction to push the given value on the stack.

Parameters:

floatValue - the constant to be pushed on the stack.

dconst

public void dconst(double doubleValue)

Generates the instruction to push the given value on the stack.

Parameters:

doubleValue - the constant to be pushed on the stack.

tconst

public void tconst(Type type)

Generates the instruction to push the given type on the stack.

Parameters:

type - the type to be pushed on the stack.

hconst

public void hconst(Handle handle)

Generates the instruction to push the given handle on the stack.

Parameters:

handle - the handle to be pushed on the stack.

cconst

public void cconst(ConstantDynamic constantDynamic)

Generates the instruction to push the given constant dynamic on the stack.

Parameters:

constantDynamic - the constant dynamic to be pushed on the stack.

load

public void load(int varIndex,
                 Type type)

aload

public void aload(Type type)

store

public void store(int varIndex,
                  Type type)

astore

public void astore(Type type)

pop

public void pop()

pop2

public void pop2()

dup

public void dup()

dup2

public void dup2()

dupX1

public void dupX1()

dupX2

public void dupX2()

dup2X1

public void dup2X1()

dup2X2

public void dup2X2()

swap

public void swap()

add

public void add(Type type)

sub

public void sub(Type type)

mul

public void mul(Type type)

div

public void div(Type type)

rem

public void rem(Type type)

neg

public void neg(Type type)

shl

public void shl(Type type)

shr

public void shr(Type type)

ushr

public void ushr(Type type)

and

public void and(Type type)

or

public void or(Type type)

xor

public void xor(Type type)

iinc

public void iinc(int varIndex,
                 int increment)

cast

public void cast(Type from,
                 Type to)

Generates the instruction to cast from the first given type to the other.

Parameters:

from - a Type.

to - a Type.

lcmp

public void lcmp()

cmpl

public void cmpl(Type type)

cmpg

public void cmpg(Type type)

ifeq

public void ifeq(Label label)

ifne

public void ifne(Label label)

iflt

public void iflt(Label label)

ifge

public void ifge(Label label)

ifgt

public void ifgt(Label label)

ifle

public void ifle(Label label)

ificmpeq

public void ificmpeq(Label label)

ificmpne

public void ificmpne(Label label)

ificmplt

public void ificmplt(Label label)

ificmpge

public void ificmpge(Label label)

ificmpgt

public void ificmpgt(Label label)

ificmple

public void ificmple(Label label)

ifacmpeq

public void ifacmpeq(Label label)

ifacmpne

public void ifacmpne(Label label)

goTo

public void goTo(Label label)

jsr

public void jsr(Label label)

ret

public void ret(int varIndex)

tableswitch

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

lookupswitch

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

areturn

public void areturn(Type type)

getstatic

public void getstatic(String owner,
                      String name,
                      String descriptor)

putstatic

public void putstatic(String owner,
                      String name,
                      String descriptor)

getfield

public void getfield(String owner,
                     String name,
                     String descriptor)

putfield

public void putfield(String owner,
                     String name,
                     String descriptor)

invokevirtual

@Deprecated
public void invokevirtual(String owner,
                          String name,
                          String descriptor)

Deprecated.

use invokevirtual(String, String, String, boolean) instead.

Deprecated.

Parameters:

owner - the internal name of the method's owner class.

name - the method's name.

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

invokevirtual

public void invokevirtual(String owner,
                          String name,
                          String descriptor,
                          boolean isInterface)

Generates the instruction to call the given virtual method.

Parameters:

owner - the internal name of the method's owner class (see Type.getInternalName()).

name - the method's name.

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

isInterface - if the method's owner class is an interface.

invokespecial

@Deprecated
public void invokespecial(String owner,
                          String name,
                          String descriptor)

Deprecated.

use invokespecial(String, String, String, boolean) instead.

Deprecated.

Parameters:

owner - the internal name of the method's owner class.

name - the method's name.

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

invokespecial

public void invokespecial(String owner,
                          String name,
                          String descriptor,
                          boolean isInterface)

Generates the instruction to call the given special method.

Parameters:

owner - the internal name of the method's owner class (see Type.getInternalName()).

name - the method's name.

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

isInterface - if the method's owner class is an interface.

invokestatic

@Deprecated
public void invokestatic(String owner,
                         String name,
                         String descriptor)

Deprecated.

use invokestatic(String, String, String, boolean) instead.

Deprecated.

Parameters:

owner - the internal name of the method's owner class.

name - the method's name.

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

invokestatic

public void invokestatic(String owner,
                         String name,
                         String descriptor,
                         boolean isInterface)

Generates the instruction to call the given static method.

Parameters:

owner - the internal name of the method's owner class (see Type.getInternalName()).

name - the method's name.

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

isInterface - if the method's owner class is an interface.

invokeinterface

public void invokeinterface(String owner,
                            String name,
                            String descriptor)

Generates the instruction to call the given interface method.

Parameters:

owner - the internal name of the method's owner class (see Type.getInternalName()).

name - the method's name.

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

invokedynamic

public void invokedynamic(String name,
                          String descriptor,
                          Handle bootstrapMethodHandle,
                          Object[] bootstrapMethodArguments)

Generates the instruction to call the given dynamic method.

Parameters:

name - the method's name.

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

bootstrapMethodHandle - the bootstrap method.

bootstrapMethodArguments - the bootstrap method constant arguments. Each argument must be an Integer, Float, Long, Double, String, Type, Handle or ConstantDynamic value. This method is allowed to modify the content of the array so a caller should expect that this array may change.

anew

public void anew(Type type)

newarray

public void newarray(Type type)

Generates the instruction to create and push on the stack an array of the given type.

Parameters:

type - an array Type.

arraylength

public void arraylength()

athrow

public void athrow()

checkcast

public void checkcast(Type type)

instanceOf

public void instanceOf(Type type)

monitorenter

public void monitorenter()

monitorexit

public void monitorexit()

multianewarray

public void multianewarray(String descriptor,
                           int numDimensions)

ifnull

public void ifnull(Label label)

ifnonnull

public void ifnonnull(Label label)

mark

public void mark(Label label)