Spring MVC详解（上）

一、Spring MVC初步认识

1.1介绍

Spring MVC是Spring Framework提供的Web组件，全称是Spring Web MVC,是目前主流的实现MVC设计模式的框架，提供前端路由映射、视图解析等功能

Java Web开发者必须要掌握的技术框架

1.2MVC是什么

MVC是一种软件架构思想，把软件按照模型，视图，控制器来划分

View:视图层，指工程中的html,jsp等页面，作用是和用户进行交互，展示数据
Controler:控制层，指工程中的Servlet,作用是接收请求和响应浏览器
Model:模型层，指工程中的JavaBean，用来处理数据
JavaBean分成两类：

• 一类称为实体类Bean:专门用来存储业务数据，比如Student,User
• 一类称为业务处理Bean:指Servlet或Dao对象，专门用来处理业务逻辑和数据访问

流程：

1. 用户通过视图层发送请求到服务器，在服务器中请求被Controller接收
2. Controller调用相应的Model层处理请求，处理完毕后结果返回到Controller
3. Controller再根据请求处理的结果找到对应的View视图，渲染数据后最终响应给浏览器

Spring MVC对这套MVC流程进行封装，帮助开发者屏蔽底层细节，并且开放出相关接口供开发者调用，让MVC开发更简单方便

1.3 核心组件

• DispatcherServlet:前置控制器，负责调度其他组件的执行，可以降低不同组件之间的耦合性，是整个Spring MVC的核心模块
• Handler:处理器，完成具体的业务逻辑，相当于Servlet
• HandlerMapping:DispatcherServlet是通过 HandlerMapping把请求映射到不同的Handler
• HandlerInterceptor:处理器拦截器，是一个接口，如果我们需要进行一些拦截处理，可以通过实现该接口完成
• HandlerExecutionChain:处理器执行链，包括两部分内容:Handler和HandlerInterceptor(系统会有一个默认的HandlerInterceptor,如果有额外拦截处理，可以添加拦截器进行设置)
• HandlerAdapter:处理器适配器，Handler执行业务方法之前，需要进行一系列的操作包括表单的数据验证、数据类型转换、把表单数据封装到POJO等，这些一系列的操作都是由
• HandlerAdapter完成，DispatcherServlet通过HandlerAdapter执行不同的Handler
• ModelAndView:封装了模型数据和视图信息，作为Handler的处理结果，返回给DispatcherServlet
• ViewResolver:视图解析器,DispatcherServlet通过它把逻辑视图解析为物理视图，最终把渲染的结果响应给客户端

1.4 工作流程

1. 客户端请求被DispatcherServlet接收
2. 根据HandlerMapping映射到Handler
3. 生成Handler和HandlerInterceptor
4. Handler和HandlerInterceptor以HandlerExecutionChain的形式一并返回给DispatcherServlet
   DispatcherServlet通过HandlerAdapter调用Handler的方法完成业务逻辑处理
5. 返回一个ModelAndView对象给DispatcherServlet
6. DispatcherServlet把获取的ModelAndView对象传给ViewResolver视图解析器，把逻辑视图解析成物理视图
7. ViewResolver返回一个View进行视图渲染(把模型填充到视图中)
8. DispatcherServlet把渲染后的视图响应给客户端

二、Spring MVC环境搭建

2.1创建maven工程,修改pom.xml加入Spring MVC的依赖

pom.xml

<?xml version="1.0" encoding="UTF-8"?><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>org.example</groupId><artifactId>SpringMVC</artifactId><version>1.0-SNAPSHOT</version><packaging>war</packaging><name>SpringMVC Maven Webapp</name><!-- FIXME change it to the project's website --><url>http://www.example.com</url><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><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.11</version><scope>test</scope></dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>5.3.19</version></dependency></dependencies></project>

2.2在web.xml中配置Spring MVC的DispatcherServlet

1. 首先在项目中创建java和resources的目录
   
2. 在resources目录中添加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"xsi:schemaLocation="http://www.springframework.org/schema/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd">
</beans>

3. 然后在web.xml 配置Spring MVC的DispatcherServlet

