Spring-mvc学习

一、初始Spring MVC

1.为什么要学习Spring MVC

1. 轻量级，简单易学
2. 高效 , 基于请求响应的MVC框架
3. 与Spring兼容性好，无缝结合
4. 约定优于配置 
5. 功能强大：RESTful、数据验证、格式化、本地化、主题等
6. 简洁灵活

2.中心控制器

Spring的web框架围绕DispatcherServlet设计。 DispatcherServlet的作用是将请求分发到不同的处理器。从Spring 2.5开始，使用Java 5或者以上版本的用户可以采用基于注解的controller声明方式。

​ Spring MVC框架像许多其他MVC框架一样, 以请求为驱动 , 围绕一个中心Servlet分派请求及提供其他功能，DispatcherServlet是一个实际的Servlet (它继承自HttpServlet 基类)。

SpringMVC的原理如下图所示：

​ 当发起请求时被前置的控制器拦截到请求，根据请求参数生成代理请求，找到请求对应的实际控制器，控制器处理请求，创建数据模型，访问数据库，将模型响应给中心控制器，控制器使用模型与视图渲染视图结果，将结果返回给中心控制器，再将结果返回给请求者。

2.3、SpringMVC执行原理

图为SpringMVC的一个较完整的流程图，实线表示SpringMVC框架提供的技术，不需要开发者实现，虚线表示需要开发者实现。

简要分析执行流程

1. DispatcherServlet表示前置控制器，是整个SpringMVC的控制中心。用户发出请求，DispatcherServlet接收请求并拦截请求。

我们假设请求的url为 : http://localhost:8080/SpringMVC/hello

如上url拆分成三部分：

http://localhost:8080服务器域名

SpringMVC部署在服务器上的web站点

hello表示控制器

通过分析，如上url表示为：请求位于服务器localhost:8080上的SpringMVC站点的hello控制器。

1. HandlerMapping为处理器映射。DispatcherServlet调用HandlerMapping,HandlerMapping根据请求url查找Handler。

2. HandlerExecution表示具体的Handler,其主要作用是根据url查找控制器，如上url被查找控制器为：hello。

3. HandlerExecution将解析后的信息传递给DispatcherServlet,如解析控制器映射等。

4. HandlerAdapter表示处理器适配器，其按照特定的规则去执行Handler。

5. Handler让具体的Controller执行。

6. Controller将具体的执行信息返回给HandlerAdapter,如ModelAndView。

7. HandlerAdapter将视图逻辑名或模型传递给DispatcherServlet。

8. DispatcherServlet调用视图解析器(ViewResolver)来解析HandlerAdapter传递的逻辑视图名。

9. 视图解析器将解析的逻辑视图名传给DispatcherServlet。

10. DispatcherServlet根据视图解析器解析的视图结果，调用具体的视图。

11. 最终视图呈现给用户。

在这里先听一遍原理，不理解没有关系，我们马上来写一个对应的代码实现大家就明白了，如果不明白，那就写10遍，没有笨人，只有懒人！

二.HelloSpring

3.1、配置版

1. 新建一个Moudle ， springmvc-02-hello ， 添加web的支持！

2. 确定导入了SpringMVC 的依赖！

