SpringMVC入门实例及详细讲解

SpringServletWebBeanMVC
Spring 框架提供了构建 Web
应用程序的全功能 MVC 模块。使用 Spring
可插入的 MVC 架构，可以选择是使用内置的 Spring Web
框架还是 Struts 这样的 Web
框架。通过策略接口，Spring
框架是高度可配置的，而且包含多种视图技术，例如 JavaServer Pages（JSP）技术、Velocity、Tiles、iText
和 POI。Spring MVC
框架并不知道使用的视图，所以不会强迫您只使用 JSP
技术。Spring MVC 分离了控制器、模型对象、分派器以及处理程序对象的角色，这种分离让它们更容易进行定制。

　　Spring 的 Web MVC
框架是围绕 DispatcherServlet
设计的，它把请求分派给处理程序，同时带有可配置的处理程序映射、视图解析、本地语言、主题解析以及上载文件支持。默认的处理程序是非常简单的 Controller
接口，只有一个方法 ModelAndView handleRequest(request, response)。Spring
提供了一个控制器层次结构，可以派生子类。如果应用程序需要处理用户输入表单，那么可以继承 AbstractFormController。如果需要把多页输入处理到一个表单，那么可以继承 AbstractWizardFormController。
Spring MVC对于现在较成熟的Model-View-Control框架而言，其解决的主要问题无外乎下面几部分：

1》将web页面中的输入元素封装为一个（请求）数据对象。

2》根据请求的不同，调度相应的逻辑处理单元，并将(请求)数据对象作为参数传入。

3》逻辑处理单元完成运算后，返回一个结果数据对象。

4》将结果数据对象中的数据与预先设计的表现层相融合并展现给用户。

开发步骤：
首先新建web Project项目：MySpringMvc
1.加载项目所需要的jar包;

spring.jar -------------------------这个在spring2.5.6资源包的dist下面

spring-webmvc.jar---------------这个在spring2.5.6资源包的dist/module下面
2.配置web.xml文件
<?xml version="1.0" encoding="UTF-8"?>
Xml代码


1.
<SPAN style="FONT-SIZE: large"><web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
2.
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
3.
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
4. http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"> 5.
<servlet>
6.
<servlet-name>dd</servlet-name>
7.
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
8.
<!-- <init-param>-->
9.
<!-- <param-name>contextConfigLocation</param-name>-->
10.
<!-- <param-value>/WEB-INF/applicationContext.xml</param-value>-->
11.
<!-- </init-param>-->
12.
</servlet>
13.
<!--
14.
applicationContext.xml文件代表示应用程序服务的配置和 bean 配置。如果想装入多个配置文件，可以在
15.
<param-value>标记中用逗号作分隔符。
16.
springmvc配置文件与spring配置的servlet名称有关[如本配置中是dd]

17.
通常springmvc配置文件名称结构为：[servlet-name]-servlet.xml，

18.
如果你没有指定init-param里面contextCofigLocation的值中对应的XML文件的话

19.
（也就是applicationContext全局配置文件没有配置在web.xml中的话）,那么像本

20.
段代码对应在springmvc中的配置文件就应该是/WEB-INF/dipatcher-servlet.xml这样的文件,

21.
否则如果配置了applicaitonContext.xml这样的spring全局配置文件，如本配置那么就必须为/WEB-INF/dd-servlet.xml

22.
-->
23.
<servlet-mapping>
24.
<servlet-name>dd</servlet-name>
25.
<url-pattern>*.do</url-pattern>
26.
</servlet-mapping>
27.
</web-app></SPAN>

2.由于上面的初始化参数中没有指定名字的XML文件，因此在WEB-INF下面建立
dispatcher-servlet.xml
Xml代码


1.
<SPAN style="FONT-SIZE: medium"><SPAN style="FONT-SIZE: large"><?xml version="1.0" encoding="UTF-8"?>
2.
<!--看到下面的beans这个元素标签没有，必须有标签的声明-->
3.
<beans
4.
xmlns="http://www.springframework.org/schema/beans"
5.
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
6.
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd"> 7.