<!DOCTYPE web-app PUBLIC"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd" ><web-app><display-name>Archetype Created Web Application</display-name><!-- 配置核心控制器 --><servlet><servlet-name>dispatcherServlet</servlet-name><servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class><!-- springmvc配置文件加载路径1）默认情况下，读取WEB-INF下面的文件2）可以改为加载类路径下（resources目录），加上classpath:--><init-param><param-name>contextConfigLocation</param-name><param-value>classpath:springmvc.xml</param-value></init-param><!--DispatcherServlet对象创建时间问题1）默认情况下，第一次访问该Servlet的创建对象，意味着在这个时间才去加载springMVC.xml2）可以改变为在项目启动时候就创建该Servlet，提高用户访问体验。<load-on-startup>1</load-on-startup>数值越大，对象创建优先级越低！ （数值越低，越先创建）--><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>dispatcherServlet</servlet-name><!--/ 匹配所有的请求；（不包括.jsp）--><!--/* 匹配所有的请求；（包括.jsp）--><!--*.do拦截以do结尾的请求--><url-pattern>/</url-pattern></servlet-mapping></web-app>

拦截请求其实就是说，只要是符合这个URL的请求都会进入到Spring MVC中去看看有没有对应的Handler./不会拦截.jsp的路径，但是会拦截.html等静态资源

• DispatcherServlet是Spring MVC提供的核心控制器，这个一个Servlet程序，该Servlet程序会接收所有请求
• 核心控制器会读取一个springmvc.xml配置，加载Spring MVC的核心配置
• 配置/代表拦截所有请求
• 代表在项目启动时实例化DispathcerServlet，如果没有配置，则在第一次访问Servlet时进行实例化

4. 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/beanshttp://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd"><!-- 配置自动扫包 --><context:component-scan base-package="com.zyh.controller"></context:component-scan><!-- 视图解析器 --><bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"><!--给逻辑视图加上前缀和后缀 --><!--前缀--><property name="prefix" value="/"></property><!--后缀--><property name="suffix" value=".jsp"></property></bean></beans>

4. 创建Controller控制器Handler，在里面编写接收参数，调用业务方法，返回视图页面等逻辑

@Controller
public class HelloHandler {/*** 当客户端访问index请求时* 直接自动关联到这个方法* 执行这个方法后，会返回结果* @return*/@RequestMapping("/index")public String index(){System.out.println("接收到了请求");//返回逻辑视图 逻辑视图相当于视图的别名 通过这个找到物理视图，也就是真正的视图//这里返回的只是页面的名称，不是完整的页面访问路径return "index";}
}

@Controller注解是为了让Spring IOC容器初始化时自动扫描到该Controller类；@RequestMapping是为了映射请求路径，这里因为类与方法上都有映射所以访问时应该是/；方法返回的结果是视图的名称index，该名称不是完整页面路径，最终会经过视图解析器解析为完整页面路径并跳转。

5. 配置Tomcat
   
   
6. 测试
   
   
   

三、@RequestMapping注解

Spring MVC通过@RequestMapping注解把URL请求和业务方法进行映射，在控制器的类定义处以及方法定义处都可以添加@RequestMapping,在类定义处添加相当于多了一层访问路径

@RequestMapping常用参数：

