SpringMVC01

1. 学习⽬标

2. 什么叫MVC？

模型-视图-控制器（MVC）是⼀个众所周知的以设计界⾯应⽤程序为基础的设计思想。它主要通过**分离模型、视图 及 控制器在应⽤程序中的⻆⾊将业务逻辑从界⾯中解耦。通常，模型负责封装应⽤程序数据在视图层展示。视图仅仅只是展示这些数据，不包含任何业务逻辑。控制器负责接收来⾃⽤户的请求，并调⽤后台服务（service或者dao）来处理业务逻辑。处理后，后台业务层可能会返回了⼀些数据在视图层展示。控制器收集这些数据及准备模型在视图层展示。MVC模式的核⼼思想是将业务逻辑从界⾯中分离出来，允许它们单独改变⽽不会相互影响。

3. SpringMVC 框架概念与特点

Spring MVC是什么?

Spring MVC是Spring家族中的⼀个web成员，它是⼀种基于Java的实现了Web MVC设计思想的请求驱动类型的轻量级Web框架，即使⽤了MVC架构模式的思想，将web层进⾏职责解耦，基于请求驱动指的就是使⽤请求-响应模型，框架的⽬的就是帮助我们简化开发，SpringMVC也是要简化我们⽇常Web开发的。

Spring MVC能帮我们做什么?

1. 让我们能⾮常简单的设计出⼲净的Web层；
2. 进⾏更简洁的Web层的开发；
3. 天⽣与Spring框架集成（如IOC容器、AOP等）；
4. 提供强⼤的约定⼤于配置的契约式编程⽀持；
5. 能简单的进⾏Web层的单元测试；
6. ⽀持灵活的URL到⻚⾯控制器的映射；
7. ⾮常容易与其他视图技术集成，如jsp、Velocity、FreeMarker等等，因为模型数据不放在特定的
API⾥，⽽是放在⼀个Model⾥（Map数据结构实现，因此很容易被其他框架使⽤）；
8. ⾮常灵活的数据验证、格式化和数据绑定机制，能使⽤任何对象进⾏数据绑定，不必实现特定框
架的API；
9. ⽀持灵活的本地化等解析；
10. 更加简单的异常处理；
11. 对静态资源的⽀持；
12. ⽀持Restful⻛格

4. SpringMVC 请求流程

Spring MVC 请求处理流程分析

Spring MVC框架也是⼀个基于请求驱动的Web框架，并且使⽤了前端控制器模式（是⽤来提供⼀个集
中的请求处理机制，所有的请求都将由⼀个单⼀的处理程序处理来进⾏设计，再根据请求映射规则分发
给相应的⻚⾯控制器（动作/处理器）进⾏处理。⾸先让我们整体看⼀下Spring MVC处理请求的流程：1. ⾸先⽤户发送请求,请求被SpringMvc前端控制器（DispatherServlet）捕获；
2. 前端控制器(DispatherServlet)对请求URL解析获取请求URI,根据URI, 调⽤HandlerMapping；
3. 前端控制器(DispatherServlet)获得返回的HandlerExecutionChain（包括Handler对象以及Handler对
象对应的拦截器）；
4. DispatcherServlet 根据获得的HandlerExecutionChain，选择⼀个合适的HandlerAdapter。（附注：
如果成功获得HandlerAdapter后，此时将开始执⾏拦截器的preHandler(...)⽅法）；
5. HandlerAdapter根据请求的Handler适配并执⾏对应的Handler；HandlerAdapter(提取Request中的
模型数据，填充Handler⼊参，开始执⾏Handler（Controller)。 在填充Handler的⼊参过程中，根
据配置，Spring将做⼀些额外的⼯作：
HttpMessageConveter： 将请求消息（如Json、xml等数据）转换成⼀个对象，将对象转换为指定
的响应信息。
数据转换：对请求消息进⾏数据转换。如String转换成Integer、Double等数据格式化：
数据格式化。 如将字符串转换成格式化数字或格式化⽇期等
数据验证： 验证数据的有效性（⻓度、格式等），验证结果存储到BindingResult或Error中）
6. Handler执⾏完毕，返回⼀个ModelAndView(即模型和视图)给HandlerAdaptor
7. HandlerAdaptor适配器将执⾏结果ModelAndView返回给前端控制器。
8. 前端控制器接收到ModelAndView后，请求对应的视图解析器。
9. 视图解析器解析ModelAndView后返回对应View;
10. 渲染视图并返回渲染后的视图给前端控制器。
11、最终前端控制器将渲染后的⻚⾯响应给⽤户或客户端

