java.lang.Object | |
↳ | org.springframework.ui.velocity.VelocityEngineFactory |
Known Direct Subclasses |
Factory that configures a VelocityEngine. Can be used standalone,
but typically you will either use VelocityEngineFactoryBean
for preparing a VelocityEngine as bean reference, or
VelocityConfigurer
for web views.
The optional "configLocation" property sets the location of the Velocity properties file, within the current application. Velocity properties can be overridden via "velocityProperties", or even completely specified locally, avoiding the need for an external properties file.
The "resourceLoaderPath" property can be used to specify the Velocity resource loader path via Spring's Resource abstraction, possibly relative to the Spring application context.
If "overrideLogging" is true (the default), the VelocityEngine will be
configured to log via Commons Logging, that is, using the Spring-provided
CommonsLoggingLogSystem
as log system.
The simplest way to use this class is to specify a
"resourceLoaderPath"
; the
VelocityEngine typically then does not need any further configuration.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
logger |
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Prepare the VelocityEngine instance and return it.
| |||||||||||
Set the location of the Velocity config file.
| |||||||||||
Set whether Velocity should log via Commons Logging, i.e.
| |||||||||||
Set whether to prefer file system access for template loading.
| |||||||||||
Set the Spring ResourceLoader to use for loading Velocity template files.
| |||||||||||
Set the Velocity resource loader path via a Spring resource location.
| |||||||||||
Set Velocity properties, like "file.resource.loader.path".
| |||||||||||
Set Velocity properties as Map, to allow for non-String values
like "ds.resource.loader.instance".
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Return the Spring ResourceLoader to use for loading Velocity template files.
| |||||||||||
Initialize a SpringResourceLoader for the given VelocityEngine.
| |||||||||||
Initialize a Velocity resource loader for the given VelocityEngine:
either a standard Velocity FileResourceLoader or a SpringResourceLoader.
| |||||||||||
Return whether to prefer file system access for template loading.
| |||||||||||
Return a new VelocityEngine.
| |||||||||||
To be implemented by subclasses that want to to perform custom
post-processing of the VelocityEngine after this FactoryBean
performed its default configuration (but before VelocityEngine.init).
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Prepare the VelocityEngine instance and return it.
IOException | if the config file wasn't found |
---|---|
on Velocity initialization failure | |
VelocityException |
Set the location of the Velocity config file. Alternatively, you can specify all properties locally.
Set whether Velocity should log via Commons Logging, i.e. whether Velocity's log system should be set to CommonsLoggingLogSystem. Default value is true.
Set whether to prefer file system access for template loading. File system access enables hot detection of template changes.
If this is enabled, VelocityEngineFactory will try to resolve the specified "resourceLoaderPath" as file system resource (which will work for expanded class path resources and ServletContext resources too).
Default is "true". Turn this off to always load via SpringResourceLoader (i.e. as stream, without hot detection of template changes), which might be necessary if some of your templates reside in an expanded classes directory while others reside in jar files.
Set the Spring ResourceLoader to use for loading Velocity template files. The default is DefaultResourceLoader. Will get overridden by the ApplicationContext if running in a context.
Set the Velocity resource loader path via a Spring resource location. Accepts multiple locations in Velocity's comma-separated path style.
When populated via a String, standard URLs like "file:" and "classpath:" pseudo URLs are supported, as understood by ResourceLoader. Allows for relative paths when running in an ApplicationContext.
Will define a path for the default Velocity resource loader with the name
"file". If the specified resource cannot be resolved to a java.io.File
,
a generic SpringResourceLoader will be used under the name "spring", without
modification detection.
Note that resource caching will be enabled in any case. With the file resource loader, the last-modified timestamp will be checked on access to detect changes. With SpringResourceLoader, the resource will be cached forever (for example for class path resources).
To specify a modification check interval for files, use Velocity's standard "file.resource.loader.modificationCheckInterval" property. By default, the file timestamp is checked on every access (which is surprisingly fast). Of course, this just applies when loading resources from the file system.
To enforce the use of SpringResourceLoader, i.e. to not resolve a path as file system resource in any case, turn off the "preferFileSystemAccess" flag. See the latter's javadoc for details.
setResourceLoader(ResourceLoader)
setVelocityProperties(Properties)
setPreferFileSystemAccess(boolean)
SpringResourceLoader
Set Velocity properties, like "file.resource.loader.path". Can be used to override values in a Velocity config file, or to specify all necessary properties locally.
Note that the Velocity resource loader path also be set to any Spring resource location via the "resourceLoaderPath" property. Setting it here is just necessary when using a non-file-based resource loader.
Set Velocity properties as Map, to allow for non-String values like "ds.resource.loader.instance".
Return the Spring ResourceLoader to use for loading Velocity template files.
Initialize a SpringResourceLoader for the given VelocityEngine.
Called by initVelocityResourceLoader
.
velocityEngine | the VelocityEngine to configure |
---|---|
resourceLoaderPath | the path to load Velocity resources from |
Initialize a Velocity resource loader for the given VelocityEngine: either a standard Velocity FileResourceLoader or a SpringResourceLoader.
Called by createVelocityEngine()
.
velocityEngine | the VelocityEngine to configure |
---|---|
resourceLoaderPath | the path to load Velocity resources from |
SpringResourceLoader
initSpringResourceLoader(VelocityEngine, String)
createVelocityEngine()
Return whether to prefer file system access for template loading.
Return a new VelocityEngine. Subclasses can override this for custom initialization, or for using a mock object for testing.
Called by createVelocityEngine()
.
IOException | if a config file wasn't found |
---|---|
on Velocity initialization failure | |
VelocityException |
To be implemented by subclasses that want to to perform custom post-processing of the VelocityEngine after this FactoryBean performed its default configuration (but before VelocityEngine.init).
Called by createVelocityEngine()
.
velocityEngine | the current VelocityEngine |
---|
IOException | if a config file wasn't found |
---|---|
on Velocity initialization failure | |
VelocityException |
createVelocityEngine()