尚硅谷SpringMVC （1-4）
一、SpringMVC简介
1、什么是MVC
MVC 是一种软件架构的思想，将软件按照模型、视图、控制器来划分
M ： Model ，模型层，指工程中的 JavaBean ，作用是处理数据
JavaBean 分为两类：
- 一类称为实体类Bean：专门存储业务数据的，如 Student、User 等
- 一类称为业务处理 Bean：指 Service 或 Dao 对象，专门用于处理业务逻辑和数据访问。
V ： View ，视图层，指工程中的 html 或 jsp 等页面，作用是与用户进行交互，展示数据
C ： Controller ，控制层，指工程中的 servlet ，作用是接收请求和响应浏览器
MVC 的工作流程： 用户通过视图层发送请求到服务器，在服务器中请求被 Controller 接收， Controller 调用相应的Model 层处理请求，处理完毕将结果返回到 Controller ， Controller 再根据请求处理的结果找到相应的View 视图，渲染数据后最终响应给浏览器
2、什么是SpringMVC
SpringMVC 是 Spring 的一个后续产品，是 Spring 的一个子项目
SpringMVC 是 Spring 为表述层开发提供的一整套完备的解决方案。在表述层框架历经 Strust 、
WebWork 、 Strust2 等诸多产品的历代更迭之后，目前业界普遍选择了 SpringMVC 作为 Java EE 项目表述层开发的首选方案 。
注：三层架构分为表述层（或表示层）、业务逻辑层、数据访问层，表述层表示前台页面和后台 servlet
3、SpringMVC的特点
- Spring 家族原生产品，与 IOC 容器等基础设施无缝对接
- 基于原生的Servlet，通过了功能强大的前端控制器DispatcherServlet，对请求和响应进行统一 处理
- 表述层各细分领域需要解决的问题全方位覆盖，提供全面解决方案
- 代码清新简洁，大幅度提升开发效率
- 内部组件化程度高，可插拔式组件即插即用，想要什么功能配置相应组件即可
- 性能卓著，尤其适合现代大型、超大型互联网项目要求
二、HelloWorld
1、开发环境
IDE ： idea
构建工具： maven3.5.4
服务器： tomcat
Spring 版本： 5.3.1
2、创建maven工程
a> 添加 web 模块
b> 打包方式： war
c> 引入依赖
war
org.springframework
spring-webmvc
5.3.24
ch.qos.logback
logback-classic
1.2.11
javax.servlet
javax.servlet-api
4.0.1
provided
org.thymeleaf
thymeleaf-spring5
3.0.15.RELEASE
3、配置web.xml
注册 SpringMVC 的前端控制器 DispatcherServlet
a> 默认配置方式
此配置作用下， SpringMVC 的配置文件默认位于 WEB-INF 下，默认名称为 -
servlet.xml ，例如，以下配置所对应 SpringMVC 的配置文件位于 WEB-INF 下，文件名为 springMVC-servlet.xml
SpringMVC
org.springframework.web.servlet.DispatcherServlet
SpringMVC
/
b> 扩展配置方式
可通过 init-param 标签设置 SpringMVC 配置文件的位置和名称，通过 load-on-startup 标签设置
SpringMVC 前端控制器 DispatcherServlet 的初始化时间
SpringMVC
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:springMVC.xml
1
SpringMVC
/
注：标签中使用 / 和 /* 的区别： / 所匹配的请求可以是 /login 或 .html 或 .js 或 .css 方式的请求路径，但是 / 不能匹配 .jsp 请求路径的请求因此就可以避免在访问jsp 页面时，该请求被 DispatcherServlet 处理，从而找不到相应的页面/* 则能够匹配所有请求，例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用 /* 的写法
4、创建请求控制器
由于前端控制器对浏览器发送的请求进行了统一的处理，但是具体的请求有不同的处理过程，因此需要创建处理具体请求的类，即请求控制器
请求控制器中每一个处理请求的方法成为控制器方法
因为 SpringMVC 的控制器由一个 POJO （普通的 Java 类）担任，因此需要通过 @Controller 注解将其标识
为一个控制层组件，交给 Spring 的 IoC 容器管理，此时 SpringMVC才能够识别控制器的存在
@Controller
public class HelloController {
}5、创建springMVC的配置文件
text/html
application/json
6、测试HelloWorld
a> 实现对首页的访问
在请求控制器中创建处理请求的方法
@Controller
public class HelloController {
// "/"--> /WEB-INF/templates/index.html
// @RequestMapping注解：处理请求和控制器方法之间的映射关系
// @RequestMapping注解的value属性可以通过请求地址匹配请求，/表示的当前工程的上下文路径
// localhost:8080/springMVC/
@RequestMapping("/")
public String index(){
//返回视图名称
return "index";
}
} b> 通过超链接跳转到指定页面
在主页 index.html 中设置超链接
首页
欢迎进入首页
访问目标页面target.html
在请求控制器中创建处理请求的方法
@Controller
public class HelloController {
// "/"--> /WEB-INF/templates/index.html
// @RequestMapping注解：处理请求和控制器方法之间的映射关系
// @RequestMapping注解的value属性可以通过请求地址匹配请求，/表示的当前工程的上下文路径
// localhost:8080/springMVC/
@RequestMapping("/")
public String index(){
//返回视图名称
return "index";
}
@RequestMapping("/target")
public String toTarget(){
return "target";
}
}7、总结
浏览器发送请求，若请求地址符合前端控制器的url-pattern，该请求就会被前端控制器
DispatcherServlet处理。前端控制器会读取SpringMVC的核心配置文件，通过扫描组件找到控制器，将请求地址和控制器中@RequestMapping注解的value属性值进行匹配，若匹配成功，该注解所标识的控制器方法就是处理请求的方法。处理请求的方法需要返回一个字符串类型的视图名称，该视图名称会被视图解析器解析，加上前缀和后缀组成视图的路径，通过Thymeleaf对视图进行渲染，最终转发到视图所对应页面
三、@RequestMapping注解
1、@RequestMapping注解的功能
从注解名称上我们可以看到， @RequestMapping 注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系。
SpringMVC 接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求。
2、@RequestMapping注解的位置
@RequestMapping 标识一个类：设置映射请求的请求路径的初始信息
@RequestMapping 标识一个方法：设置映射请求请求路径的具体信息
@Controller
@RequestMapping("/hello")
public class RequestMappingController {
@RequestMapping("/testRequestMapping")
public String success(){
return "success";
}
}
index.html:
首页
欢迎你好啊！
测试RequestMapping注解的位置
3、@RequestMapping注解的value属性
@RequestMapping 注解的 value 属性通过请求的请求地址匹配请求映射
@RequestMapping 注解的 value 属性是一个字符串类型的数组，表示该请求映射能够匹配多个请求地址所对应的请求
@RequestMapping 注解的 value 属性必须设置，至少通过请求地址匹配请求映射
测试RequestMapping注解的value位置-->testRequestMapping
测试RequestMapping注解的value位置-->test
@Controller
//@RequestMapping("/hello")
public class RequestMappingController {
@RequestMapping(value = {"/testRequestMapping","/test"})
public String success(){
return "success";
}
}4、@RequestMapping注解的method属性
@RequestMapping 注解的 method 属性通过请求的请求方式（ get 或 post ）匹配请求映射
@RequestMapping 注解的 method 属性是一个 RequestMethod 类型的数组，表示该请求映射能够匹配多种请求方式的请求
若当前请求的请求地址满足请求映射的 value 属性，但是请求方式不满足 method 属性，则浏览器报错 405： Request method 'POST' not supported
测试RequestMapping注解的method属性-->GET
当不指定method方法时，get和post请求都可以
@Controller
//@RequestMapping("/hello")
public class RequestMappingController {
@RequestMapping(
value = {"/testRequestMapping","/test"},
)
public String success(){
return "success";
}
}
当指定时，只能使用指定的请求方式
@Controller
//@RequestMapping("/hello")
public class RequestMappingController {
@RequestMapping(
value = {"/testRequestMapping","/test"},
method = {RequestMethod.GET,RequestMethod.POST}
)
public String success(){
return "success";
}
}注：1 、对于处理指定请求方式的控制器方法， SpringMVC 中提供了 @RequestMapping 的派生注解处理 get 请求的映射 -->@GetMapping处理 post 请求的映射 -->@PostMapping处理 put 请求的映射 -->@PutMapping处理 delete 请求的映射 -->@DeleteMapping2 、常用的请求方式有 get ， post ， put ， delete但是目前浏览器只支持 get 和 post ，若在 form 表单提交时，为 method 设置了其他请求方式的字符串（put 或 delete ），则按照默认的请求方式 get 处理若要发送 put 和 delete 请求，则需要通过 spring 提供的过滤器 HiddenHttpMethodFilter ，在RESTful 部分会讲到
1.
@GetMapping("/testGEtMapping")
public String testGEtMapping(){
return "success";
}测试GetMapping注解-->/testGetMapping
2 .
@RequestMapping(value = "/testPut",method =RequestMethod.PUT)
public String testPut(){
return "success";
}5、@RequestMapping注解的params属性
@RequestMapping 注解的 params 属性通过请求的请求参数匹配请求映射
@RequestMapping 注解的 params 属性是一个字符串类型的数组，可以通过四种表达式设置请求参数和请求映射的匹配关系
"param" ：要求请求映射所匹配的请求必须携带 param 请求参数
"!param" ：要求请求映射所匹配的请求必须不能携带 param 请求参数
"param=value" ：要求请求映射所匹配的请求必须携带 param 请求参数且 param=value
"param!=value" ：要求请求映射所匹配的请求必须携带 param 请求参数但是 param!=value
测试RequestMapping注解的params属性 @RequestMapping(
value = "/testParamsAndHeaders",
params = {"username","password=123456"}
)
public String testParamsAndHeaders(){
return "success";
}注：若当前请求满足 @RequestMapping 注解的 value 和 method 属性，但是不满足 params 属性，此时 页面回报错400 ： Parameter conditions "username, password!=123456" not met for actual request parameters: username={admin}, password={123456}
6、@RequestMapping注解的headers属性
@RequestMapping 注解的 headers 属性通过请求的请求头信息匹配请求映射
@RequestMapping 注解的 headers 属性是一个字符串类型的数组，可以通过四种表达式设置请求头信息和请求映射的匹配关系
"header" ：要求请求映射所匹配的请求必须携带 header 请求头信息
"!header" ：要求请求映射所匹配的请求必须不能携带 header 请求头信息
"header=value" ：要求请求映射所匹配的请求必须携带 header 请求头信息且 header=value
"header!=value" ：要求请求映射所匹配的请求必须携带 header 请求头信息且 header!=value
若当前请求满足 @RequestMapping 注解的 value 和 method 属性，但是不满足 headers 属性，此时页面显示404 错误，即资源未找到
@RequestMapping(
value = "/testParamsAndHeaders",
params = {"username","password=123456"},
headers = {"Host=localhost:8080"}
)
public String testParamsAndHeaders(){
return "success";
}测试RequestMapping注解的params属性7、SpringMVC支持ant风格的路径
模糊匹配
？：表示任意的单个字符
* ：表示任意的 0 个或多个字符
** ：表示任意的一层或多层目录
注意：在使用 ** 时，只能使用 /**/xxx 的方式
// ？：表示任意的单个字符
// *：表示任意的0个或多个字符
// **：表示任意的一层或多层目录
// 注意：在使用**时，只能使用/**/xxx的方式
@RequestMapping("/a?a/testAnt")
// @RequestMapping("/a*a/testAnt")
// @RequestMapping("/**/testAnt")
public String testAnt(){
return "success";
}测试@RequestMapping可以匹配ant风格的路径-->?
8、SpringMVC支持路径中的占位符（重点）
原始方式： /deleteUser?id=1
rest 方式： /deleteUser/1
SpringMVC 路径中的占位符常用于 RESTful 风格中，当请求路径中将某些数据通过路径的方式传输到服务器中，就可以在相应的@RequestMapping 注解的 value 属性中通过占位符 {xxx} 表示传输的数据，在通过@PathVariable 注解，将占位符所表示的数据赋值给控制器方法的形参
测试@RequestMapping支持路径中的占位符-->/testPath
@RequestMapping("/testPath/{id}/{password}")
public String testPath(@PathVariable("id") Integer id,@PathVariable("password") String password){
System.out.println("id="+id+","+"password="+password);
return "success";
}输出：id=111,password=123456
四、SpringMVC获取请求参数
1、通过ServletAPI获取
将 HttpServletRequest 作为控制器方法的形参，此时 HttpServletRequest 类型的参数表示封装了当前请求的请求报文的对象
测试使用servletAPI获取请求参数 @RequestMapping("/testServletAPI")
//形参位置的request表示当前请求
public String testServletAPI(HttpServletRequest request){
String username = request.getParameter("username");
String password = request.getParameter("password");
System.out.println("username:"+username+",password:"+password);
return "success";
}输出结果：username:admin,password:123456
2、通过控制器方法的形参获取请求参数
在控制器方法的形参位置，设置和请求参数同名的形参，当浏览器发送请求，匹配到请求映射时，在 DispatcherServlet中就会将请求参数赋值给相应的形参
测试使用控制器的形参获取请求参数
@RequestMapping("/testParam")
public String testParamm(String username,String password){
System.out.println("username:"+username+",password:"+password);
return "success";
}输出结果：username:admin,password:123456
@RequestMapping("/testParam")
public String testParamm(String username,String password,String[] hobby){
//若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
//若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
//若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果
System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
return "success";
}注：若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数若使用字符串数组类型的形参，此参数的数组中包含了每一个数据若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果
3、@RequestParam
@RequestParam 是将请求参数和控制器方法的形参创建映射关系
@RequestParam 注解一共有三个属性：
value ：指定为形参赋值的请求参数的参数名
required ：设置是否必须传输此请求参数，默认值为 true
@RequestMapping("/testParam")
public String testParamm(@RequestParam("user_name") String username, @RequestParam("pass_word") String password, String[] hobby){
//若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
//若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
//若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果
System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
return "success";
} 若设置为 true 时，则当前请求必须传输 value 所指定的请求参数，若没有传输该请求参数，且没有设置 defaultValue属性，则页面报错 400 ： Required String parameter 'xxx' is not present ；若设置为
false ，则当前请求不是必须传输 value 所指定的请求参数，若没有传输，则注解所标识的形参的值为 null
defaultValue：不管required 属性值为 true 或 false ，当 value 所指定的请求参数没有传输或传输的值
为 "" 时，则使用默认值为形参赋值
@RequestMapping("/testParam")
public String testParamm(@RequestParam(value = "user_name",required = false,defaultValue = "helloWorld") String username, @RequestParam("pass_word") String password, String[] hobby){
//若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
//若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
//若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果
System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
return "success";
}4、@RequestHeader
@RequestHeader 是将请求头信息和控制器方法的形参创建映射关系
@RequestHeader 注解一共有三个属性： value 、 required 、 defaultValue ，用法同
@RequestParam
@RequestMapping("/testParam")
public String testParamm(
@RequestParam(value = "user_name",required = false,defaultValue = "helloWorld") String username,
@RequestParam("pass_word") String password,
String[] hobby,
@RequestHeader(value = "Host",required = true,defaultValue = "zxc")String host){
//若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
//若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
//若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果
System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
System.out.println("host:"+host);
return "success";
}5、@CookieValue
@CookieValue 是将 cookie 数据和控制器方法的形参创建映射关系
@CookieValue 注解一共有三个属性： value 、 required 、 defaultValue ，用法同 @RequestParam
@RequestMapping("/testParam")
public String testParamm(
@RequestParam(value = "user_name",required = false,defaultValue = "helloWorld") String username,
@RequestParam("pass_word") String password,
String[] hobby,
@RequestHeader(value = "Host",required = true,defaultValue = "zxc")String host,
@CookieValue("JSESSIONID")String JSESSIONID){
//若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
//若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
//若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果
System.out.println("username:"+username+",password:"+password+",hobby:"+ Arrays.toString(hobby));
System.out.println("host:"+host);
System.out.println("JSESSIONID:"+JSESSIONID);
return "success";
}6、通过POJO获取请求参数
可以在控制器方法的形参位置设置一个实体类类型的形参，此时若浏览器传输的请求参数的参数名和实体类中的属性名一致，那么请求参数就会为此属性赋值
User:
public class User {
private Integer id;
private String username;
private String password;
private Integer age;
private String sex;
private String email;
public User(){
}
public User(Integer id, String username, String password, Integer age, String sex, String email) {
this.id = id;
this.username = username;
this.password = password;
this.age = age;
this.sex = sex;
this.email = email;
}
//get,set,toString方法
} @RequestMapping("/testpojo")
public String testPojo(User user){
System.out.println(user);
return "success";
}输出结果：
User{id=null, username='?????????', password='123321', age=24, sex='??·', email='1234'}
但是会出现乱码现象
7、解决获取请求参数的乱码问题
解决获取请求参数的乱码问题，可以使用 SpringMVC 提供的编码过滤器 CharacterEncodingFilter ，但是必须在web.xml 中进行注册
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
forceResponseEncoding
true
CharacterEncodingFilter
/*
注：SpringMVC 中处理编码的过滤器一定要配置到其他过滤器之前，否则无效
乱码有get请求乱码和post请求乱码。
get请求乱码时Tomcat引起的，可以一次行解决，在Tomcat文件server.xml中添加URIEncoding="UTF-8"即可。
post请求乱码需要我们自己配置，而且 编码的过滤器一定要配置到其他过滤器之前，否则无效