5. Spring MVC 环境搭建

1. 开发环境
   Idea + Maven + Jdk1.8 + Jetty
2. 新建 Maven webApp
   Idea 下创建 springmvc01 ⼯程
3. pom.xml 坐标添加
   将pom.xml中多余的内容删除掉，再添加SpringMVC需要的依赖
   

<properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target></properties><dependencies><!-- spring web --><dependency><groupId>org.springframework</groupId><artifactId>spring-web</artifactId><version>5.2.4.RELEASE</version></dependency><!-- spring mvc --><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.2.4.RELEASE</version></dependency><!-- web servlet --><dependency><groupId>javax.servlet</groupId><artifactId>javax.servlet-api</artifactId><version>3.0.1</version></dependency></dependencies>
<build><plugins><!-- 编译环境插件 --><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>2.3.2</version><configuration><source>1.8</source><target>1.8</target><encoding>UTF-8</encoding></configuration></plugin><!-- jetty插件 --><plugin><groupId>org.eclipse.jetty</groupId><artifactId>jetty-maven-plugin</artifactId><version>9.4.27.v20200227</version><configuration><scanIntervalSeconds>10</scanIntervalSeconds><!-- 设置端⼝ --><httpConnector><port>8080</port></httpConnector><!-- 设置项⽬路径 --><webAppConfig><contextPath>/springmvc01</contextPath></webAppConfig></configuration></plugin></plugins>
</build>

4. 配置 web.xml
   

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="3.0"xmlns="http://java.sun.com/xml/ns/javaee"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://java.sun.com/xml/ns/javaeehttp://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"><!-- 编码过滤 utf-8 --><filter><description>char encoding filter</description><filter-name>encodingFilter</filter-name><filter-class>org.springframework.web.filter.CharacterEncodingFilter</filterclass><init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param></filter><filter-mapping><filter-name>encodingFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping><!-- servlet请求分发器 --><servlet><servlet-name>springMvc</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:servlet-context.xml</param-value></init-param><!-- 表示启动容器时初始化该Servlet --><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>springMvc</servlet-name><!-- 这是拦截请求， "/"代表拦截所有请求，"*.do"拦截所有.do请求 --><!-- <url-pattern>/</url-pattern> --><url-pattern>*.do</url-pattern></servlet-mapping>
</web-app>

要想启动我们的 SpringMVC 环境，⽬前对于 mvc 框架的配置还未进⾏。以上在 web.xml 中引⽤了servlet-context.xml ⽂件
6.servlet-context.xml 配置

<beans xmlns="http://www.springframework.org/schema/beans"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xmlns:mvc="http://www.springframework.org/schema/mvc"xmlns:context="http://www.springframework.org/schema/context"xsi:schemaLocation="http://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsdhttp://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/contexthttp://www.springframework.org/schema/context/spring-context.xsd"><!-- 开启扫描器 --><context:component-scan base-package="com.xxxx.springmvc.controller"/><!-- 使⽤默认的 Servlet 来响应静态⽂件 --><mvc:default-servlet-handler/><!-- 开启注解驱动--><mvc:annotation-driven/><!-- 配置视图解析器 --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"id="internalResourceViewResolver"><!-- 前缀：在WEB-INF⽬录下的jsp⽬录下 --><property name="prefix" value="/WEB-INF/jsp/"/><!-- 后缀：以.jsp结尾的资源 --><property name="suffix" value=".jsp"/></bean>
</beans>

