com.scriptbasic.interfaces

Interface CommandFactory

All Superinterfaces:

FactoryManaged

All Known Implementing Classes:

BasicCommandFactory

public interface CommandFactory
extends FactoryManaged

A CommandFactory analyzes a BASIC program line and creates a Command that is the result of the analysis.

Author:

Peter Verhas date June 15, 2012

Method Summary

Methods

Modifier and Type	Method and Description
Command	create(String commandKeyword) Create a Command that starts with the keyword.
void	registerCommandAnalyzer(String keywords, CommandAnalyzer analyzer) Register a new command analyzer that the factory will use to analyze a line.

Methods inherited from interface com.scriptbasic.interfaces.FactoryManaged

setFactory

Method Detail

create

Command create(String commandKeyword)
               throws AnalysisException

Create a Command that starts with the keyword.

Parameters:

commandKeyword - the command keyword lexeme or null in case the command does not start with a keyword (e.g. procedure call or assignment)

Returns:

the created command

Throws:

AnalysisException - is there is a lexical or syntax exception if there is some error with the command factory itself and it can not analyze the line and does not know what the error is. (probably the syntax of the line is totally wrong)

registerCommandAnalyzer

void registerCommandAnalyzer(String keywords,
                           CommandAnalyzer analyzer)

Register a new command analyzer that the factory will use to analyze a line. The analyzer will be used to analyze a line if the line starts with the keyword.

Parameters:

keywords - the keyword the line should start when this command is to be analyzed or null if this analyzer analyzes a line that does not start with a specific keyword

analyzer - the command analyzer for the specific keyword