freemarker.ext.beans
Class SimpleMapModel
java.lang.Object
freemarker.template.WrappingTemplateModel
freemarker.ext.beans.SimpleMapModel
- All Implemented Interfaces:
- WrapperTemplateModel, AdapterTemplateModel, TemplateHashModel, TemplateHashModelEx, TemplateMethodModel, TemplateMethodModelEx, TemplateModel
public class SimpleMapModel
- extends WrappingTemplateModel
- implements TemplateHashModelEx, TemplateMethodModelEx, AdapterTemplateModel, WrapperTemplateModel
Model used by BeansWrapper
when simpleMapWrapper
mode is enabled. Provides a simple hash model interface to the
underlying map (does not copy like SimpleHash
),
and a method interface to non-string keys.
- Version:
- $Id: SimpleMapModel.java,v 1.9 2005/06/12 19:03:04 szegedia Exp $
- Author:
- Chris Nokleberg
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
SimpleMapModel
public SimpleMapModel(java.util.Map map,
BeansWrapper wrapper)
get
public TemplateModel get(java.lang.String key)
throws TemplateModelException
- Description copied from interface:
TemplateHashModel
- Gets a TemplateModel from the hash.
- Specified by:
get
in interface TemplateHashModel
- Parameters:
key
- the name by which the TemplateModel
is identified in the template.
- Returns:
- the TemplateModel referred to by the key,
or null if not found.
- Throws:
TemplateModelException
exec
public java.lang.Object exec(java.util.List args)
throws TemplateModelException
- Description copied from interface:
TemplateMethodModelEx
- Executes a method call.
- Specified by:
exec
in interface TemplateMethodModel
- Specified by:
exec
in interface TemplateMethodModelEx
- Parameters:
args
- a List of TemplateModel
objects
containing the values of the arguments passed to the method. If the
implementation wishes to operate on POJOs that might be underlying the
models, it can use the static utility methods in the DeepUnwrap
class to easily obtain them.
- Returns:
- the return value of the method, or null. If the returned value
does not implement
TemplateModel
, it will be automatically
wrapped using the environment
object wrapper
.
- Throws:
TemplateModelException
isEmpty
public boolean isEmpty()
- Specified by:
isEmpty
in interface TemplateHashModel
size
public int size()
- Specified by:
size
in interface TemplateHashModelEx
- Returns:
- the number of key/value mappings in the hash.
keys
public TemplateCollectionModel keys()
- Specified by:
keys
in interface TemplateHashModelEx
- Returns:
- a collection containing the keys in the hash. Every element of
the returned collection must implement the
TemplateScalarModel
(as the keys of hashes are always strings).
values
public TemplateCollectionModel values()
- Specified by:
values
in interface TemplateHashModelEx
- Returns:
- a collection containing the values in the hash.
getAdaptedObject
public java.lang.Object getAdaptedObject(java.lang.Class hint)
- Description copied from interface:
AdapterTemplateModel
- Retrieves the underlying object, or some other object semantically
equivalent to its value narrowed by the class hint.
- Specified by:
getAdaptedObject
in interface AdapterTemplateModel
- Parameters:
hint
- the desired class of the returned value. An implementation
should make reasonable effort to retrieve an object of the requested
class, but if that is impossible, it must at least return the underlying
object as-is. As a minimal requirement, an implementation must always
return the exact underlying object when
hint.isInstance(underlyingObject) == true holds. When called
with java.lang.Object.class, it should return a generic Java
object (i.e. if the model is wrapping a scripting lanugage object that is
further wrapping a Java object, the deepest underlying Java object should
be returned).
- Returns:
- the underlying object, or its value accommodated for the hint
class.
getWrappedObject
public java.lang.Object getWrappedObject()
- Description copied from interface:
WrapperTemplateModel
- Retrieves the object wrapped by this model.
- Specified by:
getWrappedObject
in interface WrapperTemplateModel