Class FreeMarkerConfigurer
- All Implemented Interfaces:
Aware
,InitializingBean
,ResourceLoaderAware
,FreeMarkerConfig
The simplest way to use this class is to specify just a "templateLoaderPath" (e.g. "classpath:templates"); you do not need any further configuration then.
This bean must be included in the application context of any application
using FreeMarkerView
. It exists purely to configure FreeMarker.
It is not meant to be referenced by application components but just internally
by FreeMarkerView
. Implements FreeMarkerConfig
to be found by
FreeMarkerView
without depending on the bean name of the configurer.
Note that you can also refer to a pre-configured FreeMarker Configuration
instance via the "configuration" property. This allows to share a FreeMarker
Configuration
for web and email usage for example.
This configurer registers a template loader for this package, allowing to reference the "spring.ftl" macro library contained in this package:
<#import "/spring.ftl" as spring/> <@spring.bind "person.age"/> age is ${spring.status.value}
Note: Spring's FreeMarker support requires FreeMarker 2.3.21 or higher.
- Since:
- 5.0
- Author:
- Rossen Stoyanchev
-
Field Summary
Fields inherited from class org.springframework.ui.freemarker.FreeMarkerConfigurationFactory
logger
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Initialize FreeMarkerConfigurationFactory'sConfiguration
if not overridden by a pre-configured FreeMarkerConfiguration
.freemarker.template.Configuration
Return theConfiguration
object wrapped by this bean.protected void
postProcessTemplateLoaders
(List<freemarker.cache.TemplateLoader> templateLoaders) This implementation registers an additionalClassTemplateLoader
for the Spring-provided macros, added to the end of the list.void
setConfiguration
(freemarker.template.Configuration configuration) Set a preconfiguredConfiguration
to use for the FreeMarker web config — for example, a shared one for web and email usage.Methods inherited from class org.springframework.ui.freemarker.FreeMarkerConfigurationFactory
createConfiguration, getAggregateTemplateLoader, getResourceLoader, getTemplateLoaderForPath, isPreferFileSystemAccess, newConfiguration, postProcessConfiguration, setConfigLocation, setDefaultEncoding, setFreemarkerSettings, setFreemarkerVariables, setPostTemplateLoaders, setPreferFileSystemAccess, setPreTemplateLoaders, setResourceLoader, setTemplateLoaderPath, setTemplateLoaderPaths
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.springframework.context.ResourceLoaderAware
setResourceLoader
-
Constructor Details
-
FreeMarkerConfigurer
public FreeMarkerConfigurer()
-
-
Method Details
-
setConfiguration
public void setConfiguration(freemarker.template.Configuration configuration) Set a preconfiguredConfiguration
to use for the FreeMarker web config — for example, a shared one for web and email usage.If this is not set, FreeMarkerConfigurationFactory's properties (inherited by this class) have to be specified.
-
afterPropertiesSet
Initialize FreeMarkerConfigurationFactory'sConfiguration
if not overridden by a pre-configured FreeMarkerConfiguration
.Indirectly sets up a
ClassTemplateLoader
to use for loading Spring macros.- Specified by:
afterPropertiesSet
in interfaceInitializingBean
- Throws:
IOException
freemarker.template.TemplateException
- See Also:
-
postProcessTemplateLoaders
This implementation registers an additionalClassTemplateLoader
for the Spring-provided macros, added to the end of the list.- Overrides:
postProcessTemplateLoaders
in classFreeMarkerConfigurationFactory
- Parameters:
templateLoaders
- the current List of TemplateLoader instances, to be modified by a subclass- See Also:
-
getConfiguration
public freemarker.template.Configuration getConfiguration()Return theConfiguration
object wrapped by this bean.- Specified by:
getConfiguration
in interfaceFreeMarkerConfig
- Returns:
- the FreeMarker
Configuration
-