com.scriptbasic.syntax

Class GenericNestedStructureHouseKeeper

java.lang.Object

com.scriptbasic.syntax.AbstractNestedStructureHouseKeeper

com.scriptbasic.syntax.GenericNestedStructureHouseKeeper

All Implemented Interfaces:

FactoryManaged, NestedStructureHouseKeeper

public final class GenericNestedStructureHouseKeeper
extends AbstractNestedStructureHouseKeeper

This version just does not nothing special to recover from error.

Author:

Peter Verhas date June 11, 2012

Nested Class Summary

Nested classes/interfaces inherited from class com.scriptbasic.syntax.AbstractNestedStructureHouseKeeper

AbstractNestedStructureHouseKeeper.Structure

Constructor Summary

Constructors

Constructor and Description
GenericNestedStructureHouseKeeper()

Method Summary

Methods

Modifier and Type	Method and Description
<T extends NestedStructure> T	pop(Class<T> expectedClass) Pops one element from the stack.

Methods inherited from class com.scriptbasic.syntax.AbstractNestedStructureHouseKeeper

getFactory, isStackIsHealthy, push, push, setFactory

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericNestedStructureHouseKeeper

public GenericNestedStructureHouseKeeper()

Method Detail

pop

public <T extends NestedStructure> T pop(Class<T> expectedClass)
                              throws AnalysisException

Description copied from interface: NestedStructureHouseKeeper

Pops one element from the stack.

Note that nested element have to be pushed on the stack nested. If we get an element off the stack that was not expected it means syntax error and therefore in this case exception is thrown.

When exception was thrown the functioning of the object is not defined by this interface. Some implementation may seek the appropriate element in the stack and throw off all top element until a proper type of element is found assuming that the user forgot to close some internal programming structured in the scripted language. Other implementations may follow more complex strategy to recover from such an error. In either case the sole reason of further syntax analysis is to discover as many syntax error as possible following the first one.

Specified by:

pop in interface NestedStructureHouseKeeper

Overrides:

pop in class AbstractNestedStructureHouseKeeper

Type Parameters:

T - expected type of the element

Returns:

the top element

Throws:

AnalysisException - when the top element of the stack is not the type that we expect