Form Post Method

Since 1.2.1 the library is able to handle FORM_POST the same way as all the other method types.
FORM_POST methods written in 1.1.x style are still supported. See documentation [here](Form Post Method1_1_x).

If you use version 1.0.x of the library see documentation [here](Form Post Method1_0_x).

If you write 1.2.1 style FORM_POST methods exception handling described here Form Post Exception Handling is not needed.

Server

A FORM_POST method handles submits of a Ext.form.Panel. The method has to be annotated with @ExtDirectMethod(ExtDirectMethodType.FORM_POST) and it has to return an instance of [ExtDirectFormPostResult] (http://rasc.ch/eds/apidocs/ch/ralscha/extdirectspring/bean/ExtDirectFormPostResult.html).

@Service
public class Profile {

    @ExtDirectMethod(ExtDirectMethodType.FORM_POST)
    public ExtDirectFormPostResult updateBasicInfo(@Valid BasicInfo basicInfo, BindingResult result) {
        if (!result.hasErrors()) {
            if (basicInfo.getEmail().equals("[email protected]")) {
                result.rejectValue("email", null, "email already taken");
            }
        }
        return new ExtDirectFormPostResult(result);
    }
}

Such a method supports all the arguments a normal Spring MVC method does:
http://static.springsource.org/spring/docs/3.2.x/spring-framework-reference/html/mvc.html#mvc-ann-requestmapping-arguments

Validation is also working the same way:
http://static.springsource.org/spring/docs/3.2.x/spring-framework-reference/html/validation.html#validation-mvc

Client

To configure a form post handler add the submit property in the api configuration of BasicForm.

  //Ext JS 3.x
  var basicInfo = new Ext.form.FormPanel( {
  //Ext JS 4.x
  var basicInfo = Ext.create('Ext.form.Panel', {
    ...
    api: {
      ...
      submit: profile.updateBasicInfo
    }

  });

It's possible to send additional parameters with the submit method.

  basicInfo.getForm().submit( {
    params: {
      foo: 'bar',
      uid: 34
    }
  });

FORM-DATA vs JSON posts

Please note that by default ExtJS forms submit using form-data. This means that de-serialization will not be handled by Jackson, but by a separate Spring MVC form handler. If you prefer to submit your forms using JSON you'll have to manually handle that:

buttons: [
    {
        text: 'Submit',
        handler: function() {
            myExtDirectService.formHandlingMethod(this.up('form').getValues(),
                function(result){
                    if(result.success) {
                        Ext.MessageBox.alert("Success", "Submitted form successfully");
                    }else{
                        Ext.MessageBox.alert("Failure", "Failed to submit form");
                    }
                }
            );
        }
    }
]

Examples

• https://demo.rasc.ch/eds/extjs3/form.html
• https://demo.rasc.ch/eds/extjs42/form.html
• https://demo.rasc.ch/eds/extjs5/form.html