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页面。
-
转发
@RequestMapping("/forward") public String forward() { return "forward:/index.jsp"; //return "index"; }
-
重定向
@RequestMapping("/redirect") public String redirect() { return "redirect:/index.jsp"; }