Package freemarker.ext.beans
package freemarker.ext.beans
The default object wrapper of FreeMarker uses this to expose Java Beans and POJO-s to templates.
Most of the issues dealing with beans are handled by the
BeansWrapper.wrap(Object)
and BeansWrapper.getStaticModels()
methods. In normal cases,
these are the only methods
you should use to turn an arbitrary Java object into a
FreeMarker TemplateModel
. Additionally, you can manually create
instance of any wrapper class using its constructors.
Note, however that in such cases you bypass the eventual model caching
of the wrapper.
-
ClassDescriptionA class that will wrap an arbitrary array into
TemplateCollectionModel
andTemplateSequenceModel
interfaces.A class that will wrap an arbitrary object intoTemplateHashModel
interface allowing calls to arbitrary property getters and invocation of accessible methods on the object from a template using the object.foo to access properties and object.bar(arg1, arg2) to invoke methods on it.ObjectWrapper
that is able to expose the Java API of arbitrary Java objects.Used forMethodAppearanceFineTuner.process(freemarker.ext.beans.BeansWrapper.MethodAppearanceDecisionInput, freemarker.ext.beans.BeansWrapper.MethodAppearanceDecision)
to store the results; see there.Used forMethodAppearanceFineTuner.process(freemarker.ext.beans.BeansWrapper.MethodAppearanceDecisionInput, freemarker.ext.beans.BeansWrapper.MethodAppearanceDecision)
as input parameter; see there.Gets/creates aBeansWrapper
singleton instance that's already configured as specified in the properties of this object; this is recommended over using theBeansWrapper
constructors.HoldsBeansWrapper
configuration settings and defines their defaults.Blacklist-based member access policy, that is, members that are matched by the listing will not be accessible, all others will be.A class that will wrap instances ofBoolean
into aTemplateBooleanModel
.Returned byMemberAccessPolicy.forClass(Class)
.A special case ofBeanModel
that can wrap Java collections and that implements theTemplateCollectionModel
in order to be usable in a <#list> block.Wraps arbitrary subclass ofDate
into a reflective model.Member access policy, used to implement default behavior that's mostly compatible with pre-2.3.30 versions, but is somewhat safer; it still can't provide safety in practice, if you allow untrusted users to edit templates! UseWhitelistMemberAccessPolicy
if you need stricter control.A class that addsTemplateModelIterator
functionality to theEnumeration
interface implementers.An exception thrown when there is an attempt to access an invalid bean property when we are in a "strict bean" modeA class that addsTemplateModelIterator
functionality to theIterator
interface implementers.Legacy blacklist based member access policy, used only to keep old behavior, as it can't provide meaningful safety.A special case ofBeanModel
that adds implementation forTemplateMethodModelEx
on map objects that is a shortcut for the Map.get() method.Implement this to restrict what class members (methods, fields, constructors) are accessible from templates.Superclass for member-selector-list-based member access policies, likeWhitelistMemberAccessPolicy
.A condition that matches some type members.Used for customizing how the methods are visible from templates, viaBeansWrapper.setMethodAppearanceFineTuner(MethodAppearanceFineTuner)
.Wraps arbitrary subclass ofNumber
into a reflective model.Wraps a set of same-name overloaded methods behindTemplateMethodModel
interface, like if it was a single method, chooses among them behind the scenes on call-time based on the argument values.A hash model that wraps a resource bundle.Model used byBeansWrapper
when simpleMapWrapper mode is enabled.A class that will wrap a reflected method call into aTemplateMethodModel
interface.Marker interface useful when used together withMethodAppearanceFineTuner
and such customizer objects, to indicate that it doesn't contain reference to theObjectWrapper
(so beware with non-static inner classes) and can be and should be used in call introspection cache keys.Subclass ofBeanModel
that exposes the return value of theObject.toString()
method through theTemplateScalarModel
interface.Indicates that the the annotated member can be exposed to templates; if the annotated member will be actually exposed depends on theObjectWrapper
in use, and how that was configured.Whitelist-based member access policy, that is, only members that are matched by the listing will be exposed.