public class

VelocityLayoutViewResolver

extends VelocityViewResolver
java.lang.Object
   ↳ org.springframework.context.support.ApplicationObjectSupport
     ↳ org.springframework.web.context.support.WebApplicationObjectSupport
       ↳ org.springframework.web.servlet.view.AbstractCachingViewResolver
         ↳ org.springframework.web.servlet.view.UrlBasedViewResolver
           ↳ org.springframework.web.servlet.view.AbstractTemplateViewResolver
             ↳ org.springframework.web.servlet.view.velocity.VelocityViewResolver
               ↳ org.springframework.web.servlet.view.velocity.VelocityLayoutViewResolver

Class Overview

Convenience subclass of VelocityViewResolver, adding support for VelocityLayoutView and its properties.

See VelocityViewResolver's javadoc for general usage info.

Summary

[Expand]
Inherited Constants
From class org.springframework.web.servlet.view.UrlBasedViewResolver
From interface org.springframework.core.Ordered
[Expand]
Inherited Fields
From class org.springframework.context.support.ApplicationObjectSupport
Public Constructors
VelocityLayoutViewResolver()
Public Methods
void setLayoutKey(String layoutKey)
Set the context key used to specify an alternate layout to be used instead of the default layout.
void setLayoutUrl(String layoutUrl)
Set the layout template to use.
void setScreenContentKey(String screenContentKey)
Set the name of the context key that will hold the content of the screen within the layout template.
Protected Methods
AbstractUrlBasedView buildView(String viewName)
Creates a new View instance of the specified view class and configures it.
Class requiredViewClass()
Requires VelocityLayoutView.
[Expand]
Inherited Methods
From class org.springframework.web.servlet.view.velocity.VelocityViewResolver
From class org.springframework.web.servlet.view.AbstractTemplateViewResolver
From class org.springframework.web.servlet.view.UrlBasedViewResolver
From class org.springframework.web.servlet.view.AbstractCachingViewResolver
From class org.springframework.web.context.support.WebApplicationObjectSupport
From class org.springframework.context.support.ApplicationObjectSupport
From class java.lang.Object
From interface org.springframework.context.ApplicationContextAware
From interface org.springframework.core.Ordered
From interface org.springframework.web.context.ServletContextAware
From interface org.springframework.web.servlet.ViewResolver

Public Constructors

public VelocityLayoutViewResolver ()

Public Methods

public void setLayoutKey (String layoutKey)

Set the context key used to specify an alternate layout to be used instead of the default layout. Screen content templates can override the layout template that they wish to be wrapped with by setting this value in the template, for example:
#set( $layout = "MyLayout.vm" )

The default key is "layout", as illustrated above.

Parameters
layoutKey the name of the key you wish to use in your screen content templates to override the layout template

public void setLayoutUrl (String layoutUrl)

Set the layout template to use. Default is "layout.vm".

Parameters
layoutUrl the template location (relative to the template root directory)

public void setScreenContentKey (String screenContentKey)

Set the name of the context key that will hold the content of the screen within the layout template. This key must be present in the layout template for the current screen to be rendered.

Default is "screen_content": accessed in VTL as $screen_content.

Parameters
screenContentKey the name of the screen content key to use

Protected Methods

protected AbstractUrlBasedView buildView (String viewName)

Creates a new View instance of the specified view class and configures it. Does not perform any lookup for pre-defined View instances.

Spring lifecycle methods as defined by the bean container do not have to be called here; those will be applied by the loadView method after this method returns.

Subclasses will typically call super.buildView(viewName) first, before setting further properties themselves. loadView will then apply Spring lifecycle methods at the end of this process.

Parameters
viewName the name of the view to build
Returns
  • the View instance
Throws
Exception

protected Class requiredViewClass ()

Requires VelocityLayoutView.