freemarker.cache

Class MergingTemplateConfigurationFactory

java.lang.Object

freemarker.cache.TemplateConfigurationFactory

freemarker.cache.MergingTemplateConfigurationFactory

public class MergingTemplateConfigurationFactory
extends TemplateConfigurationFactory

Returns the merged results of all the child factories. The factories are merged in the order as they were added. null results from the child factories will be ignored. If all child factories return null, the result of this factory will be null too.

Since:

2.3.24

Constructor Summary

Constructors

Constructor and Description
MergingTemplateConfigurationFactory(TemplateConfigurationFactory... templateConfigurationFactories)

Method Summary

Modifier and Type	Method and Description
TemplateConfiguration	get(java.lang.String sourceName, java.lang.Object templateSource) Returns (maybe creates) the TemplateConfiguration for the given template source.
protected void	setConfigurationOfChildren(Configuration cfg) Calls TemplateConfiguration.setParentConfiguration(Configuration) on each enclosed TemplateConfiguration and TemplateConfigurationFactory.setConfiguration(Configuration) on each enclosed TemplateConfigurationFactory objects.

Methods inherited from class freemarker.cache.TemplateConfigurationFactory

getConfiguration, setConfiguration

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MergingTemplateConfigurationFactory

public MergingTemplateConfigurationFactory(TemplateConfigurationFactory... templateConfigurationFactories)

Method Detail

get

public TemplateConfiguration get(java.lang.String sourceName,
                                 java.lang.Object templateSource)
                          throws java.io.IOException,
                                 TemplateConfigurationFactoryException

Description copied from class: TemplateConfigurationFactory

Returns (maybe creates) the TemplateConfiguration for the given template source.

Specified by:

get in class TemplateConfigurationFactory

Parameters:

sourceName - The name (path) that was used for TemplateLoader.findTemplateSource(String). See Template.getSourceName() for details.

templateSource - The object returned by TemplateLoader.findTemplateSource(String).

Returns:

The TemplateConfiguration to apply, or null if the there's no TemplateConfiguration for this template source.

Throws:

java.io.IOException - Typically, if there factory needs further I/O to find out more about the template source, but that fails.

TemplateConfigurationFactoryException - If there's a problem that's specific to the factory logic.

setConfigurationOfChildren

protected void setConfigurationOfChildren(Configuration cfg)

Description copied from class: TemplateConfigurationFactory

Calls TemplateConfiguration.setParentConfiguration(Configuration) on each enclosed TemplateConfiguration and TemplateConfigurationFactory.setConfiguration(Configuration) on each enclosed TemplateConfigurationFactory objects. It only supposed to call these on the direct "children" of this object, not on the children of the children.

Specified by:

setConfigurationOfChildren in class TemplateConfigurationFactory