7.⻚⾯控制器的编写

@Controller
public class HelloController {/*** 请求映射地址 /hello.do* @return*/@RequestMapping("/hello")public ModelAndView hello(){ModelAndView mv=new ModelAndView();mv.addObject("hello", "hello spring mvc");mv.setViewName("hello");return mv; }
}

8. 添加视图⻚⾯
   在 WEB-INF 下新建 jsp ⽂件夹 ，并在⽂件夹下新建 hello.jsp
   

 <%@page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath =
request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/"
;
%>
<!DOCTYPE HTML>
<html><head><base href="<%=basePath %>"><title>My JSP 'hello.jsp' starting page</title><meta http-equiv="pragma" content="no-cache"><meta http-equiv="cache-control" content="no-cache"><meta http-equiv="expires" content="0"> <meta http-equiv="keywords" content="keyword1,keyword2,keyword3"><meta http-equiv="description" content="This is my page"></head><body><!-- el表达式接收参数值 -->${hello}</body>
</html>

9.启动 jetty 服务器

访问地址 http://localhost:8080/springmvc01/hello.do

⾄此，springmvc 环境搭建完毕

6. URL 地址映射配置

6.1. @RequestMapping
通过注解 @RequestMapping 将请求地址与⽅法进⾏绑定，可以在类级别和⽅法级别声明。类级别的注
解负责将⼀个特定的请求路径映射到⼀个控制器上，将 url 和类绑定；通过⽅法级别的注解可以细化映
射，能够将⼀个特定的请求路径映射到某个具体的⽅法上，将 url 和类的⽅法绑定。
6.1.1. 映射单个 URL
@RequestMapping(“”) 或 @RequestMapping(value=“”)

/*** @RequestMapping 声明在⽅法上⾯，映射单个 URL* 访问地址：（如果有类路径需要写在⽅法路径前⾯）* http://ip:port/springmvc01/test01* @return*/
@RequestMapping("/test01")
// @RequestMapping(value = "/test01")
public ModelAndView test01(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test01");modelAndView.setViewName("hello");return modelAndView;
}
/*** 路径开头是否加 斜杠"/" 均可* @RequestMapping("/请求路径") 与 @RequestMapping("请求路径")均可* 建议加上，如：@RequestMapping("/test02")* 访问地址：（如果有类路径需要写在⽅法路径前⾯）* http://ip:port/springmvc01/test02* @return*/
@RequestMapping("test02")
public ModelAndView test02(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test02");modelAndView.setViewName("hello");return modelAndView;
}

6.1.3. 映射 URL 在控制器上
⽤于类上，表示类中的所有响应请求的⽅法都是以该地址作为⽗路径

