WICKET-7141 Add hook methods before and after update form components models (post order).

Author: florianlacreuse

wicket-core/src/main/java/org/apache/wicket/markup/html/form/Form.java

@@ -1002,10 +1002,14 @@ public void process(IFormSubmitter submittingComponent)
 
 			// before updating, call the interception method for clients
 			beforeUpdateFormComponentModels();
+			internalOnBeforeUpdateFormComponentModels();
 
 			// Update model using form data
 			updateFormComponentModels();
 
+			// after updating, call the interception method for clients
+			internalOnAfterUpdateFormComponentModels();
+
 			// validate model objects after input values have been bound
 			internalOnValidateModelObjects();
 			if (hasError())
@@ -1288,15 +1292,66 @@ protected void addDefaultSubmitButtonHandler(IHeaderResponse headerResponse)
 		headerResponse.render(OnEventHeaderItem.forMarkupId(getMarkupId(), "keypress", script.toString()));
 	}
 
+
 	/**
 	 * Template method to allow clients to do any processing (like recording the current model so
 	 * that, in case onSubmit does further validation, the model can be rolled back) before the
 	 * actual updating of form component models is done.
-	 */
+	 * 
+	 * @deprecated Use {@linkplain #onBeforeUpdateFormComponentModels} instead.
+	*/
+	@Deprecated(since = "10.5.0", forRemoval = true)
 	protected void beforeUpdateFormComponentModels()
 	{
 	}
 
+
+	/**
+	 * Calls {@linkplain #onBeforeUpdateFormComponentModels()} on this form and all nested forms that are
+	 * visible and enabled.
+	 */
+	private void internalOnBeforeUpdateFormComponentModels()
+	{
+		visitFormsPostOrder(this, (form, visit) -> {
+			if (form.isVisibleInHierarchy() && form.isEnabledInHierarchy())
+			{
+				form.onBeforeUpdateFormComponentModels();
+			}
+		});
+	}
+
+	/**
+	 * Hook method to allow clients to do any processing (like recording the current model so
+	 * that, in case onSubmit does further validation, the model can be rolled back) before the
+	 * actual updating of form component models is done.
+	 */
+	protected void onBeforeUpdateFormComponentModels()
+	{
+	}
+
+	/**
+	 * Calls {@linkplain #onAfterUpdateFormComponentModels()} on this form and all nested forms that are
+	 * visible and enabled.
+	 */
+	private void internalOnAfterUpdateFormComponentModels()
+	{
+		visitFormsPostOrder(this, (form, visit) -> {
+			if (form.isVisibleInHierarchy() && form.isEnabledInHierarchy())
+			{
+				form.onAfterUpdateFormComponentModels();
+			}
+		});
+	}
+
+	/**
+	 * Hook method to allow clients to do any processing (like updating entities or DTO from the models
+	 * to be used later on the next late-stage validation) after the actual updating of form component
+	 * models is done.
+	 */
+	protected void onAfterUpdateFormComponentModels()
+	{
+	}
+
 	/**
 	 * Called (by the default implementation of 'process') when all fields validated, the form was
 	 * updated and it's data was allowed to be persisted. It is meant for delegating further