The example code for this tutorial, preparable-interface, is available at struts-examples.
Often the data used to populate a form control is dynamically generated, perhaps from a database. When the user submits
the form, the Struts 2 validation interceptor attempts to validate the user’s form input. If validation fails the Struts 2
framework returns the value
input but the
input action is not re-executed. Rather the view associated with the
result is rendered to the user. Usually this view is the page that displayed the original form.
This work-flow can cause a problem if one or more of the form fields or some other data displayed depends on a dynamic look-up that that is accomplished in the Action class’s input method. Since the Action class’s input method is not re-executed when validation fails, the view page may no longer have access to the correct information to create the form or other display information.
The Struts 2 user mailing list is an excellent place to get help. If you are having a problem getting the tutorial example applications to work search the Struts 2 mailing list. If you don’t find an answer to your problem, post a question on the mailing list.
Struts 2 provides the Preparable interface
to overcome this problem. An Action class that implements this interface must override the prepare method. The
method will always be called by the Struts 2 framework’s prepare interceptor
whenever any method is called for the Action class and also when validation fails before the view is rendered.
prepare method you should put any statements that must be executed no matter what other Action class method will
be called and also statements that should be executed if validation fails. Usually statements in the prepare method set
the value for Action class instance fields that will be used to populate form controls and get the values that will be
used to set the initial form field values.
In addition to automatically running the prepare method the prepare interceptor
will also call a method named
prepare<ActionMethodName>. For example, define a prepare method and a
in the Action class that implements
Preparable. When the Struts 2 framework calls the input method, the prepare interceptor
will call the prepareInput and the prepare methods before calling the input method.
If you examine class EditAction in the example application (see above) you’ll see that it implements the
In the prepare method is this code:
EditAction.java prepare Method
carModelsAvailable = carModelsService.getCarModels(); setPersonBean(editService.getPerson());
The above statements get the car model values used to populate the car model check boxes displayed in the form and also get the information about the Person object being edited.
When you run the example application, look in the log to see when the prepare method is called in relation to the input
and execute methods. Running the example application and examining the log should help you understand the impact of implementing
Preparable interface and the prepare method.
When your application requires specific statements to be executed no matter which method of the Action class is called or when validation fails, you should implement the Preparable interface and override the prepare method.
|Return to HTTP Session||or||onward to Exclude Parameters|