@Controller
@RequestMapping("/url")
public class UrlController {/*** @RequestMapping 声明在类上⾯，类中的的⽅法都是以该地址作为⽗路径* 声明级别：* 类级别 + ⽅法级别 （/类路径/⽅法路径）* 访问地址：* http://ip:port/springmvc01/url/test04* @return*/@RequestMapping("/test04")public ModelAndView test04(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test04");modelAndView.setViewName("hello");return modelAndView;}
}

6.1.4. 设置 URL 映射的请求⽅式
默认没有设置请求⽅式，在HTTP 请求中最常⽤的请求⽅法是 GET、POST，还有其他的⼀些⽅法，
如：DELET、PUT、HEAD 等。
可以通过 method 属性设置⽀持的请求⽅式，如 method=RequestMethod.POST；如设置多种请求⽅
式，以⼤括号包围，逗号隔开即可。

/*** 设置请求⽅式* 通过 method 属性设置⽅法⽀持的请求⽅式，默认 GET请求和 POST等请求都⽀持。* 设置了请求⽅式，则只能按照指定的请求⽅式请求。* 访问地址：（只能使⽤POST请求访问）* http://ip:port/springmvc01/url/test05* @return*/
@RequestMapping(value = "/test05",method = RequestMethod.POST)
public ModelAndView test05(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test05");modelAndView.setViewName("hello");return modelAndView;
}

6.1.5. 通过参数名称映射 URL

/*** 通过参数名称访问* 通过参数的形式访问* 访问地址：* http://ip:port/springmvc01/url?test06* @return*/
@RequestMapping(params = "test06")
public ModelAndView test06(){ModelAndView modelAndView = new ModelAndView();modelAndView.addObject("hello","test06");modelAndView.setViewName("hello");return modelAndView;
}

7. 参数绑定

客户端请求的参数到控制器功能处理⽅法上的参数的绑定，对于参数绑定⾮常灵活。

1. 基本数据类型

/*** 基本类型数据绑定* 参数值必须存在。如果没有指定参数值，也没有设置参数默认值，则会报500异常。* @param age* @param money*/
@RequestMapping("data01")
public void data01(int age, double money){System.out.println("age:" + age + ", money:" + money);
}
/*** 基本类型数据绑定* 通过注解 @RequestParam 标记⼀个形参为请求参数。（注解声明在形参的前⾯）* 可以通过注解的属性设置相关内容* 设置参数的默认值 defaultValue* @param age* @param money*/
@RequestMapping("data02")
public void data02(@RequestParam(defaultValue = "18") int age,
@RequestParam(defaultValue = "10.0") double money){System.out.println("age:" + age + ", money:" + money);
}
/*** 基本类型数据绑定* 通过注解 @RequestParam 标记⼀个形参为请求参数。（注解声明在形参的前⾯）* 可以通过注解的属性设置相关内容* 设置参数的参数名（别名） name* @param age* @param money*/
@RequestMapping("data03")
public void data03(@RequestParam(defaultValue = "18", name = "userAge") int age,@RequestParam(defaultValue = "10.0", name = "userMoney") double money){System.out.println("age:" + age + ", money:" + money);
}

2. 包装类型

 /*** 包装类型数据绑定 （如果数据是基本类型，建议使⽤包装类型）* 客户端请求参数名与⽅法形参名保持⼀致，默认参数值为null* 可以通过 @RequestParam 的name属性设置参数的别名，defaultValue属性设置参数默认值* @param age* @param money*/
@RequestMapping("data05")
public void data05(Integer age, Double money){System.out.println("age:" + age + ", money:" + money);
}

3. 字符串类型

/*** 字符串数据绑定* 客户端请求参数名与⽅法形参名保持⼀致，默认参数值为null* 可以通过 @RequestParam 的name属性设置参数的别名，defaultValue属性设置参数默认值* @param userName* @param userPwd*/
@RequestMapping("data04")
public void data04(String userName, String userPwd){System.out.println("userName:" + userName + ", userPwd:" + userPwd);
}

4. 数组类型

 /*** 数组类型数据绑定* 客户端传参形式：ids=1&ids=2&ids=3* @param ids*/
@RequestMapping("/data06")
public void data06(String[] ids){for(String id : ids){System.out.println(id + "---");}
}

5. JavaBean 类型

