Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Methods
• Deprecated Constructors

Deprecated Interfaces

freemarker.ext.util.WrapperTemplateModel
use AdapterTemplateModel instead.

Deprecated Classes

freemarker.template.utility.CaptureOutput
Use block-assignments instead, as <assign x>...</assign>.

freemarker.ext.ant.FreemarkerXmlTask
FMPP is a more complete solution.

freemarker.ext.jdom.NodeListModel
Use NodeModel instead.

freemarker.ext.xml.NodeListModel
Use NodeModel instead.

freemarker.template.SimpleList
Use SimpleSequence instead.

Deprecated Methods

freemarker.core.SimpleCharStream.getColumn()

freemarker.template.Configuration.getDefaultConfiguration()
The usage of the static singleton (the "default") Configuration instance can easily cause erroneous, unpredictable behavior. This is because multiple independent software components may use FreeMarker internally inside the same application, so they will interfere because of the common Configuration instance. Each such component should use its own private Configuration object instead, that it typically creates with new Configuration() when the component is initialized.

freemarker.ext.beans.BeansWrapper.getInstance(Object, ModelFactory)
override BeansWrapper.getModelFactory(Class) instead. Using this method will now bypass wrapper caching (if it is enabled) and always result in creation of a new wrapper. This method will be removed in 2.4

freemarker.core.SimpleCharStream.getLine()

freemarker.core.Configurable.getSetting(String)
This method was always defective, and certainly it always will be. Don't use it. (Simply, it's hardly possible in general to convert setting values to text in a way that ensures that Configurable.setSetting(String, String) will work with them correctly.)

freemarker.core.Configurable.getSettings()
This method was always defective, and certainly it always will be. Don't use it. (Simply, it's hardly possible in general to convert setting values to text in a way that ensures that Configurable.setSettings(Properties) will work with them correctly.)

freemarker.template.utility.DeepUnwrap.premissiveUnwrap(TemplateModel)
the name of this method is mistyped. Use DeepUnwrap.permissiveUnwrap(TemplateModel) instead.

freemarker.template.Configuration.setDefaultConfiguration(Configuration)
Using the "default" Configuration instance can easily lead to erroneous, unpredictable behaviour. See more here....

Deprecated Constructors

freemarker.cache.ClassTemplateLoader()
confusing constructor, and seldom useful; use ClassTemplateLoader.ClassTemplateLoader(Class, String) instead.

freemarker.cache.ClassTemplateLoader(Class)
it is confusing that the base path is ""; use ClassTemplateLoader.ClassTemplateLoader(Class, String) instead.

freemarker.ext.servlet.ServletContextHashModel(ServletContext, ObjectWrapper)
use ServletContextHashModel.ServletContextHashModel(GenericServlet, ObjectWrapper) instead.

freemarker.template.Template(String, Reader)
This constructor uses the "default" Configuration instance, which can easily lead to erroneous, unpredictable behaviour. See more here....