sirius.tagliatelle.emitter

Class CompositeEmitter

java.lang.Object

sirius.tagliatelle.emitter.Emitter

sirius.tagliatelle.emitter.CompositeEmitter

public class CompositeEmitter
extends Emitter

Represents a composite emitter which consists of a list of child emitters.

Field Summary

Fields

Modifier and Type	Field and Description
protected List<Emitter>	children

Fields inherited from class sirius.tagliatelle.emitter.Emitter

startOfBlock

Constructor Summary

Constructors

Constructor and Description
CompositeEmitter(parsii.tokenizer.Position startOfBlock) Creates a new emitter at the given position.

Method Summary

Modifier and Type	Method and Description
void	addChild(Emitter child) Adds a new child emitter and the end of the children list.
Emitter	copy() Creates a deep copy of this emitter.
protected void	emitToContext(LocalRenderContext context) Actually produces the output while relying on the caller to properly handle any exception.
Emitter	propagateVisitor(EmitterVisitor visitor) Invokes the visitor on all sub emitters and on this emitter itself.
Emitter	reduce() Tries to optimize the list of child emitters.
String	toString()
void	visitExpressions(Function<parsii.tokenizer.Position,ExpressionVisitor> visitorSupplier) Visits all expressions contained in this emitter or its children.

Methods inherited from class sirius.tagliatelle.emitter.Emitter

emit, getStartOfBlock

Methods inherited from class java.lang.Object

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

Field Detail

children

protected List<Emitter> children

Constructor Detail

CompositeEmitter

public CompositeEmitter(parsii.tokenizer.Position startOfBlock)

Creates a new emitter at the given position.

Parameters:

startOfBlock - the start of the definition

Method Detail

addChild

public void addChild(@Nonnull
                     Emitter child)

Adds a new child emitter and the end of the children list.

Parameters:

child - the emitter to add

emitToContext

protected void emitToContext(LocalRenderContext context)
                      throws Exception

Description copied from class: Emitter

Actually produces the output while relying on the caller to properly handle any exception.

Specified by:

emitToContext in class Emitter

Parameters:

context - the render context which provides access to the local and global environment and also the target for the generated text

Throws:

Exception - all thrown exceptions are caught and converted into a RenderException

copy

public Emitter copy()

Description copied from class: Emitter

Creates a deep copy of this emitter.

When templates are inlined, the parameters are propagated and constant expressions and conditions are evaluated at compile time. This yields faster and more efficient templates. In order to perform these optimizations, we need a copy of the template and all its emitters which can safely be modified.

Specified by:

copy in class Emitter

Returns:

a deep copy of this emitter, which can safely be modified without changing this emitter

reduce

public Emitter reduce()

Tries to optimize the list of child emitters.

Two actual optimizations are attempted:

• Adjacent constant emitters are joined into one.
• Composite children hab their children pulled up into the list of children to simplify the emitter tree.

Both of these optimizations are very efficient when a template is inlined into another one.

Specified by:

reduce in class Emitter

Returns:

the optimized emitter

propagateVisitor

public Emitter propagateVisitor(EmitterVisitor visitor)

Description copied from class: Emitter

Invokes the visitor on all sub emitters and on this emitter itself.

Specified by:

propagateVisitor in class Emitter

Parameters:

visitor - the visitor to invoke

Returns:

the resulting emitter returned by the visitor

visitExpressions

public void visitExpressions(Function<parsii.tokenizer.Position,ExpressionVisitor> visitorSupplier)

Description copied from class: Emitter

Visits all expressions contained in this emitter or its children.

Specified by:

visitExpressions in class Emitter

Parameters:

visitorSupplier - a function which generates an ExpressionVisitor while supplying the current position (for improved error messages).

toString

public String toString()

Overrides:

toString in class Object