快收藏！SpringMVC万字长文笔记，我愿奉你为王者笔记

Spring MVC

Spring MVC是目前主流的实现MVC设计模式的企业级开发框架，Spring框架的一个子模块，无需整合Spring，开发起来更加便捷。

什么是MVC设计模式？

将应用程序分为Controller、Model、View三层，Controller 接收客户端请求，调用 Model 生成业务数据，传递给View。

Spring MVC 就是对这套流程的封装，屏蔽了很多底层代码，开放出接口，让开发者可以更加轻松、便捷地完成基于MVC设计模式的Web开发。

Spring MVC的核心组件

• DispatcherServlet：前置控制器，是整个流程控制的核心，控制其他组件的执行，进行统一调度，降低组件之间的耦合性，相当于总指挥；

• Handler：处理器，完成具体的业务逻辑，相当于 Servlet；

• HandlerMapping：DispatcherServlet 接收到请求之后，通过 HandlerMapping 将不同的请求映射到不同的Handler；

• HandlerInterceptor：处理器拦截器，是一个接口，如果需要完成一些拦截处理，可以实现该接口；

• HandlerExecutionChain：处理器执行链，包括两部分内容：Handler 和 HandlerInterceptor （系统会有一个默认的 HandlerInterceptor，如果需要额外设置拦截，可以添加拦截器）；

• HandlerAdapter：处理器适配器，Handler 执行业务方法之前，需要进行一系列的操作，包括表单数据的验证、数据类型的转换、将表单数据封装到 JavaBean 等，这些操作都是由 HandlerAdapter 来完成，开发者只需要将注意力集中业务逻辑的处理上（适配器设计模式），DispatcherServlet 通过 HandlerAdapter 来执行不同的Handler；

• ModelAndView：装载了模型数据和视图信息，作为 Handler 的处理结果，返回给 DispatcherServlet ；

• ViewResolver：视图解析器，DispatcherServlet 通过它将逻辑视图解析为物理视图，最终将渲染结果响应给客户端。

Spring MVC的工作流程

• 客户端请求被 DispatcherServlet 接收；

• 根据 HandlerMapping 映射到Handler；

• 生成 Handler 和 HandlerInterceptor；

• Handler 和 HandlerInterceptor 以 HandlerExecutionChain 的形式一并返回给 DispatcherServlet；

• DispatcherServlet 通过 HandlerAdapter 来调用 Handler 的方法来完成业务逻辑处理；

• Handler 返回一个 ModelAndView 给 DispatcherServlet；

• DispatcerServlet 将获取的 ModelAndView 对象传给 ViewResolver 视图解析器，将逻辑视图解析为物理视图 View；

• ViewResolver 返回一个View 给 DispatcherServlet；

• DispatcherServlet 根据 View 进行视图渲染（将模型数据 Model 填充到视图 View 中）；

• DispatcherServlet 将渲染后的结果响应给客户端。

​

Spring MVC 流程非常复杂，实际开发中很简单，因为大部分的组件不需要开发者创建、管理，只需要通过配置文件的方式完成配置即可，真正需要开发者进行处理的只有 Handler、View。

如何使用？

• 创建 Maven 工程，pom.xml；

（当IDEA工具左侧不显示项目名称，可以关闭IDEA，删除.idea文件夹，重新打开IDEA）

（利用webapp模板创建的Web工程目录，src/main/webapp，java源文件目录和resources资源目录需要自己创建）

<dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.2.9.RELEASE</version> </dependency> </dependencies>

• 在web.xml中配置 DispatcherServlet ；

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:springmvc.xml</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>

• springmvc.xml

<?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:context="http://www.springframework.org/schema/context" xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!--配置自动扫描，将组件扫描到IoC容器中--> <context:component-scan base-package="org.westos"></context:component-scan> <!--配置视图解析器--> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/"/> <!--value="/"代表根目录--> <property name="suffix" value=".jsp"/> </bean> </beans>

• 创建 Handler

package org.westos.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; /** * @author lwj * @date 2020/12/13 22:29 */ @Controller public class HelloHandler { @RequestMapping("/index") public String index() { System.out.println("执行了index..."); return "index"; } }

• 配置Tomcat服务器，启动，运行，成功。

http://localhost:8080/index

Spring MVC 注解

• @RequestMapping

Spring MVC 通过 @RequestMapping 注解将 URL 请求与业务方法进行映射，在 Handler 的类定义处和方法定义处都可以添加 @RequestMapping ，在类定义处添加，相当于客户端多了一层访问路径；

