Package dev.zemco.codegame.compilation.parsing

Class DelegatingInstructionParser

java.lang.Object

dev.zemco.codegame.compilation.parsing.DelegatingInstructionParser

All Implemented Interfaces:

IInstructionParser

public class DelegatingInstructionParser
extends Object
implements IInstructionParser

Implementation of an instruction parser that delegates parsing to other provided parsers. The first successfully parsed instruction is used as an output. The used parsers cannot be changed after construction.

Author:

Erik Zemčík

Constructor Summary

Constructors

Constructor	Description
DelegatingInstructionParser(List<IInstructionParser> instructionParsers)	Creates an instance of DelegatingInstructionParser that delegates instruction parsing to given parsers.

Method Summary

Modifier and Type	Method	Description
Optional<IInstruction>	parseInstruction(String rawInstruction)	Delegates parsing of a single instruction encoded in a given string to given parsers.

Methods inherited from class java.lang.Object

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

Constructor Details

DelegatingInstructionParser

public DelegatingInstructionParser(List<IInstructionParser> instructionParsers)

Creates an instance of DelegatingInstructionParser that delegates instruction parsing to given parsers.

Parameters:

instructionParsers - instruction parsers to use for parsing

Throws:

IllegalArgumentException - if instructionParsers is null

Method Details

parseInstruction

public Optional<IInstruction> parseInstruction(String rawInstruction)

Delegates parsing of a single instruction encoded in a given string to given parsers. This method may return an empty optional, if no parsers support the given raw instruction.

Specified by:

parseInstruction in interface IInstructionParser

Parameters:

rawInstruction - instruction encoded in a string

Returns:

parsed instruction or an empty optional

Throws:

IllegalArgumentException - if rawInstruction is null or empty

InstructionParseException - if any provided parser fails to decode rawInstruction