Package dev.zemco.codegame.execution.instructions

Class JumpInstruction

java.lang.Object

dev.zemco.codegame.execution.instructions.JumpInstruction

All Implemented Interfaces:

IInstruction

Direct Known Subclasses:

JumpIfZeroInstruction

public class JumpInstruction
extends Object
implements IInstruction

Instruction that performs a jump of the engine to the specified label.

Author:

Erik Zemčík

Constructor Summary

Constructors

Constructor	Description
JumpInstruction(String label)	Creates an instance of JumpInstruction with the target jump label.

Method Summary

Modifier and Type	Method	Description
void	execute(IExecutionContext executionContext)	Requests the engine to perform a jump to the target jump label.
protected boolean	shouldPerformJump(IExecutionContext executionContext)	Checks if the instruction should request the engine to perform a jump.

Methods inherited from class java.lang.Object

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

Constructor Details

JumpInstruction

public JumpInstruction(String label)

Creates an instance of JumpInstruction with the target jump label.

Parameters:

label - target label of the jump

Throws:

IllegalArgumentException - if label is null or empty

Method Details

execute

public void execute(IExecutionContext executionContext)
             throws InstructionExecutionException

Requests the engine to perform a jump to the target jump label.

Specified by:

execute in interface IInstruction

Parameters:

executionContext - context on which the instruction is executed

Throws:

IllegalArgumentException - if executionContext is null

InstructionExecutionException - if the target label is not known by the engine

shouldPerformJump

protected boolean shouldPerformJump(IExecutionContext executionContext)
                             throws InstructionExecutionException

Checks if the instruction should request the engine to perform a jump. This method is intended to be overridden by subclasses requiring more advanced jumping logic.

Parameters:

executionContext - context on which the instruction is executed

Returns:

true if the jump should be performed, else false

Throws:

InstructionExecutionException - if illegal state during the check is reached