 /*** JavaBean 数据绑定* 客户端请求的参数名与JavaBean对象的属性字段名保持⼀致* @param user*/
@RequestMapping("/data07")
public void data07(User user) {System.out.println(user);
}

User.java

package com.xxxx.springmvc.po;
public class User {private int id;private String userName;private String userPwd;public int getId() {return id;}public void setId(int id) {this.id = id;}public String getUserName() {return userName;}public void setUserName(String userName) {this.userName = userName;}public String getUserPwd() {return userPwd;}public void setUserPwd(String userPwd) {this.userPwd = userPwd;}@Overridepublic String toString() {return "User [id=" + id + ", userName=" + userName + ", userPwd="+ userPwd + "]";}
}

8. JSON 数据开发

现在比较流行的开发方式为异步调用。前后台以异步方式进行交换，传输的数据使用的是JSON,所以前端如果发送的是JSON数据，后端该如何接收?

对于JSON数据类型，我们常见的有三种:

• json普通数组（[“value1”,“value2”,“value3”,…]）
• json对象（{key1:value1,key2:value2,…}）
• json对象数组（[{key1:value1,…},{key2:value2,…}]）

对于上述数据，前端如何发送，后端如何接收?

JSON普通数组

步骤1:pom.xml添加依赖

SpringMVC默认使用的是jackson来处理json的转换，所以需要在pom.xml添加jackson依赖

<!-- 添加json 依赖jar包 -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.10.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.10.0</version>
</dependency> 
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.10.0</version>
</dependency>

步骤2： 修改配置⽂件

servlet-context.xml

<!-- 添加json 依赖jar包 -->
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.10.0</version>
</dependency>
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.10.0</version>
</dependency> 
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.10.0</version>
</dependency>

步骤3. 注解使⽤

1. @ResponseBody

@Controller
@RequestMapping("/user")
public class UserController {/*** @ResponseBody 返回的是JOSN格式的数据，返回JavaBean对象* 注解设置在⽅法体上* @return*/@RequestMapping("queryUser01")@ResponseBodypublic User queryUser01(){User user = new User();user.setId(1);user.setUserName("zhangsan");user.setUserPwd("123456");// 返回的是user对象return user;}/*** @ResponseBody 返回的是JOSN格式的数据，返回JavaBean对象* 注解设置在⽅法返回对象前，修饰符之后* @return*/@RequestMapping("queryUser02")public @ResponseBody User queryUser02(){User user = new User();user.setId(2);user.setUserName("lisi");user.setUserPwd("123321");// 返回的是user对象return user;}/*** @ResponseBody 返回的是JOSN格式的数据，返回集合* @return*/@RequestMapping("/queryUser03")@ResponseBodypublic List<User> queryUser03(){List<User> list = new ArrayList<>();User user01 = new User();user01.setId(1);user01.setUserName("zhangsan");user01.setUserPwd("123456");User user02 = new User();user02.setId(2);user02.setUserName("lisi");user02.setUserPwd("123321");list.add(user01);list.add(user02);// 返回的是user集合return list;}
}

2. @RequestBody

@RequestBody 注解常⽤来处理 content-type 不是默认的 application/x-www-form-urlcoded 类型的内
容，⽐如说：application/json 或者是application/xml 等。⼀般情况下来说常⽤其来处理 application/json
类型。@RequestBody接受的是⼀个 json 格式的字符串，⼀定是⼀个字符串。
通过 @RequestBody 可以将请求体中的 JSON 字符串绑定到相应的 bean 上，当然，也可以将其分别绑
定到对应的字符串上。

/*** @RequestBody 规定请求的参数是JOSN格式的字符串* 注解设置在形参前⾯* @param user* @return*/
@RequestMapping("/getUser")
@ResponseBody
public User getUser(@RequestBody User user){System.out.println(user);return user;
}
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head><title>JSON处理</title><%-- 引⼊Jquery的核⼼JS⽂件 --%><script type="text/javascript" src="js/jquery-3.4.1.js"></script>
</head>
<body><input type="button" value="JSON数据测试" onclick="test()"/><script type="text/javascript">/*** 请求传递JSON格式的数据* 返回JSON格式的数据*/function test(){$.ajax({// 请求⽅式 Get|Posttype: "post",// 请求路径url: "user/getUser",// 预期服务器返回的额数据类型dataType: "json",// 设置服务器请求类型的数据类型为JSON格式contentType: "application/json;charset=utf-8",// 传递给服务器的参数data:'{"userName":"admin","userPwd":"123456"}',// 回调函数，接收服务器返回的响应的结果 （函数中的形参⽤来接收服务器返回的数据）success:function(data){console.log(data);}})}</script>
</body>
</html>