+ /**
+ * Update the forms internal state based on submitted data.
+ *
+ * @param out
+ * the stream to the user.
+ * @param req
+ * the request to take the initial data from.
+ * @return true, iff the form succeeded and the user should be redirected.
+ * @throws GigiApiException
+ * if internal operations went wrong.
+ */