info.magnolia.templating.freemarker

Class PageDirective

java.lang.Object

info.magnolia.templating.freemarker.AbstractDirective<PageElement>

info.magnolia.templating.freemarker.PageDirective

All Implemented Interfaces:

freemarker.template.TemplateDirectiveModel, freemarker.template.TemplateModel

public class PageDirective
extends AbstractDirective<PageElement>

A freemarker page directive to instruct the page editor about the current content and dialog id (if any).

Field Summary

Fields inherited from class info.magnolia.templating.freemarker.AbstractDirective

CONTENT_ATTRIBUTE, PATH_ATTRIBUTE, UUID_ATTRIBUTE, WORKSPACE_ATTRIBUTE

Fields inherited from interface freemarker.template.TemplateModel

NOTHING

Constructor Summary

Constructors

Constructor and Description
PageDirective()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	prepareTemplatingElement(PageElement templatingElement, freemarker.core.Environment env, Map<String,freemarker.template.TemplateModel> params, freemarker.template.TemplateModel[] loopVars, freemarker.template.TemplateDirectiveBody body) Implementations of this method should prepare the TemplatingElement with the known parameters.

Methods inherited from class info.magnolia.templating.freemarker.AbstractDirective

_param, bool, checkBody, content, createTemplatingElement, doBody, execute, getTemplatingElementClass, initContentElement, integer, mandatoryBool, mandatoryContent, mandatoryObject, mandatoryString, mandatoryStringList, node, object, string

Methods inherited from class java.lang.Object

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

Constructor Detail

PageDirective

public PageDirective()

Method Detail

prepareTemplatingElement

protected void prepareTemplatingElement(PageElement templatingElement,
                            freemarker.core.Environment env,
                            Map<String,freemarker.template.TemplateModel> params,
                            freemarker.template.TemplateModel[] loopVars,
                            freemarker.template.TemplateDirectiveBody body)
                                 throws freemarker.template.TemplateModelException,
                                        IOException

Description copied from class: AbstractDirective

Implementations of this method should prepare the TemplatingElement with the known parameters. If parameters have been grabbed using the methods provided by this class, they should be removed from the map, thus leaving an empty map once the method returns. AbstractDirective.execute(freemarker.core.Environment, java.util.Map, freemarker.template.TemplateModel[], freemarker.template.TemplateDirectiveBody) will throw a TemplateModelException if there are leftover parameters.

note: The current FreeMarker implementation passes a "new" Map which we can safely manipulate. is thrown away after the execution of the directive. When no parameters are passed, the Map is readonly, but it is otherwise a regular HashMap which has been instantiated shortly before the execution of the directive. However, since this behavior is not mandated by their API, nor documented (at the time of writing, with FreeMarker 2.3.16), we should exert caution. Unit tests hopefully cover this, so we'll be safe when updating to newer FreeMarker versions.

Specified by:

prepareTemplatingElement in class AbstractDirective<PageElement>

Throws:

freemarker.template.TemplateModelException

IOException