SimpleFormController 工作流

SimpleFormController 工作流

很久前，对SimpleFormController 和AbstractWizardFormController做过一段深入的分析，并对向导型的做了个实例，但是估计是很少动手了，现在对这些东西又模糊了，我快疯了。
      需要注意的是这两个控制器都是横跨两个页面的控制器，一个是get进入修改或新增页面，另一个就是页面提交即保存或增加

      由于SimpleFormController是继承AbstractFormController，在该AbstractFormController中的handleRequestInternal方法需要判断当前提交的方法是Get还是Post，如果是Get则是New一个View，如果是Post则是运行客户端业务逻辑，然后跳转到成功页面。

•  通过Get 方式请求一个View

1、Controller受到一个Get请求；

2、formBackingObject()方法，如果需要读取数据库，这里是一个比较好的地方去做这件事情。然后将Object通过request.setAttribute来传递到页面；如果页面表单需要绑定多个Object，可以在这里读取数据库取得，然后设置到页面上。

3、initBinder() 这里是用来进行数据格式化转换的；如果在页面上显示某些类型需要进行格式化显示，那么需要在XXXXFormController中重载该方法，指定特定的转换器完成对特定Object的设置。如对于日期格式需要在本方法中增加如下代码：

binder.registerCustomEditor(Date.class, null, new CustomDateEditor(

new SimpleDateFormat("MM/dd/yyyy"),true));

4、调用AbstractFormController.handleRequestInternal方法，在该方法中判断，如果是新建一个Form View，则调用ShowNewForm方法，在ShowNewForm方法中调用了ShowForm方法，SimpleFormController实现了此方法，指向的url是Controller中注册的formView参数。

6、View 模块完成，显示给用户。

 

• 通过Post方式提交一个Form

1、  提交后根据Action指向的URL在urlMapping配置中找到指定的Controller；

2、  如果配置了Validator则使用该Validator（见applicationContext-validation.xml）进行相关的验证；缺省是beanValidator。错误信息写入到errors参数里。

3、  调用AbstractFormController.handleRequestInternal方法，在该方法中判断是通过Post来调用此方法，则调用processFormSubmission方法，该方法会先判断errors中是否有验证错误，如果有则返回到原表单页面，显示错误信息。

4、  验证通过后进入onSubmit方法，该方法的command参数对应绑定到页面的对象，

如果在表单中有多个对象需要进行绑定，那么其它对象可以通过this.bindAndValidate(HttpServletRequest request, Object command);方法来进行绑定。

5、  做相关的业务操作。

6、  往返回界面上输出结果提示信息，通过getText和saveMessage()方法完成。getText()第一个参数是在资源文件中的信息代码，第二个参数是发给该信息的参数，在该信息中通过{0}来读取，第三个参数是当前使用的Locale。saveMessage()的信息显示是通过common/messages.jsp来进行。

7、  返回一个ModelAndView(new RedirectView(success))，success对应action-servlet.xml文件该Controller所配置successView，跳转路径是相对路径。

而对于MultiActionController来说，要么继承这个类，要么给它设个delegate，注意不能类中出现方法多态。相对简单一些

 

SimpleFormController流程 引用

SimpleFormController往上繼承自AbstractFormController，而又繼承自AbstractController，
這是開始實作Controller介面的基底類別，再往上的兩個類別各司WebApplicationContext與Http response的資源。

　　對於簡單的表單需求，我們通常透過繼承SimpleFormController，並覆寫其onSumit()方法來完成表單功能，
而實際上真正的表單處理流程定義在AbstractFormController

　　這邊說明三個我覺得比較常用且不複雜的方法，在繼承了SimpleFormController（AbstractFormController）之後，
您可以覆寫這些方法：formBackingObject()、referenceData()、onBindAndValidate()。

　　當瀏覽器使用GET方法向Action發出請求時，會調用formBackingObject()方法，您可以在這個方法中預先設定好表單物件，在表單網頁中就會顯示表單的預設值，例如：

java 代码

1. protected Object formBackingObject(HttpServletRequest request) throws Exception {   
2.     LoginForm loginForm = new LoginForm();   
3.     loginForm.setUsername("guest");   
4.     loginForm.setPassword("guest");   
5.   
6.     return loginForm;   
7. }  

在使用者送出資料之後，如果sessionForm為false，則會再呼叫formBackingObject()方法取得表單物件，若sessionForm設定為true，則會試著有session中找尋表單物件。

您可以在referenceData()中定義一些JSP頁面可以參考到的參數，例如：

java 代码

1. protected Map referenceData(HttpServletRequest request) throws Exception {   
2.     Map ref = new HashMap();   
3.     ref.put("defalutUser", "guest");   
4.   
5.     return ref;   
6. }  

 

onBindAndValidate()就如其名所示，當表單物件的資料已經綁定，並且還沒開始驗證之前，您可以試著在這個方法中作一些預處理，例如進行字母大小寫轉換，附帶一些額外的資訊等等：

java 代码

1. protected void onBindAndValidate(HttpServletRequest request, Object command, BindException errors) throws Exception {   
2.  }  

url请求来到时，这样处理：
　　　　a) 请求传递给一个controller对象
　　　　b) 调用formBackingObject()方法，创建一个command对象的实例。
　　　　c) 调用initBinder()，注册需要的类型转换器
　　　　d) 调用showForm()方法，返回准备呈现给用户的视图
　　　　e) 调用referenceData()方法，准备给用户显示相关的数据。如用户登录需要选择的年度信息
　　　　f) 返回formView指定的视图
表单请求来到时，这样处理：
　　　　a) 调用formBackingObject()方法，创建一个command对象的实例。
　　　　b) 将请求传来的参数写入command对象
　　　　c) 如果设置为要求验证，则调用validator类进行数据验证
　　　　d) 调用onBindAndValidate()方法，该方法允许自定义数据绑定和校验处理
　　　　e) 调用onSubmit()方法，进行业务逻辑处理