8.
<!-- URL Mapping -->
9.
<bean id="urlMapping" class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
10.
<property name="mappings">
11.
<props>
12.
<prop key="/regAction.do">regAction</prop>
13.
</props>
14.
</property>
15.
</bean>
16.

17.
<!-- definition of View Resolver -->
18.
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
19.
<property name="viewClass">
20.
<value>org.springframework.web.servlet.view.JstlView</value>
21.
</property>
22.
<property name="prefix">
23.
<value>/view/</value>
24.
</property>
25.
<property name="suffix">
26.
<value>.jsp</value>
27.
</property>
28.
</bean>
29.
<!-- formController ,这个formController可以配置也可以不配置-->
30.
<bean id="formController"
31.
class="org.springframework.web.servlet.mvc.ParameterizableViewController">
32.
<property name="viewName">
33.
<value>form</value>
34.
</property>
35.
</bean>
36.

37.
<!-- Action Definition -->
38.
<bean id="regAction" class="org.lee.springmvc.demo.RegAction">
39.
<!--在MySpringMvc这个项目中就没有配置这个commandClass,
40.
因为它提前调用了setCommandClass(LoginForm.class)这个方法；这样跟下面效果一样
41.
不过还是建议配成下面这样的更好
42.
-->
43.
<property name="commandClass">
44.
<value>org.lee.springmvc.demo.RegInfo</value>
45.
</property>
46.
<property name="error_view">
47.
<value>error</value>
48.
</property>
49.
<property name="success_view">
50.
<value>success</value>
51.
</property>
52.
<property name="commandName">
53.
<value>myCommand</value>
54.
</property>
55.
</bean>
56.
</beans></SPAN></SPAN>

3.建立JSP文件
form.jsp
Html代码


1.
<SPAN style="FONT-SIZE: medium"><SPAN style="FONT-SIZE: large"><%@page contentType="text/html"%>
2.
<%@page pageEncoding="UTF-8"%>
3.
<%@taglib prefix="spring"
4.
uri="http://www.springframework.org/tags"%>
5.

6.
<%@taglib prefix="c"
7.
uri="http://java.sun.com/jsp/jstl/core"%>
8.
<html>
9.
<head>
10.
<meta http-equiv="Content-Type"

11.
content="text/html; charset=UTF-8">
12.
<title>Login Form</title>
13.
</head>
14.
<body>
15.
<h1>登入表单</h1>
16.
<spring:bind path="command.*">

17.
<font color="red">
18.
<b>${status.errorMessage}</b>
19.
</font><br>
20.
</spring:bind>
21.

22.
请输入使用者名称与密码：<p>
23.
<form name="loginform" action="login.do" method="post">

24.

25.
<spring:bind path="command.userName">

26.
名称 <input type="text" name="${status.expression}" value="${status.value}"/>
27.
<font color="red"><c:out value="${status.errorMessage}" /></font><br/>
28.

29.
</spring:bind>
30.

31.
<spring:bind path="command.password">

32.
密码 <input type="password" name="${status.expression}" value="${status.value}"/>
33.
<font color="red"><c:out value="${status.errorMessage}" /></font><br/>
34.
</spring:bind>
35.

36.
<input type="submit" value="确定"/>

37.
</form>
38.
注意：输入错误会再回到这个页面中。
39.
</body>
40.
</html></SPAN></SPAN>

4.建立jsp文件

success.jsp
Html代码


1.
<SPAN style="FONT-SIZE: medium"><SPAN style="FONT-SIZE: large"><%@page contentType="text/html"%>
2.
<%@page pageEncoding="GBK"%>
3.

4.
<html>
5.
<head>
6.
<meta http-equiv="Content-Type" content="text/html; charset=GBK">
7.
<title>登入成功</title>
8.
</head>
9.
<body>
10.
<H1>哈啰！ ${welcomeuser}！！</H1>

