org.apache.wicket.velocity.markup.html

Class VelocityPanel

java.lang.Object

org.apache.wicket.Component

org.apache.wicket.MarkupContainer

org.apache.wicket.markup.html.WebMarkupContainer

org.apache.wicket.markup.html.panel.Panel

org.apache.wicket.velocity.markup.html.VelocityPanel

All Implemented Interfaces:

Serializable, Iterable<Component>, IEventSink, IEventSource, IConverterLocator, IHeaderContributor, IMarkupCacheKeyProvider, IMarkupResourceStreamProvider, IRequestableComponent, org.apache.wicket.util.IHierarchical<Component>, org.apache.wicket.util.io.IClusterable

public abstract class VelocityPanel
extends Panel
implements IMarkupResourceStreamProvider, IMarkupCacheKeyProvider

Panel that displays the result of rendering a Velocity template. The template itself can be any StringResourceStream implementation, of which there are a number of convenient implementations in the util package. The model can be any normal Map, which will be used to create the VelocityContext.

Note: Be sure to properly initialize the Velocity engine before using VelocityPanel.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.markup.html.panel.Panel

PANEL

Fields inherited from class org.apache.wicket.Component

ENABLE, FLAG_INITIALIZED, FLAG_REMOVING_FROM_HIERARCHY, FLAG_RESERVED1, FLAG_RESERVED2, FLAG_RESERVED3, FLAG_RESERVED4, FLAG_RESERVED5, FLAG_RESERVED8, PARENT_PATH, PATH_SEPARATOR, RENDER

Constructor Summary

Constructors

Constructor and Description
VelocityPanel(String id, IModel<? extends Map> model) Construct.

Method Summary

Methods

Modifier and Type	Method and Description
protected boolean	escapeHtml() Gets whether to escape HTML characters.
static VelocityPanel	forTemplateResource(String id, IModel<? extends Map> model, org.apache.wicket.util.resource.IResourceStream templateResource) Convenience factory method to create a VelocityPanel instance with a given template resource.
String	getCacheKey(MarkupContainer container, Class<?> containerClass)
org.apache.wicket.util.resource.IResourceStream	getMarkupResourceStream(MarkupContainer container, Class<?> containerClass)
protected abstract org.apache.wicket.util.resource.IResourceStream	getTemplateResource() Returns the template resource passed to the constructor.
void	onComponentTagBody(MarkupStream markupStream, ComponentTag openTag)
protected void	onDetach()
protected boolean	parseGeneratedMarkup() Gets whether to parse the resulting Wicket markup.
protected boolean	throwVelocityExceptions() Whether any velocity exception should be trapped and displayed on the panel (false) or thrown up to be handled by the exception mechanism of Wicket (true).

Methods inherited from class org.apache.wicket.markup.html.panel.Panel

newMarkupSourcingStrategy

Methods inherited from class org.apache.wicket.markup.html.WebMarkupContainer

getWebPage, getWebRequest, getWebResponse, getWebSession

Methods inherited from class org.apache.wicket.MarkupContainer

add, addOrReplace, autoAdd, contains, get, get, getAssociatedMarkup, getAssociatedMarkupStream, getMarkup, getMarkupType, internalAdd, internalInitialize, iterator, iterator, onAfterRenderChildren, onRender, remove, remove, removeAll, renderAll, renderAssociatedMarkup, renderNext, replace, setDefaultModel, size, swap, toString, toString, visitChildren, visitChildren, visitChildren, visitChildren

Methods inherited from class org.apache.wicket.Component

