CoreMedia’s XML Spring configuration for the FreeMarker integration has been replaced with Spring Boot’s @AutoConfiguration for FreeMarker.

The CAE now uses the org.springframework.boot.autoconfigure.freemarker.FreeMarkerAutoConfiguration to configure the FreeMarker integration. With this change, the integration now uses the standard configurations and extension points that are provided by Spring Boot and FreeMarker. Please check the following breaking changes and apply your project’s configurations and customizations!

FreeMarker Settings

The FreeMarker settings have been changed to configuration properties. The freemarker. configurations have to be changed to spring.freemarker.settings. properties.

Additionally, the formerly non-standard setting freemarker.template.update.delay.in.seconds has been standardized to spring.freemarker.settings.template_update_delay.

Fo further information see Spring Boot Templating Properties and FreeMarker Settings.

Auto Imports

Custom auto imports are not configured with @Customize("freemarkerConfigurer.autoImports") or <customize:append bean="freemarkerConfigurer" property="autoImports"/> anymore. They are now added to the spring.freemarker.settings.auto_import property in the application.properties files for the CAE’s, using the pattern [templatePath] as [namespaceVarName]. See also FreeMarker API: Configurable.

Shared Variables

Custom shared variables are not configured with @Customize("freemarkerSharedVariables") or <customize:append bean="freemarkerSharedVariables"/> anymore. They are now configured using FreeMarkerVariablesCustomizer beans:

@Bean
FreeMarkerVariablesCustomizer myFreemarkerSharedVariablesCustomizer() {
  return variables -> variables.put("myFreemarkerFacade", new MyFreemarkerFacade());
}

Replaced XML configurations

Several Spring XML configuration files have been removed:

Their former configurations are covered by the FreeMarkerAutoConfiguration or have been migrated to Java configurations.

(CMS-27279)