Class BranchHandle

java.lang.Object

org.apache.bcel.generic.InstructionHandle

org.apache.bcel.generic.BranchHandle

public final class BranchHandle
extends InstructionHandle

BranchHandle is returned by specialized InstructionList.append() whenever a BranchInstruction is appended. This is useful when the target of this instruction is not known at time of creation and must be set later via setTarget().

See Also:

• InstructionHandle
• Instruction
• InstructionList

Field Summary

Fields inherited from class InstructionHandle

EMPTY_ARRAY, i_position

Modifier and Type	Field	Description
static final InstructionHandle[]	EMPTY_ARRAY	Empty array.
protected int	i_position	Deprecated. (since 6.0) will be made private; do not access directly, use getter/setter

Method Summary

Modifier and Type	Method	Description
int	getPosition()	Gets the position.
InstructionHandle	getTarget()	Gets the target of instruction.
void	setInstruction(Instruction i)	Sets new contents.
void	setTarget(InstructionHandle ih)	Sets the target of the instruction.
protected int	updatePosition(int offset, int maxOffset)	Called by InstructionList.setPositions when setting the position for every instruction.
void	updateTarget(InstructionHandle oldIh, InstructionHandle newIh)	Update target of instruction.

Methods inherited from class InstructionHandle

accept, addAttribute, addHandle, addTargeter, getAttribute, getAttributes, getInstruction, getNext, getPrev, getTargeters, hasTargeters, removeAllTargeters, removeAttribute, removeTargeter, swapInstruction, toString, toString

Modifier and Type	Method	Description
void	accept(Visitor v)	Convenience method, simply calls accept() on the contained instruction.
void	addAttribute(Object key, Object attr)	Add an attribute to an instruction handle.
protected void	addHandle()	Deprecated. Does nothing as of 6.3.1.
void	addTargeter(InstructionTargeter t)	Denote this handle is being referenced by t.
Object	getAttribute(Object key)	Gets an attribute of an instruction handle.
Collection<Object>	getAttributes()	Gets all attributes associated with this handle.
final Instruction	getInstruction()	Gets the instruction.
final InstructionHandle	getNext()	Gets the next instruction handle.
final InstructionHandle	getPrev()	Gets the previous instruction handle.
InstructionTargeter[]	getTargeters()	Gets the targeters.
boolean	hasTargeters()	Tests whether this handle has targeters.
void	removeAllTargeters()	Remove all targeters, if any.
void	removeAttribute(Object key)	Delete an attribute of an instruction handle.
void	removeTargeter(InstructionTargeter t)	Denote this handle isn't referenced anymore by t.
Instruction	swapInstruction(Instruction i)	Temporarily swap the current instruction, without disturbing anything.
String	toString()	Gets a string representation of the contained instruction.
String	toString(boolean verbose)	Gets a verbose string representation of the contained instruction.

Methods inherited from class Object

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

Method Details

getPosition

public int getPosition()

Description copied from class: InstructionHandle

Gets the position.

Overrides:

getPosition in class InstructionHandle

Returns:

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

getTarget

public InstructionHandle getTarget()

Gets the target of instruction.

Returns:

target of instruction.

setInstruction

public void setInstruction(Instruction i)

Sets new contents. Old instruction is disposed and may not be used anymore.

Overrides:

setInstruction in class InstructionHandle

Parameters:

i - The new instruction.

setTarget

public void setTarget(InstructionHandle ih)

Sets the target of the instruction.

Parameters:

ih - The new target.

updatePosition

protected int updatePosition(int offset,
 int maxOffset)

Description copied from class: InstructionHandle

Called by InstructionList.setPositions when setting the position for every instruction. In the presence of variable length instructions 'setPositions()' performs multiple passes over the instruction list to calculate the correct (byte) positions and offsets by calling this function.

Overrides:

updatePosition in class InstructionHandle

Parameters:

offset - additional offset caused by preceding (variable length) instructions.

maxOffset - The maximum offset that may be caused by these instructions.

Returns:

additional offset caused by possible change of this instruction's length.

updateTarget

public void updateTarget(InstructionHandle oldIh,
 InstructionHandle newIh)

Update target of instruction.

Parameters:

oldIh - The old instruction handle.

newIh - The new instruction handle.