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 StrutsMiscellaneousLibrary.formatForm(java.lang.Object) is explicitly called).

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	Form.Reception	Form validation success/fail states accepted by receiving Action.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
boolean	disableFormatting
Class<?>[]	processors
Form.Reception	reception

Element Details

disableFormatting

boolean disableFormatting

Default:

false

processors

Class<?>[] processors

Default:

{}

reception

Form.Reception reception

Default:

ERROR