11.
这是您的神秘礼物！^o^<a href="login.do">退出登录</a>
12.
</body>
13.
</html></SPAN></SPAN>

5.建立一个java bean LoginForm.java
Java代码


1.
<SPAN style="FONT-SIZE: medium"><SPAN style="FONT-SIZE: large">package zz.it.beans;

2.

3.
public class LoginForm {
4.
private String userName;
5.
private String password;
6.

7.
public String getPassword() {
8.
return password;
9.
}
10.

11.
public void setPassword(String password) {
12.
this.password = password;
13.
}
14.

15.
public String getUserName() {
16.
return userName;
17.
}
18.

19.
public void setUserName(String userName) {
20.
this.userName = userName;
21.
}
22.

23.

24.
}
25.
</SPAN></SPAN>

6.建立controller LoginController.java
Java代码


1.
<SPAN style="FONT-SIZE: medium"><SPAN style="FONT-SIZE: large">package zz.it.controller;

2.

3.

4.
import org.springframework.validation.BindException;
5.
import org.springframework.web.servlet.ModelAndView;
6.
import org.springframework.web.servlet.mvc.SimpleFormController;
7.

8.
import zz.it.beans.LoginForm;
9.

10.
public class LoginController extends SimpleFormController {

11.
/**

12.
* 构造方法
13.
*/
14.
public LoginController() {
15.
// TODO Auto-generated constructor stub
16.
//setCommandClass(LoginForm.class);
17.
//这句话要是不写的话，那么在dd-servlet.xml中的loginController里面配置上如下：
18.
// <property name="commandClass">

19.
//<value>zz.it.beans.LoginForm</value>
20.
//</property>

21.
//这样效果也是一样的

22.
}
23.

24.
public ModelAndView onSubmit(Object cmd, BindException errors) {
25.
LoginForm loginForm = (LoginForm) cmd;
26.
if (loginForm.getUserName().equals("test")
27.
&& loginForm.getPassword().equals("test")) {
28.
return new ModelAndView(getSuccessView(), "welcomeuser", loginForm

29.
.getUserName());
30.
} else {
31.
errors.reject("ccc", "用户名或密码有误！");
32.
errors.rejectValue("userName", "nameErr", null, "用户名错误");

33.
errors.rejectValue("password", "passErr", null, "密码错误");

34.
return new ModelAndView(getFormView(), errors.getModel());

35.
}
36.
}
37.
}
38.
</SPAN></SPAN>

7.最后，整合部署，访问http://localhost:1234/MySpringMvc/login.do
效果图
初始登录界面

登录成功页面

登录失败页面

我估计初学者，最关心的大都有这两个问题
1.这个controller是怎样像struts那样进行封装数据的
2.<spring:bind>为什么这么用，为什么取值只能是command.xxx

1.controller是怎样进行数据封装的
要说这个问题，我不得不说SimpleFormController了
SimpleFormController是AbstractFormController的具体实现，允许你在配置文件里通过successView和formView属性来配置成功视图（表单成功提交后要转向的页面）和表单视图（显示表单的页面）；如果提交不合法（有三种可能：1.validator出错。2.bind错误，也就是说从请求中提取参数封装到command的过程中出现了类型转化错误，比如将一个含字母字符串转换为Integer。3.onBindAndValidate()方法出错），则会重新返回到表单视图；如果提交合法，onSubmit()方法的默认实现会转向成功页面，当然你可以覆写该方法在转向之前填充一些你想返回的信息。
SimpleFormController的工作流与AbstractFormController差不多，唯一的不同是你不必自己去实现showForm()和processFormSubmission()。showForm()这个方法已经被类SimpleFormController实现了并被限定为final，你不可以在继承SimpleFormController的子类里覆写这个类。processFormSubmission()这个方法尽管可以去覆写但由于它几乎可以满足所有的要求，因此一般也不会有人去重写它。

