public class InlineTemplateEmitter extends Emitter
If a template is inlined, the emitters of the callee as well as blocks of the caller are mixed together. If an error occurs here, we still want to emulate a render stack which pretends that the template was only invoked, so that debugging is way easier. For this reason, this emitter is used to wrap inlined emitters.
Modifier and Type | Field and Description |
---|---|
protected Emitter |
body |
protected Template |
template |
startOfBlock
Constructor and Description |
---|
InlineTemplateEmitter(parsii.tokenizer.Position startOfBlock,
Template template,
Emitter body)
Creates a new instance at the given position, which references the given template and wraps the given body.
|
Modifier and Type | Method and Description |
---|---|
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()
Performs static optimizations at compile time.
|
String |
toString() |
void |
visitExpressions(Function<parsii.tokenizer.Position,ExpressionVisitor> visitorSupplier)
Visits all expressions contained in this emitter or its children.
|
emit, getStartOfBlock
public InlineTemplateEmitter(parsii.tokenizer.Position startOfBlock, Template template, Emitter body)
startOfBlock
- the position where the inlining took placetemplate
- the original template where the emitters of body were definedbody
- the inner emitters to be invoked within the artificial render stackprotected void emitToContext(LocalRenderContext context) throws Exception
Emitter
emitToContext
in class Emitter
context
- the render context which provides access to the local and global environment and also the target
for the generated textException
- all thrown exceptions are caught and converted into a RenderException
public Emitter copy()
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.
public Emitter reduce()
Emitter
Certain emitters can perform optimizations (evaluate constant expressions, combine constant outputs etc.) to create more efficient templates. This is especially important when a template is inlined, as this most probably provides a higher level of optimizations.
public Emitter propagateVisitor(EmitterVisitor visitor)
Emitter
propagateVisitor
in class Emitter
visitor
- the visitor to invokepublic void visitExpressions(Function<parsii.tokenizer.Position,ExpressionVisitor> visitorSupplier)
Emitter
visitExpressions
in class Emitter
visitorSupplier
- a function which generates an ExpressionVisitor
while supplying the current position (for
improved error messages).Copyright © 2018. All rights reserved.