add, addStateChange, afterRender, beforeRender, canCallListenerInterface, checkComponentTag, checkComponentTagAttribute, checkHierarchyChange, configure, continueToOriginalDestination, debug, detach, detachModel, detachModels, determineVisibility, error, exceptionMessage, fatal, findMarkupStream, findPage, findParent, findParentWithAssociatedMarkup, getAjaxRegionMarkupId, getApplication, getBehaviorById, getBehaviorId, getBehaviors, getBehaviors, getClassRelativePath, getConverter, getDefaultModel, getDefaultModelObject, getDefaultModelObjectAsString, getDefaultModelObjectAsString, getEscapeModelStrings, getFeedbackMessages, getFlag, getId, getInnermostModel, getInnermostModel, getLocale, getLocalizer, getMarkup, getMarkupAttributes, getMarkupId, getMarkupId, getMarkupIdFromMarkup, getMarkupIdImpl, getMarkupSourcingStrategy, getMetaData, getModelComparator, getOutputMarkupId, getOutputMarkupPlaceholderTag, getPage, getPageRelativePath, getParent, getPath, getRenderBodyOnly, getRequest, getRequestCycle, getRequestFlag, getResponse, getSession, getSizeInBytes, getStatelessHint, getString, getString, getString, getStyle, getVariation, hasBeenRendered, hasErrorMessage, hasFeedbackMessage, info, initModel, internalOnModelChanged, internalPrepareForRender, internalRenderComponent, isActionAuthorized, isAuto, isBehaviorAccepted, isEnableAllowed, isEnabled, isEnabledInHierarchy, isIgnoreAttributeModifier, isRenderAllowed, isStateless, isVersioned, isVisibilityAllowed, isVisible, isVisibleInHierarchy, markRendering, modelChanged, modelChanging, onAfterRender, onBeforeRender, onComponentTag, onConfigure, onEvent, onInitialize, onModelChanged, onModelChanging, onRemove, prepareForRender, redirectToInterceptPage, remove, remove, render, renderComponentTag, rendered, renderHead, renderHead, renderHead, renderPlaceholderTag, replaceComponentTagBody, replaceWith, sameInnermostModel, sameInnermostModel, send, setAuto, setDefaultModelObject, setEnabled, setEscapeModelStrings, setFlag, setIgnoreAttributeModifier, setMarkup, setMarkupId, setMarkupIdImpl, setMetaData, setOutputMarkupId, setOutputMarkupPlaceholderTag, setParent, setRenderBodyOnly, setRequestFlag, setResponsePage, setResponsePage, setResponsePage, setVersioned, setVisibilityAllowed, setVisible, success, urlFor, urlFor, urlFor, urlFor, urlFor, visitParents, visitParents, warn, wrap

Methods inherited from class java.lang.Object

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

Constructor Detail

VelocityPanel

public VelocityPanel(String id,
             IModel<? extends Map> model)

Construct.

Parameters:

id - Component id

templateResource - The velocity template as a string resource

model - Model with variables that can be substituted by Velocity.

Method Detail

forTemplateResource

public static VelocityPanel forTemplateResource(String id,
                                IModel<? extends Map> model,
                                org.apache.wicket.util.resource.IResourceStream templateResource)

Convenience factory method to create a VelocityPanel instance with a given template resource.

Parameters:

id - Component id

model - optional model for variable substitution.

templateResource - The template resource

Returns:

an instance of VelocityPanel

onComponentTagBody

public void onComponentTagBody(MarkupStream markupStream,
                      ComponentTag openTag)

Overrides:

onComponentTagBody in class MarkupContainer

escapeHtml

protected boolean escapeHtml()

Gets whether to escape HTML characters.

Returns:

whether to escape HTML characters. The default value is false.

getTemplateResource

protected abstract org.apache.wicket.util.resource.IResourceStream getTemplateResource()

Returns the template resource passed to the constructor.

Returns:

The template resource

parseGeneratedMarkup

protected boolean parseGeneratedMarkup()

Gets whether to parse the resulting Wicket markup.

Returns:

whether to parse the resulting Wicket markup. The default is false.

throwVelocityExceptions

protected boolean throwVelocityExceptions()

Whether any velocity exception should be trapped and displayed on the panel (false) or thrown up to be handled by the exception mechanism of Wicket (true). The default is false, which traps and displays any exception without having consequences for the other components on the page.

Trapping these exceptions without disturbing the other components is especially useful in CMS like applications, where 'normal' users are allowed to do basic scripting. On errors, you want them to be able to have them correct them while the rest of the application keeps on working.

Returns:

Whether any velocity exceptions should be thrown or trapped. The default is false.

getMarkupResourceStream

public final org.apache.wicket.util.resource.IResourceStream getMarkupResourceStream(MarkupContainer container,
                                                                      Class<?> containerClass)

Specified by:

getMarkupResourceStream in interface IMarkupResourceStreamProvider

getCacheKey

public final String getCacheKey(MarkupContainer container,
                 Class<?> containerClass)

Specified by:

getCacheKey in interface IMarkupCacheKeyProvider

onDetach

protected void onDetach()

Overrides:

onDetach in class Component