[TOC]
# Hello SpringMVC
## 简介
Spring Web MVC 是一种基于 Java 的实现了 Web MVC 设计模式的请求驱动类型的轻量级 Web 框架，即使用了 MVC 架构模式的思想，将 Web 层进行职责解耦，基于请求驱动指的就是使用**请求-响应**模型，框架的目的就是帮助我们简化开发，Spring Web MVC 可以简化日常 Web 开发。
## Spring Web MVC 能帮我们做什么
* 让我们能非常简单的设计出干净的 Web 层和薄薄的 Web 层；
* 进行更简洁的 Web 层的开发；
* 天生与 Spring 框架集成（如 IoC 容器、AOP 等）；
* 支持灵活的 URL 到页面控制器的映射；
> 基于框架的程序要成功运行，对于JAR包的版本，配置文件的正确性有着苛刻的要求，任何一个地方出错了，都会导致框架程序运行失败。
>
> 技巧： 学习框架，**务必严格按照教程的指导，完全模仿操作**，直到成功看到运行效果。 第一次成功之后，信心，思路都会有较好的铺垫，然后再根据自己的疑惑，在“成功”的代码上做原本想做的改动和调整，这样可以大大节约学习的时间，提高效率，**切勿一来就擅自改动**，给自己的学习制造障碍。
## 步骤 1 : 先运行，看到效果，再学习
Spring MVC需要做不少步骤，任何一步部做漏了，做错了，都有可能失败，这样会影响学习的信心，并且误以为本教程是走不通的。
先可运行项目 springmvc.rar（向老师要相关资料），解压后导入到eclipse中，启动Tomcat，观察是否正常运行。确定可以运行，确定教程是可以跑得起来的，再学习下面的内容。
部署成功自后，测试地址，应该看到如图所示的效果
`http://localhost:8080/springmvc/index`
## 步骤 2 : 模仿和排错
在确保可运行项目能够正确无误地运行之后，再严格照着教程的步骤，对代码模仿一遍。
模仿过程难免代码有出入，导致无法得到期望的运行结果，此时此刻通过比较**正确答案** ( 可运行项目 ) 和自己的代码，来定位问题所在。
采用这种方式，**学习有效果，排错有效率**，可以较为明显地提升学习速度，跨过学习路上的各个槛。
## 步骤 3 : 创建项目springmvc
在eclipse中新建项目springmvc，使用dynamic web project的方式。
## 步骤 4 : 导入jar包
拿到lib.rar（向老师要相关资料），并解压拷贝jar放到lib文件夹中；
> 使用老师提供的jar包，因为不同的jar包，因版本的不同，会导致**兼容性问题**。
## 步骤 5 : web.xml
配置Spring MVC的入口 DispatcherServlet，把所有的请求都提交到该Servlet
注意：`<servlet-name>springmvc</servlet-name>`
springmvc这个名字在下一步会用到。
~~~
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<display-name>springmvc</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>
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
~~~
## 步骤 6 : 创建springmvc-servlet.xml
在WEB-INF目录下创建 springmvc-servlet.xml
springmvc-servlet.xml 与上一步中的
`<servlet-name>springmvc</servlet-name>`
springmvc对应
~~~
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
<bean id="simpleUrlHandlerMapping"
class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
<property name="mappings">
<props>
<prop key="/index">indexController</prop>
</props>
</property>
</bean>
<bean id="indexController" class="com.dodoke.controller.IndexController"></bean>
</beans>
~~~
这是Spring MVC的**映射配置文件**
表示访问路径/index会交给`id=indexController`的bean处理
`id=indexController`的bean配置为类：IndexController。
## 步骤 7 : 控制类 IndexController
控制类 IndexController实现接口Controller ，提供方法handleRequest处理请求
SpringMVC通过 ModelAndView 对象把模型和视图结合在一起。
~~~
package com.dodoke.controller;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;
public class IndexController implements Controller {
@Override
public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
ModelAndView mav = new ModelAndView("index.jsp");
mav.addObject("message", "Hello SpringMVC");
return mav;
}
}
~~~
> ModelAndView注意引用正确的包。
> import org.springframework.web.servlet.ModelAndView; //正确
import org.springframework.web.portlet.ModelAndView; //错误
## 步骤 8 : 准备index.jsp
在WebContent目录下创建index.jsp
index.jsp很简单，通过EL表达式显示message的内容
~~~
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Insert title here</title>
</head>
<body>
<h1>${message }</h1>
</body>
</html>
~~~
## 步骤 9 : 部署在tomcat中，重启测试
部署在Tomcat中，重启tomcat，然后访问地址，观察效果
`http://localhost:8080/springmvc/index`
## 步骤 10 : 原理图
1. 用户访问 /index
2. 根据web.xml中的配置 所有的访问都会经过DispatcherServlet
3. 根据配置文件springmvc-servlet.xml ，访问路径/index，会进入IndexController类
4. 在IndexController中指定跳转到页面index.jsp，并传递message数据
5. 在index.jsp中显示message信息
> 一般说来，根据步骤一步一步的做过来，就可以运行看到结果了。
如果实在看不到结果，多半是因为中间某个步骤不够仔细，大小写错误，多了个下划线等等细微的错误。
## 常见问题
1. 为什么加载index.jsp请求不到后台的数据，而请求index就可以
> 访问index路径发出请求，springmvc通过这个请求进入对应的控制器，在控制器里面将视图和模型结合起来，也就是index.jsp和message,最后跳转到index.jsp界面，这个界面上的数据就是message的内容。
>`${message}` 这里，message这个数据模型是从控制器里拿出来再放到index.jsp上。如果直接访问index.jsp这个静态资源，是无法取得后台数据。
>
>补充说明：根据`<prop key="/index">indexController</prop>` ，搜index的时候，会交给`<bean id="indexController" class="com.dodoke.controller.IndexController"></bean>`也就是IndexController类处理，IndexController实现接口Controller ，提供方法handleRequest处理请求。
2. 为什么根据“springmvc-servlet.xml”这个文件的命名就可以对应到springmvc？
> 是的，这里的命名规则是{servlet-name}-servlet.xml。你在web.xml里的servlet-name是什么就查找对应的文件。
3. `<url-pattern>/</url-pattern>`的 / 是什么意思，以前用的是/*，这个是指任意访问路径吧？那 / 表示什么意思呢？
> /* 可以拦截一切路径，比如 index, index.jsp, index.html这些都可以被拦截
/ 只能拦截url请求路径，也就是index这种，带有后缀名的就不能被拦截
4. 此处的message是对象？有一个属性值是hello spring mvc？然后在index.jsp获得这个属性值？但EL表达式是${message}很像从session中取值的样子
> 这是把message设置在request作用域中，然后服务端跳转到index.jsp，之后利用EL表达式取值。
