setMap

Creates a variable with a new Map as its value.

Child commands

addMapEntry
Optional. Any number of addMapEntry commands may be set as children of setMap to have the new Map start out with content instead of being empty.

Attributes

var
Required	Value type	EL-evaluated
Yes	String	No
Defines the name of the variable that will hold the new Map.

data
Required	Value type	EL-evaluated
No	File	Yes
This attribute allows adding of a set of entries defined as a Java properties file. The resolved File value should therefore be such a properties file.

encoding

Required

Value type

EL-evaluated

No

String

Yes

The value of this attribute specifies the encoding of the Java properties file defined with the data attribute. If data is undefined, this attribute has no effect.

Valid values for this attribute are the following:

US-ASCII (also known as ISO646-US)
ISO-8859-1
UTF-8
UTF-16BE
UTF-16LE
UTF-16

If this attribute is left undefined while data is defined, value of "ISO-8859-1" is used.

ordered

Required

Value type

EL-evaluated

No

Boolean

Yes

Defines whether the new Map will be such that its entries will appear in a predictable order when looped through with its keySet() or values() methods. If the resolved value is true, the order is defined for iteration, otherwise the iteration order is more or less random.

If not defined, value of false is used as the use cases in which a Map's contents need to be iterated through in some manner, and the order would matter, are not particularly common.