Package name.matthewgreet.strutscommons.annotation

Annotation Interface Form

@Documented @Inherited @Target(FIELD) @Retention(RUNTIME) public @interface Form

Defines a member variable of a Struts action as receiving an injected form processed by another Struts action, whether successfully or not, usually to display it. The member variable is only set if the form's type is compatible with its type.

If any processors are set, the class of the Struts action that processed the form (successfully or not) must match or be a subclass one of the values. This is useful if multiple displayed forms happen to be the same type.

By default, the member variable is only set if the form's processor rejected the form. How reception values affect form data reception:

NEVER
Never accepts form data.
ERROR
Only if form data was rejected. Default.
SUCCESS
Only if form data was accepted.
ALWAYS
Always accepts form data.

Other parameters

disableFormatting
If true, disables setting of form fields from their unformatted values (unless ValidatorLibrary.formatForm(Object) is explicitly called).

  • Element Details

    • disableFormatting

      boolean disableFormatting
      Default:
      false

    • processors

      Class<?>[] processors
      Default:
      {}

    • reception

      Form.Reception reception
      Default:
      ERROR