定义继承AbstractCommandController的控制器,实现数据的自动封装
Controller
package com.hsit.controller;
import java.text.SimpleDateFormat;
import java.util.Date;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.beans.factory.config.CustomEditorConfigurer;
import org.springframework.beans.propertyeditors.CustomDateEditor;
import org.springframework.validation.BindException;
import org.springframework.web.bind.ServletRequestDataBinder;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.AbstractCommandController;
import com.hsit.pojo.UserInfo;
public class UserInfoController extends AbstractCommandController {
@Override
protected ModelAndView handle(HttpServletRequest request,
HttpServletResponse response, Object command, BindException errors)
throws Exception {
// TODO Auto-generated method stub
UserInfo user = (UserInfo) command;
System.out.println(user);
return null;
}
}
JavaBean
package com.hsit.pojo;
import java.util.Date;
public class UserInfo {
private String username;
private String password;
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
@Override
public String toString() {
return "username=" + username + ",password=" + password;
}
}
jsp 视图
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title></title>
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<!--
<script type="text/javascript" src="js/*.js"></script>
<link rel="stylesheet" type="text/css" href="styles.css">
-->
</head>
<body>
<center>
<form action="Login.do" method="post">
用户名:<input type="text" name="username" size="20"/><br>
账 号:<input type="password" name="password" size="20"><br>
<!--name名字一定要和UserInfo的属性名一样,才能正确封装-->
<input type="submit" value="提交">
</form>
</center>
</body>
</html>
配置如下
<?xml version="1.0" encoding="UTF-8"?>
<beans
xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:p="http://www.springframework.org/schema/p"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">
<!-- 配置处理器映射采用SimpleUrlHandlerMapping -->
<bean class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<!-- props底下的prop标签内填写的key都是符合转发条件的url值,之后跟的是bean的ID,
如果输入的url值与key值中的url匹配,则执行对应beanID绑定的Controller -->
<props>
<prop key="go.do">go</prop>
<prop key="test.do">test</prop>
<prop key="goLogin.do">goLogin</prop>
<prop key="Login.do">Login</prop>
</props>
</property>
</bean>
<!-- 配置视图解释器 -->
<bean class="org.springframework.web.servlet.view.UrlBasedViewResolver">
<property name="viewClass" value="org.springframework.web.servlet.view.JstlView" />
<!-- 属性prefix和suffix指定的是你的视图文件所在的路径,以及他的后缀是什么(就是类型)
以下指的就是 /WEB-INF/jsp/*.jsp
-->
<property name="prefix" value="/WEB-INF/jsp/" />
<property name="suffix" value=".jsp"></property>
</bean>
<!-- 控制器配置 -->
<bean id="goLogin" class="org.springframework.web.servlet.mvc.ParameterizableViewController">
<property name="viewName" value="login" />
</bean>
<!-- 属性commandClass的value值设置成数据要封装成什么类型,执行到该控制器时就会自动将数据封装成UserInfo-->
<bean id="Login" class="com.hsit.controller.UserInfoController">
<property name="commandClass" value="com.hsit.pojo.UserInfo" />
</bean>
</beans>
地址栏:http://colo-pc:8080/SpringMVC01/goLogin.do
输入框中输入的用户名和密码将会自动封装到UserInfo对应的属性中去
但是有一种情况我们不能成功将数据封装起来,如果.jsp界面要我们输入的信息有包括时间的话,Controller不能正确将输入框中的时间正确封装成为Date对象,因为输入框中的值带到Controller中时,都是String类型的。这时候我们就要在Controller中重写一个方法initBinder,来进行数据格式转换。
配置文件不变
jsp在表单中添加
日 期:<input type="text" name="date" size="20"><br><br>
Controller.java
package com.hsit.controller;
import java.text.SimpleDateFormat;
import java.util.Date;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.beans.propertyeditors.CustomDateEditor;
import org.springframework.validation.BindException;
import org.springframework.web.bind.ServletRequestDataBinder;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.AbstractCommandController;
import com.hsit.pojo.UserInfo;
public class UserInfoController extends AbstractCommandController {
@Override
protected ModelAndView handle(HttpServletRequest request,
HttpServletResponse response, Object command, BindException errors)
throws Exception {
// TODO Auto-generated method stub
UserInfo user = (UserInfo) command;
System.out.println(user);
return null;
}
@Override
protected void initBinder(HttpServletRequest request,
ServletRequestDataBinder binder) throws Exception {
/*数据转换成Date类型*/
binder.registerCustomEditor(Date.class, new CustomDateEditor(
new SimpleDateFormat("yyyy-MM-dd"), true));
}
}
(引自Spring in Action -- 命令控制器(如AbstractCommandController,BaseCommandController),通过将请求参数绑定到命令对象来简化请求的处理。请求参数可以通过URL参数或Web表单字段得到。尽管命令控制器可以处理表单输入,Spring还是提供了另一种可以为处理表单提供更好支持的控制器。下面,让我们来介绍Spring的表单控制器(如AbstractFormController,SimpleFormController。)
今天来介绍一下Spring的AbstractCommandController。Spring的Controller有很多选择,在你的应用中选择最合适的一个将会让你事半功倍。Spring Controller有一个自上而下的等级分类,基本上是从简单到复杂:
Controller, AbstractController
-->
ThrowawayController
-->
MultiActionController
-->
BaseCommandController, AbstractCommandController
-->
AbstractFormController, SimpleFormController
-->
AbstractWizardFormController
如果Controller中不需要处理逻辑事务,或者只需要少量的功能,大都可以继承AbstractController。如果需要处理请求中的输入,那么可以继承AbstractCommandController。这就是今天要介绍的内容。注意,环境参照Spring的简单例子。
首先,我们编写一个index.jsp:
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta. http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Index Page</title>
</head>
<body>
<center>
<form. action="user.do" method="post">
Username:<input type="text" name="username" /><br/>
Password:<input type="password" name="password" /><br/>
<input type="submit" value="Submit" />
</form>
</center>
</body>
</html>
这里我们要接收username和password两个参数。
然后配置web.xml:
<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2eehttp://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<servlet>
<servlet-name>test</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>test</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
<display-name>
SpringTest</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
</web-app>
test-servlet.xml:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean name="/user.do" class="src.UserCommandController">
<property name="page">
<value>user</value>
</property>
</bean>
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix">
<value>/WEB-INF/jsp/</value>
</property>
<property name="suffix">
<value>.jsp</value>
</property>
</bean>
</beans>
我们先写一个User类,可以看成User Bean(User.java):
package src;
public class User {
private String username;
private String password;
public User(){
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
}
这里也就两个属性即username和password,同时还有相应的get和set方法。
然后就是UserCommandController.java:
package src;
import java.util.ArrayList;
import java.util.List;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.validation.BindException;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.AbstractCommandController;
public class UserCommandController extends AbstractCommandController{
private String page;
public UserCommandController(){
setCommandClass(User.class);
}
public ModelAndView handle(HttpServletRequest request,
HttpServletResponse response,
Object command,
BindException errors) throws Exception{
User user = (User)command;
String username = user.getUsername();
String password = user.getPassword();
List list = new ArrayList();
list.add(0, username);
list.add(1, password);
return new ModelAndView(getPage(), "info", list);
}
public String getPage() {
return page;
}
public void setPage(String page) {
this.page = page;
}
}
这个控制器要处理输入的username和password(很简单),不像在Struts中必须要继承ActionForm。该类有一个要覆盖的handle()方法。在handle()方法中,command就是输入的一个对象,这里需要先转化为User类,并调用相应的方法得到username和password两个参数。然后放到一个list里面,再调用getPage()方法传回到指定的视图去。这个视图名则在test-servlet.xml中指明了为user。这里我们可以看出Spring框架的灵活性。要修改映射或者指定视图等的话只要在配置文件里面修改就可以了,而不用修改源程序。
那么接下来就是user.jsp:
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta. http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>User Information Page</title>
</head>
<body>
<center>
<h1>Your username is:${info[0] }</h1><br/>
<h1>Your password is:${info[1] }</h1>
</center>
</body>
</html>
这里就把刚刚的username和password显示了出来。
处理简单的输入可以采用AbstractCommandController,就像这个例子一样。可以根据实际情况增加相应的代码来满足不同的需求。
当然,处理表单还有SimpleFormController和AbstractFormController,以后会讲这类控制器的例子。
4.5、ServletForwardingController
将接收到的请求转发到一个命名的servlet,具体示例如下:
package cn.javass.chapter4.web.servlet;
public class ForwardingServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp)
throws ServletException, IOException {
resp.getWriter().write("Controller forward to Servlet");
}
}
<servlet>
<servlet-name>forwarding</servlet-name>
<servlet-class>cn.javass.chapter4.web.servlet.ForwardingServlet</servlet-class>
</servlet>
<!— 在chapter4-servlet.xml配置处理器 -->
<bean name="/forwardToServlet"
class="org.springframework.web.servlet.mvc.ServletForwardingController">
<property name="servletName" value="forwarding"></property>
</bean>
当我们请求/forwardToServlet时,会被转发到名字为“forwarding”的servlet处理,该sevlet的servlet-mapping标签配置是可选的。
4.6、BaseCommandController
命令控制器通用基类,提供了以下功能支持:
1、数据绑定:请求参数绑定到一个command object(命令对象,非GoF里的命令设计模式),这里的命令对象是指绑定请求参数的任何POJO对象;
commandClass:表示命令对象实现类,如UserModel;
commandName:表示放入请求的命令对象名字(默认command),request.setAttribute(commandName, commandObject);
2、验证功能:提供Validator注册功能,注册的验证器会验证命令对象属性数据是否合法;
validators:通过该属性注入验证器,验证器用来验证命令对象属性是否合法;
该抽象类没有没有提供流程功能,只是提供了一些公共的功能,实际使用时需要使用它的子类。
4.7、AbstractCommandController
命令控制器之一,可以实现该控制器来创建命令控制器,该控制器能把自动封装请求参数到一个命令对象,而且提供了验证功能。
1、创建命令类(就是普通的JavaBean类/POJO)
package cn.javass.chapter4.model;
public class UserModel {
private String username;
private String password;
//省略setter/getter
}
2、实现控制器
package cn.javass.chapter4.web.controller;
//省略import
public class MyAbstractCommandController extends AbstractCommandController {
public MyAbstractCommandController() {
//设置命令对象实现类
setCommandClass(UserModel.class);
}
@Override
protected ModelAndView handle(HttpServletRequest req, HttpServletResponse resp, Object command, BindException errors) throws Exception {
//将命令对象转换为实际类型
UserModel user = (UserModel) command;
ModelAndView mv = new ModelAndView();
mv.setViewName("abstractCommand");
mv.addObject("user", user);
return mv;
}
}
<!— 在chapter4-servlet.xml配置处理器 -->
<bean name="/abstractCommand"
class="cn.javass.chapter4.web.controller.MyAbstractCommandController">
<!-- 也可以通过依赖注入 注入命令实现类 -->
<!-- property name="commandClass" value="cn.javass.chapter4.model.UserModel"/-->
</bean>
<!— WEB-INF/jsp/abstractCommand.jsp视图下的主要内容 -->
${user.username }-${user.password }
当我们在浏览器中输入“http://localhost:9080/springmvc-chapter3/abstractCommand?username=123&password=123”,会自动将请求参数username和password绑定到命令对象;绑定时按照JavaBean命名规范绑定;
4.8、AbstractFormController
用于支持带步骤的表单提交的命令控制器基类,使用该控制器可以完成:
1、定义表单处理(表单的渲染),并从控制器获取命令对象构建表单;
2、提交表单处理,当用户提交表单内容后,AbstractFormController可以将用户请求的数据绑定到命令对象,并可以验证表单内容、对命令对象进行处理。
- @Override
- rotected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response)
- throws Exception {
- //1、是否是表单提交? 该方法实现为("POST".equals(request.getMethod())),即POST表示表单提交
- if (isFormSubmission(request)) {
- try {
- Object command = getCommand(request);
- ServletRequestDataBinder binder = bindAndValidate(request, command);
- BindException errors = new BindException(binder.getBindingResult());
- //表单提交应该放到该方法实现
- return processFormSubmission(request, response, command, errors);
- }
- catch (HttpSessionRequiredException ex) {
- //省略部分代码
- return handleInvalidSubmit(request, response);
- }
- }
- else {
- //2、表示是表单展示,该方法又转调showForm方法,因此我们需要覆盖showForm来完成表单展示
- return showNewForm(request, response);
- }
@Override protected ModelAndView handleRequestInternal(HttpServletRequest request, HttpServletResponse response) throws Exception { //1、是否是表单提交? 该方法实现为("POST".equals(request.getMethod())),即POST表示表单提交 if (isFormSubmission(request)) { try { Object command = getCommand(request); ServletRequestDataBinder binder = bindAndValidate(request, command); BindException errors = new BindException(binder.getBindingResult()); //表单提交应该放到该方法实现 return processFormSubmission(request, response, command, errors); } catch (HttpSessionRequiredException ex) { //省略部分代码 return handleInvalidSubmit(request, response); } } else { //2、表示是表单展示,该方法又转调showForm方法,因此我们需要覆盖showForm来完成表单展示 return showNewForm(request, response); } }
bindOnNewForm:是否在进行表单展示时绑定请求参数到表单对象,默认false,不绑定;
sessionForm:session表单模式,如果开启(true)则会将表单对象放置到session中,从而可以跨越多次请求保证数据不丢失(多步骤表单常使用该方式,详解AbstractWizardFormController),默认false;
Object formBackingObject(HttpServletRequest request) :提供给表单展示时使用的表单对象(form object表单要展示的默认数据),默认通过commandName暴露到请求给展示表单;
Map referenceData(HttpServletRequest request, Object command, Errors errors):展示表单时需要的一些引用数据(比如用户注册,可能需要选择工作地点,这些数据可以通过该方法提供),如:
- protected Map referenceData(HttpServletRequest request) throws Exception {
- Map model = new HashMap();
- model.put("cityList", cityList);
- return model;
- }
这样就可以在表单展示页面获取cityList数据。
SimpleFormController继承该类,而且提供了更简单的表单流程控制。
4.9、SimpleFormController
提供了更好的两步表单支持:
1、准备要展示的数据,并到表单展示页面;
2、提交数据数据进行处理。
第一步,展示:
![]()
第二步,提交表单:
接下来咱们写一个用户注册的例子学习一下:
(1、控制器
- package cn.javass.chapter4.web.controller;
- //省略import
- public class RegisterSimpleFormController extends SimpleFormController {
- public RegisterSimpleFormController() {
- setCommandClass(UserModel.class); //设置命令对象实现类
- setCommandName("user");//设置命令对象的名字
- }
- //form object 表单对象,提供展示表单时的表单数据(使用commandName放入请求)
- protected Object formBackingObject(HttpServletRequest request) throws Exception {
- UserModel user = new UserModel();
- user.setUsername("请输入用户名");
- return user;
- }
- //提供展示表单时需要的一些其他数据
- protected Map referenceData(HttpServletRequest request) throws Exception {
- Map map = new HashMap();
- map.put("cityList", Arrays.asList("山东", "北京", "上海"));
- return map;
- }
- protected void doSubmitAction(Object command) throws Exception {
- UserModel user = (UserModel) command;
- //TODO 调用业务对象处理
- System.out.println(user);
- }
- }
setCommandClass和setCommandName:分别设置了命令对象的实现类和名字;
formBackingObject和referenceData:提供了表单展示需要的视图;
doSubmitAction:用于执行表单提交动作,由onSubmit方法调用,如果不需要请求/响应对象或进行数据验证,可以直接使用doSubmitAction方法进行功能处理。
(2、spring配置(chapter4-servlet.xml)
- <bean name="/simpleForm"
- class="cn.javass.chapter4.web.controller.RegisterSimpleFormController">
- <property name="formView" value="register"/>
- <property name="successView" value="redirect:/success"/>
- </bean>
- <bean name="/success" class="cn.javass.chapter4.web.controller.SuccessController"/>
formView:表示展示表单时显示的页面;
successView:表示处理成功时显示的页面;“redirect:/success”表示成功处理后重定向到/success控制器;防止表单重复提交;
“/success” bean的作用是显示成功页面,此处就不列举了。
(3、视图页面
java代码:
- <!-- register.jsp 注册展示页面-->
- <form method="post">
- username:<input type="text" name="username" value="${user.username}"><br/>
- password:<input type="password" name="username"><br/>
- city:<select>
- <c:forEach items="${cityList }" var="city">
- <option>${city}</option>
- </c:forEach>
- </select><br/>
- <input type="submit" value="注册"/>
- </form>
<!-- register.jsp 注册展示页面--> <form method="post"> username:<input type="text" name="username" value="${user.username}"><br/> password:<input type="password" name="username"><br/> city:<select> <c:forEach items="${cityList }" var="city"> <option>${city}</option> </c:forEach> </select><br/> <input type="submit" value="注册"/> </form>
此处可以使用${user.username}获取到formBackingObject设置的表单对象、使用${cityList}获取referenceData设置的表单支持数据;
到此一个简单的两步表单到此结束,但这个表单有重复提交表单的问题,而且表单对象到页面的绑定是通过手工绑定的,后边我们会学习spring标签库(提供自动绑定表单对象到页面)。
4.10、CancellableFormController
一个可取消的表单控制器,继承SimpleFormController,额外提供取消表单功能。
1、表单展示:和SimpleFormController一样;
2、表单取消:和SimpleFormController一样;
3、表单成功提交:取消功能处理方法为:onCancel(Object command),而且默认返回cancelView属性指定的逻辑视图名。
那如何判断是取消呢?如果请求中有参数名为“_cancel”的参数,则表示表单取消。也可以通过cancelParamKey来修改参数名(如“_cancel.x”等)。
示例:
(1、控制器
复制RegisterSimpleFormController一份命名为CanCancelRegisterSimpleFormController,添加取消功能处理方法实现:
onCancel:在该功能方法内实现取消逻辑,父类的onCancel方法默认返回cancelView属性指定的逻辑视图名。
- @Override
- protected ModelAndView onCancel(Object command) throws Exception {
- UserModel user = (UserModel) command;
- //TODO 调用业务对象处理
- System.out.println(user);
- return super.onCancel(command);
- }
(2、spring配置(chapter4-servlet.xml)
- <bean name="/canCancelForm"
- class="cn.javass.chapter4.web.controller.CanCancelRegisterSimpleFormController">
- <property name="formView" value="register"/>
- <property name="successView" value="redirect:/success"/>
- <property name="cancelView" value="redirect:/cancel"/>
- </bean>
- <bean name="/cancel" class="cn.javass.chapter4.web.controller.CancelController"/>
<bean name="/canCancelForm" class="cn.javass.chapter4.web.controller.CanCancelRegisterSimpleFormController"> <property name="formView" value="register"/> <property name="successView" value="redirect:/success"/> <property name="cancelView" value="redirect:/cancel"/> </bean> <bean name="/cancel" class="cn.javass.chapter4.web.controller.CancelController"/>
cancelParamKey:用于判断是否是取消的请求参数名,默认是_cancel,即如果请求参数数据中含有名字_cancel则表示是取消,将调用onCancel功能处理方法;
cancelView:表示取消时时显示的页面;“redirect:/cancel”表示成功处理后重定向到/cancel控制器;防止表单重复提交;
“/cancel” bean的作用是显示取消页面,此处就不列举了(详见代码)。
(3、视图页面(修改register.jsp)
- <input type="submit" name="_cancel" value="取消"/>
<input type="submit" name="_cancel" value="取消"/>
该提交按钮的作用是取消,因为name="_cancel",即请求后会有一个名字为_cancel的参数,因此会执行onCancel功能处理方法。
(4、测试:
在浏览器输入“http://localhost:9080/springmvc-chapter4/canCancelForm”,则首先到展示视图页面,点击“取消按钮”将重定向到“http://localhost:9080/springmvc-chapter4/cancel”,说明取消成功了。
实际项目可能会出现比如一些网站的完善个人资料都是多个页面(即多步),那应该怎么实现呢?接下来让我们看一下spring Web MVC提供的对多步表单的支持类AbstractWizardFormController。