Known Direct Subclasses |
Known Indirect Subclasses |
View using the Velocity template engine.
Exposes the following JavaBean properties:
null
if not needed. VelocityFormatter is part of standard Velocity.
null
if not needed. DateTool is part of Velocity Tools.
null
if not needed. NumberTool is part of Velocity Tools.
Depends on a VelocityConfig object such as VelocityConfigurer being accessible in the current web application context, with any bean name. Alternatively, you can set the VelocityEngine object as bean property.
Note: Spring 3.0's VelocityView requires Velocity 1.4 or higher, and optionally Velocity Tools 1.1 or higher (depending on the use of DateTool and/or NumberTool).
[Expand]
Inherited Constants | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.springframework.web.servlet.view.AbstractTemplateView
| |||||||||||
From class
org.springframework.web.servlet.view.AbstractView
|
[Expand]
Inherited Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.springframework.context.support.ApplicationObjectSupport
| |||||||||||
From interface
org.springframework.web.servlet.View
|
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Check that the Velocity template used for this view exists and is valid.
| |||||||||||
Set whether the Velocity template should be cached.
| |||||||||||
Set the name of the DateTool helper object to expose in the Velocity context
of this view, or
null if not needed. | |||||||||||
Set the encoding of the Velocity template file.
| |||||||||||
Set the name of the NumberTool helper object to expose in the Velocity context
of this view, or
null if not needed. | |||||||||||
Set tool attributes to expose to the view, as attribute name / class name pairs.
| |||||||||||
Set the VelocityEngine to be used by this view.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Autodetect a VelocityEngine via the ApplicationContext.
| |||||||||||
Create a Velocity Context instance for the given model,
to be passed to the template for merging.
| |||||||||||
Create a Velocity Context instance for the given model,
to be passed to the template for merging.
| |||||||||||
Render the Velocity view to the given response, using the given Velocity
context which contains the complete template model to use.
| |||||||||||
Expose helpers unique to each rendering operation.
| |||||||||||
Expose helpers unique to each rendering operation.
| |||||||||||
Expose helpers unique to each rendering operation.
| |||||||||||
Expose the tool attributes, according to corresponding bean property settings.
| |||||||||||
Return the encoding for the Velocity template.
| |||||||||||
Retrieve the Velocity template specified by the given name,
using the encoding specified by the "encoding" bean property.
| |||||||||||
Retrieve the Velocity template to be rendered by this view.
| |||||||||||
Return the VelocityEngine used by this view.
| |||||||||||
Invoked on startup.
| |||||||||||
Initialize the given tool instance.
| |||||||||||
Return whether the Velocity template should be cached.
| |||||||||||
Merge the template with the context.
| |||||||||||
Process the model map by merging it with the Velocity template.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.springframework.web.servlet.view.AbstractTemplateView
| |||||||||||
From class
org.springframework.web.servlet.view.AbstractUrlBasedView
| |||||||||||
From class
org.springframework.web.servlet.view.AbstractView
| |||||||||||
From class
org.springframework.web.context.support.WebApplicationObjectSupport
| |||||||||||
From class
org.springframework.context.support.ApplicationObjectSupport
| |||||||||||
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.beans.factory.BeanNameAware
| |||||||||||
From interface
org.springframework.beans.factory.InitializingBean
| |||||||||||
From interface
org.springframework.context.ApplicationContextAware
| |||||||||||
From interface
org.springframework.web.context.ServletContextAware
| |||||||||||
From interface
org.springframework.web.servlet.View
|
Check that the Velocity template used for this view exists and is valid.
Can be overridden to customize the behavior, for example in case of multiple templates to be rendered into a single view.
locale | the desired Locale that we're looking for |
---|
true
if the resource exists (or is assumed to exist);
false
if we know that it does not existException |
---|
Set whether the Velocity template should be cached. Default is "false". It should normally be true in production, but setting this to false enables us to modify Velocity templates without restarting the application (similar to JSPs).
Note that this is a minor optimization only, as Velocity itself caches templates in a modification-aware fashion.
Set the name of the DateTool helper object to expose in the Velocity context
of this view, or null
if not needed. The exposed DateTool will be aware of
the current locale, as determined by Spring's LocaleResolver.
DateTool is part of the generic package of Velocity Tools 1.0. Spring uses a special locale-aware subclass of DateTool.
getLocale(HttpServletRequest)
LocaleResolver
Set the encoding of the Velocity template file. Default is determined by the VelocityEngine: "ISO-8859-1" if not specified otherwise.
Specify the encoding in the VelocityEngine rather than per template if all your templates share a common encoding.
Set the name of the NumberTool helper object to expose in the Velocity context
of this view, or null
if not needed. The exposed NumberTool will be aware of
the current locale, as determined by Spring's LocaleResolver.
NumberTool is part of the generic package of Velocity Tools 1.1. Spring uses a special locale-aware subclass of NumberTool.
getLocale(HttpServletRequest)
LocaleResolver
Set tool attributes to expose to the view, as attribute name / class name pairs. An instance of the given class will be added to the Velocity context for each rendering operation, under the given attribute name.
For example, an instance of MathTool, which is part of the generic package of Velocity Tools, can be bound under the attribute name "math", specifying the fully qualified class name "org.apache.velocity.tools.generic.MathTool" as value.
Note that VelocityView can only create simple generic tools or values, that is, classes with a public default constructor and no further initialization needs. This class does not do any further checks, to not introduce a required dependency on a specific tools package.
For tools that are part of the view package of Velocity Tools, a special
Velocity context and a special init callback are needed. Use VelocityToolboxView
in such a case, or override createVelocityContext
and
initTool
accordingly.
For a simple VelocityFormatter instance or special locale-aware instances of DateTool/NumberTool, which are part of the generic package of Velocity Tools, specify the "velocityFormatterAttribute", "dateToolAttribute" or "numberToolAttribute" properties, respectively.
toolAttributes | attribute names as keys, and tool class names as values |
---|
VelocityToolboxView
createVelocityContext(Map)
initTool(Object, Context)
setDateToolAttribute(String)
setNumberToolAttribute(String)
Set the VelocityEngine to be used by this view.
If this is not set, the default lookup will occur: A single VelocityConfig is expected in the current web application context, with any bean name.
Autodetect a VelocityEngine via the ApplicationContext. Called if no explicit VelocityEngine has been specified.
BeansException | if no VelocityEngine could be found |
---|
Create a Velocity Context instance for the given model, to be passed to the template for merging.
Default implementation creates an instance of Velocity's VelocityContext implementation class.
model | the model Map, containing the model attributes to be exposed to the view |
---|
Exception | if there's a fatal error while creating the context |
---|
Create a Velocity Context instance for the given model, to be passed to the template for merging.
The default implementation delegates to createVelocityContext(Map)
.
Can be overridden for a special context class, for example ChainedContext which
is part of the view package of Velocity Tools. ChainedContext is needed for
initialization of ViewTool instances.
Have a look at VelocityToolboxView
, which pre-implements
ChainedContext support. This is not part of the standard VelocityView class
in order to avoid a required dependency on the view package of Velocity Tools.
model | the model Map, containing the model attributes to be exposed to the view |
---|---|
request | current HTTP request |
response | current HTTP response |
Exception | if there's a fatal error while creating the context |
---|
createVelocityContext(Map)
initTool(Object, Context)
VelocityToolboxView
Render the Velocity view to the given response, using the given Velocity context which contains the complete template model to use.
The default implementation renders the template specified by the "url"
bean property, retrieved via getTemplate
. It delegates to the
mergeTemplate
method to merge the template instance with the
given Velocity context.
Can be overridden to customize the behavior, for example to render multiple templates into a single view.
context | the Velocity context to use for rendering |
---|---|
response | servlet response (use this to get the OutputStream or Writer) |
Exception | if thrown by Velocity |
---|
Expose helpers unique to each rendering operation. This is necessary so that different rendering operations can't overwrite each other's formats etc.
Default implementation is empty. This method can be overridden to add custom helpers to the Velocity context.
velocityContext | Velocity context that will be passed to the template |
---|---|
request | current HTTP request |
Exception | if there's a fatal error while we're adding model attributes |
---|
Expose helpers unique to each rendering operation. This is necessary so that different rendering operations can't overwrite each other's formats etc.
Called by renderMergedTemplateModel
. The default implementation
is empty. This method can be overridden to add custom helpers to the model.
model | the model that will be passed to the template for merging |
---|---|
request | current HTTP request |
Exception | if there's a fatal error while we're adding model attributes |
---|
Expose helpers unique to each rendering operation. This is necessary so that different rendering operations can't overwrite each other's formats etc.
Called by renderMergedTemplateModel
. Default implementation
delegates to exposeHelpers(velocityContext, request)
. This method
can be overridden to add special tools to the context, needing the servlet response
to initialize (see Velocity Tools, for example LinkTool and ViewTool/ChainedContext).
velocityContext | Velocity context that will be passed to the template |
---|---|
request | current HTTP request |
response | current HTTP response |
Exception | if there's a fatal error while we're adding model attributes |
---|
Expose the tool attributes, according to corresponding bean property settings.
Do not override this method unless for further tools driven by bean properties.
Override one of the exposeHelpers
methods to add custom helpers.
velocityContext | Velocity context that will be passed to the template |
---|---|
request | current HTTP request |
Exception | if there's a fatal error while we're adding model attributes |
---|
setDateToolAttribute(String)
setNumberToolAttribute(String)
exposeHelpers(Map, HttpServletRequest)
Retrieve the Velocity template specified by the given name, using the encoding specified by the "encoding" bean property.
Can be called by subclasses to retrieve a specific template, for example to render multiple templates into a single view.
name | the file name of the desired template |
---|
Exception | if thrown by Velocity |
---|
Retrieve the Velocity template to be rendered by this view.
By default, the template specified by the "url" bean property will be retrieved: either returning a cached template instance or loading a fresh instance (according to the "cacheTemplate" bean property)
Exception | if thrown by Velocity |
---|
Return the VelocityEngine used by this view.
Invoked on startup. Looks for a single VelocityConfig bean to find the relevant VelocityEngine for this factory.
BeansException |
---|
Initialize the given tool instance. The default implementation is empty.
Can be overridden to check for special callback interfaces, for example the ViewContext interface which is part of the view package of Velocity Tools. In the particular case of ViewContext, you'll usually also need a special Velocity context, like ChainedContext which is part of Velocity Tools too.
Have a look at VelocityToolboxView
, which pre-implements such a
ViewTool check. This is not part of the standard VelocityView class in order
to avoid a required dependency on the view package of Velocity Tools.
tool | the tool instance to initialize |
---|---|
velocityContext | the Velocity context |
Exception | if initializion of the tool failed |
---|
createVelocityContext(Map)
VelocityToolboxView
Return whether the Velocity template should be cached.
Merge the template with the context. Can be overridden to customize the behavior.
template | the template to merge |
---|---|
context | the Velocity context to use for rendering |
response | servlet response (use this to get the OutputStream or Writer) |
Exception | if thrown by Velocity |
---|
Process the model map by merging it with the Velocity template. Output is directed to the servlet response.
This method can be overridden if custom behavior is needed.
model | combined output Map, with request attributes and session attributes merged into it if required |
---|---|
request | current HTTP request |
response | current HTTP response |
Exception |
---|