• @Controller

@Controller 在类定义处添加，将该类交给 IoC 容器来管理（结合 springmvc.xml 的自动扫描配置使用），同时使其成为一个控制器，可以接收客户端请求；

package org.westos.controller; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; /** * @author lwj * @date 2020/12/13 22:29 */ @Controller @RequestMapping("/hello") public class HelloHandler { @RequestMapping("/index") public String index() { System.out.println("执行了index..."); return "index"; } }

http://localhost:8080/hello/index

• @RequestMapping 相关参数

1、value：指定URL请求的实际地址，是 @RequestMapping 的默认值。

@RequestMapping("/index") public String index() { System.out.println("执行了index..."); return "index"; }

等于

@RequestMapping(value = "/index") public String index() { System.out.println("执行了index..."); return "index"; }

2、method：指定请求的Method类型，GET、POST、PUT、DELETE。

@RequestMapping(value = "/index", method = RequestMethod.GET) public String index() { System.out.println("执行了index..."); return "index"; }

上述代码表示 index 方法只可以接收 GET 请求。

使用Postman工具来模拟一个POST请求访问index方法。

​

3、params：指定请求中必须包含某些参数，否则无法调用该方法。

@RequestMapping(value = "/index", method = RequestMethod.GET, params = {"name", "id=5"}) public String index() { System.out.println("执行了index..."); return "index"; }

上述代码表示请求中必须包含 name 和 id 两个参数，并且 id 的值必须是5。

http://localhost:8080/hello/index?name=zhangsan&id=5

关于参数绑定，在形参列表中通过添加 @RequestParam 注解完成 HTTP 请求参数与业务方法形参的映射。

（当请求参数名和方法形参名一致时，可以不用添加 @RequestParam 注解）

@RequestMapping(value = "/index", method = RequestMethod.GET, params = {"name", "id=5"}) public String index(@RequestParam("name") String str, @RequestParam("id") int age) { System.out.println("执行了index..."); System.out.println(str); System.out.println(age); return "index"; }

上述代码表示将请求的参数 name 和 id 分别赋给形参 str 和 age，同时自动完成了数据类型转换，将字符串"10"转换为 int 类型的10，再赋给 age，这些工作都是由 HandlerAdapter 完成。

Spring MVC 同时支持 RESTful 风格的 URL 。

传统类型： http://localhost:8080/hello/index?name=zhangsan&id=5

RESTful：http://localhost:8080/hello/rest/zhangsan/10

@RequestMapping(value = "/rest/{name}/{id}") public String rest(@PathVariable("name") String name, @PathVariable("id") int id) { System.out.println(name); System.out.println(id); return "index"; }

通过 @PathVariable 注解完成请求参数与形参的映射。

• 映射 Cookie

Spring MVC 通过映射可以直接在业务方法中获取Cookie的值。

@RequestMapping(value = "/cookie") public String cookie(@CookieValue(value = "JSESSIONID") String sessionId) { System.out.println(sessionId); return "index"; }

• 使用 JavaBean 绑定参数

Spring MVC 会根据请求参数名和 JavaBean 属性名进行自动匹配，自动为对象填充属性值，同时支持级联属性。

package org.westos.entity; import lombok.Data; /** * @author lwj * @date 2020/12/19 15:57 */ @Data public class Address { private String value; }

package org.westos.entity; import lombok.Data; /** * @author lwj * @date 2020/12/19 15:58 */ @Data public class User { private long id; private String name; private Address address; }

<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Title</title> </head> <body> <%--页面上的路径与重定向是需要添加Web项目的上下文路径的--%> <form action="/hello/register" method="post"> <label for="id">用户id：</label> <input type="text" name="id" id="id"> <br> <label for="name">用户名：</label> <input type="text" name="name" id="name"> <br> <label for="value">用户地址：</label> <input type="text" name="address.value" id="value"> <br> <input type="submit" value="注册"> </form> </body> </html>

@RequestMapping(value = "/register", method = RequestMethod.POST) public String register(User user) { System.out.println(user); return "index"; }

上述会出现中文乱码问题，只需在 web.xml 中添加 Spring MVC 自带的过滤器即可。

<filter> <filter-name>characterEncodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>characterEncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

JSP 页面的转发与重定向

Spring MVC 默认是以转发的形式响应 jsp页面。

1. 转发

@RequestMapping("/forward") public String forward() { return "forward:/index.jsp"; //return "index"; }

1. 重定向

@RequestMapping("/redirect") public String redirect() { return "redirect:/index.jsp"; }