它的处理流程是这样的：
　　

get请求来到时，这样处理：
　　

1) 请求传递给一个controller对象
　　

2) 调用formBackingObject()方法，创建一个command对象的实例。　　

3) 调用initBinder()，注册需要的类型转换器
　　

4) 调用showForm()方法，返回准备呈现给用户的视图 ,如果“bindOnNewForm”属性设为true,则ServletRequestDataBinder会将初始请求参数填入一个新的表单对象，并且执行onBindOnNewForm()方法。

5) 调用referenceData()方法，准备给用户显示相关的数据。如用户登录需要选择的年度信息　　

6) 返回formView指定的视图
post请求来到时，这样处理：
　　

1) 如果sessionForm属性没有设定，则调用formBackingObject()方法，创建一个command对象的实例。否则从session中取得表单对象　　

2) 将请求传来的参数写入command对象，看它的源代码，会发现它是这样来做的：
ServletRequestDataBinder binder = createBinder(request, command);

binder.bind(request);
3）执行onBind()方法，在绑定数据之后，验证数据之前对表单数据进行一些自制的修改动作。
　　

4) 如果设置为要求验证（validateOnBinding属性被设定），则调用validator类进行数据验证　　

5) 调用onBindAndValidate()方法，该方法允许自定义数据绑定和校验处理　　

6）执行processFormSubmission()检验 Errors对象中含不含错误，如果含有错误则执行showForm()返回到填写表单页面;否则执行onSubmit()方法，进行提交表单，然后转向成功页面。
2.<spring:kind>的用法
在Spring框架体系下，可以说规约最少，最不受限制的就是表现层技术了。不像Struts，改定了好多的标签，而且有些功能还和标签绑定了。Sping也定义了一些标签，但这些标签只是给使用者提供了一些方便，并不会提供额外的功能或效果。

Sping Tag比较少，不超过十个，这里只介绍最常用的一个<sping:bind>，也叫作Spring绑定
<sping:bind>的path属性制定了与表单中的那个属性绑定，这样，${status.expression}就代表了那个属性的名称，${status.expression}代表那个属性的值。如果path属性为“XXX.*”则与那个表单的所有属性绑定。
上面的例子表单有两个属性username和password。实际上绑定方式有两种，第一种就像我的上一篇http://javacrazyer.iteye.com/blog/790834文章讲的的那样，第二种如下：
......

<spring:bind path="loginForm">

用户名：<INPUT name="userName" type="text" value="${command.userName}"/><br>

密码：<INPUT name="password" type="password" value="${command.password}"/>

</spring:bind>
这样尽管也行，但在错误信息处理上，针对用户名和密码的报错信息不会像原来那样显示出来了

所以验证我下面要说的话：
使用<sping:bind>标签，在初次进入表单页面时并不会有什么作用，而是当表单提交后，如果有BindException错误时再返回这个页面时，可以把先前的输入显示在input里。

说到错误信息处理，我又要许多要说了，来看看我前一篇文章http://javacrazyer.iteye.com/blog/790834中controller中的
errors.reject("ccc", "用户名或密码有误！");

return new ModelAndView(getFormView(), errors.getModel());
它调用了BindException的reject方法，这样，再调用BindException的getModel()方法，就把错误连同表单等信息一并返回到表单页面用以显示。
reject方法的第一个参数是错误码，如果设定了国际化资源，则显示资源文件中该错误码对应的错误条目，如果没有设定了国际化资源，则显示reject方法的第二个参数。
reject方法的不足之处是在表现层不能区分错误消息属于那个字段，即不能说明是username不对呢还是password不对。解决这种情况可以使用rejectValue方法，这也是更一般使用的方法。rejectValue方法定义如下：
rejectValue(String field, String errorCode, Object[] errorArgs, String defaultMessage)

