...
Creating wizard flows in Stripes is actually very simple. At it's simplest it involves writing a single ActionBean to manage the flow between pages and marking it with the @Wizard annotation. Beyond that it's up to you whether you want to use a single event/method to handle navigation, or a method-per-event. Using different events (and therefore methods) per page tend to make it easier to manage the flow. An abbreviated example from Bugzooky looks like this:
| Code Block | ||||
|---|---|---|---|---|
| ||||
@Wizard
@UrlBinding("/bugzooky/Register.action")
public class RegisterActionBean extends BugzookyActionBean {
@ValidateNestedProperties({
@Validate(field="username", required=true, minlength=5, maxlength=20),
@Validate(field="password", required=true, minlength=5, maxlength=20),
@Validate(field="firstName", required=true, maxlength=50),
@Validate(field="lastName", required=true, maxlength=50)
})
private Person user; // getter/setters omitted for brevity
@Validate(required=true, minlength=5, maxlength=20, expression="this == user.password")
private String confirmPassword; // getter/setters omitted for brevity
/**
* Validates that the two passwords entered match each other, and that the
* username entered is not already taken in the system.
*/
@ValidationMethod
public void validate(ValidationErrors errors) {
if ( new PersonManager().getPerson(this.user.getUsername()) != null ) {
errors.add("user.username", new LocalizableError("usernameTaken"));
}
}
public Resolution gotoStep2() throws Exception {
return new ForwardResolution("/bugzooky/Register2.jsp");
}
/**
* Registers a new user, logs them in, and redirects them to the bug list page.
*/
@DefaultHandler
public Resolution registerUser() {
new PersonManager().saveOrUpdate(this.user);
getContext().setUser(this.user);
getContext().getMessages().add(
new LocalizableError(getClass().getName() + ".successMessage",
this.user.getFirstName(),
this.user.getUsername()));
return new RedirectResolution("/bugzooky/BugList.jsp");
}
}
|
...
To handle this situation you can designate one or more events to be "start" events. For those events, Stripes will not complain if the encrypted list of fields is not present. As a result, this should be used only for pre-events, not for the first submission of data within a wizard flow. The synxtax (reprising our example from above) is as follows:
| Code Block | ||||
|---|---|---|---|---|
| ||||
@Wizard(startEvents="begin")
@UrlBinding("/bugzooky/Register.action")
public class RegisterActionBean extends BugzookyActionBean {
....
/** Sends the user to the registration page at the start of the flow */
public Resolution begin() {
return new RedirectResolution("/bugzooky/Register.jsp");
}
....
}
|
...