Hello SpringMVC · 教案-标准教案-Java(v1)

[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` ![](https://box.kancloud.cn/3562460d2dad52d748734138eaba9139_526x177.png) ## 步骤 2 : 模仿和排错在确保可运行项目能够正确无误地运行之后，再严格照着教程的步骤，对代码模仿一遍。模仿过程难免代码有出入，导致无法得到期望的运行结果，此时此刻通过比较**正确答案** ( 可运行项目 ) 和自己的代码，来定位问题所在。采用这种方式，**学习有效果，排错有效率**，可以较为明显地提升学习速度，跨过学习路上的各个槛。 ## 步骤 3 : 创建项目springmvc 在eclipse中新建项目springmvc，使用dynamic web project的方式。 ![](https://box.kancloud.cn/3e41c3b16f7ede994ca633990a677e25_590x230.png) ## 步骤 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的内容 ![](https://box.kancloud.cn/ff1b084b61c1ea9121b5d18826eb6712_445x415.png) ~~~ <%@ 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` ![](https://box.kancloud.cn/3df7dc76fc852fbda8ce672a49c6b0e8_523x245.png) ## 步骤 10 : 原理图 1. 用户访问 /index 2. 根据web.xml中的配置所有的访问都会经过DispatcherServlet 3. 根据配置文件springmvc-servlet.xml ，访问路径/index，会进入IndexController类 4. 在IndexController中指定跳转到页面index.jsp，并传递message数据 5. 在index.jsp中显示message信息 ![](https://box.kancloud.cn/48e91182736a7fb1d981838a5b4cd76b_893x620.png) > 一般说来，根据步骤一步一步的做过来，就可以运行看到结果了。如果实在看不到结果，多半是因为中间某个步骤不够仔细，大小写错误，多了个下划线等等细微的错误。 ## 常见问题 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表达式取值。