第一个参数指定表单的域，即username或password，这样就可以分辨到底是那块出了问题；第二个参数和reject方法的第一个参数一样，制定错误码；第三个参选数制定了资源文件中的占位符；第四个参数和和reject方法的第二个参数一样。rejectValue方法还有一个简化的定义
rejectValue(String field, String errorCode, String defaultMessage)

上面是在Controller里使用的方法，使用上述方法后，若果出现BindException错误，返回表单页面时就会显示错误信息，那么如何在页面里显示错误信息呢？
上面/WEB-INF/jsp/login.jsp里由于在controller里使用的是reject方法，所以只能那么显示，如果我们使用rejectValue方法，例如改动LoginController：
errors.rejectValue("userName", "nameErr", null, "用户名错误");

errors.rejectValue("password", "passErr", null, "密码错误");
这样，就可以把页面改为如之前最后的形式
<spring:bind path="command.userName">

名称 <input type="text" name="${status.expression}" value="${status.value}"/>

<font color="red"><c:out value="${status.errorMessage}" /></font><br/>

</spring:bind>

<spring:bind path="command.password">

密码 <input type="password" name="${status.expression}" value="${status.value}"/>

<font color="red"><c:out value="${status.errorMessage}" /></font><br/>

</spring:bind>
这样错误的消息就绑定到相应的字段了。当然也可以不制定某个字段，一股脑都输出
到此，大家还是没看到我是怎样讲解command这个值的，至于为什么非要是command而不是其他值

这是因为setCommandClass这个方法是AbstractController中的一个方法，而这个

方法使用到的一个默认值public static final java.lang.String DEFAULT_COMMAND_NAME = "command";public static final java.lang.String DEFAULT_COMMAND_NAME = "command";

看到了没有，就是叫做command，所以在标签中就敢大胆的用啦

3.最后还有几个小问题
（1）一个常见的错误：

不通过controller直接访问含有spring:bind标签的JSP页面会出现下面的错误：

javax.servlet.ServletException: Neither Errors instance nor plain target object for bean name 'person' available as request attribute

解决办法：

http://spring.jactiongroup.net/viewtopic.php?p=5482
（2）星号（*）的意思

global and all field errors,

## use wildcard (*) in place of the property name

<spring:bind path="company.*">

<c:forEach items="${status.errorMessages}" var="error">

c:out value="${error}"/><br/>

</c:forEach>

</spring:bind>
（3）command的意思

3-1 commandClass

相当于struts中的ActionForm，用来封装V中的数据，方便在C中使用。
3-2 commandName

用来指定JSP中的数据需要绑定到哪个对象。默认为command

比如下面的配置中,commandName就是command

<spring:bind path='command.email'>

<td><input type='text' name='${status.expression}'

value='${status.value}' size='30'

maxlength='100'></td></tr>

</spring:bind>

因为是缺省值，所以它就不需要再在Controller中显示声明
如果在Controller中设置了setCommandName("me");则上面的配置文件需要改为：

<spring:bind path='me.email'>

<td><input type='text' name='${status.expression}'

value='${status.value}' size='30'

maxlength='100'></td></tr>

</spring:bind>

简单吧。

（4）一个要注意的问题（原文链接）

一个普通的<spring.bind>的使用类似于：
<spring:bind path="user.age">

<input type="text" name="age" value="${status.value}">

<font color="red">${status.errorMessage}</font>

</spring:bind>
需要注意的是：<input>的name属性值必须与<spring:bind>的path属性的匹配，否则就绑定不了！
例如下面的代码就绑定不了
<spring:bind path="user.age">

<input type="text" name="theAge" value="${status.value}">

<font color="red">${status.errorMessage}</font>

</spring:bind>
为了避免手误，强烈推荐下列方法来绑定：
<spring:bind path="user.age">

<input type="text" name="${status.expression}" value="${status.value}">

<font color="red">${status.errorMessage}</font>

</spring:bind>