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.