Package org.aspectj.apache.bcel.generic

Class InstructionHandle

java.lang.Object

org.aspectj.apache.bcel.generic.InstructionHandle

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

BranchHandle

public class InstructionHandle
extends Object
implements Serializable

Instances of this class give users a handle to the instructions contained in an InstructionList. Instruction objects may be used more than once within a list, this is useful because it saves memory and may be much faster. Within an InstructionList an InstructionHandle object is wrapped around all instructions, i.e., it implements a cell in a doubly-linked list. From the outside only the next and the previous instruction (handle) are accessible. One can traverse the list via an Enumeration returned by InstructionList.elements().

Version:

$Id: InstructionHandle.java,v 1.9 2009/10/05 17:35:36 aclement Exp $

Author:

M. Dahm

See Also:

• Instruction
• BranchHandle
• InstructionList
• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected int	pos

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	InstructionHandle(Instruction i)

Method Summary

Modifier and Type	Method	Description
void	addTargeter(InstructionTargeter t)	Denote this handle is being referenced by t.
final Instruction	getInstruction()
final InstructionHandle	getNext()
int	getPosition()
final InstructionHandle	getPrev()
Set<InstructionTargeter>	getTargeters()
Set<InstructionTargeter>	getTargetersCopy()
boolean	hasTargeters()
void	removeAllTargeters()	Remove all targeters, if any.
void	removeTargeter(InstructionTargeter t)	Denote this handle isn't referenced anymore by t.
void	setInstruction(Instruction i)	Replace current instruction contained in this handle.
String	toString()
String	toString(boolean verbose)

Methods inherited from class java.lang.Object

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

Field Details

pos

protected int pos

Constructor Details

InstructionHandle

protected InstructionHandle(Instruction i)

Method Details

getNext

public final InstructionHandle getNext()

getPrev

public final InstructionHandle getPrev()

getInstruction

public final Instruction getInstruction()

setInstruction

public void setInstruction(Instruction i)

Replace current instruction contained in this handle. Old instruction is disposed using Instruction.dispose().

getPosition

public int getPosition()

Returns:

the position, i.e., the byte code offset of the contained instruction. This is accurate only after InstructionList.setPositions() has been called.

removeAllTargeters

public void removeAllTargeters()

Remove all targeters, if any.

removeTargeter

public void removeTargeter(InstructionTargeter t)

Denote this handle isn't referenced anymore by t.

addTargeter

public void addTargeter(InstructionTargeter t)

Denote this handle is being referenced by t.

hasTargeters

public boolean hasTargeters()

getTargeters

public Set<InstructionTargeter> getTargeters()

getTargetersCopy

public Set<InstructionTargeter> getTargetersCopy()

toString

public String toString(boolean verbose)

Returns:

a (verbose) string representation of the contained instruction.

toString

public String toString()

Overrides:

toString in class Object