Package serp.bytecode

Class LoadInstruction

java.lang.Object

serp.bytecode.CodeEntry

serp.bytecode.Instruction

serp.bytecode.TypedInstruction

serp.bytecode.LocalVariableInstruction

serp.bytecode.LoadInstruction

All Implemented Interfaces:

BCEntity, VisitAcceptor

public class LoadInstruction
extends LocalVariableInstruction

Loads a value from the locals table to the stack.

Field Summary

Fields

Modifier and Type	Field	Description
private static java.lang.Class[][]	_mappings
(package private) java.lang.String	_type

Fields inherited from class serp.bytecode.CodeEntry

byteIndex, next, prev

Constructor Summary

Constructors

Constructor	Description
LoadInstruction(Code owner)
LoadInstruction(Code owner, int opcode)

Method Summary

Modifier and Type	Method	Description
void	acceptVisit(BCVisitor visit)	Accept a visit from a BCVisitor, calling the appropriate methods to notify the visitor that it has entered this entity, and to provide it with the proper callbacks for each sub-entity owned by this one.
(package private) void	calculateLocal()	Subclasses can use this method to calculate the locals index based on their opcode.
(package private) void	calculateOpcode()	Subclasses with variable opcodes can use this method to be notified that information possibly affecting the opcode has been changed.
boolean	equalsInstruction(Instruction other)	LoadInstructions are equal if the type they reference the same type and locals index or if either is unset.
(package private) int	getLength()	Return the length in bytes of this opcode, including all arguments.
int	getLogicalStackChange()	Return the logical number of stack positions changed by this instruction.
int	getStackChange()	Return the number of stack positions this instruction pushes or pops during its execution.
java.lang.String	getTypeName()	Return the type name for this instruction.
boolean	isThis()	Equivalent to getLocal () == 0 && getType () == Object.class; the this ptr is always passed in local variable 0.
(package private) void	read(java.io.DataInput in)	Read the arguments for this opcode from the given stream.
(package private) void	read(Instruction orig)	Copy the given instruction data.
LoadInstruction	setThis()	Equivalent to setLocal (0).setType (Object.class); the this ptr is always passed in local variable 0.
TypedInstruction	setType(java.lang.String type)	Set the type of this instruction.
(package private) void	write(java.io.DataOutput out)	Write the arguments for this opcode to the given stream.

Methods inherited from class serp.bytecode.LocalVariableInstruction

getLocal, getLocalVariable, getParam, setLocal, setLocalVariable, setParam

Methods inherited from class serp.bytecode.TypedInstruction

getType, getTypeBC, mapType, setType, setType

Methods inherited from class serp.bytecode.Instruction

getByteIndex, getClassLoader, getCode, getLineNumber, getName, getOpcode, getPool, getProject, invalidate, invalidateByteIndexes, isValid, setOpcode

Methods inherited from class java.lang.Object

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

Field Detail

_mappings

private static final java.lang.Class[][] _mappings

_type

java.lang.String _type

Constructor Detail

LoadInstruction

LoadInstruction(Code owner)

LoadInstruction

LoadInstruction(Code owner,
                int opcode)

Method Detail

getLength

int getLength()

Description copied from class: Instruction

Return the length in bytes of this opcode, including all arguments. For many opcodes this method relies on an up-to-date byte index.

Overrides:

getLength in class Instruction

getStackChange

public int getStackChange()

Description copied from class: Instruction

Return the number of stack positions this instruction pushes or pops during its execution.

Overrides:

getStackChange in class Instruction

Returns:

0 if the stack is not affected by this instruction, a positive number if it pushes onto the stack, and a negative number if it pops from the stack

getLogicalStackChange

public int getLogicalStackChange()

Description copied from class: Instruction

Return the logical number of stack positions changed by this instruction. In other words, ignore weirdness with longs and doubles taking two stack positions.

Overrides:

getLogicalStackChange in class Instruction

getTypeName

public java.lang.String getTypeName()

Description copied from class: TypedInstruction

Return the type name for this instruction. If the type has not been set, this method will return null.

Overrides:

getTypeName in class LocalVariableInstruction

setType

public TypedInstruction setType(java.lang.String type)

Description copied from class: TypedInstruction

Set the type of this instruction. Types that have no direct support will be converted accordingly.

Overrides:

setType in class LocalVariableInstruction

Returns:

this instruction, for method chaining

setThis

public LoadInstruction setThis()

Equivalent to setLocal (0).setType (Object.class); the this ptr is always passed in local variable 0.

Returns:

this instruction, for method chaining

isThis

public boolean isThis()

Equivalent to getLocal () == 0 && getType () == Object.class; the this ptr is always passed in local variable 0.

equalsInstruction

public boolean equalsInstruction(Instruction other)

LoadInstructions are equal if the type they reference the same type and locals index or if either is unset.

Overrides:

equalsInstruction in class LocalVariableInstruction

acceptVisit

public void acceptVisit(BCVisitor visit)

Description copied from interface: VisitAcceptor

Accept a visit from a BCVisitor, calling the appropriate methods to notify the visitor that it has entered this entity, and to provide it with the proper callbacks for each sub-entity owned by this one.

Specified by:

acceptVisit in interface VisitAcceptor

Overrides:

acceptVisit in class Instruction

read

void read(Instruction orig)

Description copied from class: Instruction

Copy the given instruction data.

Overrides:

read in class LocalVariableInstruction

read

void read(java.io.DataInput in)
   throws java.io.IOException

Description copied from class: Instruction

Read the arguments for this opcode from the given stream. This method should be overridden by opcodes that take arguments.

Overrides:

read in class Instruction

Throws:

java.io.IOException

write

void write(java.io.DataOutput out)
    throws java.io.IOException

Description copied from class: Instruction

Write the arguments for this opcode to the given stream. This method should be overridden by opcodes that take arguments.

Overrides:

write in class Instruction

Throws:

java.io.IOException

calculateOpcode

void calculateOpcode()

Description copied from class: LocalVariableInstruction

Subclasses with variable opcodes can use this method to be notified that information possibly affecting the opcode has been changed.

Overrides:

calculateOpcode in class LocalVariableInstruction

calculateLocal

void calculateLocal()

Description copied from class: LocalVariableInstruction

Subclasses can use this method to calculate the locals index based on their opcode.

Overrides:

calculateLocal in class LocalVariableInstruction