• value:指定URL请求的实际地址，是@RequestMapping的默认值
• method:指定请求的method类型，包括GET、POST、PUT、DELETE等
• params:指定request请求中必须包含的参数值，如果不包含的话，就无法调用该方法

   @RequestMapping(value = "/index",method = RequestMethod.POST,params="id")public String index(){System.out.println("接收到了请求");//返回逻辑视图 逻辑视图相当于视图的别名 通过这个找到物理视图，也就是真正的视图//注意：这里返回的只是页面名称，不是完整的页面访问路径return "index";}

四、参数绑定

4.1 URL风格参数绑定

params是对URL请求参数进行限制，不满足条件的URL无法访问该方法，需要在业务方法中获取URL的参数值。

1. 在业务方法定义时声明参数列表
2. 给参数列表添加@RequestParam注解进行绑定
   
   
   
   
   Spring MVC可以自动完成数据类型转换，该工作是由HandlerAdapter来完成的

4.2 RESTful风格的URL参数获取

• 传统的URL：localhost:8080/hello/index?id=1&name=tom
• RESTful URL:localhost:8080/hello/index/1/tom

 @RequestMapping("/restful/{id}/{name}")public String restful(@PathVariable("id") Integer num, @PathVariable("name") String name){System.out.println(num+"-"+name);return "index";}

4.3映射Cookie

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

4.4使用POJO绑定参数

Spring MVC会根据请求参数名和POJO属性名进行匹配，自动为该对象填充属性值，并且支持属性级联
首先创建实体类

为了方便测试，写一个addUser.jsp页面

<html>
<head><title>Title</title>
</head>
<body>
<form action="/hello/add" method="post"><table><tr><td>编号:</td><td><input type="text" name="id"></td></tr><tr><td>姓名:</td><td><input type="text" name="name"></td></tr><tr><td><input type="submit" value="提交"></td></tr></table></form></body>
</html>

然后在Handler中，编写相关方法

启动Tomcat服务器

结果发现出现乱码问题

为了解决这个问题，我们只需要在web.xml配置文件中配置过滤器就可以了

  <filter><filter-name>encodingFilter</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>encodingFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping>

4.5JSP页面的转发和重定向

Spring MVC默认是通过转发的形式响应JSP，可以手动进行修改

    @RequestMapping("/restful/{id}/{name}")public String restful(@PathVariable("id") Integer num, @PathVariable("name") String name){System.out.println(num+"-"+name);return "index";}

重定向：

    @RequestMapping("/restful/{id}/{name}")public String restful(@PathVariable("id") Integer num, @PathVariable("name") String name){System.out.println(num+"-"+name);return "redirect:/index.jsp";}

设置重定向的时候不能写逻辑视图，必须写明资源的物理路径，比如"rediect:/index.jsp"

转发:

    @RequestMapping("/restful/{id}/{name}")public String restful(@PathVariable("id") Integer num, @PathVariable("name") String name){System.out.println(num+"-"+name);return "forward:/index.jsp";}

五、数据绑定

• 数据绑定：在后台业务方法中，直接获取前端HTTP请求中的参数
• HTTP请求传输的参数都是String类型的，Handler业务方法中的参数是开发者指定的参数类型，比如int,Object，所以需要进行数据类型的转换
• Spring MVC的HandlerAdapter组件会在执行Handler业务方法之前，完成参数的绑定，开发者直接使用即可
  

5.1基本数据类型

@RequestMapping("/baseType")
@ResponseBody
public String baseType(int id){return "id:"+id;
}

客户端HTTP请求中必须包含id参数，否则抛出500异常，因为id不能为null

同时id的值必须为数值，而且必须为整数，否则抛出400异常

5.2包装类

 @RequestMapping("/packageType")@ResponseBodypublic String packageType(Integer id){return "id:"+id;}

如果HTPP请求中没有包含id参数，不会报错，id的值就是null，会直接返回id:null给客户端，但是如果id=a,或者id=1.2,同样会抛出404异常，因为数据类型无法转换

• value=“id”:把HTTP请求中名字为id的参数和Handler业务方法中的形参进行映射
• required：true表示id参数必须填，false表示非必填
• defaultValue=“0”:表示当HTTP请求中没有id参数的时候，形参的默认值是0

5.3数组类型

@RequestMapping("/arrayType")
@ResponseBody
public String arrayType(String[] names){StringBuffer buffer = new StringBuffer();for (String str:names){buffer.append(str).append(" ");}return "names:"+buffer.toString();
}

5.4POJO(java对象)

public class User {private Integer id;private String name;private Address address;@Overridepublic String toString() {return "User{" +"id=" + id +", name='" + name + '\'' +", address=" + address +'}';}public Address getAddress() {return address;}public void setAddress(Address address) {this.address = address;}public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}}

public class Address {private Integer code;private String value;public Integer getCode() {return code;}public void setCode(Integer code) {this.code = code;}public String getValue() {return value;}public void setValue(String value) {this.value = value;}@Overridepublic String toString() {return "Address{" +"code=" + code +", value='" + value + '\'' +'}';}
}

<html>
<head><title>Title</title>
</head>
<body>
<form action="/hello/add" method="post"><table><tr><td>编号:</td><td><input type="text" name="id"></td></tr><tr><td>姓名:</td><td><input type="text" name="name"></td></tr><tr><td>地址编号:</td><td><input type="text" name="address.code"></td></tr><tr><td>地址信息:</td><td><input type="text" name="address.value"></td></tr><tr><td><input type="submit" value="提交"></td></tr></table></form></body>
</html>

我们可以在springmvc.xml中添加一个消息转换器把中文乱码解决掉
前后端转换的数据称为消息
解决响应时乱码问题，springmvc.xml中配置转换器即可

5.5 List

Spring MVC不支持List类型的直接转换，需要包装成Object

public class UserList {private List<User> userList;public List<User> getUserList() {return userList;}public void setUserList(List<User> userList) {this.userList = userList;}
}

注意：User类一定要有无参构造，否则抛出异常

@RequestMapping("/listType")
@ResponseBody
public String listType(UserList userList){StringBuffer buffer = new StringBuffer();for (User user:userList.getUserList()){buffer.append(user);}return "用户:"+buffer.toString();
}

5.6 JSON

• JSON数据必须用JSON.stringfy()方法转换成字符串
• contentType:"application/json;charset=UTF-8"不能省略
• @RequestBody注解
  读取HTTP请求参数，通过SpringMVC提供的HttpMessageConverter接口把读取的参数转换为JSON、XML格式的数据，绑定到业务方法的形参
  需要使用组件结合@RequestBody注解把JSON转为JavaBean，这里使用FastJson，其优势是如果属性为空，就不会将其转为JSON
  把业务方法返回的对象，通过HttpMessageConverter接口转为指定格式的数据，JSON、XML等，响应给客户端