3. 配置web.xml ， 注册DispatcherServlet

   1. <?xml version="1.0" encoding="UTF-8"?>
   2. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
   3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   4. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
   5. version="4.0">
   7. <!--1.注册DispatcherServlet-->
   8. <servlet>
   9. <servlet-name>springmvc</servlet-name>
   10. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
   11. <!--关联一个springmvc的配置文件:【servlet-name】-servlet.xml-->
   12. <init-param>
   13. <param-name>contextConfigLocation</param-name>
   14. <param-value>classpath:springmvc-servlet.xml</param-value>
   15. </init-param>
   16. <!--启动级别-1-->
   17. <load-on-startup>1</load-on-startup>
   18. </servlet>
   20. <!--/ 匹配所有的请求；（不包括.jsp）-->
   21. <!--/* 匹配所有的请求；（包括.jsp）-->
   22. <servlet-mapping>
   23. <servlet-name>springmvc</servlet-name>
   24. <url-pattern>/</url-pattern>
   25. </servlet-mapping>
   27. </web-app>

4. 编写SpringMVC 的 配置文件！名称：springmvc-servlet.xml : [servletname]-servlet.xml

   说明，这里的名称要求是按照官方来的

   1. <?xml version="1.0" encoding="UTF-8"?>
   2. <beans xmlns="http://www.springframework.org/schema/beans"
   3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   4. xsi:schemaLocation="http://www.springframework.org/schema/beans
   5. http://www.springframework.org/schema/beans/spring-beans.xsd">
   7. </beans>

5. 添加 处理映射器

   1. <bean class="org.springframework.web.servlet.handler.BeanNameUrlHandlerMapping"/>

6. 添加 处理器适配器

   1. <bean class="org.springframework.web.servlet.mvc.SimpleControllerHandlerAdapter"/>

7. 添加 视图解析器

   1. <!--视图解析器:DispatcherServlet给他的ModelAndView-->
   2. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver" id="InternalResourceViewResolver">
   3. <!--前缀-->
   4. <property name="prefix" value="/WEB-INF/jsp/"/>
   5. <!--后缀-->
   6. <property name="suffix" value=".jsp"/>
   7. </bean>

8. 编写我们要操作业务Controller ，要么实现Controller接口，要么增加注解；需要返回一个ModelAndView，装数据，封视图；

   1. package com.kuang.controller;
   3. import org.springframework.web.servlet.ModelAndView;
   4. import org.springframework.web.servlet.mvc.Controller;
   6. import javax.servlet.http.HttpServletRequest;
   7. import javax.servlet.http.HttpServletResponse;
   9. //注意：这里我们先导入Controller接口
   10. public class HelloController implements Controller {
   12. public ModelAndView handleRequest(HttpServletRequest request, HttpServletResponse response) throws Exception {
   13. //ModelAndView 模型和视图
   14. ModelAndView mv = new ModelAndView();
   16. //封装对象，放在ModelAndView中。Model
   17. mv.addObject("msg","HelloSpringMVC!");
   18. //封装要跳转的视图，放在ModelAndView中
   19. mv.setViewName("hello"); //: /WEB-INF/jsp/hello.jsp
   20. return mv;
   21. }
   23. }

9. 将自己的类交给SpringIOC容器，注册bean

   1. <!--Handler-->
   2. <bean id="/hello" class="com.kuang.controller.HelloController"/>

10. 写要跳转的jsp页面，显示ModelandView存放的数据，以及我们的正常页面；

    1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
    2. <html>
    3. <head>
    4. <title>Kuangshen</title>
    5. </head>
    6. <body>
    7. ${msg}
    8. </body>
    9. </html>

11. 配置Tomcat 启动测试！

可能遇到的问题：访问出现404，排查步骤：

1. 查看控制台输出，看一下是不是缺少了什么jar包。
2. 如果jar包存在，显示无法输出，就在IDEA的项目发布中，添加lib依赖！
3. 重启Tomcat 即可解决！

小结：看这个估计大部分同学都能理解其中的原理了，但是我们实际开发才不会这么写，不然就疯了，还学这个玩意干嘛！我们来看个注解版实现，这才是SpringMVC的精髓，到底有多么简单，看这个图就知道了。

3.2、注解版

1. 新建一个Moudle，springmvc-03-hello-annotation 。添加web支持！

   建立包结构 com.kuang.controller

2. 由于Maven可能存在资源过滤的问题，我们将配置完善

   1. <build>
   2. <resources>
   3. <resource>
   4. <directory>src/main/java</directory>
   5. <includes>
   6. <include>**/*.properties</include>
   7. <include>**/*.xml</include>
   8. </includes>
   9. <filtering>false</filtering>
   10. </resource>
   11. <resource>
   12. <directory>src/main/resources</directory>
   13. <includes>
   14. <include>**/*.properties</include>
   15. <include>**/*.xml</include>
   16. </includes>
   17. <filtering>false</filtering>
   18. </resource>
   19. </resources>
   20. </build>

3. 在pom.xml文件引入相关的依赖：主要有Spring框架核心库、Spring MVC、servlet , JSTL等。我们在父依赖中已经引入了！

4. 配置web.xml

   注意点：

   • 注意web.xml版本问题，要最新版！
   • 注册DispatcherServlet
   • 关联SpringMVC的配置文件
   • 启动级别为1
   • 映射路径为 / 【不要用/*，会404】
   1. <?xml version="1.0" encoding="UTF-8"?>
   2. <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
   3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   4. xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
   5. version="4.0">
   7. <!--1.注册servlet-->
   8. <servlet>
   9. <servlet-name>SpringMVC</servlet-name>
   10. <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
   11. <!--通过初始化参数指定SpringMVC配置文件的位置，进行关联-->
   12. <init-param>
   13. <param-name>contextConfigLocation</param-name>
   14. <param-value>classpath:springmvc-servlet.xml</param-value>
   15. </init-param>
   16. <!-- 启动顺序，数字越小，启动越早 -->
   17. <load-on-startup>1</load-on-startup>
   18. </servlet>
   20. <!--所有请求都会被springmvc拦截 -->
   21. <servlet-mapping>
   22. <servlet-name>SpringMVC</servlet-name>
   23. <url-pattern>/</url-pattern>
   24. </servlet-mapping>
   26. </web-app>

   / 和 /* 的区别：
   < url-pattern > / </ url-pattern > 不会匹配到.jsp， 只针对我们编写的请求；
   即：.jsp 不会进入spring的 DispatcherServlet类 。
   < url-pattern > / </ url-pattern > 会匹配 .jsp，
   会出现返回 jsp视图 时再次进入spring的DispatcherServlet 类，导致找不到对应的controller所以报404错。

5. 添加Spring MVC配置文件

   • 让IOC的注解生效
   • 静态资源过滤 ：HTML . JS . CSS . 图片 ， 视频 …..
   • MVC的注解驱动
   • 配置视图解析器

   在resource目录下添加springmvc-servlet.xml配置文件，配置的形式与Spring容器配置基本类似，为了支持基于注解的IOC，设置了自动扫描包的功能，具体配置信息如下：

   1. <?xml version="1.0" encoding="UTF-8"?>
   2. <beans xmlns="http://www.springframework.org/schema/beans"
   3. xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   4. xmlns:context="http://www.springframework.org/schema/context"
   5. xmlns:mvc="http://www.springframework.org/schema/mvc"
   6. xsi:schemaLocation="http://www.springframework.org/schema/beans
   7. http://www.springframework.org/schema/beans/spring-beans.xsd
   8. http://www.springframework.org/schema/context
   9. https://www.springframework.org/schema/context/spring-context.xsd
   10. http://www.springframework.org/schema/mvc
   11. https://www.springframework.org/schema/mvc/spring-mvc.xsd">
   13. <!-- 自动扫描包，让指定包下的注解生效,由IOC容器统一管理 -->
   14. <context:component-scan base-package="com.kuang.controller"/>
   15. <!-- 让Spring MVC不处理静态资源 -->
   16. <mvc:default-servlet-handler />
   17. <!--
   18. 支持mvc注解驱动
   19. 在spring中一般采用@RequestMapping注解来完成映射关系
   20. 要想使@RequestMapping注解生效
   21. 必须向上下文中注册DefaultAnnotationHandlerMapping
   22. 和一个AnnotationMethodHandlerAdapter实例
   23. 这两个实例分别在类级别和方法级别处理。
   24. 而annotation-driven配置帮助我们自动完成上述两个实例的注入。
   25. -->
   26. <mvc:annotation-driven />
   28. <!-- 视图解析器 -->
   29. <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"
   30. id="internalResourceViewResolver">
   31. <!-- 前缀 -->
   32. <property name="prefix" value="/WEB-INF/jsp/" />
   33. <!-- 后缀 -->
   34. <property name="suffix" value=".jsp" />
   35. </bean>
   37. </beans>

   在视图解析器中我们把所有的视图都存放在/WEB-INF/目录下，这样可以保证视图安全，因为这个目录下的文件，客户端不能直接访问。

6. 创建Controller

   编写一个Java控制类： com.kuang.controller.HelloController , 注意编码规范

   1. package com.kuang.controller;
   3. import org.springframework.stereotype.Controller;
   4. import org.springframework.ui.Model;
   5. import org.springframework.web.bind.annotation.RequestMapping;
   7. @Controller
   8. @RequestMapping("/HelloController")
   9. public class HelloController {
   11. //真实访问地址 : 项目名/HelloController/hello
   12. @RequestMapping("/hello")
   13. public String sayHello(Model model){
   14. //向模型中添加属性msg与值，可以在JSP页面中取出并渲染
   15. model.addAttribute("msg","hello,SpringMVC");
   16. //web-inf/jsp/hello.jsp
   17. return "hello";
   18. }
   19. }
   • @Controller是为了让Spring IOC容器初始化时自动扫描到；
   • @RequestMapping是为了映射请求路径，这里因为类与方法上都有映射所以访问时应该是/HelloController/hello；
   • 方法中声明Model类型的参数是为了把Action中的数据带到视图中；
   • 方法返回的结果是视图的名称hello，加上配置文件中的前后缀变成WEB-INF/jsp/hello.jsp。

1. 创建视图层

   在WEB-INF/ jsp目录中创建hello.jsp ， 视图可以直接取出并展示从Controller带回的信息；

   可以通过EL表示取出Model中存放的值，或者对象；

   1. <%@ page contentType="text/html;charset=UTF-8" language="java" %>
   2. <html>
   3. <head>
   4. <title>SpringMVC</title>
   5. </head>
   6. <body>
   7. ${msg}
   8. </body>
   9. </html>

2. 配置Tomcat运行

   配置Tomcat ， 开启服务器 ， 访问 对应的请求路径！

OK，运行成功！

3.3、小结

实现步骤其实非常的简单：

1. 新建一个web项目
2. 导入相关jar包
3. 编写web.xml , 注册DispatcherServlet
4. 编写springmvc配置文件
5. 接下来就是去创建对应的控制类 , controller
6. 最后完善前端视图和controller之间的对应
7. 测试运行调试.

使用springMVC必须配置的三大件：

处理器映射器、处理器适配器、视图解析器

通常，我们只需要手动配置视图解析器，而处理器映射器和处理器适配器只需要开启注解驱动即可，而省去了大段的xml配置