addMapEntry

Adds an entry to a Map. The entry will have the key and value as defined by the resolved values of this command's attributes.

Parent commands

setMap
Optional. If placed as a child of setMap, the map attribute may be left undefined to have the parent command's new Map receive the entry.

Attributes

key
Required	Value type	EL-evaluated
Yes	String	Yes
Defines the key for the generated map entry. If the Map already has an entry with this key, that entry will be replaced by this new entry.

value
Required	Value type	EL-evaluated
Yes	Any	Yes
Defines the value for the generated map entry.

map

Required

Value type

EL-evaluated

No

Map

Yes

Defines the Map into which the new entry is added. A Data item is also a valid value, as it is a specialized Map.

If this attribute is undefined and this command is a child of setMap, the entry is added into that newly created Map. Leaving this attribute undefined if this command is not a child of setMap is considered an error.

Examples

Use addMapEntry together with setMap to create new Maps with content.

CODE

<setMap var="dynamoPerson"><addMapEntry key="firstName" value="Millie"><addMapEntry key="lastName" value="Dynamoweaver">

On its own addMapEntry can be used to add a new entry or overwrite an existing entry of any Map.

CODE

<setMap var="activeItem"><addMapEntry key="wasModified" value="${false}">...<addMapEntry key="wasModified" value="${true}" map="${activeItem}">