Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column
width10%
<clear-field>
Column
Removes a field from memory.
Code Block
xml
xml
<clear-field field="foo" />

Attributes

field

optional

The name of the field to remove

map-name

optional

The name of the map to remove


Info
titleProposed Changes

Currently, both attributes are optional. Require at least one attribute.

Section
Column
width10%
<create-object>
Column
Create a new Java object.
Code Block
xml
xml

<create-object field="foo" class-name="com.acme.SomeClass">
  <string value="bar" />
  <field field="foo" />
</create-object>

Attributes

field

optional

The name of the field for the new object

class-name

optional

The Java class name


Child Elements

<field>

optional

<string>

optional


Info
titleProposed Changes
  • Currently, both attributes are optional. Require both attributes.
  • Deprecate and replace with scriptlet
<env-to-env>
Warning

Deprecated. Use <set>.

...

Warning

Deprecated. Use <set>.

Section
Column
width10%
<fail-message>
Column
Declares a message to be added to a message list.
Code Block
xml
xml

<add-error>
  <fail-message message="There was an error" />
</add-error>

Attributes

message

optional

The message text


Info
titleProposed Changes
  • Currently, the message attribute is optional. Require the message attribute.
Section
Column
width10%
<fail-property>
Column
Declares a property key that is used to add a message to a message list.
Code Block
xml
xml

<add-error>
  <fail-property resource="ErrorMessages" property="FooError" />
</add-error>

Attributes

resource

optional

Name of the resource where the message can be found

property

optional

The message property key


Info
titleProposed Changes
  • Currently, both attributes are optional. Require both attributes.
<field-to-env>
Warning

Deprecated. Use <set>.

...

<request-to-field>
<session-to-field>

...

Section
Column
width10%
<set>
Column
Assigns a value to a field.
Code Block
xml
xml
<set field="foo" value="bar" />
<set field="baz" from-field="foo" />

Attributes

field

required

The name of the field to set (the l-value)

 

from-field

required if value attribute is empty

The name of a field to copy from (the r-value)

 

value

required if from-field attribute is empty

A constant value

 

default-value

optional

A default constant value - used if from-field evaluates to null

 

type

optional

The Java data type of field

Defaults to "String"

set-if-null

optional

Controls if field can be set to null.

Defaults to "false"

set-if-empty

optional

Controls if field can be set to an empty value. The meaning of "empty" depends on the Java data type.

Defaults to "true"


Info
titleProposed Changes
  • Add a new attribute: from-script. The attribute will be used exclusively for scriptlets that are currently found in other attributes.
  • Rename the from-field attribute to from. The attribute will be used exclusively for UEL expressions.
  • Change the behavior of the value attribute: The attribute will be used exclusively for string constants.
  • Remove the type attribute default.

...