Spring-SimpleFormController

我不是女神ヾ 2022-08-07 08:38 142阅读 0赞

## Spring-SimpleFormController ##

SimpleFormController在Controller继承体系位于最底端，是一个功能强大，而且比较复杂的Controller。下面是SimpleFormController的主要继承图谱：

[![Spring学习笔记（十二）----SimpleFormController（上）][Spring_----SimpleFormController]][Spring_----SimpleFormController_Spring_----SimpleFormController]

（摘自 [http://www.javaworld.com.tw/jute/post/view?bid=42&id=152356][http_www.javaworld.com.tw_jute_post_view_bid_42_id_152356]）

SimpleFormController本身的强大和复杂性从上图就可以看出。实际上，SimpleController除了在处理上要经过一个多步的流程，而且在处理不同类型请求时（如post，get）。（希望大家看一下上面的图和bean定义）

下面是SimpleFormController的处理流程，分为post方法和get方法。

get方法处理流程（一般连接的形式为get方法）：

1.  按请求转到相应controller；
2.  调用formBackingObject()方法，创建一个command对象的实例（如果设定了commandClass，则不需要override formBackingObject()方法了）；
3.  调用initBinder()，注册需要的类型转换器；
4.  调用showForm()方法，返回一个view，即准备呈现给用户的视图，一般情况下这个方法是不需要override的，只需设定formView即可；
5.  调用referenceData()方法。这个方法返回一个Map对象，可以把在view中需要展现的数据放入这个Map中；
6.  转到formView指定的视图。

一般情况下步骤2，3，4的方法是不需要override的，它们只需要在配置文件中进行相关属性的定义即可。而步骤5的referenceData()一般是要在自己的SimpleFormController中进行重新定义的。

post方法处理流程（一般用于处理表单）：

1.  按请求转到相应controller；
2.  调用formBackingObject()方法，创建一个command对象的实例（如果设定了commandClass，则不需要override formBackingObject()方法了）；
3.  把请求参数注入表单对象；
4.  执行onBind()方法；
5.  执行validator验证。
6.  执行onBindAndValidate()方法；
7.  若有err，则转到formView视图;
8.  执行onSubmit()方法或doSubmitAction()方法。

同处理get方法一样，步骤2的formBackingObject()方法一般是不会去重载的。步骤3也不需要我们做什么。真正需要我们做的是4，5，6，8步。当然4，5，6是可选的，如果有需要，可以去实现它们中的一个或几个，执行的步骤是按上面的顺序。但步骤8的两个方法是必须选一个的（两个都override是没有意义的）。

这里要说明一下onSubmit()方法和doSubmitAction()方法。在SimpleFormController中，有三种形式的onSubmit方法，它们是：

*  onSubmit(req, res, command, errs);
 *  onSubmit(command, errs);
 *  onSubmit(command);

但是这三种方法不是孤立的，第一个方法在执行中会调用第二个方法，第二个方法在执行中会调用第三个方法。一般在定义自己的SimpleFormController时只是override onSubmit(command)方法。

doSubmitAction()方法是一个有意思的方法，它的完整定义如下：

它的返回类型是void，而不是我们预想的ModelAndView，并且也不返回任何视图层需要的数据。实际上doSubmitAction执行完毕后会自动转到successView视图。并且如果配合sessionForm来使用的的话（sessionForm设为true），那么在转到successView视图后，在session中可以取到先前的表单对象（所谓的POJO）。

说了这么多，还是看个实例比较形象（SimpleFormController(中)）。

下面是一个SimpleFormController的实例，虽然有些地方显得吹毛求疵，但主要是为了表达一个完整的流程。

首先先看配置文件，web.xml就不说了，下面的是 **/WEB-INF/mvc-config.xml**:

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:97.6%; height:23px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td>&lt;?xml version="1.0" encoding="UTF-8"?&gt; &lt;!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "<a href="http://www.springframework.org/dtd/spring-beans.dtd" rel="nofollow">http://www.springframework.org/dtd/spring-beans.dtd</a>"&gt; &lt;beans&gt; &lt;!--InternalResourceViewResolver--&gt; &lt;bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"&gt; &lt;property name="prefix"&gt; &lt;value&gt;/WEB-INF/jsp/&lt;/value&gt; &lt;/property&gt; &lt;property name="suffix"&gt; &lt;value&gt;.jsp&lt;/value&gt; &lt;/property&gt; &lt;/bean&gt; &lt;!--SimpleUrlHandlerMapping--&gt; &lt;bean id="urlHandlerMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping"&gt; &lt;property name="mappings"&gt; &lt;props&gt; &lt;prop key="/user.htm"&gt;userController&lt;/prop&gt; &lt;/props&gt; &lt;/property&gt; &lt;/bean&gt; &lt;/beans&gt;</td> 
 </tr> 
 </tbody> 
</table>

然后是**/WEB-INF/controller-config.xml**:

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:104.44%; height:413px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td>&lt;?xml version="1.0" encoding="UTF-8"?&gt; &lt;!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "<a href="http://www.springframework.org/dtd/spring-beans.dtd" rel="nofollow">http://www.springframework.org/dtd/spring-beans.dtd</a>"&gt; &lt;beans&gt; &lt;bean id="userValidator" class="com.yangsq.validator.UserValidator"/&gt; &lt;bean id="userController" class="com.yangsq.controller.UserController"&gt; &lt;property name="commandName"&gt; &lt;value&gt;command&lt;/value&gt; &lt;/property&gt; &lt;property name="commandClass"&gt; &lt;value&gt;com.yangsq.domain.User&lt;/value&gt; &lt;/property&gt; &lt;property name="validator"&gt; &lt;ref bean="userValidator" /&gt; &lt;/property&gt; &lt;property name="formView"&gt; &lt;value&gt;user&lt;/value&gt; &lt;/property&gt; &lt;property name="successView"&gt; &lt;value&gt;hello&lt;/value&gt; &lt;/property&gt; &lt;/bean&gt; &lt;/beans&gt;</td> 
 </tr> 
 </tbody> 
</table>

这里需要对上面的配置文件进行说明。commandName属性的设置是为了可以在页面中使用Spring tag，对业务流程没有影响，如果不想使用Spring tag，则这个属性可以没有。commandClass指定了封装表单的类，注意，要指定完整的路径，不能只指定一个类名，也不能<ref .../>。validator的设定说明了要使用验证器。formView和successView这两个属性设定了转向的页面，它们是父类所具有的，所以不需要在你的controller中再注入了。

下面是验证器：

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:99.06%; height:22px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td> import org.springframework.validation.Errors; import org.springframework.validation.Validator; import com.yangsq.domain.User; public class UserValidator implements Validator{ public boolean supports(Class clazz) { return clazz.equals(User.class); } public void validate(Object obj, Errors err) { User user = (User) obj; if (user.getPhone().length() &lt; 7) { user.setCreateTime(null); err.reject("phoneErr", "电话号码位数要大于7"); }else if (user.getAge() &lt;= 0) { user.setCreateTime(null); err.reject("ageErr", "年龄要大于0"); } } } </td> 
 </tr> 
 </tbody> 
</table>

验证器实现了Validator借口，supports和validate这两个方法是必须实现的。验证器的主要任务是对表单类进行验证，这时请求的数据已经封装到表单类里了。

下面是表单类:

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:102.38%; height:22px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td>public class User { private String account; private String phone; private int age; private String city; private Date createTime; public String getAccount() { return account; } public void setAccount(String account) { this.account = account; } public int getAge() { return age; } public void setAge(int age) { this.age = age; } public String getPhone() { return phone; } public void setPhone(String phone) { this.phone = phone; } public Date getCreateTime() { return createTime; } public void setCreateTime(Date createTime) { this.createTime = createTime; } public String getCity() { return city; } public void setCity(String city) { this.city = city; } }</td> 
 </tr> 
 </tbody> 
</table>

属性包括用户名称，电话，年龄，城市和创建日期。此外，为了表达一个完成的演示，还创建了一个city类：

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:100.72%; height:22px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td>public class City { private String cityName; private String cityNo; public String getCityName() { return cityName; } public void setCityName(String cityName) { this.cityName = cityName; } public String getCityNo() { return cityNo; } public void setCityNo(String cityNo) { this.cityNo = cityNo; } }</td> 
 </tr> 
 </tbody> 
</table>

下面就是这个例子的主角，UserController：

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:100.31%; height:22px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td> public class UserController extends SimpleFormController { protected Map referenceData(HttpServletRequest req) throws Exception { Map map = new HashMap(); List cityList = new ArrayList(); City city1 = new City(); city1.setCityName("BeiJing"); city1.setCityNo("010"); cityList.add(city1); City city2 = new City(); city2.setCityName("ShangHai"); city2.setCityNo("020"); cityList.add(city2); map.put("cityList", cityList); return map; } protected void onBind(HttpServletRequest req, Object obj) throws Exception { User user = (User) obj; //format the infor user.setAccount(user.getAccount().trim()); user.setPhone(user.getPhone().trim()); } protected void onBindAndValidate(HttpServletRequest req, Object obj, BindException err) throws Exception { User user = (User) obj; user.setCreateTime(new Date()); } protected ModelAndView onSubmit(Object obj) throws Exception { User user = (User) obj; return new ModelAndView(this.getSuccessView(), "user", user); } } </td> 
 </tr> 
 </tbody> 
</table>

下面是使用到的页面 user.jsp的主要部分（表单）：

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:101.13%; height:22px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td>&lt;FORM action="user.htm" method="post"&gt; &lt;TABLE&gt; &lt;TBODY&gt; &lt;TR&gt; &lt;TD&gt; &lt;spring:bind path="command.account"&gt; 用户名：&lt;INPUT name="${status.expression}" type="text" value="${status.value}"/&gt; &lt;/spring:bind&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;spring:bind path="command.age"&gt; 年龄：&lt;INPUT name="${status.expression}" type="text" value="${status.value}"/&gt; &lt;/spring:bind&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;spring:bind path="command.phone"&gt; 电话号码：&lt;INPUT name="${status.expression}" type="text" value="${status.value}"/&gt; &lt;/spring:bind&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;spring:bind path="command.city"&gt; 城市： &lt;SELECT name="${status.expression}"&gt; &lt;c:forEach items="${cityList}" var="city" varStatus="loopStep"&gt; &lt;OPTION value="${city.cityNo}" &lt;c:if test="${city.cityNo == status.value}"&gt;selected&lt;/c:if&gt;&gt; &lt;c:out value="${city.cityName}"/&gt; &lt;/OPTION&gt; &lt;/c:forEach&gt; &lt;/SELECT&gt; &lt;/spring:bind&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;spring:bind path="command.*"&gt; &lt;c:out value="${status.errorMessage}"/&gt; &lt;/spring:bind&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD align="center"&gt; &lt;INPUT type="submit" value="提交" /&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;/TBODY&gt; &lt;/TABLE&gt; &lt;/FORM&gt;</td> 
 </tr> 
 </tbody> 
</table>

hello.jsp的主要部分：

<table style="border-bottom:#999 1px solid; border-left:#999 1px solid; width:97.4%; height:22px; font-size:12px; border-top:#999 1px solid; border-right:#999 1px solid"> 
 <tbody> 
 <tr> 
 <td>&lt;TABLE&gt; &lt;TBODY&gt; &lt;TR&gt; &lt;TD&gt; User infor: &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;c:out value="${user.account}" /&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;c:out value="${user.age}" /&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;c:out value="${user.phone}" /&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;c:out value="${user.city}" /&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;TR&gt; &lt;TD&gt; &lt;c:out value="${user.createTime}" /&gt; &lt;/TD&gt; &lt;/TR&gt; &lt;/TBODY&gt; &lt;/TABLE&gt;</td> 
 </tr> 
 </tbody> 
</table>

在 SimpleFormController（下）会结合效果图，说明一下整个流程：

在地址栏中直接输入地址 [http://localhost:8080/SpringMVC/user.htm][http_localhost_8080_SpringMVC_user.htm]（SpringMVC是工程名），会显示如下页面（user.jsp）：

处理原理：在地址栏输入地址提交后，实际上是对user.htm的一个get请求，在 SimpleFormController（上）里介绍了SimpleFormController对get方法的处理流程。这里会执行UserController的referenceData方法。在referenceData方法里生成了一个城市类的List。用于user.jsp（formView）的城市下来框。

在上图框体内填入信息：

点击提交，会出现如下页面：

处理原理：填入信息后点击提交，会以user.htm路径按post方法提交表单，在 SimpleFormController（上）里介绍了SimpleFormController对post方法的处理流程。在UserController里，首先会执行onBind方法，然后是UserValidator类（验证器），然后是onBindAndValidate方法。由于UserValidator类检验出了错误（电话号码位数不够），所以执行完onBindAndValidate方法后会转到user.jsp（formView）。而不会执行onSubmit方法。

修改电话号码：

点击提交：

转到hello.jsp(successView)页面。

处理原理：填入信息后点击提交，会以user.htm路径按post方法提交表单。处理流程和上述失败时差不多。只是在执行完onBindAndValidate方法后由于没有了错误，接着执行onSubmit方法。

以上是整个的处理流程。

[Spring_----SimpleFormController]: http://s5.sinaimg.cn/orignal/4b86f2eef323726f868f4
[Spring_----SimpleFormController_Spring_----SimpleFormController]: /images/20220805/b71f985e14c94d5baa1fe6957a4a8cfe.png
[http_www.javaworld.com.tw_jute_post_view_bid_42_id_152356]: http://www.javaworld.com.tw/jute/post/view?bid=42&id=152356
[http_localhost_8080_SpringMVC_user.htm]: http://localhost:8080/SpringMVC/user.htm

Spring-SimpleFormController

发表评论取消回复

还没有评论，来说两句吧...

相关阅读